Zum Hauptinhalt springen

Registertabelle

Nachfolgend die Registertabelle für Modbus TCP für die Einstellung "WARP Charger".

Input Registers können nur gelesen werden und liefern Informationen über den Zustand der Wallbox. Gewisse Register sind nur verfügbar, wenn das dazu angegebene Feature verfügbar ist. So sind zum Beispiel die Informationen zur Ladeleistung, Energie usw. nur verfügbar, wenn die Wallbox über ein Meter verfügt: Ein WARP3 Charger Pro (Version mit Stromzähler) liefert diese Werte, ein WARP3 Charger Smart (Version ohne Stromzähler) nicht.

Welche Features die Wallbox bietet, kann über Discrete Inputs ausgelesen werden. Eine Steuerung der Wallbox ist über die Holding Registers und Coils möglich.

Input Registers (Funktionscodes: Lesen: 4)

RegisteradresseNameTypBenötigtes FeatureBeschreibung
0Version der Registertabelleuint32---Aktuelle Version: 3
2Firmware-Version Majoruint32---Beispielsweise 2 für Firmware 2.4.0+66558ade
4Firmware-Version Minoruint32---Beispielsweise 4 für Firmware 2.4.0+66558ade
6Firmware-Version Patchuint32---Beispielsweise 0 für Firmware 2.4.0+66558ade
8Zeitstempel der Firmwareuint32---Unix-Timestamp des Zeitpunktes an dem eine Firmware gebaut wurde. Beispielsweise 0x66558ADE für Firmware 2.4.0+66558ade (in Dezimal 1716882142), entspricht dem 28. Mai 2024 07:42:22 UTC.
10Charger-IDuint32---Dekodierte Form der Base58-UID, die für Standard-Hostnamen, -SSID usw. genutzt wird. Zum Beispiel 185460 für X8A.
12Uptime (s)uint32---Zeit in Sekunden seit dem Start der Wallbox-Firmware.
1000IEC-61851-Zustanduint32evse
  • 0: A
  • 1: B
  • 2: C
  • 3: D
  • 4: E/F
1002Ladestatusuint32evse
  • 0: Nicht verbunden
  • 1: Warte auf Freigabe
  • 2: Ladebereit
  • 3: Lädt
  • 4: Fehler
1004User-IDuint32evseID des Benutzers der den Ladevorgang gestartet hat. 0 falls eine Freigabe ohne Benutzerzuordnung erfolgt ist. 0xFFFFFFFF falls gerade kein Ladevorgang läuft.
1006Start-Zeitstempel (min)uint32evseEin Unix-Timestamp in Minuten, der den Startzeitpunkt des Ladevorgangs angibt. 0 falls zum Startzeitpunkt keine Zeitsynchronisierung verfügbar war.
1008Ladedauer (s)uint32evseDauer des laufenden Ladevorgangs in Sekunden. Auch ohne Zeitsynchronisierung verfügbar.
1010Erlaubter Ladestromuint32evseMaximal erlaubter Ladestrom, der dem Fahrzeug zur Verfügung gestellt wird. Dieser Strom ist das Minimum der Stromgrenzen aller Ladeslots.
1012 bis 1050Ladestromgrenzen (mA)uint32 (20x)evseAktueller Wert der Ladestromgrenzen in Milliampere. 0xFFFFFFFF falls eine Stromgrenze nicht aktiv ist. 0 falls eine Stromgrenze blockiert. Sonst zwischen 6000 (6A) und 32000 (32A).
2000Stromzählertypuint32meter
  • 0: Kein Stromzähler verfügbar
  • 1: SDM72 (nur WARP1)
  • 2: SDM630
  • 3: SDM72 V2
  • 4: SDM72CTM
  • 5: SDM630MCT V2
  • 6: DSZ15DZMOD
  • 7: DEM4A
2002Ladeleistung (W)float32meterDie aktuelle Ladeleistung in Watt.
2004absolute Energie (kWh)float32meterDie geladene Energie seit der Herstellung des Stromzählers.
2006relative Energie (kWh)float32meterDie geladene Energie seit dem letzten Reset (siehe Holding Register 2000).
2008Energie des Ladevorgangsfloat32meterDie während des laufenden Ladevorgangs geladene Energie.
2100 bis 2268weitere Stromzähler-Wertefloat32 (85x)all_valuesSiehe API-Dokumentation
3100Verbundene Phasenuint32phase_switchGibt an wie viele Phasen mit dem Fahrzeug verbunden sind (1 oder 3).
3102Zustand der Phasenumschaltunguint32phase_switch

Aktueller Zustand der Phasenumschaltung:

  • 0: Phasenumschaltung ist bereit für Kommandos.
  • 1: Phasenumschaltung ist über die Einstellungen deaktiviert.
  • 2: Phasenumschaltung ist aktiviert aber aktuell nicht verfügbar.
  • 3: Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.
