Connecter une borne de recharge à un serveur OCPP est généralement rapide, mais de petites erreurs peuvent coûter des heures : un caractère erroné dans l’identifiant de la borne, ws au lieu de wss, ou un port bloqué. La plupart des problèmes de connexion ont quelques causes typiques, faciles à éviter une fois qu’on les connaît.
Ce guide pas à pas explique comment connecter une borne à un serveur OCPP (CSMS). Il couvre les prérequis, l’emplacement des paramètres, la signification de chaque champ, le test de la connexion et la résolution des problèmes les plus fréquents. Vous trouverez à la fin un exemple avec le format d’URL d’Üreticy.
- Il vous faut quatre éléments : une connexion Internet fonctionnelle, un firmware compatible OCPP, l’URL du serveur et un identifiant de borne unique.
- L’identifiant de la borne correspond normalement à la dernière partie du chemin de l’URL et doit correspondre exactement, majuscules et minuscules comprises.
- Utilisez
wss://(TLS) dès que la borne le permet, et vérifiez que l’horloge de la borne est à l’heure. - Une connexion réussie se reconnaît à trois signes : BootNotification accepté, heartbeats réguliers et état du connecteur correct.
Les prérequis avant de commencer
Vérifiez ces points avant d’ouvrir les paramètres de la borne :
- Connexion Internet : Ethernet, Wi-Fi ou carte SIM mobile. Pour une connexion par SIM, vérifiez que le forfait data est actif et que les paramètres APN sont corrects.
- Accès sortant : le réseau doit autoriser les connexions sortantes vers le serveur, généralement sur le port 443 pour
wss://. C’est la borne qui ouvre la connexion : aucun port entrant n’est nécessaire. - Firmware : la borne doit disposer d’un firmware compatible OCPP. Vérifiez la version prise en charge (1.6J, 2.0.1 ou 2.1) et, si nécessaire, installez le dernier firmware stable du fabricant.
- Paramètres de connexion fournis par votre CSMS : l’URL du serveur, la version du protocole et, le cas échéant, un mot de passe.
- Accès installateur : les identifiants de l’interface web de la borne, de l’application installateur ou de l’outil de configuration.
Où trouver les paramètres OCPP
Chaque fabricant place les paramètres à un endroit différent, mais on retrouve trois options courantes :
- Interface web : vous connectez un ordinateur portable à la borne par câble ou à son propre point d’accès Wi-Fi, puis ouvrez une adresse IP locale dans le navigateur.
- Application installateur : une application mobile qui se connecte à la borne en Bluetooth ou en Wi-Fi.
- Outil de configuration : un logiciel pour ordinateur, parfois relié par USB ou câble série. Certains fabricants permettent aussi la configuration via leur propre portail cloud.
Cherchez des menus intitulés par exemple« Backend »,« OCPP »,« Central System » ou« Network ». Le manuel d’installation comporte généralement une section dédiée.
Les champs à renseigner
| Champ (noms courants) | Valeur à saisir | Remarques |
|---|---|---|
| Central System URL, CSMS URL, OCPP server URL | L’adresse WebSocket fournie par votre CSMS | Commence par ws:// ou wss:// |
| Charge Point ID, ChargeBoxIdentity, Station ID | Un nom unique pour cette borne | Généralement ajouté au chemin de l’URL ; sensible à la casse |
| Version du protocole | OCPP 1.6J, 2.0.1 ou 2.1 | Doit correspondre à ce que le CSMS attend pour cette borne |
| Mot de passe, clé d’autorisation | Le mot de passe d’authentification HTTP Basic | Facultatif ; utilisé avec les profils de sécurité 1 et 2 |
| Certificat TLS | Certificat racine ou certificat client | Nécessaire pour wss:// si la borne ne fait pas confiance par défaut au certificat du serveur, ainsi que pour le profil 3 |
Comment l’URL et l’identifiant fonctionnent ensemble
En OCPP, la borne se connecte à l’URL du serveur en ajoutant son identifiant à la fin du chemin. Par exemple, avec l’URL de serveur wss://csms.example.com/ocpp et l’identifiant CP001, la borne se connecte à wss://csms.example.com/ocpp/CP001.
Certaines bornes ajoutent l’identifiant automatiquement : vous ne saisissez alors que l’URL de base. D’autres attendent l’URL complète, identifiant compris. Lisez attentivement le manuel. Si l’identifiant est ajouté deux fois ou pas du tout, le CSMS ne reconnaîtra pas la borne.
Pas à pas : connecter la borne
- Créez ou réservez la borne dans votre CSMS, ou notez l’identifiant que vous comptez utiliser. Adoptez une convention de nommage claire, par exemple code du site suivi d’un numéro.
- Ouvrez les paramètres de la borne via l’interface web, l’application ou l’outil.
- Configurez la connexion réseau et vérifiez que la borne a accès à Internet.
- Saisissez l’URL du serveur et l’identifiant de la borne exactement comme décrit ci-dessus.
- Sélectionnez la version du protocole correspondant à la configuration de votre CSMS.
- Saisissez le mot de passe et le certificat si votre configuration de sécurité les utilise.
- Vérifiez les paramètres horaires. Activez le NTP si la borne le permet et réglez le bon fuseau horaire.
- Enregistrez et redémarrez la borne ou le module de communication.
Comment tester la connexion
Après le redémarrage, vérifiez ces signes dans le CSMS et dans les journaux de messages OCPP :
- BootNotification accepté : la borne envoie son fabricant, son modèle et son firmware, et le CSMS répond Accepted. Une réponse Pending ou Rejected signifie que la borne est connue mais pas encore validée.
- Heartbeat : les heartbeats arrivent à l’intervalle fixé dans la réponse au BootNotification, généralement toutes les 60 à 300 secondes.
- StatusNotification : chaque connecteur signale un état, normalement Available lorsqu’aucun véhicule n’est branché.
- Commande à distance : envoyez un TriggerMessage ou modifiez la disponibilité, et vérifiez que la borne répond.
- Session de test : présentez un badge RFID, rechargez un véhicule quelques minutes et vérifiez que la session et les relevés de compteur apparaissent.
Pour en savoir plus sur ces messages, lisez Qu’est-ce que l’OCPP ?
Problèmes courants et solutions
| Symptôme | Cause probable | Que faire |
|---|---|---|
| La borne n’apparaît jamais dans le CSMS | Pas d’Internet, URL erronée ou port sortant bloqué | Vérifiez l’état du réseau sur la borne ; testez l’URL ; demandez au service informatique d’autoriser le trafic sortant sur le port 443 |
| La connexion est immédiatement refusée | Identifiant de borne erroné ou inconnu | Comparez l’identifiant caractère par caractère, y compris la casse, les espaces et les tirets |
La connexion fonctionne en ws:// mais pas en wss:// | Certificat non reconnu ou TLS non pris en charge | Installez le bon certificat racine ou mettez à jour le firmware |
| TLS échoue alors que le certificat est correct | L’horloge de la borne est fausse | Activez le NTP ou réglez l’heure manuellement ; la validation du certificat dépend de la date |
| Erreur d’authentification | Mot de passe ou profil de sécurité erroné | Ressaisissez le mot de passe et vérifiez le profil configuré des deux côtés |
| La connexion se coupe régulièrement | Signal mobile faible ou réseau instable | Vérifiez la puissance du signal, la position de l’antenne et les paramètres de heartbeat et de ping |
| La borne se connecte mais les messages échouent | Versions du protocole différentes | Assurez-vous que la borne et le CSMS utilisent la même version de l’OCPP |
Exemple : connecter une borne à Üreticy
Avec Üreticy, chaque client reçoit une URL OCPP personnelle au format suivant :
wss://ocpp.ureticy.com/URT{customer-no}/{charge-point-id}Par exemple, si votre numéro client était 1001 et l’identifiant de votre borne HOTEL-01, l’adresse complète serait wss://ocpp.ureticy.com/URT1001/HOTEL-01. Si votre borne ajoute l’identifiant automatiquement, saisissez uniquement wss://ocpp.ureticy.com/URT1001 comme URL de base et HOTEL-01 comme identifiant de borne.
Lorsque la borne se connecte avec un identifiant qui ne figure pas encore dans votre compte, elle apparaît automatiquement en attente dans le tableau de bord. Vous l’ajoutez en un clic, et la borne affiche alors son état, sa puissance et son énergie en temps réel. Une mise en service type prend une dizaine de minutes. Les bornes OCPP 1.6J, 2.0.1 et 2.1 utilisent le même format d’URL, en WS ou WSS. En cas de problème, les journaux de messages OCPP consultables montrent précisément quels messages ont été échangés. Plus de détails sur la page du logiciel OCPP.
Après la connexion : prochaines étapes
- Donnez à chaque connecteur un nom clair et imprimez des étiquettes QR code pour que conducteurs et techniciens puissent l’identifier.
- Ajoutez les badges RFID et les conducteurs, et définissez les bornes que chaque conducteur peut utiliser.
- Configurez des alertes pour les défauts, les déconnexions et les commandes restées sans réponse.
- Si vous utilisez des quotas d’énergie, configurez des règles de limite en kWh par conducteur ou par véhicule. La page limites kWh et recharge intelligente explique leur fonctionnement.
Questions fréquentes
Faut-il une adresse IP fixe pour connecter une borne à un serveur OCPP ?
Généralement non. En OCPP-J, la borne ouvre une connexion WebSocket sortante vers le serveur : elle n’a donc pas besoin d’adresse IP publique ou fixe. Le réseau doit seulement autoriser les connexions sortantes vers l’adresse et le port du serveur.
Quelle est la différence entre ws:// et wss:// ?
Ce sont deux adresses WebSocket. ws:// transmet les données sans chiffrement, tandis que wss:// chiffre la connexion avec TLS. Utilisez wss:// dès que la borne le permet, car il protège les identifiants de badge, les relevés de compteur et les mots de passe.
Peut-on modifier l’identifiant de la borne par la suite ?
Techniquement oui, mais le CSMS considérera le nouvel identifiant comme une nouvelle borne. L’historique des sessions et les paramètres restent associés à l’ancien identifiant, sauf si votre logiciel permet de les migrer. Mieux vaut adopter dès le départ une convention de nommage claire et définitive.
Pourquoi ma borne affiche-t-elle Pending après le BootNotification ?
Pending signifie que le CSMS a bien reçu la borne mais ne l’a pas encore entièrement acceptée, par exemple parce qu’elle n’est pas encore rattachée à un compte. Validez ou ajoutez la borne dans le CSMS : elle sera acceptée au prochain démarrage ou à la prochaine tentative.
Comment transférer une borne d’un serveur OCPP à un autre ?
Modifiez l’URL du serveur, et si nécessaire l’identifiant de la borne et le mot de passe, dans les paramètres de la borne, puis redémarrez-la. Exportez d’abord l’historique des sessions de l’ancien système. L’OCPP étant ouvert, il n’est pas nécessaire de remplacer le matériel.
Prêt à connecter votre première borne ? Obtenez votre URL OCPP personnelle avec le logiciel OCPP Üreticy, ou contactez-nous si vous avez besoin d’aide pour un modèle de borne précis.