Accueil / bornes / Configuration OCPP d'une borne

Configuration OCPP d'une borne

Mis à jour le 09 octobre 2026
1 min 48 Chargekeeper Academy · Commencer par la vidéo Les paramètres OCPP La vidéo pose l’essentiel en quelques minutes ; cet article va plus loin. Voir la vidéo
Sur cette page Où se trouve la configuration OCPP ?Les recommandations de ChargekeeperLes règles bloquantes pour l'exploitationLes règles de bon réglageLire la vue guidéeLes modulesLes filtresLes badges d'un réglageModifier un réglageLe détail des réglagesAutorisation des utilisateursMesures et relevésConnexion au serveurConnecteur et signalisationSécurité de la liaisonLes modules en lecture seuleQuestions fréquentesBesoin d'aide ?

La configuration OCPP est l'ensemble des réglages qu'une borne porte en elle : comment elle autorise un badge, ce qu'elle mesure, à quel rythme elle parle à la supervision. Chaque réglage est une clé OCPP avec une valeur.

Chargekeeper lit ces clés sur la borne, vous les présente en clair, vous signale celles qui s'écartent des bonnes pratiques et vous laisse les corriger. Cette page explique l'écran, les recommandations appliquées et le rôle de chaque réglage.

Les réglages décrits ici sont ceux du protocole OCPP 1.6.

Où se trouve la configuration OCPP ?

  1. Ouvrez Bornes dans le menu.
  2. Ouvrez la fiche de la borne.
  3. Allez sur l'onglet Paramètres OCPP.

L'onglet propose deux vues, par les deux boutons en haut :

Vue Ce qu'elle montre Pour qui
Guidé Les réglages connus, regroupés par thème, avec un libellé en français, une explication, un contrôle adapté (interrupteur, liste à cocher, durée) et les recommandations. L'usage courant.
Avancé La liste brute de toutes les clés de la borne, y compris celles propres au fabricant. Un réglage absent de la vue guidée.

Si la borne n'a jamais transmis sa configuration, la vue guidée affiche « Aucun paramètre OCPP connu pour cette borne ». Cliquez sur Lire la configuration de la borne.

Les recommandations de Chargekeeper

Chargekeeper applique un seul jeu de règles à la configuration OCPP. Ce même jeu sert à deux endroits :

  • dans la vue Guidé, où chaque réglage qui s'en écarte est signalé avec le conseil correspondant, y compris pendant que vous modifiez la valeur ;
  • dans les Alertes, si le module d'alertes est activé pour votre organisation : la borne mal configurée remonte alors comme une alerte de mauvaise configuration OCPP.

Il n'y a donc pas deux référentiels : ce que l'écran vous conseille est ce que l'alerte vous reprochera.

Les règles bloquantes pour l'exploitation

Ces écarts sont classés erreur : ils empêchent une fonction de marcher ou ouvrent une faille.

Clé OCPP Valeur attendue Pourquoi
AuthorizeRemoteTxRequests true Sinon la borne n'autorise pas la supervision à démarrer une recharge à distance (application, tableau de bord).
AllowOfflineTxForUnknownId false À true, la borne hors ligne accepte n'importe quel badge : ces recharges ne peuvent être rattachées à aucun compte.
MeterValueSampleInterval Supérieure à 0 À 0, la borne n'envoie aucun relevé pendant la recharge : pas de courbe, pas de suivi.
MeterValuesSampledData Contient Energy.Active.Import.Register C'est l'index d'énergie : sans lui, la supervision ne connaît pas l'énergie délivrée pendant la recharge.
StopTxnAlignedData Contient Energy.Active.Import.Register L'index d'énergie doit accompagner la fin de session.

Les règles de bon réglage

Ces écarts sont classés avertissement : la borne fonctionne, mais mal réglée. Toute valeur hors de la plage est signalée.

