Skip to content

Latest commit

 

History

History
115 lines (98 loc) · 14.2 KB

modbus-de.md

File metadata and controls

115 lines (98 loc) · 14.2 KB

Deutsch • English

Modbus

Die go-eCharger bieten ein Modbus TCP Interface an, mit dem einige Leistungs- und Energiewerte abgefragt werden können. Dieses Interface muss erst über die App oder http API aktiviert werden. Daten gelesen werden können über die Modbus Funktion 3 und die Modbus Funktion 4. Daten können über die Modbus Funktion 16 geschrieben werden. Nach Aktivierung kann der TCP Port 502 verwendet werden.

Funktion Nr Name Unterstützt?
01 Read Coil Status Nein
02 Read Input Status Nein
03 Read Holding Registers Ja, für alle Register unten aufgelistet
04 Read Input Registers Ja, für alle Register unten aufgelistet
05 Force Single Coil Nein
06 Preset Single Register Nein
15 Force Multiple Coils Nein
16 Preset Multiple Registers Ja, für alle Register unten aufgelistet

Über die App das Modbus Interface aktivieren und prüfen

Unten im Tab "Internet", dann "Erweiterte Einstelluingen" im Menü anwählen, dann relativ weit unten bei Modbus

Über die http API das Modbus interface aktivieren und prüfen

Die Chargers verfügen über API Keys zum Konfigurieren und Prüfen des Modbus interface. Diese API Keys können mit der http api verwendet werden.

Beispiel: http://192.168.0.77/api/set?men=true

api key Beschreibung Datentyp R?W? Kategorie
men modbus slave aktiviert bool R/W Config
msp modbus slave port (erfordert Neustart) uint16 R/W Config
msb modbus slave Bytes vertauschen bool R/W Config
msr modbus slave Register vertauschen bool R/W Config
mro modbus slave Lese-Operationen size_t R Status
mwo modbus slave Schreib-Operationen size_t R Status

Modbus Profil

Holding Registers (read/write)

Daten in dieser Tabelle können mit der Modbus Funktion 03 gelesen und mit der Modbus Funktion 16 geschrieben werden.