4000 bis 4009ID des letzten NFC-Tagsuint8 (20x)nfcDie ID des zuletzt erkannten NFC-Tags als ASCII-kodierter Hex-String.
4010Alter des letzten NFC-Tagsuint32nfcZeit in Millisekunden seitdem das zuletzt erkannten NFC-Tag das letzte mal erkannt wurde. Zeiten < 1000 ms bedeuten typischerweise, dass das Tag gerade an die Wallbox gehalten wird.
4012 bis 4013Typ des letzten NFC-Tagsuint8 (4x)nfc

Typ des zuletzt erkannten NFC-Tags als ASCII-kodierter Hex-String.

  • "0000": Mifare Classic
  • "0001": NFC Forum Typ 1
  • "0002": NFC Forum Typ 2
  • "0003": NFC Forum Typ 3
  • "0004": NFC Forum Typ 4
  • "0005": NFC Forum Typ 5

Holding Registers (Funktionscodes: Lesen: 3, Schreiben: 16)

RegisteradresseNameTypBenötigtes FeatureBeschreibung
0Rebootuint32---Startet die Wallbox (bzw. den ESP-Brick) neu, um beispielsweise Konfigurationsänderungen anzuwenden. Passwort: 0x012EB007
1000Ladefreigabeuint32evseVeraltet. Stattdessen Coil 1000 verwenden! 0 zum Blockieren des Ladevorgangs; ein Wert ungleich 0 zum Freigeben.
1002Erlaubter Ladestrom (mA)uint32evse0 mA oder 6000 mA bis 32000 mA. Andere Ladestromgrenzen können den Strom weiter verringern!
1004Front-LED-Blinkmusteruint32evse

Steuert die LED des Tasters in der Wallbox-Front.

Blinkmuster und -dauer müssen mit einem Modbus-Befehl geschrieben werden! Falls auch die Farbe gesetzt werden soll (nur WARP3), müssen die Register 1004 bis einschließlich 1013 in einem Befehl geschrieben werden.

Damit die LED kontrolliert werden kann muss die Option "Status-LED-Steuerung" aktiviert sein.

  • -1: EVSE kontrolliert LED
  • 0: LED aus
  • 1 bis 254: LED gedimmt
  • 255: LED an
  • 1001: bekanntes NFC-Tag erkannt
  • 1002: unbekanntes NFC-Tag erkannt
  • 1003: NFC-Tag notwendig
  • 2001 bis 2010: Fehlerblinken 1 bis 10 mal
1006Front-LED-Blinkdaueruint32evseDie Dauer in Millisekunden für die das in Register 1004 gesetzte Blinkmuster angezeigt werden soll. Maximal 65535 ms werden unterstützt.
1008Front-LED-Blinkfarbwert (Hue)uint32evseDer Farbwert der Farbe (im HSV-Farbraum) in der das im Register 1004 gesetzte Blinkmuster angezeigt werden soll. Nur Werte zwischen 0 und 359 (°) sind erlaubt. Die Farbe kann nur bei einem WARP3 Charger gesetzt werden. WARP und WARP2 Charger besitzen eine einfarbig blaue LED.
1010Front-LED-Blinkfarbsättigung (Saturation)uint32evseDie Farbsättigung der Farbe (im HSV-Farbraum) in der das im Register 1004 gesetzte Blinkmuster angezeigt werden soll. Nur Werte zwischen 0 und 255 sind erlaubt. Die Farbe kann nur bei einem WARP3 Charger gesetzt werden. WARP und WARP2 Charger besitzen eine einfarbig blaue LED.
1012Front-LED-Blinkfarbhelligkeit (Value)uint32evseDie Helligkeit der Farbe (im HSV-Farbraum) in der das im Register 1004 gesetzte Blinkmuster angezeigt werden soll. Nur Werte zwischen 0 und 255 sind erlaubt. Die Farbe kann nur bei einem WARP3 Charger gesetzt werden. WARP und WARP2 Charger besitzen eine einfarbig blaue LED.
2000Relative Energie zurücksetzenuint32meterSetzt den relativen Energiewert zurück (Input Register 2006). Passwort: 0x3E12E5E7
3100Phasenumschaltung auslösenuint32phase_switch1 für einphasiges Laden. 3 für dreiphasiges Laden.
4000 bis 4009ID des vorzutäuschenden NFC-Tagsuint8 (20x)nfc

