Dokumentation

læs og styr cFos Charging Manager via Modbus

Ud over HTTP og MQTT tilbyder cFos Charging Manager også en Modbus API. Dette er modelleret efter SunSpec. Du kan angive en TCP-port eller COM-port-parameter og et Modbus-ID under "SunSpec-adresseindstillinger" i Charging Manager-konfigurationen. Dette får cFos Charging Manager til at lytte til TCP-porten eller COM-porten under de angivne parametre og til Modbus ID og Modbus ID + 1. Generelle Charging Manager-værdier, parametre, flag og variabler er tilgængelige under Modbus ID. Enheder, der er konfigureret i Charging Manager (wallboxe og målere), kan forespørges under ID + 1. Som Modbus-funktion kan du bruge 3 og 4 til læsning og 6 og 16 til skrivning. OBS: På Raspberry er TCP-porte under 1024 reserveret til programmer med administratorrettigheder. Det er derfor bedre at vælge et højere portnummer, f.eks. 1502.

SunSpec Modbus-specifikationen angiver, at Modbus-adresseområdet begynder med en identifikator "SunS" og derefter indeholder såkaldte SunSpec-modeller. Hver model har et modelidentifikationsnummer ved offset 0 og en længdespecifikation af de resterende registre, der hører til modellen, ved offset 1. Modellens værdier følger derefter fra offset 2. Vigtigt: Du bør scanne SunSpec-adresseområdet og altid estimere længden ved offset 1. Antag ikke faste længder eller faste registeradresser, da det er meget sandsynligt, at vi vil tilføje yderligere værdier til modellerne over tid. Model 1 (Common) kommer altid først, med oplysninger om producent, versionsnumre osv. Du kan downloade SunSpec Modbus-specifikationerne fra SunSpec Alliance for at få detaljerede oplysninger. SunSpec-adresseområdet for cFos Charging Manager starter med adresse 40000.

cFos Charging Manager viser i første omgang følgende værdier som Model 213 (trefaset måler, float) under Modbus ID efter Common-modellen:
Grid consumption
Total consumers
Total generators
PV surplus
Utilised wallbox power
Available wallbox power
Fault power

Herefter følger "custom" model 60000 med indstillingsparametre for cFos Charging Manager: 8 float-værdier følger i øjeblikket efter model og længde: Maximum total current, reserve, overdraw, maximum total wallbox current in mA per phase, maximum phase imbalance (in mA), load management active (1 = active, 0 = inactive), imbalance incl. consumers (1 = active, 0 = inactive), load management active (1 = active, 0 = inactive), load management inactive (1 = active, 0 = inactive), load imbalance incl. consumers (1 = active, 0 = inactive). Belastning (1 = aktiv, 0 = inaktiv), maksimal total strøm i procent. Dette er de globale Charging Manager-parametre, som også kan indstilles i brugergrænsefladen. Ændringer af disse værdier gemmes (med en maksimal forsinkelse på 150 sekunder). Den samlede strøm i procent kan f.eks. bruges til dynamisk at justere opladningseffekten efter anmodning fra netoperatøren.

Herefter følger "custom" model 60001. 32 registre (16bit) følger efter model og længde. De kan indeholde værdierne 0 og 1 og læse eller skrive op til 32 Charging Manager-flag. Status for disse flag kan derefter forespørges i formler ved hjælp af CM._flag1 til CM._flag32 og bruges til beregninger.

Dette efterfølges af "custom" model 60002, efterfulgt af mulige Charging Manager-variabler efter model og længde. Der er 22 registre til rådighed for hver variabel. De første 20 registre er en Modbus-streng til variabelnavnet (navne, der er for lange, afkortes). De følgende 2 registre indeholder den aktuelle float-værdi for variablen. Hvis du skriver float-værdien for en Charging Manager-variabel, sletter du alle eksisterende formler og indstiller variablen til en fast værdi.

