NexBlue Anleitung zur Integration von AutoCharge

Implementieren Sie die Fahrzeugregistrierung, die automatische Autorisierung und die Zuordnung von Transaktionen in Ihrem CPMS mithilfe von Ladegeräten mit der Funktion „ NexBlue “.

ProtokollOCPP 1.6
FahrzeugidentifikationMAC-Adresse
KonfigurationsschlüsselAutoChargeEnabled
Unterstützte Modelle
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Kompatibilität

1.1 Unterstützung für Ladegeräte

Bevor Sie die AutoCharge-Funktion an einem Ladegerät anbieten, senden Sie GetConfiguration um die unterstützten Konfigurationsschlüssel abzurufen. Ein leerer Schlüssel array fordert alle unterstützten Schlüssel an.

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

Prüfen Sie, ob AutoChargeEnabled ist vorhanden in Konfigurationsschlüssel.

Charger → CPMS · GetConfiguration.conf · Auszug aus der Antwort
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Abfrageergebnis Auslegung
Key kehrte zurück mit value = "true" AutoCharge wird unterstützt und ist aktiviert.
Key kehrte zurück mit value = "false" AutoCharge wird unterstützt, ist jedoch deaktiviert.
Schlüssel fehlt in der vollständigen Liste oder ist aufgeführt unter unknownKey AutoCharge wird von der aktuellen Firmware des Ladegeräts nicht unterstützt.

Sie können den Schlüssel auch direkt abfragen mit {"key":["AutoChargeEnabled"]}. Eine fehlgeschlagene oder wegen Zeitüberschreitung abgebrochene Abfrage begründet keinen Anspruch auf Unterstützung.

1.2 Fahrzeugkompatibilität

Die Funktionsfähigkeit des Ladegeräts und die Fahrzeugkompatibilität werden separat geprüft. Ein kompatibles Fahrzeug muss eine lesbare, stabile und eindeutige MAC-Adresse bereitstellen.

Während der Integrationstests:

  • Stellen Sie sicher, dass Ihr CPMS folgende Daten empfängt Autorisieren mit idTag = VID:<MAC> wenn das Fahrzeug angeschlossen ist.
  • Führen Sie die Registrierung durch und wiederholen Sie die Plug-in-Sitzungen. Vergewissern Sie sich, dass die VID konsistent bleibt und die automatische Autorisierung erfolgreich verläuft.
  • Halten Sie das Fahrzeugmodell und die Softwareversion zusammen mit den Testergebnissen fest. Schließen Sie Fahrzeuge aus, von denen bekannt ist, dass sie zufällige oder gemeinsam genutzte Kennungen verwenden.

Fahrzeuglisten von Drittanbietern dienen lediglich als Anhaltspunkt. Die Unterstützung durch ein anderes Ladenetzwerk bedeutet nicht, dass die Kompatibilität mit den Wechselstrom-Ladegeräten von „ NexBlue “ gegeben ist. Überprüfen Sie betroffene Fahrzeuge erneut, falls sich durch ein Software-Update die Identifikation oder das Ladeverhalten ändert.

Bei Fahrzeugen ohne verifizierte Identifizierung sollten Sie Ihre bestehenden Autorisierungsmethoden weiterhin zur Verfügung halten.

2. Konfiguration

OCPP-Konfigurationsschlüssel Typ Wert
AutoChargeEnabled Boolesch wahr: „AutoCharge“ aktivieren.
false: „AutoCharge“ deaktivieren.

Nachdem Sie die Kompatibilität des Ladegeräts überprüft haben, senden Sie Konfiguration ändern mit AutoChargeEnabled auf … einstellen "wahr" um die Funktion zu aktivieren, oder "false" um es zu deaktivieren. Konfigurationswerte werden als Zeichenfolgen übertragen.

Fahrzeugkennungen in eingehenden Daten erkennen Authorize.req.idTag Werte im folgenden Format:

VID:<MAC>

Das Beispiel MAC 00155D0665D6 wird zu VID:00155D0665D6.

3. Fahrzeugzulassung

Implementieren Sie die Registrierungsschnittstelle, die Benutzerbestätigung und die Verknüpfung von VID und Konto in Ihrem CPMS. Das Ladegerät liefert die Fahrzeugkennung.

  1. Stellen Sie einen Registrierungsablauf für einen authentifizierten Benutzer bereit und fordern Sie ihn auf, das Fahrzeug zu verbinden.
  2. Wenn das Ladegerät angeschlossen wird Vorbereitung, rechnen Sie mit einem Autorisieren Anfrage mit der Fahrzeug-ID (VID).
Charger → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Schlagen Sie die VID nach. Bei einem nicht zugelassenen Fahrzeug geben Sie Ungültig oder Gesperrt.
  2. Nachdem der Benutzer die Registrierung bestätigt hat, verknüpfen Sie die VID mit dem Konto und senden Sie RemoteStartTransaction.
  3. Verarbeiten Sie das Ladegerät StartTransaction das anfordern und zurückgeben transactionId in StartTransaction.conf.
  4. Die weiteren Schritte durchführen Datenübertragung Meldung zur Verknüpfung des Fahrzeugs mit der Transaktion, wie in Abschnitt 5 definiert.

4. Automatische Autorisierung

Bei nachfolgenden Plug-in-Sitzungen sind eingehende Autorisieren fordert Folgendes:

01

Lies die Fahrzeugkennung aus idTag = VID:<MAC>.

02

Rufen Sie die Kontoverknüpfung des Fahrzeugs ab und überprüfen Sie den Autorisierungsstatus.

03

Zurück Angenommen für ein zugelassenes Fahrzeug. Zurück Ungültig bei einer unbekannten VID oder Gesperrt wegen einer gesperrten Registrierung.

04

Wenn das Ladegerät ein Signal sendet StartTransaction, die Anfrage bearbeiten und die Transaktions-ID zurückgeben.

Halten Sie die Fahrzeugidentifikation von der Autorisierung getrennt. Der Erhalt einer VID bedeutet keine Autorisierung des Fahrzeugs; Ihr CPMS entscheidet, ob das zugehörige Konto belastet werden darf.

5. Transaktionsmetadaten

Nachdem Ihr CPMS zurückgeschickt wurde StartTransaction.conf, rechnen Sie mit Folgendem NexBlue Datenübertragung Nachricht, die die MAC-Adresse des Fahrzeugs mit der Transaktion verknüpft.

Ladegerät → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Feld Wert / Format
Anbieter-ID com.nexblue.autocharge/v1
messageId VID
Daten JSON-kodierte Zeichenkette, die Folgendes enthält: VID und Transaktions-ID.
data.VID MAC-Adresse des Fahrzeugs ohne die VID: Präfix.
data.TransactionID Transaktions-ID, die in StartTransaction.conf, dargestellt als Zeichenkette.

Entschlüsseln Daten als JSON, suchen Sie die Transaktion mithilfe von Transaktions-ID, und es mit VID. Bei Feldnamen wird zwischen Groß- und Kleinschreibung unterschieden; VID enthält die MAC-Adresse ohne die VID: Präfix.