Mit den Registern 4000 bis einschließlich 4013 kann ein NFC-Tag vorgetäuscht werden (analog zur API nfc/inject_tag):

  • Register 4000 bis 4009: Die ID des Tags als ASCII-kodierter Hex-String.
  • Register 4010 und 4011:

    • "0001": Mit dem vorgetäuschten Tag kann ein Ladevorgang nur gestartet werden (analog zur API nfc/inject_tag_start)
    • "0002": Mit dem vorgetäuschten Tag kann ein Ladevorgang nur gestoppt werden (analog zur API nfc/inject_tag_stop)
    • alle anderen Werte: Mit dem vorgetäuschten Tag kann ein Ladevorgang gestartet und gestoppt werden (analog zur API nfc/inject_tag)
  • Register 4012 und 4013: Der Typ des NFC-Tags als ASCII-kodierter Hex-String:

    • "0000": Mifare Classic
    • "0001": NFC Forum Typ 1
    • "0002": NFC Forum Typ 2
    • "0003": NFC Forum Typ 3
    • "0004": NFC Forum Typ 4
    • "0005": NFC Forum Typ 5

Schreiben der Register 4012 und 4013 startet das Vortäuschen das Tags. Danach werden die Holding Register 4000 bis 4013 geleert! Das Datenformat der Holding Register 4000 bis 4013 ist identisch zum Format der Input Register 4000 bis 4013 (die das zuletzt gesehen NFC-Tag enthalten). Ein physisch existierendes Tag kann also (wieder) vorgetäuscht werden, indem es einmal an die Wallbox gehalten wird und die dabei erzeugten Werte in den Input Registern 4000 bis 4013 später in die Holding Register 4000 bis 4013 geschrieben werden.

4010 bis 4011Verwendungszweck des vorgetäuschten NFC-Tagsuint8 (4x)nfcSiehe Beschreibung der Holding Register 4000 bis 4009.
4012 bis 4013Typ des vorgetäuschten NFC-Tagsuint8 (4x)nfcSiehe Beschreibung der Holding Register 4000 bis 4009.

Discrete Inputs (Funktionscodes: Lesen: 2)

RegisteradresseNameTypBenötigtes FeatureBeschreibung
0Feature "evse" verfügbarbool---Ein Ladecontroller steht zur Verfügung. Dieses Feature sollte bei allen WARP Chargern, deren Hardware funktionsfähig ist, vorhanden sein.
1Feature "meter" verfügbarbool---Ein Stromzähler und Hardware zum Auslesen desselben über RS485 ist verfügbar. Dieses Feature wird erst gesetzt, wenn ein Stromzähler mindestens einmal erfolgreich über Modbus ausgelesen wurde.
2Feature "phases" verfügbarbool---Der verbaute Stromzähler kann Energie und weitere Messwerte einzelner Phasen messen.
3Feature "all_values" verfügbarbool---Der verbaute Stromzähler kann weitere Messwerte auslesen.
4Feature "phase_switch" verfügbarbool---Hardware und Konfiguration erlauben eine Phasenumschaltung.
5Feature "nfc" verfügbarbool---Ein NFC-Bricklet ist verbaut und aktiv.
6Feature "evse_sd_input" verfügbarbool---Der Ladecontroller verfügt über einen Abschalteingang.
7Feature "evse_gp_input" verfügbarbool---Der Ladecontroller verfügt über einen konfigurierbaren Eingang.
8Feature "evse_gp_output" verfügbarbool---Der Ladecontroller verfügt über einen konfigurierbaren Ausgang.
1100Zustand des Abschalteingangsboolevse_sd_input 0 - geschlossen, 1 - geöffnet
1101Zustand des konfigurierbaren Eingangsboolevse_gp_input 0 - geschlossen, 1 - geöffnet
2100Phase L1 angeschlossenboolphases
2101Phase L2 angeschlossenboolphases
2102Phase L3 angeschlossenboolphases
2103Phase L1 aktivboolphases
2104Phase L2 aktivboolphases
2105Phase L3 aktivboolphases

Coils (Funktionscodes: Lesen: 1, Einzelschreiben: 5, Mehrfachschreiben: 15)

RegisteradresseNameTypBenötigtes FeatureBeschreibung
1000Ladefreigabeboolevsefalse bzw. 0 zum Blockieren des Ladevorgangs. true bzw. 1 zum Freigeben. Identisch zu Holding Register 1000.
1001Manuelle Ladefreigabeboolevsefalse bzw. 0 zum Blockieren des Ladevorgangs. true bzw. 1 zum Freigeben. Setzt die Ladefreigabe, die auch (je nach Konfiguration) vom Taster, den Start/Stop-Buttons auf der Webinterface-Statusseite und der evse/[start/stop]_charging-API verwendet wird.
1100Zustand des Abschalteingangsboolevse_sd_input 0 - geschlossen, 1 - geöffnet
1101Zustand des konfigurierbaren Eingangsboolevse_gp_input 0 - geschlossen, 1 - geöffnet