Dokumentacija

branje in krmiljenje upravitelja polnjenja cFos Charging Manager prek Modbusa

Poleg HTTP in MQTT upravitelj polnjenja cFos Charging Manager ponuja tudi vmesnik Modbus API. Ta je zasnovan po modelu SunSpec. V konfiguraciji Charging Managerja lahko pod "SunSpec address settings" (Nastavitve naslova SunSpec) določite parameter vrat TCP ali vrat COM in identifikator Modbus. To povzroči, da program cFos Charging Manager posluša vrata TCP ali vrata COM pod določenimi parametri ter ID Modbus in ID Modbus + 1. Pod ID Modbus so na voljo splošne vrednosti, parametri, zastave in spremenljivke programa Charging Manager. Naprave, nastavljene v Charging Managerju (wallboxi in števci), je mogoče poizvedovati pod ID + 1. Kot funkcijo Modbus lahko uporabite 3 in 4 za branje ter 6 in 16 za pisanje. Pozor: Na Raspberryju so vrata TCP pod 1024 rezervirana za programe z administratorskimi pravicami. Zato je bolje izbrati višjo številko vrat, npr. 1502.

V specifikaciji SunSpec Modbus je navedeno, da se območje naslovov Modbus začne z identifikatorjem "SunS" in nato vsebuje tako imenovane modele SunSpec. Vsak model ima identifikacijsko številko modela na odmiku 0 in specifikacijo dolžine preostalih registrov, ki pripadajo modelu, na odmiku 1. Vrednosti modela nato sledijo od odmika 2. Pomembno: Preglejte naslovno območje SunSpec in vedno ocenite dolžino na odmiku 1. Ne predpostavljajte fiksnih dolžin ali fiksnih naslovov registrov, saj je zelo verjetno, da bomo sčasoma modelom dodali dodatne vrednosti. Model 1 (Common) je vedno na prvem mestu, s podatki o proizvajalcu, številkami različic itd. Za podrobne informacije prenesite specifikacije SunSpec Modbus iz združenja SunSpec Alliance. Naslovno območje SunSpec za upravitelja polnjenja cFos se začne z naslovom 40000.

Upravitelj polnjenja cFos na začetku prikaže naslednje vrednosti kot model 213 (trifazni števec, plavajoči) pod ID Modbus za modelom Common:
Poraba omrežja
Skupaj porabniki
Skupaj generatorji
Presežek fotovoltaike
Izkoriščena moč wallboxa
Razpoložljiva moč wallboxa
Napačna moč

Temu sledi "custom" model 60000 z nastavitvenimi parametri cFos Charging Manager: za modelom in dolžino trenutno sledi 8 plavajočih vrednosti: največji skupni tok, rezerva, prekoračitev, največji skupni tok wallboxa v mA po fazi, največje fazno neravnotežje (v mA), upravljanje obremenitve aktivno (1 = aktivno, 0 = neaktivno), neravnotežje vključno s porabniki (1 = aktivno, 0 = neaktivno), upravljanje obremenitve aktivno (1 = aktivno, 0 = neaktivno), upravljanje obremenitve neaktivno (1 = aktivno, 0 = neaktivno), neravnotežje obremenitve vključno s porabniki (1 = aktivno, 0 = neaktivno). Obremenitev (1 = aktivno, 0 = neaktivno), največji skupni tok v odstotkih. To so globalni parametri Charging Managerja, ki jih lahko nastavite tudi v uporabniškem vmesniku. Spremembe teh vrednosti se shranijo (z največ 150-sekundnim zamikom). Skupni tok v odstotkih se lahko na primer uporabi za dinamično prilagajanje polnilne moči na zahtevo upravljavca omrežja.

Temu sledi model "po meri" 60001. 32 registrov (16-bitnih) sledi modelu in dolžini. Ti lahko vsebujejo vrednosti 0 in 1 ter berejo ali zapisujejo do 32 zastavic upravitelja polnjenja. Stanje teh zastavic se lahko nato poizveduje v formulah z uporabo CM._flag1 do CM._flag32 in uporabi za izračune.

Temu sledi model "po meri" 60002, za modelom in dolžino pa možne spremenljivke Charging Managerja. Za vsako spremenljivko je na voljo 22 registrov. Prvih 20 registrov je niz Modbus za ime spremenljivke (predolga imena se skrajšajo). Naslednja dva registra vsebujeta trenutno vrednost spremenljivke. Če zapišete plavajočo vrednost spremenljivke Charging Manager, izbrišete vse obstoječe formule in spremenljivko nastavite na fiksno vrednost.

