NexBlue Handleiding voor de integratie van AutoCharge

Implementeer voertuigregistratie, automatische autorisatie en koppeling van transacties in uw CPMS met behulp van NexBlue -laadpunten.

ProtocolOCPP 1.6
VoertuigidentificatieMAC-adres
ConfiguratiesleutelAutoCharge ingeschakeld
Ondersteunde modellen
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Compatibiliteit

1.1 Ondersteuning voor opladers

Voordat u de AutoCharge-functie op een oplader activeert, moet u het volgende verzenden: GetConfiguration om de ondersteunde configuratiesleutels op te halen. Een leeg sleutel array vraagt alle ondersteunde sleutels op.

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

Controleer of AutoCharge ingeschakeld is aanwezig in configuratiesleutel.

Oplader → CPMS · GetConfiguration.conf · fragment uit het antwoord
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Zoekresultaat Vertaling
Key kwam terug met value = "true" AutoCharge wordt ondersteund en is ingeschakeld.
Key kwam terug met value = "false" AutoCharge wordt ondersteund, maar is uitgeschakeld.
Sleutel ontbreekt in de volledige lijst, of staat vermeld in unknownKey AutoCharge wordt niet ondersteund door de huidige firmware van de oplader.

Je kunt de sleutel ook rechtstreeks opvragen met {"key":["AutoChargeEnabled"]}. Een mislukte of verlopen query vormt geen grond voor ondersteuning.

1.2 Compatibiliteit met voertuigen

De functionaliteit van de oplader en de compatibiliteit met het voertuig worden afzonderlijk gecontroleerd. Een compatibel voertuig moet een leesbaar, stabiel en uniek MAC-adres verstrekken.

Tijdens de integratietests:

  • Controleer of uw CPMS het volgende ontvangt: Autoriseren met idTag = VID:<MAC> wanneer het voertuig is aangesloten.
  • Voltooi de registratie en herhaal de plug-in-sessies. Controleer of de VID consistent blijft en of de automatische autorisatie slaagt.
  • Noteer het voertuigmodel en de softwareversie samen met de testresultaten. Sluit voertuigen uit waarvan bekend is dat ze willekeurige of gedeelde identificatiecodes gebruiken.

Voertuiglijsten van derden dienen als referentie. Ondersteuning door een ander laadnetwerk betekent niet dat er compatibiliteit bestaat met de AC-laders van NexBlue . Controleer de betreffende voertuigen opnieuw als een software-update de identificatie of het laadgedrag wijzigt.

Voor voertuigen zonder geverifieerde identificatie dient u uw bestaande autorisatiemethoden bij de hand te houden.

2. Configuratie

OCPP-configuratiesleutel Type Waarde
AutoCharge ingeschakeld Booleaans waar: schakel AutoCharge in.
false: schakel AutoCharge uit.

Nadat je hebt gecontroleerd of de oplader wordt ondersteund, stuur je Configuratie wijzigen met AutoCharge ingeschakeld instellen op "waar" om de functie in te schakelen, of "false" om het uit te schakelen. Configuratiewaarden worden als tekenreeksen verzonden.

Voertuigidentificatiecodes in inkomende gegevens herkennen Authorize.req.idTag waarden in de volgende indeling:

VID:<MAC>

Het voorbeeld-MAC-adres 00155D0665D6 wordt VID:00155D0665D6.

3. Voertuigregistratie

Implementeer de registratie-interface, de gebruikersbevestiging en de koppeling tussen VID en account in uw CPMS. De oplader levert de voertuig-ID aan.

  1. Zorg voor een registratieproces voor een aangemelde gebruiker en vraag hem of haar om het voertuig te koppelen.
  2. Wanneer de oplader wordt aangesloten Voorbereiding, verwacht een Autoriseren verzoek waarin het VID-nummer van het voertuig is vermeld.
Oplader → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Zoek het VID-nummer op. Bij een niet-geregistreerd voertuig: ga terug naar Ongeldig of Geblokkeerd.
  2. Nadat de gebruiker de registratie heeft bevestigd, koppel je de VID aan het account en verstuur je RemoteStartTransaction.
  3. Verwerk de oplader’s StartTransactie het opvragen en terugsturen van de transactie-ID in StartTransaction.conf.
  4. Ga als volgt te werk Gegevensoverdracht bericht om het voertuig aan de transactie te koppelen, zoals omschreven in paragraaf 5.

4. Automatische autorisatie

Behandel bij volgende plug-in-sessies inkomende Autoriseren verzoekt als volgt:

01

Lees het voertuigidentificatienummer uit idTag = VID:<MAC>.

02

Zoek de accountkoppeling van het voertuig op en controleer de autorisatiestatus ervan.

03

Terug Geaccepteerd voor een goedgekeurd voertuig. Terug Ongeldig voor een onbekende VID of Geblokkeerd bij een geblokkeerde registratie.

04

Wanneer de oplader een signaal verstuurt StartTransactie, het verzoek verwerken en de transactie-ID teruggeven.

Houd de voertuigidentificatie gescheiden van de autorisatie. Het ontvangen van een VID betekent niet dat het voertuig is geautoriseerd; uw CPMS bepaalt of het bijbehorende account kosten in rekening mag brengen.

5. Metagegevens van transacties

Nadat uw CPMS is teruggestuurd StartTransaction.conf, houd dan rekening met het volgende NexBlue Gegevensoverdracht bericht waarin het MAC-adres van het voertuig aan de transactie wordt gekoppeld.

Oplader → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Veld Waarde / indeling
leverancier-ID com.nexblue.autocharge/v1
messageId VID
gegevens Een in JSON gecodeerde tekenreeks die het volgende bevat: VID en Transactie-ID.
data.VID MAC-adres van het voertuig zonder de VIDEO: voorvoegsel.
data.TransactionID Transactie-ID geretourneerd in StartTransaction.conf, weergegeven als een tekenreeks.

Decoderen gegevens als JSON, zoek de transactie op met behulp van Transactie-ID, en koppel het aan VID. Bij veldnamen wordt onderscheid gemaakt tussen hoofdletters en kleine letters; VID bevat het MAC-adres zonder de VIDEO: voorvoegsel.