Lorsqu’une borne de recharge cesse de fonctionner, le premier indice arrive généralement sous la forme d’un message OCPP. La borne signale un statut tel que Faulted accompagné d’un code d’erreur, et parfois d’un code propre au fabricant plus détaillé. Bien lire ces messages évite des déplacements inutiles et permet de résoudre les problèmes plus vite.

Ce guide explique les statuts de connecteur OCPP 1.6 et chaque code d’erreur standard, avec pour chacun la cause typique et une première action pertinente. Il décrit ensuite une méthode de dépannage, les bonnes pratiques pour les redémarrages et déverrouillages à distance, la mise en place de la journalisation et des alertes, et le moment où il faut envoyer un technicien.

À retenir
  • En OCPP 1.6, les bornes signalent leur statut et leurs erreurs dans le message StatusNotification.
  • L’errorCode standard indique la catégorie du problème ; les champs facultatifs vendorErrorCode et info en donnent souvent la cause exacte.
  • Consultez d’abord les journaux et l’historique, puis tentez l’action à distance la moins perturbante.
  • Envoyez un technicien pour les erreurs liées à la sécurité, les défauts répétés ou les problèmes que les commandes à distance ne résolvent pas.

D’où viennent les codes d’erreur OCPP

En OCPP 1.6, une borne envoie un StatusNotification au CSMS chaque fois que le statut d’un connecteur change ou qu’une erreur survient. Le message contient l’identifiant du connecteur, le statut, un errorCode et, en option, un vendorErrorCode, un identifiant de fabricant et un texte info. Le connecteur 0 désigne la borne dans son ensemble.

Un code d’erreur différent de NoError s’accompagne généralement du statut Faulted, mais pas toujours. Une borne peut signaler une erreur, par exemple WeakSignal ou HighTemperature, tout en continuant à fonctionner dans un autre statut. C’est la combinaison du statut et du code d’erreur qui donne l’image complète.

En OCPP 2.0.1, le message StatusNotification est simplifié et ne signale que le statut du connecteur. Les problèmes détaillés sont remontés sous forme d’événements via le device model (par exemple avec NotifyEvent). Les principes de cet article restent valables, mais les noms de champs diffèrent.

Les statuts de connecteur en OCPP 1.6

StatutSignification
AvailableLe connecteur est libre et prêt pour une nouvelle session.
PreparingUn utilisateur a engagé une action, comme brancher le câble ou présenter un badge, mais la recharge n’a pas commencé.
ChargingDe l’énergie est délivrée au véhicule.
SuspendedEVSELa borne ne délivre pas d’énergie, par exemple en raison d’une limite de puissance ou d’une décision locale.
SuspendedEVLe véhicule n’accepte pas d’énergie, par exemple parce que la batterie est pleine ou qu’il programme sa recharge.
FinishingLa transaction est terminée, mais le connecteur n’est pas encore libre, par exemple parce que le câble est toujours branché.
ReservedLe connecteur est réservé à un utilisateur précis.
UnavailableLe connecteur a été désactivé, par exemple avec une commande ChangeAvailability.
FaultedUne erreur empêche l’utilisation du connecteur.

Deux statuts provoquent beaucoup de fausses alertes. SuspendedEV est normal lorsqu’un véhicule est plein ou attend un départ programmé. Finishing est normal jusqu’à ce que le conducteur débranche. Ni l’un ni l’autre ne constitue un défaut en soi.

Les codes d’erreur OCPP 1.6 expliqués

Le tableau liste tous les codes d’erreur standard de l’OCPP 1.6. Les causes et premières actions indiquées sont des exemples typiques ; consultez toujours le manuel de la borne, car les fabricants utilisent les codes de manière légèrement différente.