Register (wire-format) Bezeichnung Register Typ Datentyp Länge Beschreibung
40201 (200) ALLOW Holding Register uint16_t 1 allow_charging: PWM Signal darf
anliegen
0: nein
1: ja
40202 (201) ACCESS_STATE Holding Register uint16_t 1 access_state: Zugangskontrolle.
0: Offen
1: RFID / App benötigt
2: Strompreis / automatisch
3: Scheduler
40205 (204) CABLE_LOCK_MODE Holding Register uint16_t 1 Kabelverriegelung Einstellung
0: Verriegeln solange Auto angesteckt
1: Nach Ladevorgang automatisch
entriegeln
2: Kabel immer verriegelt lassen
40207 (206) LED_BRIGHTNESS Holding Register uint16_t 1 LED Helligkeit von 0-255
0: LED aus
255: LED Helligkeit maxima
40208 (207) LED_SAVE_ENERGY Holding Register uint16_t 1 led_save_energy: LED automatisch
nach 10 Sekunden abschalten
0: Energiesparfunktion deaktiviert
1: Energiesparfunktion aktiviert
40209 (208) ELECTRICITY_PRICES_HOURS Holding Register uint16_t 1 Minimale ​Anzahl ​von Stunden in der
mit "Strompreis - automatisch" geladen
werden muss
Beispiel: 2 ("Auto ist nach 2 Stundenvoll genug")
40210 (209) ELECTRICITY_PRICES_FINISHED Holding Register uint16_t 1 Stunde (​Uhrzeit​) in der mit "Strompreis
- automatisch" die Ladung mindestens
aho ​Stunden gedauert haben muss.
Beispiel: 7 ("Fertig bis 7:00, also davor
mindestens 2 Stunden geladen")
40211 (210) ELECTRICITY_PRICES_ZONE Holding Register uint16_t 1 Awattar Preiszone
0: Österreich
1: Deutschland
40212 (211) AMPERE_MAX Holding Register uint16_t 1 Absolute max. Ampere: Maximalwert
für Ampere Einstellung
Beispiel: 20 (Einstellung auf mehr als
20A in der App nicht möglich)
40213 (212) AMPERE_L1 Holding Register uint16_t 1 Ampere Level 1 für Druckknopf am
Gerät.
6-32: Ampere Stufe aktiviert
0: Stufe deaktivert (wird übersprungen)
40214 (213) AMPERE_L2 Holding Register uint16_t 1 Ampere Level 2 für Druckknopf am
Gerät.
6-32: Ampere Stufe aktiviert
0: Stufe deaktivert (wird übersprungen)
40215 (214) AMPERE_L3 Holding Register uint16_t 1 Ampere Level 3 für Druckknopf am
Gerät.
6-32: Ampere Stufe aktiviert
0: Stufe deaktivert (wird übersprungen)
40216 (215) AMPERE_L4 Holding Register uint16_t 1 Ampere Level 4 für Druckknopf am
Gerät.
6-32: Ampere Stufe aktiviert
0: Stufe deaktivert (wird übersprungen)
40217 (216) AMPERE_L5 Holding Register uint16_t 1 Ampere Level 5 für Druckknopf am
Gerät.
6-32: Ampere Stufe aktiviert
0: Stufe deaktivert (wird übersprungen)
40218 (217) CLOUD_DISABLED Holding Register uint16_t 1 Cloud disabled
0: cloud enabled
1: cloud disabled
40219 (218) NORWAY_MODE Holding Register uint16_t 1 Norwegen-Modus​ aktiviert
0: deaktiviert (Erdungserkennung
aktiviert)
1: aktiviert (keine Erdungserkennung,
nur für IT-Netze gedacht)
40300 (299) AMPERE_VOLATILE Holding Register uint16_t 1 Ampere Wert für die PWM
Signalisierung in ganzen Ampere von
6-32A

Wird nicht im EEPROM gespeichert
und wird beim nächsten Bootvorgang
auf den zuletzt im EEPROM
gespeicherten Wert ​zurückgesetzt​.
Für Energieregelung
40301 (300) AMPERE_EEPROM Holding Register uint16_t 1 Ampere Wert für die PWM
Signalisierung in ganzen Ampere von
6-32A

Wird im EEPROM ​gespeichert ​(max.
Schreibzyklen ca. 100.000)
40333 (332) PHASE_SWITCH_MODE Holding Register uint16_t 1 Selbe wie api key psm, akzeptiert nur 0, 1, 2 (Seit Firmware 55.5)
40334 (333)
40335 (334)
40336 (335)
40337 (336)
ENERGY_LIMIT Holding Register float (64) 4 Selbe wie api key dwo, auf float Inf setzen, um "null" Limit auszudrücken (Limit deaktiviert), oder jede andere float Zahl in Wattstunden (Wh) (Seit Firmware 55.5)
40338 (337) FORCE_STATE Holding Register uint16_t 1 Selbe wie api key frc, akzeptiert nur 0, 1, 2 (Seit Firmware 55.6)

Input Registers (read-only)

Daten in dieser Tabelle können mit der Modbus Funktion 04 gelesen werden.

Register(wire-format) Bezeichnung Register Typ Datentyp Länge Beschreibung
30101 (100) CAR_STATE Input Register uint16_t 1 Status PWM Signalisierung
0: unbekannt, Ladestation defekt
1: Ladestation bereit, kein Fahrzeug
2: Fahrzeug lädt
3: Warte auf Fahrzeug
4: Ladung beendet, Fahrzeug noch
verbunden
30102 (101) PP_CABLE Input Register uint16_t 1 Typ2 Kabel Ampere codierung
13-32: Ampere Codierung
0: kein Kabel
30106 (105)
30107 (106)
FWV Input Register ascii (4 byte) 2 Firmware Version als ASCII
30108 (107) ERROR Input Register uint16_t 1 error:
1: RCCB (Fehlerstromschutzschalter)
3: PHASE (Phasenstörung)
8: NO_GROUND (Erdungserkennung)
10, default: INTERNAL (sonstiges)
30109 (108)
30110 (109)
VOLT_L1 Input Register uint32_t 2 Spannung auf L1 in Volt
30111 (110)
30112 (111)
VOLT_L2 Input Register uint32_t 2 Spannung auf L2 in Volt
112
113
VOLT_L3 Input Register uint32_t 2 Spannung auf L3 in Volt
114
115
AMP_L1 Input Register uint32_t 2 Ampere auf L1 in 0.1A (123 entspricht 12, 3A)
116
117
AMP_L2 Input Register uint32_t 2 Ampere auf L2 in 0.1A (123 entspricht 12, 3A)
118
119
AMP_L3 Input Register uint32_t 2 Ampere auf L3 in 0.1A (123 entspricht 12, 3A)
120
121
POWER_TOTAL Input Register uint32_t 2 Leistung gesamt in 0.01W (360000 entspricht 3,6kW)
128
129
ENERGY_TOTAL Input Register uint32_t 2 Gesamt geladene Energiemenge in 0.1kWh (360 entspricht 36kWh)
132
133
ENERGY_CHARGE Input Register uint32_t 2 Geladene Energiemenge in
Deka-Watt-Sekunden
Beispiel:100’000 bedeutet, 1’000’000
Ws (=277Wh = 0, 277kWh) wurden in
diesem Ladevorgang geladen.
144
145
VOLT_N Input Register uint32_t 2 Spannung auf N in Volt
146
147
POWER_L1 Input Register uint32_t 2 Leistung auf L1 in 0.1kW (36 entspricht 3, 6kW)
148
149
POWER_L2 Input Register uint32_t 2 Leistung auf L2 in 0.1kW (36 entspricht 3, 6kW)
150
151
POWER_L3 Input Register uint32_t 2 Leistung auf L3 in 0.1kW (36 entspricht 3, 6kW)
152
153
POWER_FACTOR_L1 Input Register uint32_t 2 Leistungsfaktor auf L1 in %
154
155
POWER_FACTOR_L2 Input Register uint32_t 2 Leistungsfaktor auf L2 in %
156
157
POWER_FACTOR_L3 Input Register uint32_t 2 Leistungsfaktor auf L3 in %
158
159
POWER_FACTOR_N Input Register uint32_t 2 Leistungsfaktor auf N in %
202 ADAPTER_INPUT Input Register uint16_t 1 adapter_in: Ladebox ist mit Adapter
angesteckt
0: NO_ADAPTER
1: 16A_ADAPTER
203 UNLOCKED_BY Input Register uint16_t 1 Nummer der RFID Karte, die den
jetzigen Ladevorgang freigeschalten
hat
205 PHASES Input Register uint16_t 1 Phasen vor und nach dem Schütz
binary flags: 0b00ABCDEF
A... phase 3, vor dem Schütz
B... phase 2 vor dem Schütz
C... phase 1 vor dem Schütz
D... phase 3 nach dem Schütz
E... phase 2 nach dem Schütz
F... phase 1 nach dem Schütz
pha 0b00001000: Phase 1 ist
vorhanden
pha 0b00111000: Phase1-3 ist
vorhanden
301
302
303
MAC Input Register unsigned integer (48) 3 MAC Adresse der WLAN Station, binär
304
305
306
307
308
309
SNR Input Register ascii (12 byte) 6 Seriennummer des go-eCharger, als
ASCII
310
311
312
313
314
HOSTNAME Input Register ascii (10 byte) 6 Hostname des go-eCharger, als ASCII
315
316
317
318
IP Input Register ascii (8 byte) 4 IP Adresse des go-eCharger, 1 Bytepro Register
319
320
321
322
SUBNET Input Register unsigned integer (64) 4 Subnetzmaske des go-eCharger, 1
Byte pro Register
323
324
325
326
GATEWAY Input Register ascii (4 byte) 4 Gateway des go-eCharger, 1 Byte proRegister
30328 (327)
30329 (328)
30330 (329)
30331 (330)
30332 (331)
RFID_CARD Input Register binary (10 byte) 5 Zuletzt hingehaltene RFID Seriennummer, 4-byte und 7-byte lange Nummern werden mit Nullen am Ende aufgefüllt, 10-byte lange Nummern füllen die 5 modbus register sowieso schon (Seit Firmware 55.5)
30333 (332)
30334 (333)
30335 (334)
30336 (335)
ENERGY_CARD0 Input Register double 4 Energie aufgebucht auf RFID Karte 1 (in W)
30337 (336)
30338 (337)
30339 (338)
30340 (339)
ENERGY_CARD1 Input Register double 4 Energie aufgebucht auf RFID Karte 2 (in W)
30341 (340)
30342 (341)
30343 (342)
30344 (343)
ENERGY_CARD2 Input Register double 4 Energie aufgebucht auf RFID Karte 3 (in W)
30345 (344)
30346 (345)
30347 (346)
30348 (347)
ENERGY_CARD3 Input Register double 4 Energie aufgebucht auf RFID Karte 4 (in W)
30349 (348)
30350 (349)
30351 (350)
30352 (351)
ENERGY_CARD4 Input Register double 4 Energie aufgebucht auf RFID Karte 5 (in W)
30353 (352)
30354 (353)
30355 (354)
30356 (355)
ENERGY_CARD5 Input Register double 4 Energie aufgebucht auf RFID Karte 6 (in W)
30357 (356)
30358 (357)
30359 (358)
30360 (359)
ENERGY_CARD6 Input Register double 4 Energie aufgebucht auf RFID Karte 7 (in W)
30361 (360)
30362 (361)
30363 (362)
30364 (363)
ENERGY_CARD7 Input Register double 4 Energie aufgebucht auf RFID Karte 8 (in W)
30365 (364)
30366 (365)
30367 (366)
30368 (367)
ENERGY_CARD8 Input Register double 4 Energie aufgebucht auf RFID Karte 9 (in W)
30369 (368)
30370 (369)
30371 (370)
30372 (371)
ENERGY_CARD9 Input Register double 4 Energie aufgebucht auf RFID Karte 10 (in W)