Clé OCPP Plage recommandée Pourquoi
MeterValueSampleInterval 60 à 300 secondes Trop court : trafic inutile. Trop long : courbes grossières et suivi tardif.
HeartbeatInterval 300 à 43 200 secondes (5 minutes à 12 heures) Le battement de cœur dit que la borne est vivante. Trop rare, une borne tombée est détectée tard.
MeterValuesAlignedData Contient Energy.Active.Import.Register Les relevés d'horloge doivent porter l'index d'énergie.
ConnectionTimeOut 60 secondes ou plus C'est le temps laissé entre le badge (ou le paiement) et le branchement du câble. Trop court, l'autorisation expire avant que le conducteur ait branché.
WebSocketPingInterval 140 à 220 secondes, 180 conseillé Trop bas : liaison instable. Trop haut : une connexion rompue est détectée tard.
TransactionMessageAttempts 3 à 10 tentatives Trop bas : des sessions se perdent après une coupure réseau. Trop haut : charge réseau inutile.

Les clés qui ne figurent dans aucun de ces deux tableaux n'ont pas de règle : la vue guidée les explique, sans les juger.

Lire la vue guidée

Les modules

Les réglages sont rangés en onze modules, que vous dépliez un par un.

Module Ce qu'il règle
Autorisation des utilisateurs Qui peut démarrer une charge, et ce que fait la borne quand elle perd la supervision.
Mesures et relevés Ce que la borne mesure, à quel rythme, et ce qu'elle joint à la fin de session.
Connexion au serveur Rythme des échanges avec la supervision et résistance aux coupures réseau.
Connecteur et signalisation Comportement au débranchement et réglages du bandeau lumineux.
Liste locale de badges Liste embarquée qui permet à la borne d'autoriser sans le serveur.
Pilotage de la charge Ce que la borne accepte comme consignes de limitation de puissance.
Réservation Capacité de réserver un point de charge à l'avance.
Mise à jour du firmware Moyens par lesquels la borne récupère un firmware ou dépose un journal.
Plug and Charge Reconnaissance du véhicule par certificat, sans badge ni application.
Sécurité de la liaison Identité de la borne et niveau de protection de la connexion au serveur.
Limites déclarées par la borne Plafonds annoncés par la borne. Ils conditionnent ce que le serveur peut lui demander.

Chaque module affiche le nombre de réglages modifiables. Un module dont un réglage s'écarte des recommandations porte un badge à vérifier, visible même replié.

Les filtres

Au-dessus des modules, une recherche et cinq filtres : Toutes, À vérifier (les écarts aux recommandations), Modifiables, Lecture seule, Non supportées.

Les badges d'un réglage

Badge Ce qu'il veut dire
Requise La norme OCPP impose cette clé à toute borne.
Lecture seule La borne ne laisse pas modifier cette clé. C'est la borne qui fait foi, même si la norme la dit modifiable.
Redémarrage La borne a accepté la valeur mais ne l'appliquera qu'après un redémarrage.
Obsolète Clé retirée par une édition plus récente de la norme.
Non remontée La borne n'a pas transmis cette clé à la dernière lecture. Cela ne prouve pas qu'elle la refuse : la lecture a pu être incomplète.
Non supportée La borne a déclaré ne pas connaître cette clé. Une écriture serait refusée.
À revérifier La borne avait déclaré la clé inconnue avec un ancien firmware ; elle en a changé depuis. Relisez sa configuration.
Illisible La borne n'a rien pu répondre pour cette clé précise. Le défaut vient de la borne, pas de votre réglage.

Pour une clé Non remontée, le bouton Écrire quand même tente l'écriture : seule la borne peut dire si elle l'accepte. Si elle ne la connaît pas, elle répond « non supportée » et rien n'est changé.

Modifier un réglage

  1. Dans la vue Guidé, dépliez le module et changez la valeur. Si elle s'écarte d'une recommandation, le conseil s'affiche aussitôt sous le réglage.
  2. Une barre apparaît en bas : « modification(s) en attente d'envoi ». Rien n'est encore parti vers la borne.
  3. Cliquez sur Envoyer à la borne.
  4. Une fenêtre récapitule chaque clé, son ancienne valeur et la nouvelle. Confirmez avec Envoyer à la borne.
  5. Les clés sont écrites une par une, chacune confirmée par la borne : comptez quelques secondes par ligne.

Chaque ligne se termine par un résultat :

Résultat Ce qui s'est passé
Accepté La borne applique la valeur.
Redémarrage requis La valeur est enregistrée, elle prendra effet au prochain redémarrage de la borne.
Refusé La borne n'a pas voulu de cette valeur.
Non supportée La borne ne connaît pas cette clé.
Non envoyée L'envoi s'est arrêté avant cette clé.

