Messages OCPP
Avec ChargePilot, vos bornes de recharge communiquent avec le contrôleur ChargePilot via protocole OCPP. Des messages prédéfinis (actions) sont échangés entre la borne de recharge et le contrôleur ChargePilot. Ceux-ci incluent des messages d’authentification d’une session de recharge, des messages d’état et d’erreur, ainsi que des redémarrages de borne.
Il est possible d’effectuer une recherche sur plusieurs valeurs à l’aide de la barre de recherche, par exemple sur l’action, l’identifiant de la borne de recharge ou l’état (correspondant à Action, Charging Station ID, Status).
Vous trouverez ci-dessous des informations plus détaillées sur les différents niveaux de journalisation dans ChargePilot, et leur contenu.
Niveaux de journalisation OCPP
Il existe trois niveaux de journalisation dans ChargePilot :
- Aucun journal
- Journaux de niveau informatif
- Journaux de niveau débogage
Par défaut, votre site est configuré au niveau informatif, ce qui vous permet de consulter les renseignements pertinents et les analyses liées aux changements d’état, aux messages d’erreur et aux transactions sur votre site.
Journaux de niveau informatif
Les messages (actions) suivants sont inclus dans le niveau informatif :
| ||
1 | Authorize | Avant qu’un propriétaire de véhicule électrique puisse commencer ou arrêter une recharge, le point de recharge doit autoriser l’opération. Le point de recharge NE DOIT fournir de l’énergie qu’après autorisation. Lors de l’arrêt d’une session de recharge, le point de recharge NE DOIT envoyer une requête Authorize.req que si l’identifiant utilisé pour arrêter la session est différent de celui utilisé pour la démarrer. |
2 | BootNotification | Après le démarrage, un point de recharge DOIT envoyer une requête au système central contenant les informations sur sa configuration (ex. : version, fournisseur, etc.). Le système central DOIT répondre pour indiquer s’il accepte le point de recharge. |
3 | FirmwareStatusNotification | Un point de recharge envoie des notifications pour informer le système central de l’avancement d’une mise à jour du micrologiciel. Le point de recharge DOIT envoyer un PDU FirmwareStatusNotification.req pour informer le système central de l’état du téléchargement et de l’installation. Le point de recharge NE DOIT envoyer l’état inactif (« Idle ») qu’après réception d’un message TriggerMessage pour cette notification, et uniquement lorsqu’elle ne télécharge/installe plus de micrologiciel. |
4 | StartTransaction | Le point de recharge DOIT envoyer un PDU StartTransaction.req au système central pour l’informer qu’une session de recharge a commencé. Si cette session termine une réservation (via l’opération « Reserve Now »), alors le StartTransaction.req DOIT inclure l’identifiant de réservation (« reservationId »). |
5 | StatusNotification | Le point de recharge envoie une notification au système central pour l’informer d’un changement d’état ou d’une erreur. |
6 | StopTransaction | Lorsqu’une session est arrêtée, le point de recharge DOIT envoyer un PDU StopTransaction.req au système central pour l’informer que la session a pris fin. |
Journaux de niveau débogage
Les messages (actions) suivants sont inclus dans le niveau débogage du journal en supplément du niveau informatif du journal :
- CancelReservation
- CertificateSigned
- ChangeAvailability
- ChangeConfiguration
- ClearCache
- ClearChargingProfile
- DataTransfer
- DeleteCertificate
- DiagnosticsStatusNotification
- ExtendedTriggerMessage
- FirmwareStatusNotification
- GetCompositeSchedule
- GetConfiguration
- GetDiagnostics
- GetInstalledCertificateIds
- GetLocalListVersion
- GetLog
- Heartbeat
- InstallCertificate
- LogStatusNotification
- MeterValues
- RemoteStartTransaction
- RemoteStopTransaction
- ReserveNow
- Reset
- SecurityEventNotification
- SendLocalList
- SetChargingProfile
- SignCertificate
- SignedFirmwareStatusNotification
- SignedUpdateFirmware
- TriggerMessage
- UnlockConnector
- UpdateFirmware
Toutes les bornes ne prennent pas en charge l’ensemble des messages OCPP. Toutefois, certains messages sont obligatoires pour assurer l’intégration avec ChargePilot.
Contenu des messages OCPP
Chaque action comporte plusieurs valeurs, qui sont expliquées dans le tableau ci-dessous :
| ||
1 | action | Type de message, par exemple « StatusNotification » |
2 | connector_id | Identifiant du point de recharge |
3 | request | Requête. Selon l’action, la requête contient des informations différentes. |
4 | site_id | Identifiant du site |
5 | charger_id | Identifiant de la borne de recharge |
6 | response | Réponse. Selon l’action, la réponse contient des informations différentes. |
7 | datetime | Date et heure du message OCPP |
8 | source | Source : indique l’origine du message.
|
Téléchargement des journaux OCPP
ChargePilot permet de télécharger les journaux OCPP afin de fournir des rapports détaillés sur les événements de recharge et les erreurs. Le téléchargement peut être filtré par l’identifiant (ID) de borne, messages de statut OCPP, actions, ainsi que par date et heure. Cela permet aux utilisateurs de cibler les informations pertinentes à leur analyse et de réduire le nombre de champs dans le téléchargement.
Des descriptions et exemples de chaque champ du téléchargement sont présentés dans le tableau ci-dessous. Veuillez noter que cette fonctionnalité permet d’afficher un maximum de 10 000 entrées à la fois. Pour réussir l’exportation, utilisez les options de filtrage pour affiner votre recherche.
Pour plus de détails sur chaque champ, veuillez consulter la documentation OCPP 1.6J du document Open Charge Alliance (voir lien ci-dessous).
Descriptions des champs
En-têtes du journal de téléchargement OCPP | Description | Exemple | Ce champ est-il envoyé par tous les EVSE ? |
Datetime | Date et heure du message envoyé via OCPP, en UTC | 2024-11-26T10:03:49Z | |
Action | Fait référence à l’opération ou commande spécifique dans un échange entre le point de recharge et le système central (ici, ChargePilot) | StatusNotification, StopTransaction, Heartbeat | |
Charger ID | Identifiant de la borne de recharge (unique pour chaque borne) | Charger 5 | |
Connector ID | Identifiant du point de recharge. Indique de quel port de la borne proviennent les informations (ex. 0, 1, 2). Généralement, 0 indique le port principal et 1, 2 ou 3 indiquent des ports de recharge supplémentaires sur la borne de recharge. | 1 | Si ce champ est vide, cela peut indiquer une borne avec un seul port. |
Request Vendor Error Code | Code d’erreur propre au fabricant, fournissant des informations supplémentaires pour le débogage ou les rapports d’erreur. Les fabricants de bornes utilisent des codes différents, avec des niveaux de détail variables. Veuillez contacter le fabricant de votre IRVE pour une explication détaillée de chaque code. | CHARGER_DOOR_OPEN | |
Request Timestamp | Date et heure du message au moment où il est traité par ChargePilot. Il peut y avoir un léger décalage (<2 secondes) entre ce champ et le champ « datetime »”, en raison de différences de granularité des données. Ce champ est associé à « StartTransaction », « StopTransaction » et « StatusNotification ». | 2024-11-26T10:03:49Z | |
Request Status | Indique l’état opérationnel d’un point de recharge, communiqué via les messages « StatusNotification ». Ce statut reflète les différentes phases de la session de recharge, tel que « Available », « Preparing », « Charging », « SuspendedEV », « SuspendedEVSE », « Finishing » et « Faulted ». Chaque état représente la disponibilité, l’activité ou une anomalie du point de recharge. | Faulted | |
Request Error Code | Indique divers problèmes rencontrés lors de la communication entre une borne et le système dorsal. Ces erreurs sont généralement rapportées via le message « StatusNotification » d’OCPP et aident les opérateurs à diagnostiquer et résoudre les problèmes efficacement. | EVCommunicationError ou ConnectorLockFailure | |
Request Info | Indique toute information supplémentaire liée au message, généralement une erreur. | State transition | |
Request Vendor ID | Identifiant unique utilisé pour spécifier le fabricant ou le fournisseur à l’origine d’une requête. Souvent associé aux messages « StatusNotification ». Configuré par le fabricant de l’IRVE. | HLX | |
Request ID Tag | Identifiant RFID du véhicule, souvent utilisé dans les messages « StopTransaction » et « StartTransaction ». Contient l’identifiant de l’utilisateur ayant arrêté la recharge. Ce champ est optionnel, car une borne peut interrompre une session sans « idTag », par exemple en cas de réinitialisation. | 43434 | |
Request Meter Stop | Relevé du compteur d’énergie à la fin d’une session (en wattheures), envoyé avec le message « StopTransaction ». Les IRVE peuvent envoyer ces données de manière continue ou les remettre à zéro à chaque session. | 1387299 | |
Request Transaction ID | Identifiant unique d’une session de recharge, utilisé de manière cohérente dans « StartTransaction », « StopTransaction » et « MeterValues ». Configuré par le fabricant de l’IRVE. | 4356987 | |
Request Reason | Indique la raison pour laquelle une transaction a été arrêtée. Utilisé uniquement avec les messages « StopTransaction ». | PowerLoss | |
Response ID Tag Info Status | Indique le statut d’autorisation d’une session de recharge liée à un identifiant RFID spécifique. Souvent relié aux messages « Authorize », « StartTransaction » ou « StopTransaction ». | Accepted | |
L1 Voltage* | Tension de sortie envoyée au véhicule via le connecteur, en volts. | 31.234 | |
L2 Voltage* | Tension de sortie envoyée au véhicule via le connecteur, en volts. | 31.234 | |
L3 Voltage* | Tension de sortie envoyée au véhicule via le connecteur, en volts. | 31.234 | |
Voltage* | Tension de sortie envoyée au véhicule via le connecteur, en volts. | 101 | |
L1 Current.Import* | Courant instantané vers le véhicule (sur la phase L1), en ampères. | 5 | |
L2 Current.Import* | Courant instantané vers le véhicule (sur la phase L2), en ampères. | 5 | |
L3 Current.Import* | Courant instantané vers le véhicule (sur la phase L3), en ampères. | 5 | |
Current.Import* | Courant instantané vers le véhicule, en ampères. | 15 | |
L1 Power* | Puissance active instantanée importée par le véhicule (généralement en W ou kW) sur L1. Correspond à « Power.Active.Import ». | 12 | |
L2 Power* | Puissance active instantanée importée par le véhicule (généralement en W ou kW) sur L2. Correspond à « Power.Active.Import ». | 12 | |
L3 Power* | Puissance active instantanée importée par le véhicule (généralement en W ou kW) sur L3. Correspond à « Power.Active.Import ». | 12 | |
Power* | Puissance active instantanée importée par le véhicule (généralement en W ou kW). Correspond à « Power.Active.Import ». | 12 |
* Différentes bornes rapportent ces champs selon différents formats. Cela signifie que certaines colonnes peuvent être vides, selon le modèle de borne. De plus, toutes les bornes ne rapportent pas ces données supplémentaires. Lorsqu’elles sont disponibles, elles apparaîtront dans le journal OCPP tel que rapporté par la borne. Veuillez consulter votre fabricant d’IRVE pour plus de détails.
Cet article a-t-il été utile ?
C'est super !
Merci pour votre commentaire
Désolé ! Nous n'avons pas pu vous être utile
Merci pour votre commentaire
Commentaires envoyés
Nous apprécions vos efforts et nous allons corriger l'article