Lorsqu'une borne se connecte à un serveur OCPP, la première chose qu'elle dit est : « Je suis là, voici ma marque et mon modèle. » Ce message de présentation s'appelle BootNotification. Il paraît simple, mais il détermine si la borne est acceptée, règle son horloge et fixe le rythme de toute la communication qui suit.
Quand le BootNotification est-il envoyé ?
Une borne envoie un BootNotification :
- Au premier démarrage ou lorsqu'elle redémarre après une coupure de courant,
- Après une commande Reset,
- Lorsqu'une mise à jour du firmware se termine et que la borne redémarre,
- Dans certaines implémentations, lorsque la connexion WebSocket est rétablie après une longue interruption.
En OCPP 1.6J, la borne ne doit pas envoyer d'autres messages tant qu'elle n'a pas reçu de réponse Accepted à son BootNotification, sauf exceptions explicitement autorisées par le CSMS.
Que contient le message ?
En OCPP 1.6J, les champs obligatoires sont chargePointVendor (fabricant) et chargePointModel (modèle). Les champs facultatifs comprennent le numéro de série, la version du firmware, l'ICCID et l'IMSI (informations de la carte SIM), le type et le numéro de série du compteur. En OCPP 2.0.1 et 2.1, les informations sont regroupées dans un objet chargingStation et un champ reason est ajouté (PowerUp, FirmwareUpdate, RemoteReset, Watchdog, etc.). Ce champ est très précieux pour comprendre pourquoi la borne a redémarré.
Exemple de requête 1.6J :
[2, "1001", "BootNotification", {"chargePointVendor": "MarqueExemple", "chargePointModel": "DC60", "firmwareVersion": "3.2.1"}]
Les trois réponses possibles du CSMS
Accepted
La borne est reconnue et peut commencer à fonctionner. La réponse contient deux valeurs importantes :
currentTime: l'heure actuelle pour que la borne règle son horloge.interval: l'intervalle entre les messages Heartbeat (secondes).
Pending
Le CSMS a vu la borne mais ne l'a pas encore acceptée. Cette réponse est utilisée, par exemple, lorsque la borne attend une validation dans le tableau de bord ou lorsque le CSMS veut d'abord envoyer certains paramètres. Dans cet état, le CSMS peut envoyer à la borne des messages de configuration et de requête. La borne renvoie le BootNotification après l'interval.
Rejected
La borne n'a pas été acceptée. Cela arrive généralement à cause d'un identifiant de borne non reconnu ou d'une connexion non autorisée. La borne attend le délai indiqué puis réessaie.
Problèmes fréquents sur le terrain
La borne envoie le BootNotification en boucle
Si la réponse est Pending ou Rejected, la borne entre dans une boucle. Vérifiez si la borne attend une validation dans le tableau de bord. Dans Üreticy, les bornes non reconnues apparaissent dans la liste des bornes en attente et s'ajoutent au compte en un clic.
L'heure semble erronée
Si la borne n'applique pas la valeur currentTime, les horaires des sessions peuvent dériver. Cela crée une grande confusion dans les rapports. Voir notre article sur la synchronisation de l'horloge en OCPP.
Redémarrages fréquents
Si le champ reason en 2.0.1 indique Watchdog ou Unknown, la borne redémarre peut-être d'elle-même. Recherchez des causes matérielles comme l'alimentation, un bogue du firmware ou une surchauffe. En 1.6J, vous pouvez arriver à une conclusion similaire en surveillant la fréquence des BootNotification.
Modèle ou numéro de série vide
Certaines bornes n'envoient pas les champs facultatifs. Le numéro de série est important pour la gestion de l'inventaire ; demandez au fabricant de renseigner ce champ via un paramètre du firmware.
Pourquoi les données du BootNotification sont-elles précieuses ?
Chaque BootNotification enregistre l'identité de la borne, son firmware et l'heure de son redémarrage. Ces informations permettent :
- De constituer un inventaire du parc par version de firmware,
- De détecter les redémarrages inattendus,
- De gérer les lignes mobiles grâce aux informations de la carte SIM.
Pour une première connexion pas à pas, consultez notre guide pour connecter une borne à un serveur OCPP.
Liste de contrôle de mise en service
Lors du raccordement d'une nouvelle borne, suivre cet ordre à l'étape du BootNotification facilite le travail :
- Saisissez l'URL OCPP et l'identifiant de la borne (Charge Point ID) exactement comme dans le tableau de bord.
- Redémarrez la borne et vérifiez dans les journaux que la requête BootNotification arrive.
- Confirmez que la réponse est Accepted et que la valeur interval est celle attendue.
- Vérifiez ensuite que des messages StatusNotification arrivent pour chaque connecteur.
- Enfin, lancez et arrêtez une courte session de recharge avec un badge de test.
Une fois ces cinq étapes réalisées, la borne est prête à fonctionner.
Conclusion
Le BootNotification est la porte d'entrée de la communication OCPP. Une réponse Accepted permet à la borne de fonctionner, règle son horloge et fixe le rythme des Heartbeat ; Pending et Rejected la mettent en attente. Bien suivre ce message et sa réponse accélère la mise en service et aide à repérer tôt les pannes silencieuses. Le logiciel OCPP d'Üreticy enregistre chaque BootNotification avec la version du firmware et la cause du redémarrage.