Ładowarki VOOL i kontroler VOOL LMC mają własne, osobne interfejsy Modbus, które służą do różnych celów. Oba są używane do integracji lokalnych, takich jak Home Assistant, system zarządzania energią lub fotowoltaiką albo system zarządzania budynkiem. Wybierz ten, który odpowiada temu, co chcesz odczytywać lub sterować:

Oba są domyślnie wyłączone, a wsparcie VOOL może je włączyć zdalnie — napisz na [email protected], podając numer seryjny ładowarki lub LMC.

Jeśli ładowarka łączy się z platformą VOOL przez LMC po magistrali CAN i nie ma własnego połączenia Ethernet ani Wi-Fi, nie ma interfejsu Modbus ładowarki, z którym można się połączyć: Modbus znajduje się w ładowarce, a w takiej konfiguracji ładowarka nie jest w Twojej sieci. Który przypadek dotyczy Ciebie, sprawdzisz na stronie ładowarki w portalu internetowym: jeśli OCPP source wskazuje LMC, a sekcja Connectivity nie pokazuje własnego Wi-Fi ani Ethernetu, ładowarka działa za LMC.

W instalacji CAN nadal możesz korzystać z interfejsu Modbus TCP kontrolera LMC — o ile sam LMC jest w Twojej sieci — aby odczytywać prądy i napięcia przyłącza lokalizacji oraz ustawiać limit prądu przyłącza. Ogranicza to lokalizację jako całość; sterowanie lub pomiary poszczególnych ładowarek przez Modbus wymagają bezpośredniego podłączenia ładowarki do Twojej sieci.

Niezależnie od swojego serwera Modbus TCP, LMC komunikuje się przez Modbus także w przeciwnym kierunku: odczytuje zewnętrzny licznik energii. W tej roli LMC działa jako Modbus master.

Warto to wyraźnie wyjaśnić, bo często powoduje zamieszanie: pole adresu IP w konfiguracji licznika to adres licznika, a nie ładowarki. Jeśli licznik jest podłączony do LMC przez RS485 i w ogóle nie jest w sieci, to pole Cię nie dotyczy — podaj nam zamiast tego prędkość transmisji, a wsparcie go skonfiguruje.

Interfejs jest domyślnie wyłączony. Włącza się go parametrem ładowarki 522 — Enable Modbus TCP/UDP interface. Ten parametr znajduje się we własnym oprogramowaniu ładowarki, a nie w portalu internetowym VOOL: portal nie ma strony Modbus, przełącznika Modbus ani listy numerowanych parametrów, więc nie ma tam czego szukać. Po włączeniu interfejs nasłuchuje na porcie 502 (TCP i UDP) — 522 to numer parametru, a nie port. Modbus działa na tym samym, jednym interfejsie (Ethernet lub Wi-Fi) co pozostały ruch ładowarki; konfiguracja hybrydowa z Modbus na jednym i OCPP na drugim nie jest obsługiwana.

Ładowarka potrzebuje oprogramowania z lipca 2025 r. lub nowszego. Interfejs Modbus pojawił się w gateway v1.17.2 (bundle v1.9.33), a funkcje kontrolera zostały uzupełnione w bundle v1.9.40 (gateway v1.17.7, MCU v2.12.3). W starszym oprogramowaniu ten parametr w ogóle nie istnieje, więc nie da się go znaleźć. Wersja oprogramowania ładowarki jest widoczna na jej stronie w portalu internetowym, w sekcji Configuration.

Najprostszy sposób, by go włączyć: napisz na [email protected], podając numer seryjny ładowarki, i poproś o włączenie Modbus. VOOL może to zrobić zdalnie, zwykle w ciągu jednego dnia roboczego. Jeśli współpracujesz z instalatorem, może on też skonfigurować ładowarkę bezpośrednio przez Bluetooth, korzystając z trybu instalatora w aplikacji mobilnej VOOL.

Wszystkie rejestry są rejestrami typu holding, big-endian. Interfejs przyjmuje maksymalnie 3 jednoczesne połączenia i zamyka połączenie po 60 sekundach bez komunikacji.

Rejestry tylko do odczytu obejmują stan ładowarki i fazy pojazdu (100–101), prądy, napięcia i moc czynną na poszczególnych fazach (102–111) oraz energię pobraną (200–201). Rejestry zapisywalne to 500 polecenie ładowania (1 = start, 2 = stop), 501 zewnętrzny limit prądu i 502 zewnętrznie dozwolone fazy. Rejestr 502 jest ograniczony do 10 przełączeń faz na godzinę. Pełna tabela z jednostkami, skalowaniem i definicjami bitów znajduje się w Instrukcji Modbus ładowarki w tym centrum pomocy. LMC używa innej mapy (wartości float32, pomiary przyłącza w rejestrach 600–625) — zobacz Modbus TCP w VOOL LMC.

To najczęstsze nieporozumienie, więc wprost: zapis przez Modbus nie może podnieść prądu ładowarki powyżej skonfigurowanego limitu. Górną granicą jest Current limit ustawiony dla ładowarki w portalu internetowym. Jeśli system zarządzania energią zapisze 32 A do rejestru 501 w ładowarce skonfigurowanej na 16 A, ładowarka nadal ładuje prądem 16 A. Rejestr 501 jest żądaniem, a ładowarka stosuje najniższy z obowiązujących w danym momencie limitów.

Jednocześnie może obowiązywać kilka limitów — skonfigurowane maksimum, zewnętrzny limit prądu lub mocy, zarządzanie obciążeniem, ograniczenie termiczne. Dlatego pojedyncza wartość limitu odczytana przez Modbus niekoniecznie jest tą, która jest stosowana. Jeśli zmierzony prąd nie odpowiada oczekiwaniom, podaj wsparciu numer seryjny i godziny, a sprawdzimy, który limit faktycznie obowiązywał.

Zapisuj do rejestru 500 tylko wtedy, gdy naprawdę chcesz rozpocząć lub zatrzymać ładowanie. Polecenia są przetwarzane w momencie zapisu, więc start trzeba zapisać ponownie dla każdej nowej sesji — ale zapisywanie go cyklicznie, np. raz na minutę, to realny problem: zalewa wewnętrzne logi ładowarki, przez co stają się bezużyteczne przy diagnozowaniu, a start, który nadejdzie w tym samym momencie, w którym ładowarka sama uruchamia ładowanie, może wywołać konflikt. Jeśli ładowarka ma włączone Auto start, i tak sama rozpocznie ładowanie, a Twoja integracja nie musi w ogóle wysyłać polecenia start.

Żaden z interfejsów Modbus nie ma uwierzytelniania. Używaj ich tylko w lokalnych, bezpiecznych sieciach i nigdy nie udostępniaj portu w internecie.

Istnieją zewnętrzne integracje Home Assistant dla sprzętu VOOL. Nie są one tworzone ani utrzymywane przez VOOL, a niektóre nie działają z LMC bez modyfikacji. W sprawie integracji społeczności skontaktuj się z jej autorem.

Modbus i OCPP to udokumentowane ścieżki integracji. W sprawie API dla partnerów lub deweloperów napisz na [email protected], numerując pytania, a przekażemy je do odpowiednich osób.