Under Modbus ID + 1 vises målere og wallboxe, der er sat op i Charging Manager, som følger. Wallboxe udveksles som SunSpec model 113 udvidet med 2 16 bit registre. Offset 62 indeholder wallboxens status (1=venter, 2=tilsluttet, 3=oplader, 4=oplader med ventilation, 5=fejl), og offset 63 indeholder enhedens ID. 1 = E1, 2 = E2 osv. Tællere vises med model 213 udvidet med 2 16 bit registre. Offset 126 indeholder målerens rolle (0=display, 1=forbrug, 2=generation, 3=netforbrug, 4=elbilforbrug, 5=lager hjemme, 6=lager alle), offset 127 indeholder enhedens ID (-1 for M1, -2 for M2, osv.). Hvis måleren er en lagerenhed (rolle 5 eller 6), efterfølges model 213 af model 124, som er udvidet med et 16-bit register. Offset 26 indeholder igen enhedens ID. For at vise enheder under Modbus ID + 1 skal du aktivere "Publicer enhedsinformation via Modbus" i enhedens indstillinger.

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.

Liste over værdier for model 213:
Offset 0: 213
Offset 1: Længde
Offset 2: Samlede strømme L1-L3 (A)
Offset 4: Strøm L1 (A)
Offset 6: Strøm L2 (A)
Offset 8: Strøm L3 (A)
Offset 10: Spænding (V)
Offset 12: Spænding L1 (V)
Offset 14: Spænding L2 (V)
Offset 16: Spænding 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: Tilsyneladende effekt (VA)
Offset 38: Tilsyneladende effekt L1 (VA)
Offset 40: Tilsyneladende effekt L2 (VA)
Offset 42: Tilsyneladende effekt L3 (VA)
Offset 44: Reaktiv effekt (VAr)
Offset 60: Eksport, aktiv effekt (Wh)
Offset 68: Import, aktiv effekt (Wh)
Offset 126: Role (for Modbus ID + 1)
Offset 127: Device ID (for Modbus ID + 1)

Liste over værdier for model 113:
Offset 0: 113
Offset 1: Length
Offset 2: Total currents L1-L3 (A)
Offset 4: Strøm L1 (A)
Offset 6: Strøm L2 (A)
Offset 8: Strøm L3 (A)
Offset 16: Spænding L1 (V)
Offset 18: Spænding L2 (V)
Offset 20: Spænding L3 (V)
Offset 22: Effekt (W)
Offset 24: 50 Hz
Offset 26: Tilsyneladende effekt (VA)
Offset 32: Import, aktiv effekt (Wh)
Offset 62: Status (for Modbus ID + 1)
Offset 63: Enheds-ID (for Modbus ID + 1)

Liste over værdier for model 124:
Offset 0: 124
Offset 1: Længde
Offset 2: Maks. opladnings-/afladningseffekt (W)
Offset 3: Procent af nuværende opladningseffektgrænse
Offset 4: Procent af nuværende afladningseffektgrænse
Offset 8: Opladningstilstand i procent
Offset 18: Skaleringsfaktor for offset 2
Offset 19: Skaleringsfaktor for offset 3 og 4
Offset 26: Device ID (for Modbus ID + 1)

Liste over værdier for model 60000:
Alle værdier i float, read/write access, får flash til at blive opdateret, dvs. ikke ændre ofte for at undgå skader.dvs. skal ikke ændres ofte for at undgå skader.
Offset 0: 60000 (unt16, read-only)
Offset 1: Length (uint16, read-only)
Offset 2: Max. Total current (mA)
Offset 4: Power Reserve (mA)
Offset 6: Overdraw (mA)
Offset 8: Max Wallbox total current (mA)
Offset 10: Max. Faseubalance (mA)
Offset 12: 1 = Belastningsstyring aktiv, 0 = inaktiv
Offset 14: 1 = Tilføj hjemmeforbrug til ubalance, 0 = inaktiv
Offset 16: Procent af maks. total strøm, gemmes ikke, kan ændres ofte.

Liste over værdier for model 60001:
Alle værdier 0 eller 1, int16, read/write access, gemmes ikke, kan ændres ofte.
Offset 0: 60001 (uint16, skrivebeskyttet)
Offset 1: Length (uint16, skrivebeskyttet)
Offset 2: CM._flag1
...
Offset 33: CM._flag32

Liste over værdier for model 60002:
Alle værdier float, read/write access, gemmes ikke, kan ændres ofte. Offset 0: 60002 (uint16, skrivebeskyttet)
Offset 1: Længde (uint16, skrivebeskyttet)
Offset 2..22: Navn Charging Manager Variabel 1
Offset 23..24: Værdi Charging Manager Variabel 1
Offset 25..45: Navn Charging Manager Variabel 2
Offset 46..47: Værdi Charging Manager Variabel 2
...