VOOL-latureilla ja VOOL LMC:llä on kummallakin oma Modbus-rajapintansa, ja ne tekevät eri asioita. Molempia käytetään paikallisiin integraatioihin, kuten Home Assistantiin, aurinko- tai energianhallintajärjestelmään tai kiinteistöautomaatioon. Valitse se, joka vastaa sitä, mitä haluat lukea tai ohjata:
Laturin Modbus TCP/UDP — yhden laturin tila, vaihekohtaiset virrat, jännitteet, teho ja energia sekä käynnistys/pysäytys, ulkoinen virtaraja ja sallitut vaiheet. Laturilla on oltava oma Ethernet- tai Wi-Fi-yhteys. Käsitellään tässä artikkelissa ja laturin Modbus-käsikirjassa.
LMC:n Modbus TCP (LMC-ohjelmisto v6.4.0 ja uudempi) — kohteen pääsyötön virrat ja jännitteet vaiheittain sekä kirjoitusoikeudella kuormanhallinnan käyttämä liittymän virtaraja. Se ei anna yksittäisten laturien mittauksia, energialaskureita eikä laturien käynnistystä/pysäytystä. Täydellinen rekisterikartta: Modbus TCP VOOL LMC:ssä.
Molemmat ovat oletuksena pois päältä, ja VOOL-tuki voi ottaa ne käyttöön etänä – lähetä sähköpostia osoitteeseen [email protected] ja kerro laturin tai LMC:n sarjanumero.
Pelkät CAN-asennukset
Jos laturisi on yhteydessä VOOL-alustaan LMC:n kautta CAN-väylällä eikä sillä ole omaa Ethernet- tai Wi-Fi-yhteyttä, laturin Modbus-rajapintaan ei voi yhdistää: Modbus on laturin sisällä, eikä laturi tässä kokoonpanossa ole verkossasi. Näet kumpi tilanne on kyseessä laturin sivulta selainportaalissa: jos OCPP source on LMC eikä Connectivity-osiossa näy omaa Wi-Fi- tai Ethernet-yhteyttä, laturi on LMC:n takana.
CAN-asennuksessa voit silti käyttää LMC:n Modbus TCP -rajapintaa – kunhan LMC itse on verkossasi – lukeaksesi kohteen pääsyötön virrat ja jännitteet ja asettaaksesi liittymän virtarajan. Se rajoittaa koko kohdetta; laturikohtainen ohjaus tai mittaus Modbusilla vaatii, että laturi on suoraan yhteydessä verkkoosi.
LMC lukee myös mittareita Modbusilla
Modbus TCP -palvelimensa lisäksi LMC käyttää Modbusia myös toiseen suuntaan: se lukee ulkoista energiamittaria. Silloin LMC toimii Modbus-isäntänä.
Modbus RTU RS485:n kautta — tavallinen tapaus. Tarvitset mittarin tiedonsiirtonopeuden (baud) ja joissain tapauksissa sen orja-osoitteen. Nopeus määräytyy mittarin mukaan; 19200 on yleinen. Esimerkki: Siemens PAC2200, laite-ID 126, 19200 baud.
Modbus TCP Ethernetin kautta — tässä tarvitset mittarin IP-osoitteen.
Tämä kannattaa sanoa ääneen, koska se aiheuttaa todellista hämmennystä: mittarin asetusten IP-osoitekenttä on mittarin osoite, ei laturin. Jos mittarisi on kytketty LMC:hen RS485:llä eikä ole verkossa lainkaan, kenttä ei koske sinua – kerro meille tiedonsiirtonopeus, niin tuki voi määrittää sen.
Modbusin käyttöönotto laturissa
Rajapinta on oletuksena pois päältä. Se otetaan käyttöön laturin parametrilla 522 — Enable Modbus TCP/UDP interface. Parametri on laturin omassa laiteohjelmistossa, ei VOOL-selainportaalissa: portaalissa ei ole Modbus-sivua, Modbus-kytkintä eikä numeroitujen parametrien luetteloa, joten sieltä ei kannata etsiä. Käyttöönoton jälkeen rajapinta kuuntelee porttia 502 (TCP ja UDP) – 522 on parametrin numero, ei portti. Modbus toimii samassa yksittäisessä rajapinnassa (Ethernet tai Wi-Fi) kuin laturin muu liikenne; hybridikokoonpanoa, jossa Modbus on yhdessä ja OCPP toisessa, ei tueta.
Laturissasi on oltava heinäkuun 2025 tai uudempi ohjelmisto. Modbus-rajapinta tuli gateway-versiossa v1.17.2 (paketti v1.9.33), ja tukevat ohjaintoiminnot valmistuivat paketissa v1.9.40 (gateway v1.17.7, MCU v2.12.3). Vanhemmassa ohjelmistossa parametria ei ole lainkaan, joten sitä ei löydy etsimälläkään. Laturisi versio näkyy sen sivulla selainportaalissa kohdassa Configuration.
Helpoin tapa saada se päälle: lähetä sähköpostia osoitteeseen [email protected], kerro laturin sarjanumero ja pyydä ottamaan Modbus käyttöön. VOOL voi tehdä sen etänä, yleensä yhden työpäivän kuluessa. Jos käytät asentajaa, hän voi myös määrittää laturin suoraan Bluetoothilla VOOL-mobiilisovelluksen asentajatilassa.
Laturin rekisterikartta
Kaikki rekisterit ovat holding-rekistereitä, big-endian. Rajapinta hyväksyy enintään 3 samanaikaista yhteyttä ja sulkee yhteyden 60 sekunnin hiljaisuuden jälkeen.
Vain luku -rekisterit kattavat laturin tilan ja auton vaiheet (100–101), vaihekohtaiset virrat, jännitteet ja pätötehon (102–111) sekä tuodun energian (200–201). Kirjoitettavat rekisterit ovat 500 latauskomento (1 = käynnistä, 2 = pysäytä), 501 ulkoinen virtaraja ja 502 ulkoiset sallitut vaiheet. Rekisteri 502 on rajoitettu 10 vaiheenvaihtoon tunnissa. Täydellinen taulukko yksiköineen, skaalauksineen ja bittimäärityksineen on tämän tukikeskuksen laturin Modbus-käsikirjassa. LMC käyttää eri karttaa (float32-arvot, pääsyötön mittaukset 600–625) – ks. Modbus TCP VOOL LMC:ssä.
Mitä Modbus-kirjoitus voi ja ei voi tehdä
Tämä on yleisin väärinkäsitys, joten suoraan: Modbus-kirjoitus ei voi nostaa laturia sen määritetyn virtarajan yli. Laturille selainportaalissa asetettu Current limit on katto. Jos energianhallintasi kirjoittaa 32 A rekisteriin 501 laturissa, joka on määritetty 16 A:lle, laturi lataa silti 16 A:lla. Rekisteri 501 on pyyntö, ja laturi käyttää voimassa olevista rajoista pienintä.
Useita rajoja voi olla voimassa samanaikaisesti – määritetty maksimi, ulkoinen virta- tai tehoraja, kuormanhallinta, lämpörajoitus. Siksi Modbusilla luettu yksittäinen raja-arvo ei välttämättä ole se, jota käytetään. Jos mittaamasi virta ei vastaa odotettua, kerro tuelle sarjanumero ja ajankohdat, niin selvitämme, mikä raja oli todella voimassa.
Älä lähetä käynnistyskomentoa toistuvasti
Kirjoita rekisteriin 500 vain, kun todella haluat käynnistää tai pysäyttää. Komennot käsitellään kirjoitushetkellä, joten käynnistys on kirjoitettava uudelleen jokaista uutta latausta varten – mutta sen kirjoittaminen ajastetusti kerran minuutissa on todellinen ongelma: se tulvii laturin sisäiset lokit ja tekee niistä hyödyttömiä vianmäärityksessä, ja käynnistys, joka saapuu samalla hetkellä kun laturi käynnistyy itse, voi olla ristiriidassa. Jos laturissa on Auto start päällä, se aloittaa latauksen joka tapauksessa itse, eikä integraatiosi tarvitse lähettää käynnistystä lainkaan.
Jos toimiva integraatio lakkaa vastaamasta
Tarkista ensin laitteen IP-osoite verkossasi. Laiteohjelmistopäivityksen tai reititinvaihdoksen jälkeen laturin LAN-IP voi muuttua, ja integraatio kyselee osoitetta, jota ei enää ole. VOOL-selainportaali ei näytä laturin IP-osoitetta – lue se reitittimesi yhdistettyjen laitteiden luettelosta tai kysy VOOL-tuelta, joka voi lukea sen laturista. Vertaa sitä integraatiosi osoitteeseen ennen kuin oletat, että rajapinta on kytketty pois.
Aseta kiinteä IP (tai DHCP-varaus) latureille ja LMC:lle reitittimessäsi. Reitittimen jakamien osoitteiden muutokset ovat rikkoneet myös kuormanhallinnan tiedonsiirron usean laturin kohteissa.
Tarkista, että laite on samassa aliverkossa kuin sitä kyselevä kone, ja muista laturin 3 samanaikaisen yhteyden raja.
Tietoturvahuomautus
Kummassakaan Modbus-rajapinnassa ei ole todennusta. Käytä niitä vain paikallisissa, suojatuissa verkoissa äläkä koskaan avaa porttia internetiin.
Yhteisön integraatiot ja kumppanirajapinnat
VOOL-laitteille on kolmansien osapuolten Home Assistant -integraatioita. VOOL ei ole tehnyt eikä ylläpidä niitä, ja osa ei toimi LMC:n kanssa ilman muutoksia. Yhteisön integraatiota koskevissa kysymyksissä ota yhteyttä sen tekijään.
Modbus ja OCPP ovat dokumentoidut integraatiotavat. Kumppani- tai kehittäjärajapintoja koskevissa kysymyksissä lähetä sähköpostia osoitteeseen [email protected] numeroiduin kysymyksin, niin ohjaamme ne eteenpäin.