Dokumentáció

a cFos Charging Manager olvasása és vezérlése Modbuson keresztül

A HTTP és az MQTT mellett a cFos Charging Manager Modbus API-t is biztosít. Ezt a SunSpec után modellezték. A Charging Manager konfigurációjában a "SunSpec címbeállítások" alatt megadhat egy TCP port vagy COM port paramétert és egy Modbus azonosítót. Ennek hatására a cFos Charging Manager a megadott paraméterek szerinti TCP-portot vagy COM-portot, valamint a Modbus ID-t és a Modbus ID + 1-t hallgatja. A Modbus ID alatt az általános Charging Manager értékek, paraméterek, flagek és változók állnak rendelkezésre. A Charging Managerben beállított eszközök (wallboxok és mérők) az ID + 1 alatt kérdezhetők le. Modbus funkcióként a 3 és 4 olvasáshoz, a 6 és 16 pedig íráshoz használható. Figyelem: Raspberry-n az 1024 alatti TCP portok az admin jogokkal rendelkező programok számára vannak fenntartva. Ezért jobb, ha magasabb portszámot választ, pl. 1502-t.

A SunSpec Modbus specifikáció szerint a Modbus címtartomány "SunS" azonosítóval kezdődik, majd az úgynevezett SunSpec modelleket tartalmazza. Minden modellnek van egy modellazonosító száma a 0. eltolásnál, és a modellhez tartozó többi regiszter hosszának meghatározása az 1. eltolásnál. A modell értékei ezután a 2. eltolástól következnek. Fontos: A SunSpec címtartományt át kell pásztázni, és az 1. offsetnél mindig meg kell becsülni a hosszat. Ne feltételezzen fix hosszúságot vagy fix regisztercímeket, mivel nagyon valószínű, hogy idővel további értékeket fogunk hozzáadni a modellekhez. Az 1. modell (Common) mindig az első helyen szerepel, a gyártó, a verziószámok stb. részleteivel. Részletes információkért kérjük, töltse le a SunSpec Modbus specifikációkat a SunSpec Alliance-tól. A SunSpec címtartománya a cFos Charging Manager számára a 40000-as címmel kezdődik.

A cFos Charging Manager kezdetben a Common modell után a Modbus ID alatt a következő értékeket jeleníti meg Model 213 (háromfázisú mérő, float) néven:
Hálózati fogyasztás
Fogyasztók összesen
Generátorok összesen
PV többlet
Kihasznált faliszekrényteljesítmény
Rendelkezésre álló faliszekrényteljesítmény
Hibateljesítmény

Ezt követi a 60000-as "egyéni" modell a cFos Charging Manager beállítási paramétereivel: a modell és a hossz után jelenleg 8 float-érték következik: Maximális teljes áram, tartalék, túlhúzás, maximális teljes faliszekrényáram fázisonként mA-ben, maximális fázisegyenetlenség (mA-ben), terheléskezelés aktív (1 = aktív, 0 = inaktív), egyenetlenség a fogyasztókkal együtt (1 = aktív, 0 = inaktív), terheléskezelés aktív (1 = aktív, 0 = inaktív), terheléskezelés inaktív (1 = aktív, 0 = inaktív), terhelésegyenetlenség a fogyasztókkal együtt (1 = aktív, 0 = inaktív). Terhelés (1 = aktív, 0 = inaktív), maximális teljes áram százalékban. Ezek a globális Charging Manager paraméterek, amelyek a felhasználói felületen is beállíthatók. Ezen értékek módosításai (legfeljebb 150 másodperces késleltetéssel) elmentésre kerülnek. A százalékban kifejezett teljes áram például a töltési teljesítmény dinamikus módosítására használható a hálózatüzemeltető kérésére.

Ezt követi az "egyéni" 60001-es modell. 32 regiszter (16 bites) követi a modellt és a hosszúságot. Ezek 0 és 1 értékeket tartalmazhatnak, és legfeljebb 32 töltéskezelői jelzőt olvashatnak vagy írhatnak. Ezeknek a zászlóknak az állapota aztán a CM._flag1-től CM._flag32-ig lekérdezhető képletekben, és számításokhoz felhasználható.

Ezt követi az "egyéni" 60002-es modell, majd a modell és a hossz után a lehetséges töltéskezelő változók. Minden változóhoz 22 regiszter áll rendelkezésre. Az első 20 regiszter egy Modbus karakterlánc a változó nevéhez (a túl hosszú nevek le lesznek vágva). A következő 2 regiszter a változó aktuális lebegőértékét tartalmazza. Ha egy Charging Manager változó float-értékét írja be, akkor törli a meglévő képleteket, és a változót fix értékre állítja.

