NexBlue Guide d'intégration d'AutoCharge

Mettez en place l'enregistrement des véhicules, l'autorisation automatique et l'association des transactions dans votre CPMS à l'aide des bornes de recharge « NexBlue ».

ProtocoleOCPP 1.6
Identifiant du véhiculeAdresse MAC
Clé de configurationAutoChargeEnabled
Modèles pris en charge
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Compatibilité

1.1 Prise en charge des chargeurs

Avant de proposer la fonction AutoCharge sur un chargeur, envoyez GetConfiguration pour récupérer les clés de configuration prises en charge. Un fichier vide clé L'array demande toutes les clés prises en charge.

CPMS → Chargeur · GetConfiguration.req
[
  2,
  "ac-config-001",
  "GetConfiguration",
  {
    "key": []
  }
]

Vérifiez si AutoChargeEnabled est présent dans clé de configuration.

Charger → CPMS · GetConfiguration.conf · extrait de la réponse
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Résultat de la requête Interprétation
La clé est revenue avec value = "true" La fonction AutoCharge est prise en charge et activée.
La clé est revenue avec value = "false" La fonction AutoCharge est prise en charge, mais elle est désactivée.
Clé absente de la liste complète, ou figurant dans unknownKey La fonction AutoCharge n'est pas prise en charge par la version actuelle du micrologiciel du chargeur.

Vous pouvez également interroger directement la clé à l'aide de {"key":["AutoChargeEnabled"]}. Une requête ayant échoué ou ayant dépassé le délai d'attente ne constitue pas un élément à charge.

1.2 Compatibilité avec les véhicules

La capacité du chargeur et la compatibilité du véhicule font l'objet de vérifications distinctes. Un véhicule compatible doit fournir une adresse MAC lisible, stable et unique.

Au cours des tests d'intégration :

  • Vérifiez que votre CPMS reçoit Autoriser avec idTag = VID:<MAC> lorsque le véhicule est connecté.
  • Effectuez l'enregistrement et répétez les sessions de connexion. Vérifiez que le VID reste cohérent et que l'autorisation automatique aboutit.
  • Notez le modèle du véhicule et la version du logiciel avec les résultats des tests. Excluez les véhicules dont on sait qu’ils utilisent des identifiants aléatoires ou partagés.

Les listes de véhicules fournies par des tiers constituent des références indicatives. La prise en charge par un autre réseau de recharge ne garantit pas la compatibilité avec les chargeurs CA d’ NexBlue . Vérifiez à nouveau les véhicules concernés si une mise à jour logicielle modifie leur identification ou leur comportement de recharge.

Pour les véhicules dont l'identification n'a pas été vérifiée, veillez à disposer de vos moyens d'autorisation habituels.

2. Configuration

Clé de configuration OCPP Type Valeur
AutoChargeEnabled Booléen vrai: activez la fonction « AutoCharge ».
false: désactiver la recharge automatique.

Après avoir vérifié la compatibilité du chargeur, envoyez Modifier la configuration avec AutoChargeEnabled réglé sur « vrai » pour activer cette fonctionnalité, ou « false » pour la désactiver. Les valeurs de configuration sont transmises sous forme de chaînes de caractères.

Reconnaître les identifiants des véhicules dans les données entrantes Authorize.req.idTag valeurs selon le format suivant :

VID:<MAC>

L'exemple MAC 00155D0665D6 devient VID:00155D0665D6.

3. Immatriculation des véhicules

Mettez en œuvre l'interface d'enregistrement, la confirmation par l'utilisateur et l'association entre le VID et le compte dans votre CPMS. Le chargeur fournit l'identifiant du véhicule.

  1. Mettre en place un processus d'inscription pour un utilisateur authentifié et l'inviter à connecter son véhicule.
  2. Lorsque le chargeur est branché Préparation, attendez-vous à un Autoriser demande contenant le numéro d'identification du véhicule (VID).
Charger → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Recherchez le numéro d'immatriculation (VID). S'il s'agit d'un véhicule non immatriculé, revenez à la page précédente. Non valide ou Bloqué.
  2. Une fois que l'utilisateur a confirmé son inscription, associez le VID au compte et envoyez RemoteStartTransaction.
  3. Traiter le chargeur StartTransaction demander et renvoyer le transactionId dans StartTransaction.conf.
  4. Gérer ce qui suit Transfert de données message permettant d'associer le véhicule à la transaction, tel que défini à la section 5.

4. Autorisation automatique

Pour les sessions de plug-in suivantes, gérez les Autoriser demande ce qui suit :

01

Lire l'identifiant du véhicule à partir de idTag = VID:<MAC>.

02

Consultez les informations relatives au compte associé au véhicule et vérifiez son statut d'autorisation.

03

Retour Accepté pour un véhicule homologué. Retour Non valide pour un VID inconnu ou Bloqué en cas d'inscription bloquée.

04

Lorsque le chargeur envoie StartTransaction, traiter la demande et renvoyer l'identifiant de transaction.

Veillez à ne pas confondre l'identification du véhicule et l'autorisation. L'obtention d'un VID n'autorise pas l'utilisation du véhicule ; c'est votre CPMS qui décide si le compte associé est autorisé à effectuer des prélèvements.

5. Métadonnées des transactions

Une fois que vous aurez reçu votre CPMS StartTransaction.conf, attendez-vous à ce qui suit NexBlue Transfert de données message associant l'adresse MAC du véhicule à la transaction.

Chargeur → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Champ Valeur / format
vendorId com.nexblue.autocharge/v1
messageId VID
données Chaîne de caractères encodée au format JSON contenant VID et ID de transaction.
data.VID Adresse MAC du véhicule sans le VID : préfixe.
data.TransactionID Identifiant de transaction renvoyé dans StartTransaction.conf, représenté sous forme de chaîne de caractères.

Décoder données au format JSON, localisez la transaction à l'aide de ID de transaction, et l'associer à VID. Les noms des champs sont sensibles à la casse ; VID contient l'adresse MAC sans le VID : préfixe.