Dokumentation

läsa och styra cFos Charging Manager via Modbus

Förutom HTTP och MQTT tillhandahåller cFos Charging Manager även ett Modbus API. Detta är modellerat efter SunSpec. Du kan ange en TCP-port eller COM-portparameter och ett Modbus-ID under "SunSpec-adressinställningar" i laddningshanterarens konfiguration. Detta får cFos Charging Manager att lyssna på TCP-porten eller COM-porten under de angivna parametrarna och på Modbus ID och Modbus ID + 1. Allmänna Charging Manager-värden, parametrar, flaggor och variabler är tillgängliga under Modbus ID. Enheter som konfigurerats i Charging Manager (wallboxar och mätare) kan förfrågas under ID + 1. Som Modbus-funktion kan du använda 3 och 4 för läsning och 6 och 16 för skrivning. OBS: På Raspberry är TCP-portar under 1024 reserverade för program med administratörsrättigheter. Det är därför bättre att välja ett högre portnummer, t.ex. 1502.

Enligt SunSpec Modbus-specifikationen börjar Modbus adressområde med en identifierare "SunS" och innehåller sedan s.k. SunSpec-modeller. Varje modell har ett modellidentifikationsnummer vid offset 0 och en längdspecifikation för de återstående register som tillhör modellen vid offset 1. Modellens värden följer sedan från offset 2. Viktigt: Du bör skanna SunSpec-adressområdet och alltid uppskatta längden vid offset 1. Utgå inte från fasta längder eller fasta registeradresser, eftersom det är mycket troligt att vi kommer att lägga till ytterligare värden i modellerna med tiden. Modell 1 (Common) kommer alltid först, med uppgifter om tillverkare, versionsnummer etc. Ladda ner SunSpec Modbus-specifikationerna från SunSpec Alliance för detaljerad information. SunSpec-adressområdet för cFos Charging Manager börjar med adress 40000.

cFos Charging Manager visar initialt följande värden som modell 213 (trefasmätare, flytande) under Modbus ID efter den gemensamma modellen:
Grid consumption
Total consumers
Total generators
PV surplus
Utilised wallbox power
Available wallbox power
Fault power

Därefter följer "custom" modell 60000 med inställningsparametrar för cFos Charging Manager: 8 float-värden följer för närvarande efter modell och längd: Maximum total current, reserve, overdraw, maximum total wallbox current in mA per phase, maximum phase obbalance (in mA), load management active (1 = active, 0 = inactive), obalance incl. consumers (1 = active, 0 = inactive), load management active (1 = active, 0 = inactive), load management inactive (1 = active, 0 = inactive), load obalance incl. consumers (1 = active, 0 = inactive). Last (1 = aktiv, 0 = inaktiv), maximal total ström i procent. Detta är de globala Charging Manager-parametrarna som också kan ställas in i användargränssnittet. Ändringar av dessa värden sparas (med en maximal fördröjning på 150 sekunder). Den totala strömmen i procent kan till exempel användas för att dynamiskt justera laddningseffekten på begäran av nätoperatören.

Därefter följer "custom" modell 60001. 32 register (16bit) följer modell och längd. Dessa kan innehålla värdena 0 och 1 och läsa eller skriva upp till 32 Charging Manager-flaggor. Statusen för dessa flaggor kan sedan efterfrågas i formler som använder CM._flag1 till CM._flag32 och användas för beräkningar.

Detta följs av "anpassad" modell 60002, följt av möjliga Charging Manager-variabler efter modell och längd. Det finns 22 register tillgängliga för varje variabel. De första 20 registren är en Modbus-sträng för variabelnamnet (namn som är för långa trunkeras). De följande 2 registren innehåller variabelns aktuella floatvärde. Om du skriver float-värdet för en Charging Manager-variabel raderar du alla befintliga formler och ställer in variabeln till ett fast värde.

Under Modbus ID + 1 visas mätare och wallboxar som är konfigurerade i Charging Manager på följande sätt. Wallboxar utbytta som SunSpec modell 113 utökade med 2 st 16 bitars register. Offset 62 innehåller wallboxens status (1=väntar, 2=inkopplad, 3=laddar, 4=laddar med ventilation, 5=fel) och offset 63 innehåller enhetens ID. 1 = E1, 2 = E2 osv. Räknare visas med modell 213 utökad med 2 st 16 bitars register. Offset 126 innehåller mätarens roll (0=display, 1=förbrukning, 2=generering, 3=nätförbrukning, 4=elbilsförbrukning, 5=lagring hem, 6=lagring alla), offset 127 innehåller enhetens ID (-1 för M1, -2 för M2, etc.). Om mätaren är en lagringsenhet (roll 5 eller 6), följs modell 213 av modell 124, som utökas med ett 16-bitars register. Offset 26 innehåller återigen enhetens ID. För att visa enheter under Modbus ID + 1 måste du aktivera "Publicera enhetsinformation via Modbus" i enhetsinställningarna.

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.

