Dokumentasjon

les og kontroller cFos Charging Manager via Modbus

I tillegg til HTTP og MQTT tilbyr cFos Charging Manager også et Modbus API. Dette er modellert etter SunSpec. Du kan angi en TCP-port eller COM-portparameter og en Modbus-ID under "SunSpec-adresseinnstillinger" i Charging Manager-konfigurasjonen. Dette får cFos Charging Manager til å lytte til TCP-porten eller COM-porten under de angitte parametrene og til Modbus ID og Modbus ID + 1. Generelle Charging Manager-verdier, parametere, flagg og variabler er tilgjengelige under Modbus ID. Enheter som er konfigurert i Charging Manager (Wallbox-ladestasjoner og målere) kan forespørres under ID + 1. Som Modbus-funksjon kan du bruke 3 og 4 for lesing og 6 og 16 for skriving. OBS: På Raspberry er TCP-porter under 1024 forbeholdt programmer med administratorrettigheter. Det er derfor bedre å velge et høyere portnummer, f.eks. 1502.

Ifølge SunSpec Modbus-spesifikasjonen begynner Modbus-adresseområdet med identifikatoren "SunS" og inneholder deretter såkalte SunSpec-modeller. Hver modell har et modellidentifikasjonsnummer ved offset 0 og en lengdespesifikasjon av de resterende registrene som tilhører modellen ved offset 1. Modellens verdier følger deretter fra offset 2. Viktig: Du bør skanne SunSpec-adresseområdet og alltid anslå lengden ved offset 1. Ikke anta faste lengder eller faste registeradresser, da det er svært sannsynlig at vi vil legge til flere verdier i modellene over tid. Modell 1 (Common) kommer alltid først, med opplysninger om produsent, versjonsnummer osv. Last ned SunSpec Modbus-spesifikasjonene fra SunSpec Alliance for detaljert informasjon. SunSpec-adresseområdet for cFos Charging Manager starter med adresse 40000.

cFos Charging Manager viser først følgende verdier som modell 213 (trefasemåler, float) under Modbus ID etter Common-modellen:
Grid consumption
Total consumers
Total generators
PV surplus
Utilised wallbox power
Available wallbox power
Fault power

Deretter følger "custom" modell 60000 med innstillingsparametere for cFos Charging Manager: 8 float-verdier følger for øyeblikket etter modell og lengde: 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). Last (1 = aktiv, 0 = inaktiv), maksimal total strøm i prosent. Dette er de globale Charging Manager-parametrene som også kan stilles inn i brukergrensesnittet. Endringer i disse verdiene lagres (med en maksimal forsinkelse på 150 sekunder). Den totale strømmen i prosent kan for eksempel brukes til dynamisk justering av ladeeffekten på forespørsel fra nettoperatøren.

Deretter følger "custom" modell 60001. 32 registre (16bit) følger etter modell og lengde. Disse kan inneholde verdiene 0 og 1 og lese eller skrive opptil 32 Charging Manager-flagg. Status for disse flaggene kan deretter spørres etter i formler ved hjelp av CM._flag1 til CM._flag32 og brukes til beregninger.

Deretter følger "tilpasset" modell 60002, etterfulgt av mulige Charging Manager-variabler etter modell og lengde. Det er 22 registre tilgjengelig for hver variabel. De første 20 registrene er en Modbus-streng for variabelnavnet (for lange navn avkortes). De følgende 2 registrene inneholder variabelens gjeldende flyteverdi. Hvis du skriver float-verdien til en Charging Manager-variabel, sletter du alle eksisterende formler og setter variabelen til en fast verdi.

