Modbus TCP/UDP on laadija liides. VOOLi laadijad pakuvad seda kohalike integratsioonide jaoks, näiteks Home Assistant või päikese- ja energiahaldur. Kaks asja tuleb enne kõike muud selgeks teha: liides asub laadijas, mitte LMC-s, ja see eeldab, et laadijal on oma võrguühendus.
Ainult CAN-ühendusega paigalduses see ei tööta
Kui laadija jõuab VOOLi platvormile LMC kaudu CAN-ühendusega ja tal ei ole oma Etherneti- ega WiFi-ühendust, siis ei ole Modbusi liidest, millega ühenduda. Modbus on laadija sees ja sellises paigalduses ei ole laadija sinu võrgus. Kummal juhul sa oled, näed laadija lehelt veebiportaalis: kui OCPP source näitab LMC ja jaotises Connectivity ei ole laadijal oma WiFit ega Ethernetti, siis on laadija LMC taga.
LMC-l endal ei ole Modbusi liidest kolmandate osapoolte juhtimiseks. See on plaanis, kuid tähtaega ei ole. Seega vajab Modbusi integratsioon laadijat, mis on otse sinu võrku ühendatud.
LMC ja Modbus on eri asi
LMC räägib Modbusi, aga vastupidises suunas: ta loeb välist elektriarvestit. Sel juhul on LMC Modbusi peaseade (master), mitte liides, mille kaudu saaks laadijat juhtida.
Modbus RTU üle RS485 — tavaline juhtum. Vaja on arvesti andmesidekiirust (baud rate) ja mõnel juhul ka seadme aadressi (slave address). Kiiruse määrab arvesti; levinud on 19200. Näide: Siemens PAC2200, seadme ID 126, kiirus 19200.
Modbus TCP üle Etherneti — siin on vaja arvesti IP-aadressi.
Seda tasub selgelt välja öelda, sest see tekitab tegelikku segadust: arvesti seadistuses olev IP-aadressi väli on arvesti, mitte laadija aadress. Kui sinu arvesti on LMC-ga ühendatud RS485 kaudu ja ei ole üldse võrgus, siis see väli sinu kohta ei käi — anna meile hoopis andmesidekiirus ja tugi seadistab selle.
Modbusi sisselülitamine laadijal
Liides on vaikimisi väljas. Selle lülitab sisse laadija parameeter 522 — Enable Modbus TCP/UDP interface. See parameeter asub laadija enda tarkvaras, mitte VOOLi veebiportaalis: portaalis ei ole Modbusi lehte, Modbusi lülitit ega nummerdatud parameetrite loendit, nii et sealt ei ole midagi otsida. Kui liides on sees, kuulab see porti 502 (TCP ja UDP) — 522 on parameetri number, mitte port. Modbus töötab samal liidesel (Ethernet või WiFi) kui laadija muu liiklus; hübriidseadistus, kus Modbus on ühel ja OCPP teisel liidesel, ei ole toetatud.
Laadijal peab olema 2025. aasta juuli või uuem tarkvara. Modbusi liides tuli gateway versiooniga v1.17.2 (komplekt v1.9.33) ja seda toetavad kontrolleri funktsioonid said valmis komplektis v1.9.40 (gateway v1.17.7, MCU v2.12.3). Vanemas tarkvaras seda parameetrit lihtsalt ei ole, nii et otsimine ei aita. Laadija versioon on näha selle lehel veebiportaalis jaotises Configuration.
Lihtsaim viis see sisse lülitada: kirjuta aadressile [email protected] laadija seerianumbriga ja palu Modbus sisse lülitada. VOOL saab seda teha kaugelt, tavaliselt ühe tööpäeva jooksul. Kui teed koostööd paigaldajaga, saab tema laadijat ka otse Bluetoothi kaudu seadistada, kasutades VOOLi mobiiliäpi paigaldaja režiimi (installer mode).
Registrid
Kõik registrid on hoideregistrid (holding register), big-endian. Liides lubab korraga kuni 3 ühendust ja sulgeb ühenduse, kui 60 sekundi jooksul sidet ei ole.
Ainult loetavad registrid katavad laadija oleku ja auto faasid (100–101), voolud, pinged ja aktiivvõimsuse faasi kaupa (102–111) ning sisse võetud energia (200–201). Kirjutatavad registrid on 500 laadimiskäsk (1 = start, 2 = stopp), 501 väline voolupiirang ja 502 välised lubatud faasid. Register 502 lubab kuni 10 faasilülitust tunnis. Täielik tabel koos ühikute, skaleerimise ja bittide tähendustega on selle abikeskuse artiklis Charger Modbus manual.
Mida Modbusi kirjutamine saab ja ei saa teha
See on kõige levinum arusaamatus, seega otse: Modbusi kaudu ei saa laadijat seadistatud voolupiirangust kõrgemale viia. Veebiportaalis laadijale määratud Current limit on ülempiir. Kui sinu energiahaldur kirjutab registrisse 501 väärtuse 32 A laadijale, mille piirang on 16 A, laeb laadija ikka 16 A-ga. Register 501 on soov ja laadija rakendab kehtivatest piirangutest kõige madalamat.
Korraga võib kehtida mitu piirangut — seadistatud maksimum, väline voolu- või võimsuspiirang, koormushaldus, soojuslik piiramine. Nii et üks Modbusist loetud piiranguväärtus ei pruugi olla see, mida tegelikult kasutatakse. Kui mõõdetud vool ei vasta ootusele, anna toele seerianumber ja kellaajad ning me vaatame järele, milline piirang tegelikult kehtis.
Ära saada start-käsku korduvalt
Kirjuta registrisse 500 ainult siis, kui tegelikult tahad laadimist alustada või lõpetada. Käske töödeldakse kirjutamise hetkel, nii et iga uue seansi jaoks tuleb start uuesti kirjutada — aga selle saatmine taimeriga, kord minutis, on tõeline probleem: see ujutab laadija sisemised logid üle ja muudab need diagnoosimiseks kasutuks, ning start, mis saabub täpselt siis, kui laadija ise automaatselt käivitub, võib tekitada konflikti. Kui laadijal on Auto start sees, alustab ta laadimist igal juhul ise ja integratsioon ei pea start-käsku üldse saatma.
Kui töötav integratsioon lõpetab vastamise
Kontrolli esmalt seadme IP-aadressi oma võrgus. Pärast tarkvarauuendust või ruuteri vahetust võib laadija kohtvõrgu IP muutuda ning integratsioon pärib aadressilt, mida enam ei ole. VOOLi veebiportaal ei näita laadija IP-aadressi — loe see oma ruuteri ühendatud seadmete loendist või küsi VOOLi toelt, kes saab selle laadijast välja lugeda. Võrdle seda integratsioonis seadistatud aadressiga, enne kui eeldad, et liides on välja lülitatud.
Määra laadijatele ja LMC-le püsiv IP (või DHCP reserveering) oma ruuteris. Ruuteri poolt määratud aadressi muutumine on rikkunud ka koormushalduse sidet mitme laadijaga objektidel.
Kontrolli, et seade on samas alamvõrgus kui masin, mis teda pärib, ja pea meeles kuni 3 samaaegse ühenduse piirangut.
Turvamärkus
Modbusi liidesel ei ole autentimist. Kasuta seda ainult kohalikus, turvalises võrgus.
Kogukonna integratsioonid ja partneri API
VOOLi seadmete jaoks on olemas kolmandate osapoolte Home Assistanti integratsioone. Neid ei ole loonud ega halda VOOL ja mõned neist ei tööta LMC-ga ilma kohandamiseta. Küsimustega kogukonna integratsiooni kohta pöördu selle autori poole.
Modbus ja OCPP on dokumenteeritud integreerimisteed. Partneri- või arendaja-API küsimustega kirjuta aadressile [email protected], nummerdades oma küsimused, ja me suuname need edasi.