Ładowarka VOOL udostępnia interfejs Modbus TCP/UDP do integracji lokalnych. Na tej stronie znajduje się pełna instrukcja interfejsu (22.01.2026, oprogramowanie v1.9.40; GW v1.17.7, MCU v2.12.3). Wersja PDF jest załączona poniżej.
Opis
Interfejs Modbus jest dostępny przez Ethernet i Wi-Fi. Połączenie hybrydowe — jednoczesne korzystanie z Modbus przez Wi-Fi i OCPP przez Ethernet (lub odwrotnie) — nie jest obsługiwane; wszystkie połączenia korzystają w danym momencie z jednego wspólnego interfejsu.
Domyślnie Modbus jest wyłączony i można go włączyć za pomocą specjalnego parametru 522 — Enable Modbus TCP/UDP interface. Dział wsparcia VOOL może go też włączyć zdalnie dla danego numeru seryjnego.
Specyfikacja protokołu
Port: 502 (TCP i UDP)
Kolejność bajtów: big-endian
Maksymalna liczba jednoczesnych połączeń: 3 — kolejne próby połączenia są odrzucane
Limit czasu: 60 s (połączenie jest zamykane przy braku komunikacji)
Ten interfejs Modbus nie ma żadnych zabezpieczeń. Używaj go wyłącznie w lokalnych, bezpiecznych sieciach. VOOL nie ponosi odpowiedzialności za szkody spowodowane nieuprawnionym dostępem do interfejsu Modbus.
Tabela rejestrów
Wszystkie rejestry są rejestrami typu holding.
Address | Opis | Type | Dostęp | Jednostka | Miejsca dziesiętne |
100 | Stan ładowarki | uint | R | enum | - |
101 | Fazy pojazdu (EV Phases) | uint | R | binary | - |
102–104 | Prąd AC L1 / L2 / L3 | int | R | A | 0.01 |
105–107 | Napięcie L1 / L2 / L3 | int | R | V | 0.1 |
108 | Moc czynna (całkowita) | int | R | kW | 0.01 |
109–111 | Moc czynna L1 / L2 / L3 | int | R | kW | 0.01 |
200–201 | Energia pobrana (MSB, LSB) | uint32 | R | Wh | 1 |
500 | Polecenie ładowania | uint | W | enum | - |
501 | Zewnętrzny limit prądu | uint | R/W | A | 0.01 |
502 | Zewnętrznie dozwolone fazy | uint | R/W | binary | - |
Rejestry oznaczone W pozwalają na odczyt, ale odpowiedź może nie zawierać sensownej wartości. Uwaga: adres rejestru 502 (External Allowed Phases) nie ma związku z portem TCP 502 — ta sama liczba to przypadek.
Stan ładowarki (rejestr 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
Fazy pojazdu (rejestr 101)
Wskazuje, ile faz wykorzystuje pojazd (nie fazy sieci): bit 0 = L1, bit 1 = L2, bit 2 = L3. Przykład: 0b001 — pojazd używa tylko L1 (pojazd jednofazowy); 0b111 — wszystkie fazy (pojazd trójfazowy). 0b110 (L2+L3) to zwykle nietypowa kombinacja i może wskazywać na usterkę kabla lub połączenia na L1.
Polecenie ładowania (rejestr 500)
1 = rozpocznij ładowanie, 2 = zatrzymaj ładowanie. Polecenia są przetwarzane przy zdarzeniu zapisu rejestru: jeśli ładowarka z jakiegokolwiek powodu się zatrzymała, aby rozpocząć ładowanie ponownie, trzeba jeszcze raz zapisać polecenie startu. Reakcję odczytaj z rejestru stanu ładowarki. Nie zapisuj prawidłowych wartości poleceń cyklicznie — nie spowoduje to awarii, ale zaśmieca system i sprawia, że wewnętrzne logi stają się bezużyteczne.
Zewnętrznie dozwolone fazy (rejestr 502)
Określa, z których faz sieci (L1, L2, L3) ładowarka może korzystać: bit 0 = L1, bit 1 = L2, bit 2 = L3. Wyjścia fazowe ładowarki automatycznie dobierają odpowiednią konfigurację i zawsze najpierw podłączają wyjście L1 — gdy dozwolona jest tylko L2, ładowarka łączy fazę L2 sieci z L1 pojazdu. Przykład: 0b010 — dozwolona tylko L2; 0b101 — dozwolone L1 i L3, L2 zabroniona.
Maksymalnie 10 przełączeń na godzinę. Ładowarka liczy przełączenia i automatycznie je ogranicza; licznik zeruje się godzinę po pierwszym przełączeniu. Włączanie faz jest dozwolone nawet po przekroczeniu limitu, aby uniknąć zablokowania.
Zaktualizowana instrukcja obejmująca kolejną generację oprogramowania ładowarki jest w przygotowaniu i zastąpi tę stronę, gdy to oprogramowanie zostanie wydane.