A Modbus ID + 1 alatt a Charging Managerben beállított mérők és fali dobozok a következőképpen jelennek meg. Wallboxok cseréje SunSpec 113-as modellként, 2 16 bites regiszterrel bővítve. A 62-es offset tartalmazza a wallbox állapotát (1=várakozás, 2=csatlakoztatva, 3=töltés, 4=töltés szellőzéssel, 5=hiba), a 63-as offset pedig az eszköz azonosítóját. 1 = E1, 2 = E2 stb. A számlálók a 213-as modell 2 16 bites regiszterrel kibővítve jelennek meg. A 126-os offset tartalmazza a mérő szerepét (0=kijelző, 1=fogyasztás, 2=termelés, 3=hálózati fogyasztás, 4=elektromos autó fogyasztása, 5=tárolás otthon, 6=tárolás minden), a 127-es offset tartalmazza a készülék azonosítóját (-1 az M1 esetében, -2 az M2 esetében stb.). Ha a mérő tárolóeszköz (5. vagy 6. szerepkör), a 213-as modell után a 124-es modell következik, amely egy 16 bites regiszterrel bővül. 26-os offset ismét az eszköz azonosítóját tartalmazza. A Modbus ID + 1 alatti eszközök megjelenítéséhez aktiválni kell a "Publish device information via Modbus" (eszközinformációk közzététele Modbuson keresztül) opciót az eszköz beállításaiban.

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.

Az értékek listája a 213-as modellhez:
Offset 0: 213
Offset 1: Hosszúság
Offset 2: Összes áram L1-L3 (A)
Offset 4: Áram L1 (A)
Offset 6: Áram L2 (A)
Offset 8: Áram L3 (A)
Offset 10: Feszültség (V)
Offset 12: Feszültség L1 (V)
Offset 14: Feszültség L2 (V)
Offset 16: Feszültség L3 (V)
Offset 26: 50 Hz
Offset 28: teljesítmény (W)
Offset 30: teljesítmény L1 (W)
Offset 32: teljesítmény L2 (W)
Offset 34: teljesítmény L3 (W)
Offset 36:
Offset 38: L1 látszólagos teljesítmény (VA)
Offset 40: L2 látszólagos teljesítmény (VA)
Offset 42: L3 látszólagos teljesítmény (VA)
Offset 44: Reaktív teljesítmény (VAr)
Offset 60: Export, aktív teljesítmény (Wh)
Offset 68: Import, aktív teljesítmény (Wh)
Offset 126: Szerep (Modbus ID + 1)
Offset 127: Készülék azonosító (Modbus ID + 1)

A 113-as modell értéklistája:
Offset 0: 113
Offset 1: Hosszúság
Offset 2: Összes áram L1-L3 (A)
Offset 4: Áram L1 (A)
Offset 6: Áram L2 (A)
Offset 8: Áram L3 (A)
Offset 16: Feszültség L1 (V)
Offset 18: Feszültség L2 (V)
Offset 20: Feszültség L3 (V)
Offset 22: Teljesítmény (W)
Offset 24: 50 Hz
Offset 26: Látszólagos teljesítmény (VA)
Offset 32: Import, aktív teljesítmény (Wh)
Offset 62: Állapot (Modbus ID + 1 esetén)
Offset 63: Készülék azonosító (Modbus ID + 1 esetén)

A 124-es modell értéklistája:
Offset 0: 124
Offset 1: Hossz
Offset 2: Töltési/kisütési maximális teljesítmény (W)
Offset 3: Az aktuális töltési teljesítményhatár százalékos aránya
Offset 4: Az aktuális kisütési teljesítményhatár százalékos aránya
Offset 8: A töltés állapota százalékban
Offset 18: A 2. offsethez tartozó skálázási tényező
Offset 19: Skálázási tényező a 3. és 4. offsethez
26. offset: Készülékazonosító (Modbus ID + 1 esetén)

Értéklista a 60000-as modellhez:
Minden érték float, olvasási/írási hozzáférés, a flash frissítését okozza, azaz a károsodás elkerülése érdekében ne változtassa gyakran.azaz ne változtassa meg gyakran, hogy elkerülje a károkat.
Offset 0: 60000 (unt16, csak olvasható)
Offset 1: Length (uint16, csak olvasható)
Offset 2: Max. Teljes áram (mA)
Offset 4: Teljesítménytartalék (mA)
Offset 6: Túlhúzás (mA)
Offset 8: Max. teljes Wallbox áram (mA)
Offset 10: Max. Fázisegyensúlytalanság (mA)
12. offset 12: 1 = terheléskezelés aktív, 0 = inaktív
14. offset 14: 1 = otthoni fogyasztás hozzáadása az egyensúlytalansághoz, 0 = inaktív
16. offset 16: a max. teljes áram százalékos aránya, nem kerül elmentésre, gyakran változtatható.

Értéklista a 60001-es modellhez:
Minden érték 0 vagy 1, int16, írható/olvasható, nem kerül mentésre, gyakran módosítható.
Offset 0: 60001 (uint16, csak olvasható)
Offset 1: Length (uint16, csak olvasható)
Offset 2: CM._flag1
...
33-as eltolás: CM._flag32

60002-es modell értéklistája:
Minden érték lebegő, írható/olvasható, nem tárolódik, gyakran módosítható. Offset 0: 60002 (uint16, csak olvasható)
Offset 1: Length (uint16, csak olvasható)
Offset 2..22: Name Charging Manager Variable 1
Offset 23..24: Value Charging Manager Variable 1
Offset 25..45: Name Charging Manager Variable 2
Offset 46..47: Value Charging Manager Variable 2
...