Die VOOL Ladestation bietet eine Modbus-TCP/UDP-Schnittstelle für lokale Integrationen. Diese Seite enthält das vollständige Schnittstellenhandbuch (22.01.2026, Firmware v1.9.40; GW v1.17.7, MCU v2.12.3). Die PDF-Version ist unten angehängt.
Beschreibung
Die Modbus-Schnittstelle ist über Ethernet und WLAN verfügbar. Eine Hybridverbindung – Modbus über WLAN und gleichzeitig OCPP über Ethernet (oder umgekehrt) – wird nicht unterstützt; alle Verbindungen nutzen jeweils eine gemeinsame Schnittstelle.
Standardmäßig ist Modbus deaktiviert und kann über den speziellen Parameter 522 — Enable Modbus TCP/UDP interface aktiviert werden. Der VOOL Support kann es für eine bestimmte Seriennummer auch aus der Ferne aktivieren.
Protokollspezifikation
Port: 502 (TCP und UDP)
Byte-Reihenfolge: Big-Endian
Maximal gleichzeitige Verbindungen: 3 – weitere Verbindungsversuche werden abgelehnt
Timeout: 60 s (die Verbindung wird geschlossen, wenn keine Kommunikation stattfindet)
Diese Modbus-Schnittstelle hat keinerlei Sicherheitsfunktionen. Nutzen Sie sie nur in lokalen, sicheren Netzwerken. VOOL haftet nicht für Schäden durch unbefugten Zugriff auf die Modbus-Schnittstelle.
Registertabelle
Alle Register sind Holding-Register.
Adresse | Beschreibung | Typ | Zugriff | Einheit | Dezimalstellen |
100 | Status der Ladestation | uint | R | enum | - |
101 | Fahrzeugphasen | uint | R | binary | - |
102–104 | Wechselstrom L1 / L2 / L3 | int | R | A | 0.01 |
105–107 | Spannung L1 / L2 / L3 | int | R | V | 0.1 |
108 | Wirkleistung (gesamt) | int | R | kW | 0.01 |
109–111 | Wirkleistung L1 / L2 / L3 | int | R | kW | 0.01 |
200–201 | Bezogene Energie (MSB, LSB) | uint32 | R | Wh | 1 |
500 | Ladebefehl | uint | W | enum | - |
501 | Externe Strombegrenzung | uint | R/W | A | 0.01 |
502 | Extern erlaubte Phasen | uint | R/W | binary | - |
Mit W gekennzeichnete Register können gelesen werden, die Antwort enthält aber möglicherweise keinen sinnvollen Wert. Hinweis: Die Registeradresse 502 (External Allowed Phases) hat nichts mit dem TCP-Port 502 zu tun – die gleiche Zahl ist Zufall.
Status der Ladestation (Register 100)
0 = UNDEFINED, 1 = AVAILABLE, 2 = PREPARING, 3 = CHARGING, 4 = SUSPENDED_EV, 5 = SUSPENDED_EVSE, 6 = FINISHING, 7 = RESERVED, 8 = UNAVAILABLE, 9 = FAULTED, 10 = STARTING_CHARGING
Fahrzeugphasen (Register 101)
Gibt an, wie viele Phasen das Fahrzeug nutzt (nicht die Netzphasen): Bit 0 = L1, Bit 1 = L2, Bit 2 = L3. Beispiel: 0b001 – das Fahrzeug nutzt nur L1 (einphasiges Fahrzeug); 0b111 – alle Phasen (dreiphasiges Fahrzeug). 0b110 (L2+L3) ist meist eine ungewöhnliche Kombination und kann auf einen Kabel- oder Anschlussfehler an L1 hindeuten.
Ladebefehl (Register 500)
1 = Start Charging, 2 = Stop Charging. Befehle werden beim Schreibereignis des Registers verarbeitet: Hat die Ladestation aus irgendeinem Grund gestoppt, muss der Startbefehl erneut geschrieben werden, um einen neuen Start auszulösen. Die Reaktion lesen Sie im Statusregister der Ladestation. Schreiben Sie gültige Befehlswerte nicht periodisch – das verursacht keine Fehler, belastet aber das System und macht die internen Logs unbrauchbar.
Extern erlaubte Phasen (Register 502)
Legt fest, welche Netzeingangsphasen (L1, L2, L3) die Ladestation nutzen darf: Bit 0 = L1, Bit 1 = L2, Bit 2 = L3. Die Phasenausgänge wählen automatisch eine passende Konfiguration und schalten immer zuerst den Ausgang L1 – ist nur L2 erlaubt, verbindet die Ladestation Netz-L2 mit Fahrzeug-L1. Beispiel: 0b010 – nur L2 erlaubt; 0b101 – L1 und L3 erlaubt, L2 gesperrt.
Maximal 10 Schaltvorgänge pro Stunde. Die Ladestation zählt und begrenzt Schaltvorgänge automatisch; der Zähler wird eine Stunde nach dem ersten Vorgang zurückgesetzt. Das Freigeben von Phasen ist auch über das Limit hinaus erlaubt, um eine Sperrsituation zu vermeiden.
Ein aktualisiertes Handbuch für die nächste Firmware-Generation der Ladestation ist in Vorbereitung und ersetzt diese Seite, sobald diese Firmware erscheint.