VOOL-laturissa on Modbus TCP/UDP -liitäntä paikallisia integraatioita varten. Tällä sivulla on liitännän koko käyttöohje (22.01.2026, laiteohjelmisto v1.9.40; GW v1.17.7, MCU v2.12.3). PDF-versio on liitteenä alla.
Kuvaus
Modbus-liitäntä on käytettävissä Ethernet- ja Wi-Fi-liitännöissä. Hybridiyhteyttä — Modbus Wi-Fin kautta ja OCPP Ethernetin kautta (tai päinvastoin) samanaikaisesti — ei tueta; kaikki yhteydet käyttävät kerrallaan yhtä yhteistä liitäntää.
Oletuksena Modbus on pois käytöstä, ja sen voi ottaa käyttöön erityisparametrilla 522 — Enable Modbus TCP/UDP interface. VOOL-tuki voi myös ottaa sen käyttöön etänä tietylle sarjanumerolle.
Protokollan määritykset
Portti: 502 (TCP ja UDP)
Tavujärjestys: big-endian
Samanaikaisia yhteyksiä enintään: 3 — muut yhteysyritykset hylätään
Aikakatkaisu: 60 s (yhteys suljetaan, kun tiedonsiirtoa ei ole)
Tässä Modbus-liitännässä ei ole minkäänlaista tietoturvaa. Käytä sitä vain paikallisissa, suojatuissa verkoissa. VOOL ei vastaa vahingoista, jotka johtuvat luvattomasta pääsystä Modbus-liitäntään.
Rekisteritaulukko
Kaikki rekisterit ovat holding-rekistereitä.
Osoite | Kuvaus | Tyyppi | Pääsy | Yksikkö | Desimaalit |
100 | Laturin tila | uint | R | enum | - |
101 | Auton vaiheet | uint | R | binary | - |
102–104 | Vaihtovirta L1 / L2 / L3 | int | R | A | 0.01 |
105–107 | Jännite L1 / L2 / L3 | int | R | V | 0.1 |
108 | Pätöteho (yhteensä) | int | R | kW | 0.01 |
109–111 | Pätöteho L1 / L2 / L3 | int | R | kW | 0.01 |
200–201 | Tuotu energia (MSB, LSB) | uint32 | R | Wh | 1 |
500 | Latauskomento | uint | W | enum | - |
501 | Ulkoinen virtaraja | uint | R/W | A | 0.01 |
502 | Ulkoisesti sallitut vaiheet | uint | R/W | binary | - |
W-merkittyjä rekistereitä voi lukea, mutta vastaus ei välttämättä sisällä mielekästä arvoa. Huom: rekisteriosoite 502 (External Allowed Phases) ei liity TCP-porttiin 502 — sama numero on sattumaa.
Laturin tila (rekisteri 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
Auton vaiheet (rekisteri 101)
Kertoo, montaako vaihetta auto käyttää (ei verkon vaiheita): bit 0 = L1, bit 1 = L2, bit 2 = L3. Esimerkki: 0b001 — auto käyttää vain L1:tä (1-vaiheinen auto); 0b111 — kaikki vaiheet (3-vaiheinen auto). 0b110 (L2+L3) on yleensä epänormaali yhdistelmä ja voi viitata kaapeli- tai liitäntävikaan L1:ssä.
Latauskomento (rekisteri 500)
1 = Start Charging, 2 = Stop Charging. Komennot käsitellään rekisterin kirjoitustapahtumassa: jos laturi on pysähtynyt mistä tahansa syystä, käynnistyskomento on kirjoitettava uudelleen uuden käynnistyksen aloittamiseksi. Lue reaktio laturin tilarekisteristä. Älä kirjoita kelvollisia komentoarvoja jaksoittain — se ei aiheuta vikoja, mutta kuormittaa järjestelmää ja tekee sisäisistä lokeista käyttökelvottomia.
Ulkoisesti sallitut vaiheet (rekisteri 502)
Määrittää, mitä verkon syöttövaiheita (L1, L2, L3) laturi saa käyttää: bit 0 = L1, bit 1 = L2, bit 2 = L3. Laturin vaihelähdöt valitsevat automaattisesti sopivan kokoonpanon ja kytkevät aina ensin L1-lähdön — kun vain L2 on sallittu, laturi kytkee verkon L2:n auton L1:een. Esimerkki: 0b010 — vain L2 sallittu; 0b101 — L1 ja L3 sallittu, L2 kielletty.
Enintään 10 kytkentää tunnissa. Laturi laskee ja rajoittaa kytkentöjä automaattisesti; laskuri nollautuu tunnin kuluttua ensimmäisestä kytkennästä. Vaiheiden salliminen on mahdollista myös rajan ylittyessä, jotta vältetään lukkiutuminen.
Päivitetty käyttöohje seuraavan sukupolven laturiohjelmistolle on valmisteilla, ja se korvaa tämän sivun, kun kyseinen laiteohjelmisto julkaistaan.