Lista över värden för modell 213:
Offset 0: 213
Offset 1: Längd
Offset 2: Totala strömmar L1-L3 (A)
Offset 4: Ström L1 (A)
Offset 6: Ström L2 (A)
Offset 8: Ström L3 (A)
Offset 10: Spänning (V)
Offset 12: Spänning L1 (V)
Offset 14: Spänning L2 (V)
Offset 16: Spänning L3 (V)
Offset 26: 50 Hz
Offset 28: Effekt (W)
Offset 30: Effekt L1 (W)
Offset 32: Effekt L2 (W)
Offset 34: Effekt L3 (W)
Offset 36: Skenbar effekt (VA)
Offset 38: Skenbar effekt L1 (VA)
Offset 40: Skenbar effekt L2 (VA)
Offset 42: Skenbar effekt L3 (VA)
Offset 44: Reaktiv effekt (VAr)
Offset 60: Export, aktiv effekt (Wh)
Offset 68: Import, aktiv effekt (Wh)
Offset 126: Roll (för Modbus ID + 1)
Offset 127: Device ID (för Modbus ID + 1)

Lista över värden för modell 113:
Offset 0: 113
Offset 1: Längd
Offset 2: Totala strömmar L1-L3 (A)
Offset 4: Ström L1 (A)
Offset 6: Ström L2 (A)
Offset 8: Ström L3 (A)
Offset 16: Spänning L1 (V)
Offset 18: Spänning L2 (V)
Offset 20: Spänning L3 (V)
Offset 22: Effekt (W)
Offset 24: 50 Hz
Offset 26: Skenbar effekt (VA)
Offset 32: Import, aktiv effekt (Wh)
Offset 62: Status (för Modbus ID + 1)
Offset 63: Enhets-ID (för Modbus ID + 1)

Lista över värden för modell 124:
Offset 0: 124
Offset 1: Längd
Offset 2: Max. laddnings-/urladdningseffekt (W)
Offset 3: Procent av aktuell laddningseffektgräns
Offset 4: Procent av aktuell urladdningseffektgräns
Offset 8: Laddningsstatus i procent
Offset 18: Skalningsfaktor för offset 2
Offset 19: Skalningsfaktor för offset 3 och 4
Offset 26: Device ID (för Modbus ID + 1)

Lista över värden för modell 60000:
Alla värden i float, read/write access, gör att flash uppdateras, dvs. ändra inte ofta för att undvika skador.d.v.s. ändra inte ofta för att undvika skador.
Offset 0: 60000 (unt16, skrivskyddad)
Offset 1: Längd (uint16, skrivskyddad)
Offset 2: Max. Total ström (mA)
Offset 4: Effektreserv (mA)
Offset 6: Överuttag (mA)
Offset 8: Max Wallbox total ström (mA)
Offset 10: Max. Fasobalans (mA)
Offset 12: 1 = Laststyrning aktiv, 0 = inaktiv
Offset 14: 1 = Lägg till hemförbrukning till obalansen, 0 = inaktiv
Offset 16: Procent av max. totalström, sparas inte, kan ändras ofta.

Värdelista för modell 60001:
Alla värden 0 eller 1, int16, skriv-/läsbehörighet, sparas inte, kan ändras ofta.
Offset 0: 60001 (uint16, skrivskyddad)
Offset 1: Length (uint16, skrivskyddad)
Offset 2: CM._flag1
...
Offset 33: CM._flag32

Lista över värden för modell 60002:
Alla värden float, read/write access, sparas inte, kan ändras ofta. Offset 0: 60002 (uint16, skrivskyddad)
Offset 1: Length (uint16, skrivskyddad)
Offset 2..22: Namn Charging Manager Variabel 1
Offset 23..24: Värde Charging Manager Variabel 1
Offset 25..45: Namn Charging Manager Variabel 2
Offset 46..47: Värde Charging Manager Variabel 2
...