NexBlue Przewodnik po integracji z AutoCharge

Wprowadź funkcję rejestracji pojazdów, automatycznej autoryzacji oraz powiązania transakcji w swoim systemie CPMS przy użyciu ładowarek NexBlue .

ProtokółOCPP 1.6
Identyfikacja pojazduAdres MAC
Klucz konfiguracyjnyAutoChargeEnabled
Obsługiwane modele
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Kompatybilność

1.1 Obsługa ładowarek

Zanim udostępnisz funkcję AutoCharge w ładowarce, wyślij GetConfiguration w celu pobrania obsługiwanych kluczy konfiguracyjnych. Pusty klucz Tablica pobiera wszystkie obsługiwane klucze.

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

Sprawdź, czy AutoChargeEnabled występuje w klucz konfiguracyjny.

Ładowarka → CPMS · GetConfiguration.conf · fragment odpowiedzi
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Wynik zapytania Tłumaczenie ustne
Key wrócił z value = "true" Funkcja AutoCharge jest obsługiwana i włączona.
Key wrócił z wartość = „false” Funkcja AutoCharge jest obsługiwana, ale wyłączona.
Klucz nie figuruje na pełnej liście lub jest wymieniony w unknownKey Obecna wersja oprogramowania sprzętowego ładowarki nie obsługuje funkcji AutoCharge.

Można również bezpośrednio wyszukać klucz za pomocą {"key":["AutoChargeEnabled"]}. Nieudane zapytanie lub zapytanie, dla którego upłynął limit czasu, nie stanowi podstawy do udzielenia wsparcia.

1.2 Kompatybilność z pojazdami

Sprawdzanie możliwości ładowarki i zgodności pojazdu to odrębne procesy. Zgodny pojazd musi generować czytelny, stabilny i niepowtarzalny adres MAC.

Podczas testów integracyjnych:

  • Sprawdź, czy system CPMS odbiera Zezwól z idTag = VID:<MAC> gdy pojazd jest podłączony.
  • Zakończ rejestrację i powtórz sesje wtyczki. Sprawdź, czy identyfikator VID pozostaje niezmienny, a automatyczne uwierzytelnianie przebiega pomyślnie.
  • Wraz z wynikami testów należy odnotować model pojazdu i wersję oprogramowania. Należy wykluczyć pojazdy, o których wiadomo, że wykorzystują losowe lub wspólne identyfikatory.

Wykazy pojazdów innych producentów mają charakter orientacyjny. Obsługa w innej sieci ładowania nie oznacza kompatybilności z ładowarkami prądu przemiennego NexBlue . Należy ponownie zweryfikować pojazdy, których to dotyczy, jeśli aktualizacja oprogramowania spowoduje zmianę identyfikacji lub zachowania podczas ładowania.

W przypadku pojazdów bez zweryfikowanych danych identyfikacyjnych należy zapewnić dostępność dotychczasowych metod autoryzacji.

2. Konfiguracja

Klucz konfiguracyjny OCPP Typ Wartość
AutoChargeEnabled Boole'owski prawda: włącz funkcję AutoCharge.
false: wyłącz funkcję AutoCharge.

Po sprawdzeniu, czy ładowarka jest obsługiwana, wyślij Zmień konfigurację z AutoChargeEnabled ustawić na „prawda” aby włączyć tę funkcję, lub "false" aby ją wyłączyć. Wartości konfiguracyjne są przesyłane jako ciągi znaków.

Rozpoznawanie identyfikatorów pojazdów w danych przychodzących Authorize.req.idTag wartości w następującym formacie:

VID:<MAC>

Przykładowy adres MAC 00155D0665D6 staje się VID:00155D0665D6.

3. Rejestracja pojazdu

Zaimplementuj w systemie CPMS interfejs rejestracji, proces potwierdzania przez użytkownika oraz powiązanie identyfikatora pojazdu (VID) z kontem. Ładowarka dostarcza identyfikator pojazdu.

  1. Należy zapewnić proces rejestracji dla uwierzytelnionego użytkownika i poprosić go o podłączenie pojazdu.
  2. Gdy ładowarka zostanie podłączona Przygotowanie, spodziewaj się Zezwól wniosek zawierający numer identyfikacyjny pojazdu (VID).
Ładowarka → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Sprawdź numer VID. W przypadku pojazdu niezarejestrowanego wróć Nieprawidłowe lub Zablokowane.
  2. Po potwierdzeniu rejestracji przez użytkownika należy powiązać identyfikator VID z kontem i wysłać Zdalne rozpoczęcie transakcji.
  3. Przetworzyć ładowarkę StartTransaction pobranie i zwrot identyfikator transakcji w StartTransaction.conf.
  4. Zajmij się tym, co nastąpi później Przesyłanie danych komunikat służący do powiązania pojazdu z transakcją, zgodnie z definicją zawartą w sekcji 5.

4. Automatyczna autoryzacja

W przypadku kolejnych sesji wtyczek należy obsługiwać przychodzące Zezwól zwraca się z następującymi wnioskami:

01

Odczytaj identyfikator pojazdu z idTag = VID:<MAC>.

02

Sprawdź powiązanie konta z pojazdem i zweryfikuj status jego autoryzacji.

03

Powrót Zaakceptowano dla pojazdu z ważnym dowodem rejestracyjnym. Powrót Nieprawidłowe w przypadku nieznanego identyfikatora VID lub Zablokowane w przypadku zablokowanej rejestracji.

04

Gdy ładowarka wysyła StartTransaction, przetworzyć żądanie i zwrócić identyfikator transakcji.

Należy oddzielić identyfikację pojazdu od procesu autoryzacji. Otrzymanie identyfikatora VID nie oznacza autoryzacji pojazdu; to system CPMS decyduje, czy powiązane konto może zostać obciążone.

5. Metadane transakcji

Po otrzymaniu zwrotu z CPMS StartTransaction.conf, należy spodziewać się następujących sytuacji NexBlue Przesyłanie danych komunikat powiązujący adres MAC pojazdu z transakcją.

Ładowarka → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Pole Wartość / format
identyfikator dostawcy com.nexblue.autocharge/v1
identyfikator wiadomości VID
dane Ciąg znaków zakodowany w formacie JSON, zawierający VID oraz Identyfikator transakcji.
data.VID Adres MAC pojazdu bez WIDEO: przedrostek.
data.TransactionID Identyfikator transakcji zwrócony w StartTransaction.conf, przedstawiony jako ciąg znaków.

Dekoduj dane w formacie JSON, znajdź transakcję za pomocą Identyfikator transakcji, i powiązać to z VID. W nazwach pól rozróżniana jest wielkość liter; VID zawiera adres MAC bez WIDEO: przedrostek.