NexBlue AutoCharge-integraatio-opas

Ota ajoneuvorekisteröinti, automaattinen valtuutus ja tapahtumien yhdistäminen käyttöön CPMS-järjestelmässäsi käyttämällä NexBlue -latauslaitteita.

PöytäkirjaOCPP 1.6
Ajoneuvon tunnistetiedotMAC-osoite
MäärityskoodiAutoChargeEnabled
Tuetut mallit
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Yhteensopivuus

1.1 Laturin tuki

Ennen kuin otat AutoCharge-toiminnon käyttöön latauslaitteessa, lähetä GetConfiguration hakemaan sen tukemat määritysavaimet. Tyhjä avain array pyytää kaikki tuetut avaimet.

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

Tarkista, onko AutoChargeEnabled on läsnä asetusavain.

Laturi → CPMS · GetConfiguration.conf · ote vastauksesta
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Hakutulos Tulkinta
Key palasi mukanaan arvo = "true" AutoCharge-toiminto on tuettu ja käytössä.
Key palasi mukanaan arvo = "false" AutoCharge-toiminto on tuettu, mutta se on poistettu käytöstä.
Avain puuttuu täydellisestä luettelosta tai se on lueteltu kohdassa unknownKey Nykyinen laturin laiteohjelmisto ei tue AutoCharge-toimintoa.

Voit myös hakea avainta suoraan komennolla {"key":["AutoChargeEnabled"]}. Epäonnistunut tai aikakatkaistu kysely ei riitä todisteeksi.

1.2 Ajoneuvon yhteensopivuus

Laturin toimintakyky ja ajoneuvon yhteensopivuus tarkistetaan erikseen. Yhteensopivan ajoneuvon on annettava luettavissa oleva, vakaa ja yksilöllinen MAC-osoite.

Integraatiotestauksen aikana:

  • Varmista, että CPMS-järjestelmäsi vastaanottaa Valtuuta ja idTag = VID:<MAC> kun ajoneuvo on kytketty.
  • Suorita rekisteröinti loppuun ja toista laajennuksen istunnot. Tarkista, että VID-tunnus pysyy samana ja että automaattinen valtuutus onnistuu.
  • Kirjaa ajoneuvomalli ja ohjelmistoversio testitulosten yhteyteen. Jätä pois ajoneuvot, joiden tiedetään käyttävän satunnaistettuja tai jaettuja tunnisteita.

Kolmansien osapuolten ajoneuvoluettelot ovat suuntaa-antavia viitteitä. Yhteensopivuus toisen latausverkon kanssa ei takaa yhteensopivuutt NexBlue in vaihtovirtalatureiden kanssa. Tarkista kyseiset ajoneuvot uudelleen, jos ohjelmistopäivitys muuttaa ajoneuvon tunnistetietoja tai latauskäyttäytymistä.

Jos ajoneuvon tunnistetiedot eivät ole vahvistettuja, pidä nykyiset tunnistautumistavat käytettävissä.

2. Asetukset

OCPP-määritystunnus Tyyppi Arvo
AutoChargeEnabled Booli totta: ota AutoCharge käyttöön.
false: Poista AutoCharge käytöstä.

Kun olet varmistanut, että laturi on yhteensopiva, lähetä Muuta asetuksia ja AutoChargeEnabled asetetaan "true" ominaisuuden ottamiseksi käyttöön, tai "false" sen poistamiseksi käytöstä. Asetusarvot lähetetään merkkijonoina.

Tunnista saapuvien ajoneuvojen tunnisteet Authorize.req.idTag arvot seuraavassa muodossa:

VID:<MAC>

Esimerkki MAC-osoitteesta 00155D0665D6 muuttuu VID:00155D0665D6.

3. Ajoneuvon rekisteröinti

Toteuta rekisteröintirajapinta, käyttäjän vahvistus ja VID:n ja tilin välinen sidonta CPMS-järjestelmässäsi. Laturi toimittaa ajoneuvotunnisteen.

  1. Tarjoa kirjautumisprosessi todennetulle käyttäjälle ja kehota häntä yhdistämään ajoneuvo.
  2. Kun laturi kytketään Valmistautuminen, odotettavissa on Valtuuta pyyntö, jossa mainitaan ajoneuvon VID-numero.
Laturi → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Tarkista ajoneuvotunnus (VID). Jos ajoneuvoa ei ole rekisteröity, palaa Virheellinen tai Estetty.
  2. Kun käyttäjä on vahvistanut rekisteröitymisen, liitä VID tiliin ja lähetä RemoteStartTransaction.
  3. Käsittele laturin StartTransaction pyytää ja palauttaa transactionId ... StartTransaction.conf.
  4. Hoida seuraavat asiat Tiedonsiirto viesti, jolla ajoneuvo liitetään tapahtumaan, kuten kohdassa 5 määritellään.

4. Automaattinen valtuutus

Seuraavissa plug-in-istunnoissa käsittele saapuvat Valtuuta pyytää seuraavaa:

01

Lue ajoneuvon tunniste seuraavasta: idTag = VID:<MAC>.

02

Tarkista ajoneuvon tilisidonta ja sen valtuutustila.

03

Palaa Hyväksytty valtuutetulle ajoneuvolle. Paluu Virheellinen tuntemattoman VID:n tapauksessa tai Estetty jos rekisteröinti on estetty.

04

Kun laturi lähettää StartTransaction, käsittele pyyntö ja palauta tapahtumatunniste.

Pidä ajoneuvotunniste (VID) erillään käyttöoikeudesta. VID:n saaminen ei tarkoita, että ajoneuvolla olisi käyttöoikeus; CPMS-järjestelmäsi päättää, voiko siihen liitetty tili veloittaa.

5. Tapahtuman metatiedot

Kun CPMS-tuloksesi ovat tulleet StartTransaction.conf, odotettavissa on seuraavaa NexBlue Tiedonsiirto viesti, joka yhdistää ajoneuvon MAC-osoitteen tapahtumaan.

Laturi → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Kenttä Arvo / muoto
toimittajan tunnus com.nexblue.autocharge/v1
messageId VID
tiedot JSON-koodattu merkkijono, joka sisältää VID ja TransactionID.
data.VID Ajoneuvon MAC-osoite ilman VID: etuliite.
data.TransactionID Tapahtuman tunniste palautetaan kohdassa StartTransaction.conf, esitettynä merkkijonona.

Dekoodaa tiedot JSON-muodossa, etsi tapahtuma käyttämällä TransactionID, ja liittää sen VID. Kenttien nimissä otetaan huomioon kirjainkoko; VID sisältää MAC-osoitteen ilman VID: etuliite.