Pod Modbus ID + 1 so števci in stenske omarice, nastavljene v Charging Managerju, prikazani na naslednji način. Wallboxi se izmenjujejo kot model SunSpec 113, razširjen z dvema 16-bitnima registroma. Odmik 62 vsebuje stanje stenske škatle (1=čakanje, 2=priključen, 3=polni, 4=polni s prezračevanjem, 5=zmoti), odmik 63 pa vsebuje ID naprave. 1 = E1, 2 = E2 itd. Števci so prikazani z modelom 213, razširjenim z dvema 16-bitnima registroma. Odmik 126 vsebuje vlogo števca (0 = prikaz, 1 = poraba, 2 = proizvodnja, 3 = poraba na omrežju, 4 = poraba električnega avtomobila, 5 = shranjevanje doma, 6 = shranjevanje vseh), odmik 127 vsebuje ID naprave (-1 za M1, -2 za M2 itd.). Če je števec naprava za shranjevanje (vloga 5 ali 6), modelu 213 sledi model 124, ki je razširjen s 16-bitnim registrom. Odmik 26 ponovno vsebuje ID naprave. Če želite prikazati naprave pod Modbus ID + 1, morate v nastavitvah naprave aktivirati možnost "Publish device information via Modbus" (Objavljanje informacij o napravi prek Modbusa).

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

Seznam vrednosti za model 213:
Offset 0: 213
Offset 1: dolžina
Offset 2: skupni tokovi L1-L3 (A)
Offset 4: tok L1 (A)
Offset 6: tok L2 (A)
Offset 8: tok L3 (A)
Offset 10: napetost (V)
Offset 12: Napetost L1 (V)
Offset 14: Napetost L2 (V)
Offset 16: Napetost L3 (V)
Offset 26: 50 Hz
Offset 28: Moč (W)
Offset 30: Moč L1 (W)
Offset 32: Moč L2 (W)
Offset 34: Moč L3 (W)
Offset 36:
Odmik 38: navidezna moč L1 (VA)
Odmik 40: navidezna moč L2 (VA)
Odmik 42: navidezna moč L3 (VA)
Odmik 44: jalova moč (VAr)
Odmik 60: izvoz, aktivna moč (Wh)
Odmik 68: Uvoz, aktivna moč (Wh)
Offset 126: Vloga (za Modbus ID + 1)
Offset 127: ID naprave (za Modbus ID + 1)

Seznam vrednosti za model 113:
Offset 0: 113
Offset 1: dolžina
Offset 2: skupni tokovi L1-L3 (A)
Offset 4: Odmik 6: tok L1 (A)
Odmik 6: tok L2 (A)
Odmik 8: tok L3 (A)
Odmik 16: napetost L1 (V)
Odmik 18: napetost L2 (V)
Odmik 20: napetost L3 (V)
Odmik 22: moč (W)
Odmik 24: 50 Hz
Odmik 26: Navidezna moč (VA)
Offset 32: uvoz, aktivna moč (Wh)
Offset 62: stanje (za Modbus ID + 1)
Offset 63: ID naprave (za Modbus ID + 1)

Seznam vrednosti za model 124:
Offset 0: 124
Offset 1: dolžina
Offset 2: Največja moč polnjenja/razreševanja (W)
Offset 3: odstotek trenutne omejitve moči polnjenja
Offset 4: odstotek trenutne omejitve moči praznjenja
Offset 8: stanje polnjenja v odstotkih
Offset 18: faktor skaliranja za offset 2
Offset 19: Faktor skaliranja za odmik 3 in 4
Odmik 26: ID naprave (za Modbus ID + 1)

Seznam vrednosti za model 60000:
Vse vrednosti so v spremenljivki, dostop z branjem/pisanjem, povzroči posodobitev bliskovnega zapisa, tj. ne spreminjajte jih pogosto, da ne pride do poškodb.tj. ne spreminjajte pogosto, da se izognete poškodbam.
Odmik 0: 60000 (unt16, samo za branje)
Odmik 1: dolžina (uint16, samo za branje)
Odmik 2: max. Skupni tok (mA)
Offset 4: Rezerva moči (mA)
Offset 6: Presežek (mA)
Offset 8: Maks. skupni tok Wallboxa (mA)
Offset 10: Maks. Fazno neravnovesje (mA)
Offset 12: 1 = upravljanje obremenitve aktivno, 0 = neaktivno
Offset 14: 1 = dodajanje domače porabe k neravnovesju, 0 = neaktivno
Offset 16: odstotek največjega skupnega toka, ni shranjen, lahko se pogosto spreminja.

Seznam vrednosti za model 60001:
Vse vrednosti 0 ali 1, int16, dostop za branje/pisanje, niso shranjene, lahko se pogosto spreminjajo.
Odmik 0: 60001 (uint16, samo za branje)
Odmik 1: Dolžina (uint16, samo za branje)
Odmik 2: CM._flag1
...
Offset 33: CM._flag32

Seznam vrednosti za model 60002:
Vse vrednosti float, dostop za branje/pisanje, niso shranjene, lahko se pogosto spreminjajo. Offset 0: 60002 (uint16, samo za branje)
Offset 1: Length (uint16, samo za branje)
Offset 2..22: Ime Charging Manager Variable 1
Offset 23..24: Vrednost Charging Manager Variable 1
Offset 25..45: Ime Charging Manager Variable 2
Offset 46..47: Vrednost Charging Manager Variable 2
...