errorCodeSignificationCause typiquePremière action
ConnectorLockFailureLe verrouillage du câble ne s’est pas enclenché ou libéréProblème mécanique de verrou, câble mal inséréDemander au conducteur de réinsérer le câble ; tenter un déverrouillage du connecteur
EVCommunicationErrorLa communication avec le véhicule a échouéProblème côté véhicule, câble ou contacts de prise endommagésTester avec un autre véhicule avant de mettre en cause la borne
GroundFailureDéfaut de terre ou courant résiduel détectéDéfaut d’isolement, humidité, véhicule ou câble défectueuxNe pas redémarrer en boucle ; traiter comme un problème de sécurité
HighTemperatureTempérature trop élevéeSoleil direct, ventilation obstruée, bornes de raccordement surchargéesVérifier la ventilation et les conditions ambiantes
InternalErrorErreur matérielle ou logicielle de la borneProblème de firmware ou défaillance d’un composant interneLire le vendorErrorCode ; tenter un redémarrage logiciel
LocalListConflictConflit entre la liste locale et le CSMSLa réponse du CSMS diffère de la liste d’autorisation localeRenvoyer la liste locale depuis le CSMS
NoErrorAucune erreurSignalement de statut normalAucune action nécessaire
OtherErrorErreur non couverte par les autres codesCondition propre au fabricantLire le vendorErrorCode et le champ info, puis consulter le manuel
OverCurrentFailureSurintensité détectéeVéhicule appelant trop de courant, problème de câblageVérifier le véhicule et l’installation
OverVoltageTension au-dessus de la plage autoriséePerturbation du réseau ou problème d’alimentationVérifier l’alimentation ; faire intervenir un électricien si le problème se répète
PowerMeterFailureLe compteur d’énergie ne peut pas être luDéfaut du compteur ou problème de câblage interneVérifier les relevés dans les journaux ; planifier une intervention
PowerSwitchFailureLe contacteur ou le relais n’a pas commutéContacteur usé ou colléMettre le connecteur hors service ; envoyer un technicien
ReaderFailureLe lecteur d’identification est défaillantDéfaut ou dégradation du lecteur RFIDTester avec un badge enregistré connu ; planifier une réparation
ResetFailureLe redémarrage n’a pas pu être effectuéProblème de firmware ou de matérielTenter un redémarrage matériel ou une coupure d’alimentation sur site
UnderVoltageTension en dessous de la plage autoriséeAlimentation faible, connexion desserrée, problème réseauVérifier l’alimentation et les bornes de raccordement
WeakSignalSignal sans fil faibleMauvaise couverture mobile ou Wi-FiAméliorer la position de l’antenne ou le réseau

Une méthode de dépannage pratique

  1. Lisez le message complet. Examinez ensemble le statut, l’errorCode, le vendorErrorCode et le champ info, et notez l’heure.
  2. Consultez l’historique. Est-ce la première occurrence ou un problème récurrent ? A-t-il commencé après une mise à jour de firmware, une coupure de courant ou un épisode météo ?
  3. Vérifiez la connectivité. Si les heartbeats se sont arrêtés, le problème vient peut-être du réseau et non de la borne. Consultez notre guide pour connecter une borne à un serveur OCPP pour les problèmes de connexion courants.
  4. Actualisez le statut. Utilisez TriggerMessage pour demander un nouveau StatusNotification et confirmer que l’erreur est toujours active.
  5. Tentez la correction la moins perturbante. Déverrouillez le connecteur, modifiez la disponibilité ou effectuez un redémarrage logiciel, dans cet ordre lorsque c’est pertinent.
  6. Escaladez. Si l’erreur revient ou touche à la sécurité, mettez le connecteur hors service et planifiez l’intervention d’un technicien.

Bon usage des redémarrages et déverrouillages à distance

Un usage imprudent des commandes à distance peut agacer les conducteurs ou masquer de vrais problèmes.

  • Vérifiez d’abord les sessions en cours. Un redémarrage met fin aux transactions en cours. Ne redémarrez pas une borne pendant qu’un conducteur recharge, sauf si la borne est déjà inutilisable.
  • Privilégiez le redémarrage logiciel. Un redémarrage logiciel (soft reset) relance proprement le logiciel. N’utilisez le redémarrage matériel (hard reset) qu’en cas d’échec du premier.
  • Ne déverrouillez que sur demande. Déverrouillez un connecteur lorsqu’un conducteur signale un câble bloqué, idéalement en restant en contact avec lui.
  • Ne masquez pas les défauts de sécurité. Redémarrer en boucle après une erreur GroundFailure ou de surintensité peut mettre des personnes en danger.
  • Désactivez les connecteurs défectueux. Passer un connecteur en indisponible évite aux conducteurs de perdre leur temps jusqu’à sa réparation.
  • Consignez ce que vous avez fait. Un journal des commandes et de leurs résultats aide la personne suivante à comprendre l’historique.

