Connecter une borne Hager Witty Park (XEV202C)

Les bornes Hager Witty Park communicantes — références XEV2xxC, dont la XEV202C — communiquent avec Chargekeeper en OCPP 1.5 SOAP.

Elles se distinguent des bornes plus récentes sur un point : il n'y a ni interface web, ni application constructeur. Toute la configuration passe par un fichier texte chargé depuis une clé USB dans le contrôleur de la borne.

Cet article détaille ce fichier. Pour la création du jeton et pour comprendre les limites du protocole 1.5 — détection de déconnexion, commandes à distance — reportez-vous à l'article Connecter une borne en OCPP SOAP 1.5.

---

1. Prérequis

• Une borne en version communicante : la référence se termine par C et la borne embarque une carte TCP/IP. Les modèles sans cette carte ne peuvent pas être supervisés.
• La clé USB livrée avec la borne (fournie uniquement avec les modèles XEV2xx), qui sert à transférer la configuration vers le contrôleur.
• Une connexion Ethernet entre la borne et la box ou le routeur du site, avec une sortie internet ouverte.
• L'identifiant du contrôleur de la borne, noté bxxxx par Hager. Il figure sur le nom des fichiers de configuration fournis avec la borne.

---

2. Créer le jeton de connexion

Dans Chargekeeper, ouvrez le module Bornes, onglet Connecter une borne, puis Créer. Renseignez :

Le format SOAP n'apparaît dans la liste que si le type d'URL est réglé sur Rétro-compatible, et la version 1.5 n'apparaît qu'une fois le format SOAP sélectionné. Si ces choix n'apparaissent pas, reprenez les champs de gauche à droite.

Enregistrez le jeton : l'URL OCPP n'est calculée qu'après l'enregistrement. Rouvrez-le, puis copiez l'URL avec le bouton de copie.

---

3. Le fichier de configuration

La Witty se configure par des fichiers .cfg dont le nom commence par l'identifiant du contrôleur. Selon la version de firmware, il s'agit soit de fichiers séparés (bxxxx config.cfg, bxxxx manager.cfg, bxxxx network.cfg), soit d'un fichier unique bxxxx global.cfg qui regroupe toutes les sections.

⚠️ Le nom du fichier doit porter l'identifiant bxxxx de la borne que vous configurez. Si le préfixe ne correspond pas, le contrôleur ignore le fichier sans message d'erreur et aucun paramètre n'est appliqué. Cet identifiant est propre au contrôleur : il est différent de l'identifiant du point de charge saisi dans refcp.

Section [Config] — activer la supervision

[Config]
 Access_control=      2       # 2 -> OCPP-Park

Section [Network] — le réseau local du site

[Network]
 mac=
 dhcp=                0                        # 0 -> DHCP désactivé, 1 -> DHCP activé
 ip_addr=             <adresse-de-la-borne>
 subnet_mask=         <masque-du-réseau>
 gateway=             <adresse-de-la-passerelle>
 dns1=                <dns-primaire>
 dns2=                <dns-secondaire>

⚠️ Toutes les valeurs entre chevrons sont des emplacements à remplacer par celles du réseau du site. Demandez-les au responsable informatique du site si vous ne les connaissez pas.

Ces paramètres décrivent la borne sur le réseau local du site, derrière la box ou le routeur. L'adresse IP publique du site n'apparaît nulle part dans ce fichier.

• ip_addr doit être une adresse libre du réseau local, dans le même sous-réseau que gateway.
• gateway est l'adresse locale de la box ou du routeur.
• dns1 et dns2 sont joints à travers cette passerelle.

💡 Si le plan d'adressage du site n'est pas encore arrêté, réglez dhcp= 1 pour un premier essai : la box attribuera l'adresse, ce qui permet de valider la connexion avant de repasser en adresse fixe.

Section [OCPP] — le raccordement à Chargekeeper

[OCPP]
 login=               ""
 password=            ""
 server=              "<URL OCPP copiée depuis Chargekeeper>"
 client=              ""
 refcp=               "<identifiant-de-la-borne>"

• server reçoit l'URL copiée à l'étape 2, entre guillemets, sans la retaper. Elle a la forme suivante, où chaque élément entre chevrons est propre à votre organisation :

  https://<serveur-ocpp>/OCPP15?TenantID=<identifiant-organisation>%26Token=<jeton>
  

  Le %26 entre les deux paramètres est volontaire : c'est la forme encodée du caractère &.

