NexBlue Veiledning for integrering av AutoCharge

Implementer kjøretøyregistrering, automatisk autorisasjon og transaksjonstilknytning i CPMS-systemet ditt ved hjelp av NexBlue ladere.

Protokoll OCPP 1.6
MAC-adresse for kjøretøyidentitet
KonfigurasjonsnøkkelAutomatisk lading aktivert
Støttede modeller
SDU

Edge 2 · Edge Max · Point 2

MDU

Deltaet · Delta Max

1. Kompatibilitet

1.1 Støtte for ladere

Før du tilbyr AutoCharge på en lader, send Hentkonfigurasjon for å hente de støttede konfigurasjonsnøklene. En tom nøkkel arrayet ber om alle støttede nøkler.

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

Sjekk om Automatisk lading aktivert er tilstede i konfigurasjonsnøkkel.

Lader → CPMS · GetConfiguration.conf · svarutdrag
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Søkeresultat Tolkning
Nøkkel returnert med verdi = "sann" AutoCharge støttes og er aktivert.
Nøkkel returnert med verdi = "usann" AutoCharge støttes, men er deaktivert.
Nøkkel mangler på den fullstendige listen, eller er oppført i ukjent nøkkel AutoCharge støttes ikke av den nåværende laderens firmware.

Du kan også spørre nøkkelen direkte med {"key":["AutoChargeEnabled"]}En mislykket eller tidsavbrutt spørring etablerer ikke støtte.

1.2 Kompatibilitet med kjøretøy

Ladekapasitet og kjøretøykompatibilitet er separate kontroller. Et kompatibelt kjøretøy må ha en lesbar, stabil og unik MAC-adresse.

Under integrasjonstesting:

  • Bekreft at CPMS-systemet ditt mottar Autorisere med idTag = VID:<MAC> når kjøretøyet er tilkoblet.
  • Fullfør registreringen og gjenta plugin-øktene. Kontroller at VID-en forblir konsistent og at automatisk autorisasjon lykkes.
  • Registrer kjøretøymodell og programvareversjon sammen med testresultatene. Ekskluder kjøretøy som er kjent for å bruke tilfeldige eller delte identifikatorer.

Tredjeparts kjøretøylister er screeningreferanser. Støtte på et annet ladenettverk etablerer ikke kompatibilitet med NexBlue AC-ladere. Valider berørte kjøretøy på nytt hvis en programvareoppdatering endrer identifikasjon eller ladeatferd.

For kjøretøy uten bekreftet identifikasjon, ha eksisterende autorisasjonsmetoder tilgjengelig.

2. Konfigurasjon

OCPP-konfigurasjonsnøkkel Type Verdi
Automatisk lading aktivert Boolsk ekte: aktiver automatisk lading.
falsk: deaktiver automatisk lading.

Etter at du har bekreftet ladestøtten, send Endre konfigurasjon med Automatisk lading aktivert satt til "ekte" for å aktivere funksjonen, eller "falsk" for å deaktivere den. Konfigurasjonsverdier overføres som strenger.

Gjenkjenne kjøretøyidentifikatorer i innkommende Autorisasjonskrav.idTag verdier i henhold til følgende format:

VID:<MAC>

Eksempel-MAC-en 00155D0665D6 blir VID:00155D0665D6.

3. Kjøretøyregistrering

Implementer registreringsgrensesnittet, brukerbekreftelsen og VID-til-konto-bindingen i CPMS-systemet ditt. Laderen leverer kjøretøyidentifikatoren.

  1. Sørg for en registreringsflyt for en autentisert bruker og be dem om å koble til kjøretøyet.
  2. Når laderen kommer inn Forbereder, forvent en Autorisere forespørsel som inneholder kjøretøyets VID.
Lader → CPMS · Autorisasjonskrav
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Slå opp VID-en. For et uregistrert kjøretøy, returner Ugyldig eller Blokkert.
  2. Etter at brukeren bekrefter registreringen, kobler du VID-en til kontoen og sender den EksternStartTransaksjon.
  3. Behandle laderens Starttransaksjon forespørsel og returner transaksjons-ID i StartTransaction.conf.
  4. Håndter det påfølgende Dataoverføring melding for å knytte kjøretøyet til transaksjonen, som definert i avsnitt 5.

4. Automatisk autorisasjon

For påfølgende plugin-økter, håndter innkommende Autorisere forespørsler som følger:

01

Les kjøretøyidentifikatoren fra idTag = VID:<MAC>.

02

Slå opp kjøretøyets kontobinding og sjekk autorisasjonsstatusen.

03

Retur Godkjent for et autorisert kjøretøy. Returner Ugyldig for en ukjent VID eller Blokkert for en blokkert registrering.

04

Når laderen sender Starttransaksjon, behandle forespørselen og returnere transaksjonsidentifikatoren.

Hold kjøretøyidentifikasjonen atskilt fra autorisasjon. Mottak av et VID autoriserer ikke kjøretøyet; CPMS-systemet ditt avgjør om den tilknyttede kontoen kan belaste.

5. Transaksjonsmetadata

Etter at CPMS-en din er tilbake StartTransaction.conf, forvent følgende NexBlue Dataoverføring melding som knytter kjøretøyets MAC-adresse til transaksjonen.

Lader → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Felt Verdi / format
leverandør-ID com. nexblue .autocharge/v1
meldings-ID VID
data JSON-kodet streng som inneholder VID og Transaksjons-ID.
data.VID Kjøretøyets MAC-adresse uten VID: prefiks.
data.TransaksjonsID Transaksjonsidentifikator returnert i StartTransaction.conf, representert som en streng.

Dekode data som JSON, finn transaksjonen ved hjelp av Transaksjons-ID, og assosier det med VIDFeltnavn skiller mellom store og små bokstaver; VID inneholder MAC-adressen uten VID: prefiks.