À savoir :

  • Le bouton Sauvegarder de la fiche n'envoie pas la configuration OCPP. Il enregistre la fiche de la borne dans la supervision. Tant que la barre « en attente d'envoi » est affichée, fermer ou sauvegarder la fiche abandonne vos modifications OCPP : l'écran vous le rappelle avant.
  • Les valeurs sont écrites dans le format que la borne utilise déjà (par exemple l'orthographe exacte de la clé, ou la façon d'écrire une liste).
  • Relire depuis la borne redemande à la borne sa configuration complète. L'en-tête indique la date de la dernière lecture.
  • Si la supervision ne peut pas joindre la borne, sa configuration ne peut être ni lue ni modifiée à distance : l'écran l'indique.

Le détail des réglages

Autorisation des utilisateurs

Réglage à l'écran Clé OCPP Rôle
Accepter les badges inconnus hors ligne AllowOfflineTxForUnknownId Hors connexion, la borne accepte un badge qu'elle ne connaît pas. Pratique en site isolé, risqué en accès public. Recommandé : désactivé.
Cache d'autorisation AuthorizationCacheEnabled Mémorise les badges déjà acceptés par le serveur pour les réautoriser hors ligne.
Autoriser avant un démarrage à distance AuthorizeRemoteTxRequests Un démarrage lancé depuis la supervision ou l'application passe par une vérification d'autorisation. Recommandé : activé.
Utiliser la liste locale hors ligne LocalAuthorizeOffline Hors connexion, la borne décide à partir de la liste de badges qu'elle a en mémoire.
Autoriser localement sans attendre le serveur LocalPreAuthorize La borne démarre dès qu'elle reconnaît le badge localement. Démarrage plus rapide, au risque de démarrer sur un badge révoqué.
Arrêter la charge si le badge devient invalide StopTransactionOnInvalidId Si le serveur invalide un badge en cours de session, la charge s'arrête.
Énergie tolérée après invalidation MaxEnergyOnInvalidId Énergie (en Wh) encore délivrée après l'invalidation d'un badge, avant de couper.

Mesures et relevés

Réglage à l'écran Clé OCPP Rôle
Mesures envoyées pendant la charge MeterValuesSampledData Grandeurs relevées à intervalle régulier pendant une session. Une grandeur retirée disparaît des courbes et des diagnostics. Doit contenir l'index d'énergie consommée.
Intervalle entre deux relevés MeterValueSampleInterval Rythme des relevés pendant la charge. Recommandé : 60 à 300 secondes.
Mesures des relevés d'horloge MeterValuesAlignedData Grandeurs des relevés calés sur l'horloge, envoyés même hors session. Doit contenir l'index d'énergie consommée.
Relevé aligné sur l'horloge ClockAlignedDataInterval Relevé supplémentaire calé sur des heures rondes, indépendant des sessions. 900 secondes donnent un relevé par quart d'heure ; 0 le désactive.
Mesures jointes à l'arrêt StopTxnSampledData Grandeurs incluses dans le message de fin de session. L'index d'énergie doit y figurer : c'est lui qui clôture la facturation.
Relevés d'horloge joints à l'arrêt StopTxnAlignedData Relevés alignés sur l'horloge, transmis à la clôture de la session. Doit contenir l'index d'énergie consommée.
Ordre des phases par connecteur ConnectorPhaseRotation Dit au serveur comment les trois phases sont raccordées sur chaque connecteur. Une valeur fausse fausse l'équilibrage par phase.

Les grandeurs que vous pouvez cocher dans ces listes :

Grandeur à l'écran Valeur OCPP À quoi elle sert
Index d'énergie consommée Energy.Active.Import.Register Compteur cumulé en Wh. C'est lui qui donne l'énergie facturée. Indispensable.
Puissance consommée Power.Active.Import Puissance instantanée. Nécessaire aux courbes de charge et au pilotage.
Courant consommé Current.Import Courant par phase. Nécessaire à l'équilibrage par phase.
Tension Voltage Tension par phase. Utile au diagnostic réseau.
Puissance autorisée / Courant autorisé Power.Offered / Current.Offered Ce que la borne met à disposition. Permet de vérifier qu'une consigne est appliquée.
Niveau de batterie du véhicule SoC Pourcentage de charge. Remonté seulement si le véhicule le communique.
Température interne Temperature Température de la borne. Utile pour diagnostiquer un bridage thermique.
Régime de ventilation RPM Vitesse du ventilateur de refroidissement.