• login et password restent vides. Chargekeeper authentifie la borne par le jeton contenu dans l'URL, pas par une authentification HTTP.

• refcp est l'identifiant du point de charge, celui sous lequel la borne apparaîtra dans la supervision. Laissé vide, c'est l'adresse MAC de la borne qui est utilisée. Si la borne est déjà déclarée dans votre organisation, refcp doit correspondre exactement à l'identifiant déclaré.

• client est laissé vide, comme dans tous les exemples de la notice Hager. Chargekeeper mémorise l'adresse de rappel de la borne à partir des messages qu'elle envoie ; ce champ n'a pas à être renseigné pour établir la connexion.

💡 HTTPS ou HTTP ? Le point d'accès OCPP 1.5 accepte les deux. La notice Hager ne documente que le http://, mais un jeton Sécurisé reste à privilégier. Si la borne ne parvient pas à se connecter en HTTPS, générez un jeton Non sécurisé et remplacez l'URL : la pile TLS de ce matériel peut être trop ancienne. Pensez alors à ouvrir le port sortant correspondant, 443 en HTTPS ou 80 en HTTP.

Le slash ajouté par le firmware

Le firmware de ces bornes traite l'URL de supervision comme un chemin de base et y ajoute un slash, parfois suivi de sa propre référence. Comme le jeton est le dernier paramètre de l'URL, ce suffixe se retrouve collé à sa valeur, qui arrive sous la forme <jeton>/ ou <jeton>/<identifiant-de-la-borne>.

Chargekeeper l'ignore et extrait correctement les paramètres. Recopiez l'URL telle quelle, sans chercher à supprimer ce slash. Si vous rencontrez malgré tout un refus de connexion mentionnant un jeton invalide, contactez le support.

---

4. Charger la configuration dans la borne

1. Copiez le ou les fichiers .cfg à la racine de la clé USB.
2. Ouvrez l'enveloppe extérieure de la borne et insérez la clé dans le port USB du contrôleur.
3. Redémarrez la borne pour que la configuration soit prise en compte.
4. Relisez la configuration depuis la borne pour vérifier que les valeurs saisies ont bien été appliquées.

---

5. Vérifier la connexion

À sa première connexion, la borne envoie un message Boot Notification et s'enregistre dans Chargekeeper.

• Ouvrez le module Bornes : la borne doit apparaître dans la liste.
• Consultez les logs OCPP pour confirmer la réception du Boot Notification, puis des Heartbeat.

Si aucun connecteur n'apparaît dans un premier temps, c'est normal : la configuration automatique des points de charge attend les notifications d'état OCPP, ce qui peut prendre plusieurs minutes après le redémarrage de la borne.

---

6. Résolution des problèmes

Les vérifications communes à toutes les bornes 1.5 — URL copiée intégralement, identifiant renseigné, port sortant ouvert — sont regroupées dans l'article Connecter une borne en OCPP SOAP 1.5. Voici ce qui est propre à ce matériel.

La borne n'apparaît pas du tout dans la supervision. Vérifiez d'abord le nom du fichier de configuration : un préfixe bxxxx qui ne correspond pas au contrôleur fait ignorer le fichier silencieusement, et aucun de vos réglages n'est appliqué. Vérifiez ensuite que ip_addr et gateway appartiennent bien au réseau sur lequel la borne est branchée.

Vous reprenez le fichier d'une supervision précédente. Ne conservez pas la section [Network] telle quelle. L'adressage local qu'elle contient était valable pour l'accès réseau du prestataire précédent — souvent une carte SIM sur un APN opérateur privé. Sur un autre accès internet, ces adresses ne correspondent plus à aucun réseau existant et la borne n'a plus de route sortante.

La borne sort par une carte SIM fournie par la supervision précédente. Il s'agit très probablement d'un APN privé qui ne route que vers les serveurs de ce prestataire. Aucun changement de configuration ne permettra d'atteindre Chargekeeper : il faut une sortie internet ouverte, la box du site ou une carte SIM M2M avec un APN standard.

Les commandes à distance ne fonctionnent pas (démarrage, arrêt, redémarrage). C'est une limite du protocole 1.5, expliquée en détail dans l'article générique. Sur ce matériel, la notice Hager demande une adresse IP publique fixe sur le site — ou un tunnel VPN si l'adresse est dynamique — ainsi qu'une règle de redirection de port sur le routeur : port externe 80 en TCP vers l'adresse locale de la borne, port interne 8080.