Under Modbus ID + 1 vises målere og Wallbox-ladestasjoner som er konfigurert i Charging Manager på følgende måte. Wallbox-ladestasjoner utveksles som SunSpec-modell 113 utvidet med 2 16-bits registre. Offset 62 inneholder Wallbox-ladestasjonens status (1=venter, 2=tilkoblet, 3=lader, 4=lader med ventilasjon, 5=feil) og offset 63 inneholder enhetens ID. 1 = E1, 2 = E2 osv. Tellerne vises med modell 213 utvidet med 2 16-bits registre. Offset 126 inneholder målerens rolle (0=visning, 1=forbruk, 2=generering, 3=nettforbruk, 4=elbilforbruk, 5=lagring hjemme, 6=lagring alle), offset 127 inneholder enhets-ID (-1 for M1, -2 for M2 osv.). Hvis måleren er en lagringsenhet (rolle 5 eller 6), etterfølges modell 213 av modell 124, som er utvidet med et 16-bits register. Offset 26 inneholder igjen enhets-ID-en. Hvis du vil vise enheter under Modbus ID + 1, må du aktivere "Publiser enhetsinformasjon via Modbus" i enhetsinnstillingene.

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 verdier for modell 213:
Offset 0: 213
Offset 1: Lengde
Offset 2: Total strøm L1-L3 (A)
Offset 4: Strøm L1 (A)
Offset 6: Strøm L2 (A)
Offset 8: Strøm L3 (A)
Offset 10: Spenning (V)
Offset 12: Spenning L1 (V)
Offset 14: Spenning L2 (V)
Offset 16: Spenning 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: Tilsynelatende effekt (VA)
Offset 38: Tilsynelatende effekt L1 (VA)
Offset 40: Tilsynelatende effekt L2 (VA)
Offset 42: Tilsynelatende 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 verdier for modell 113:
Offset 0: 113
Offset 1: Length
Offset 2: Total current L1-L3 (A)
Offset 4: Strøm L1 (A)
Offset 6: Strøm L2 (A)
Offset 8: Strøm L3 (A)
Offset 16: Spenning L1 (V)
Offset 18: Spenning L2 (V)
Offset 20: Spenning L3 (V)
Offset 22: Effekt (W)
Offset 24: 50 Hz
Offset 26: Tilsynelatende effekt (VA)
Offset 32: Import, aktiv effekt (Wh)
Offset 62: Status (for Modbus ID + 1)
Offset 63: Device ID (for Modbus ID + 1)

Liste over verdier for modell 124:
Offset 0: 124
Offset 1: Lengde
Offset 2: Maks. lade-/utladningseffekt (W)
Offset 3: Prosent av gjeldende ladeeffektgrense
Offset 4: Prosent av gjeldende utladningseffektgrense
Offset 8: Ladetilstand i prosent
Offset 18: Skaleringsfaktor for offset 2
Offset 19: Skaleringsfaktor for offset 3 og 4
Offset 26: Device ID (for Modbus ID + 1)

Liste over verdier for modell 60000:
Alle verdier i float, lese/skrive-tilgang, fører til oppdatering av flash, dvs. ikke endre ofte for å unngå skader.dvs. ikke endre ofte for å unngå skader.
Offset 0: 60000 (uint16, skrivebeskyttet)
Offset 1: Length (uint16, skrivebeskyttet)
Offset 2: Max. Total strøm (mA)
Offset 4: Power Reserve (mA)
Offset 6: Overdraw (mA)
Offset 8: Max Wallbox total strøm (mA)
Offset 10: Max. Faseubalanse (mA)
Offset 12: 1 = Laststyring aktiv, 0 = inaktiv
Offset 14: 1 = Legg til eget forbruk i ubalansen, 0 = inaktiv
Offset 16: Prosent av maks. total strøm, lagres ikke, kan endres ofte.

Liste over verdier for modell 60001:
Alle verdier 0 eller 1, int16, lese/skrive-tilgang, lagres ikke, kan endres ofte.
Offset 0: 60001 (uint16, skrivebeskyttet)
Offset 1: Length (uint16, skrivebeskyttet)
Offset 2: CM._flag1
...
Offset 33: CM._flag32

Liste over verdier for modell 60002:
Alle verdier flyter, lese/skrive-tilgang, lagres ikke, kan endres ofte. Offset 0: 60002 (uint16, skrivebeskyttet)
Offset 1: Length (uint16, skrivebeskyttet)
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
...