NexBlue Vejledning til integration af AutoCharge

Implementer køretøjsregistrering, automatisk godkendelse og tilknytning af transaktioner i dit CPMS ved hjælp af opladere med » NexBlue «.

ProtokolOCPP 1.6
Køretøjets identitetMAC-adresse
KonfigurationsnøgleAutoChargeEnabled
Understøttede modeller
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Kompatibilitet

1.1 Understøttelse af opladere

Inden du aktiverer AutoCharge på en oplader, skal du sende GetConfiguration for at hente de konfigurationsnøgler, der understøttes. En tom nøgle array anmoder om alle understøttede nøgler.

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

Kontroller, om AutoChargeEnabled findes i konfigurationsnøgle.

Oplader → CPMS · GetConfiguration.conf · uddrag af svar
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Søgeresultat Fortolkning
Nøglen blev returneret sammen med værdi = "true" AutoCharge understøttes og er aktiveret.
Nøglen blev returneret sammen med værdi = "false" AutoCharge understøttes, men er deaktiveret.
Nøgle mangler på den fulde liste eller er opført i ukendtNøgle AutoCharge understøttes ikke af den nuværende firmware til opladeren.

Du kan også søge direkte på nøglen med {"key":["AutoChargeEnabled"]}. En mislykket forespørgsel eller en forespørgsel, hvor tidsfristen er udløbet, udgør ikke grundlag for support.

1.2 Kompatibilitet med køretøjer

Opladerkapacitet og køretøjskompatibilitet kontrolleres hver for sig. Et kompatibelt køretøj skal kunne levere en læsbar, stabil og entydig MAC-adresse.

Under integrationstest:

  • Kontroller, at dit CPMS modtager Godkend med idTag = VID:<MAC> når køretøjet er tilsluttet.
  • Gennemfør registreringen, og gentag plug-in-sessionerne. Kontroller, at VID’en forbliver den samme, og at den automatiske godkendelse lykkes.
  • Notér køretøjsmodellen og softwareversionen sammen med testresultaterne. Udelad køretøjer, som man ved bruger tilfældige eller delte identifikatorer.

Tredjeparts køretøjslister fungerer som vejledende referencer. At et køretøj understøttes af et andet ladenetværk betyder ikke, at det er kompatibelt med AC-ladere fra NexBlue . De berørte køretøjer skal valideres på ny, hvis en softwareopdatering ændrer identifikationen eller opladningsadfærden.

For køretøjer uden verificeret identifikation skal du sørge for, at dine nuværende godkendelsesmetoder er tilgængelige.

2. Konfiguration

OCPP-konfigurationsnøgle Type Værdi
AutoChargeEnabled Boolsk sandt: Aktivér AutoCharge.
false: Deaktiver AutoCharge.

Når du har bekræftet, at opladeren understøttes, skal du sende Skift konfiguration med AutoChargeEnabled indstillet til "sandt" for at aktivere funktionen, eller "false" for at deaktivere den. Konfigurationsværdierne overføres som strenge.

Genkende køretøjsidentifikatorer i indgående data Authorize.req.idTag værdier i følgende format:

VID:<MAC>

Eksemplet MAC 00155D0665D6 bliver VID:00155D0665D6.

3. Køretøjsregistrering

Implementer registreringsgrænsefladen, brugerbekræftelsen og sammenkædningen af VID og konto i jeres CPMS. Opladeren leverer køretøjets identifikationsnummer.

  1. Opret en registreringsproces for en godkendt bruger, og bed vedkommende om at tilslutte køretøjet.
  2. Når opladeren tilsluttes Forberedelse, kan du forvente en Godkend anmodning, der indeholder køretøjets VID.
Oplader → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Slå VID-nummeret op. For et uregistreret køretøj skal du vende tilbage Ugyldig eller Blokeret.
  2. Når brugeren har bekræftet registreringen, skal du knytte VID’en til kontoen og sende RemoteStartTransaction.
  3. Behandl opladerens StartTransaction anmode om og returnere transaktions-id i StartTransaction.conf.
  4. Håndter det efterfølgende DataOverførsel meddelelse, der knytter køretøjet til transaktionen, jf. afsnit 5.

4. Automatisk godkendelse

Ved efterfølgende plug-in-sessioner skal indgående Godkend anmoder om følgende:

01

Læs køretøjets identifikationsnummer fra idTag = VID:<MAC>.

02

Slå køretøjets kontobinding op, og kontroller dets autorisationsstatus.

03

Tilbage Godkendt for et godkendt køretøj. Tilbage Ugyldig for en ukendt VID eller Blokeret ved en blokeret registrering.

04

Når opladeren sender StartTransaction, behandle anmodningen og returnere transaktions-id’et.

Hold køretøjsidentifikationen adskilt fra godkendelsen. Modtagelse af et VID betyder ikke, at køretøjet er godkendt; dit CPMS afgør, om den tilknyttede konto må foretage afregning.

5. Transaktionsmetadata

Når din CPMS er returneret StartTransaction.conf, kan du forvente følgende NexBlue DataOverførsel en besked, der knytter køretøjets MAC-adresse til transaktionen.

Oplader → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Felt Værdi / format
leverandør-id com.nexblue.autocharge/v1
messageId VID
data JSON-kodet streng, der indeholder VID og Transaktions-ID.
data.VID Køretøjets MAC-adresse uden VID: præfiks.
data.TransactionID Transaktions-id returneret i StartTransaction.conf, repræsenteret som en streng.

Afkode data som JSON, find transaktionen ved hjælp af Transaktions-ID, og knytte det til VID. Der skelnes mellem store og små bogstaver i feltnavne; VID indeholder MAC-adressen uden VID: præfiks.