Les autres grandeurs (énergie renvoyée, énergie réactive, facteur de puissance, fréquence) servent à des usages particuliers et sont rarement utiles en recharge classique.

Connexion au serveur

Réglage à l'écran Clé OCPP Rôle
Battement de cœur HeartbeatInterval Délai entre deux signaux de vie quand la borne n'a rien d'autre à dire. Recommandé : 300 à 43 200 secondes.
Ping de la liaison WebSocketPingInterval Maintient la connexion ouverte à travers les routeurs et pare-feux qui coupent les liaisons inactives. Recommandé : 140 à 220 secondes, 180 conseillé.
Délai avant abandon du branchement ConnectionTimeOut Temps laissé entre le passage du badge et le branchement du câble. Recommandé : 60 secondes ou plus.
Tentatives d'envoi d'un message de session TransactionMessageAttempts Nombre de réémissions d'un message de session resté sans réponse. Recommandé : 3 à 10.
Délai entre deux tentatives TransactionMessageRetryInterval Attente entre deux réémissions. Multiplié par le nombre de tentatives, il donne la durée de résistance à une coupure.
Tentatives de redémarrage ResetRetries Nombre de tentatives après un ordre de redémarrage resté sans effet.
Durée minimale d'un état MinimumStatusDuration Filtre les changements d'état trop brefs.

Connecteur et signalisation

Réglage à l'écran Clé OCPP Rôle
Arrêter la session au débranchement StopTransactionOnEVSideDisconnect La session se clôt dès que le véhicule est débranché.
Déverrouiller le câble au débranchement UnlockConnectorOnEVSideDisconnect Libère le câble automatiquement. Sinon, l'utilisateur doit repasser son badge pour le récupérer.
Clignotements de signalisation BlinkRepeat Nombre de clignotements du bandeau lumineux.
Intensité lumineuse LightIntensity Luminosité du bandeau, en pourcentage.

Sécurité de la liaison

Réglage à l'écran Clé OCPP Rôle
Niveau de sécurité de la connexion SecurityProfile Niveau 0 : aucune sécurité. Niveau 1 : mot de passe seul. Niveau 2 : liaison chiffrée et mot de passe, le socle recommandé. Niveau 3 : liaison chiffrée et certificat.
Clé d'authentification AuthorizationKey Secret que la borne utilise pour s'authentifier. Écrit sur la borne, jamais relu.
Nom de l'opérateur CpoName Nom attendu dans le certificat du serveur.

⚠️ Niveau de sécurité : à ne pas changer sans préparation

Un changement mal préparé du niveau de sécurité peut couper définitivement la borne de la supervision : elle ne saurait plus se reconnecter pour être corrigée, et il faudrait intervenir sur place. Contactez le support avant de le modifier.

Les modules en lecture seule

Liste locale de badges, Pilotage de la charge, Réservation, Mise à jour du firmware et Limites déclarées par la borne montrent surtout ce que la borne annonce savoir faire : capacité de la liste de badges, unités de consigne acceptées, nombre de profils de charge, protocoles de transfert, nombre de connecteurs. Ces valeurs se lisent, elles ne se règlent pas : elles disent ce que la supervision peut demander à la borne.

Questions fréquentes

Une clé n'apparaît pas dans la vue guidée. Elle est propre au fabricant, ou hors du catalogue. Passez en vue Avancé.

La borne refuse ma valeur. La borne reste seule juge de ce qu'elle accepte. Vérifiez la valeur attendue dans la documentation du fabricant.

Le résultat est « Redémarrage requis ». Redémarrez la borne depuis sa fiche pour que la valeur prenne effet.

La vue guidée n'affiche aucun conseil. Si le message « Les règles de configuration n'ont pas pu être chargées » apparaît, aucun contrôle n'est appliqué sur l'écran à ce moment-là. Rechargez la page ; si cela persiste, contactez le support.

J'ai une alerte de mauvaise configuration OCPP. Ouvrez la borne, onglet Paramètres OCPP, vue Guidé, filtre À vérifier : les réglages en cause y sont listés avec la valeur attendue.

Besoin d'aide ?

Écrivez au support Chargekeeper : support@charge-keeper.com.