Le logiciel OCPP Üreticy permet, depuis le tableau de bord, le redémarrage logiciel et matériel, l’arrêt à distance, le déverrouillage du connecteur, le changement de disponibilité, la modification de configuration et le TriggerMessage, et le résultat de chaque commande est journalisé.

Journalisation et alertes

Un CSMS doit conserver les messages OCPP bruts, permettre de les rechercher et alerter les bonnes personnes en cas de problème.

  • Journaux de messages bruts : le contenu exact du StatusNotification, champs fabricant compris, est souvent le chemin le plus rapide vers un diagnostic.
  • Alertes : prévenez l’équipe en cas de défaut, de déconnexion ou de commande restée sans réponse.
  • Historique des statuts : une chronologie par connecteur montre si un défaut est nouveau ou récurrent.

Üreticy fournit des journaux de messages OCPP consultables et des alertes pour les défauts, les déconnexions, les commandes sans réponse et les dépassements de limite, ainsi qu’un tableau de bord de l’état des connecteurs en temps réel. Consultez la liste complète des fonctionnalités.

Quand envoyer un technicien

  • Erreurs liées à la sécurité comme GroundFailure, OverCurrentFailure ou des erreurs de tension répétées.
  • Défaillances matérielles comme PowerSwitchFailure, PowerMeterFailure ou ReaderFailure.
  • Tout défaut qui réapparaît après un redémarrage, ou une borne qui reste hors ligne après vérification du réseau.
  • Des dommages visibles signalés par les conducteurs, comme des câbles, des prises ou des boîtiers cassés.
  • Des défauts de lecteur de badges qui bloquent l’accès ; consultez notre guide de l’autorisation par badge RFID pour écarter d’abord un problème de badge.

Transmettez au technicien les codes d’erreur, les codes fabricant, les horodatages et les actions à distance déjà tentées.

Questions fréquentes

Quelle est la différence entre statut et errorCode en OCPP ?

Le statut décrit l’état du connecteur, comme Available, Charging ou Faulted. L’errorCode décrit un problème, comme GroundFailure ou InternalError. En OCPP 1.6, les deux sont transmis ensemble dans le message StatusNotification.

Que signifie vendorErrorCode ?

Le vendorErrorCode est un champ facultatif dans lequel le fabricant de la borne indique son propre code d’erreur, plus détaillé. Sa signification est définie dans la documentation du fabricant, et non dans l’OCPP. Il est souvent plus utile que l’errorCode standard pour le diagnostic.

SuspendedEV est-il une erreur ?

Non. SuspendedEV signifie que le véhicule n’accepte pas d’énergie pour le moment, par exemple parce que sa batterie est pleine ou qu’il attend une heure de recharge programmée. Ce statut ne mérite une analyse que si un véhicule qui a besoin d’énergie y reste bloqué.

Faut-il redémarrer une borne qui signale Faulted ?

Un redémarrage logiciel est une première étape raisonnable pour les erreurs d’origine logicielle comme InternalError, à condition qu’aucune session ne soit en cours. Pour les erreurs liées à la sécurité comme GroundFailure, ne redémarrez pas en boucle : mettez le connecteur hors service et faites intervenir un technicien.

Les codes d’erreur OCPP 2.0.1 sont-ils les mêmes qu’en 1.6 ?

Non. En OCPP 2.0.1, le StatusNotification ne signale que le statut du connecteur, et les problèmes détaillés sont remontés sous forme d’événements via le device model. La démarche de dépannage est la même, mais les messages et les champs diffèrent.

Visualisez chaque statut de connecteur, chaque code d’erreur et chaque message OCPP au même endroit, et traitez les défauts avec des commandes à distance journalisées. Découvrez le logiciel OCPP Üreticy ou contactez-nous pour une démonstration.