Configuration OCPP d'une borne
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 ?
- Ouvrez Bornes dans le menu.
- Ouvrez la fiche de la borne.
- 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
- 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.
- Une barre apparaît en bas : « modification(s) en attente d'envoi ». Rien n'est encore parti vers la borne.
- Cliquez sur Envoyer à la borne.
- Une fenêtre récapitule chaque clé, son ancienne valeur et la nouvelle. Confirmez avec Envoyer à la borne.
- 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.