OpenEMS Modbus-API (battery)
Die OpenEMS Modbus-API ist die integrierte Modbus-TCP-Slave-Schnittstelle von OpenEMS Edge, einem Open-Source-Energiemanagementsystem, das in Wohn- und Gewerbeanlagen mit Batteriespeicher eingesetzt wird. Der Modbus-API Controller erzeugt eine dynamische Registertabelle, die interne OpenEMS-Kanaele ueber TCP-Port 502 bereitstellt. Diese Battery-Vorlage liest zwei Kernwerte aus dem _sum-Komponenten-Block: den Ladezustand an Register 302 und die aktive Leistung an Register 415. Verbinden Sie den ModbusCloud Gateway mit demselben Netzwerk wie den OpenEMS Edge-Host und importieren Sie die Vorlage, um das Batteriespeicher-Verhalten direkt zu verfolgen.
- Protokoll
- Modbus TCP
- Anschluss
- Ethernet, Modbus TCP
- Register
- 2, nur lesen
- Marke
- OpenEMS
- Kompatible Modelle
- Modbus-API
- Zuletzt aktualisiert
Register (2)
2 lesen, 0 schreiben
| Name | Einheit | Zugriff | Adresse (Verborgen bis zur Eingabe Ihrer E-Mail-Adresse) | Funktion (verborgen) | Typ (verborgen) |
|---|---|---|---|---|---|
| power | W | Lesen | |||
| soc | % | Lesen |
Register werden geladen…
Senden Sie Ihre Geräteliste
Steht ein Gerät noch nicht in der Bibliothek, erstellen wir die Vorlage kostenlos, sobald wir die Register haben.
Anwendungsfälle
- Ueberwachen Sie den Ladezustand des Batteriespeichers kontinuierlich, um ungewoehnliche Selbstentladung zwischen Ladezyklen zu erkennen.
- Verfolgen Sie die aktive Leistung an Register 415, um zu pruefen, ob der Speicher planmassig laedt oder entlaedt.
- Konfigurieren Sie eine Warnung, wenn der Ladezustand waehrend der Nachtentladung einen Schwellenwert unterschreitet.
- Vergleichen Sie Leistungswerte mehrerer OpenEMS Edge-Standorte in der ModbusCloud-Mehranlagen-Uebersicht.
- Pruefen Sie, ob die Batterieleistung nach einem geplanten Ladefenster auf null zurueckkehrt, um das Regelungsverhalten zu bestaetigen.
Installation
Aktivieren Sie den Modbus-API Controller in Ihrer OpenEMS Edge-Instanz: Oeffnen Sie die Apache Felix Web Console, fuegen Sie die Komponente Controller.Api.ModbusTcp.ReadWrite oder Controller.Api.ModbusTcp.ReadOnly hinzu und bestaetigen Sie den Betrieb auf TCP-Port 502.
Verbinden Sie den ModbusCloud Gateway mit demselben LAN-Segment wie den OpenEMS Edge-Host und stellen Sie sicher, dass keine Firewall-Regel Port 502 zwischen Gateway und Edge sperrt.
Fuegen Sie im ModbusCloud-Portal den Gateway hinzu, importieren Sie die Vorlage OpenEMS Modbus-API (battery) und stellen Sie die Modbus-Unit-ID auf die in Ihrer Edge-Instanz konfigurierte Slave-ID ein (Standard: 1).
Pruefen Sie die Verbindung, indem Sie Register 302 (soc) in der Live-Ansicht des Portals ablesen: Der Wert muss mit dem Ladezustand im OpenEMS UI-Dashboard uebereinstimmen.
Zu beachten
Warum liefert Register 302 stets null oder keinen Wert?
Register 302 ist dem Kanal _sum/EssSoc zugeordnet und wird nur befuellt, wenn in OpenEMS Edge mindestens eine aktive ESS-Komponente vorhanden ist. Ohne konfigurierte und laufende Batteriekomponente bleibt der Kanal undefiniert und die Modbus-API gibt null zurueck. Pruefen Sie in der Apache Felix Web Console, ob eine ESS-Komponente den Status RUNNING hat.
Der Gateway verbindet sich auf Port 502, aber es erscheinen keine Werte. Was ist zu tun?
Pruefen Sie, ob der Modbus-API Controller in OpenEMS Edge den Status RUNNING hat und nicht nur konfiguriert ist. Pruefen Sie ausserdem die Unit-ID: Die Standard-Modbus-Slave-ID von OpenEMS ist 1. Wurde Ihre Edge-Instanz neu konfiguriert, kann die Slave-ID abweichen. Bestaetigen Sie dies in der Controller-Konfiguration der Felix Web Console.
Warum wird Register 415 als NaN oder unplausibler Float-Wert angezeigt?
Register 415 verwendet den Typ float32, der zwei aufeinanderfolgende 16-Bit-Register belegt. Liest Ihr Client nur ein einzelnes Registerwort aus, wird der Float falsch dekodiert. Stellen Sie sicher, dass die ModbusCloud-Vorlage korrekt angewendet wurde und kein weiterer Modbus-Master gleichzeitig dieselbe Adresse abfragt, da dies den Zwei-Register-Lesevorgang verfaelschen kann.
Die Registertabelle meiner Edge-Instanz weicht von dieser Vorlage ab. Warum?
Die OpenEMS Modbus-API erzeugt eine dynamische Registertabelle basierend auf den exportierten Komponenten. Die Adressen in dieser Vorlage (302 fuer soc, 415 fuer power) entsprechen dem Standard-_sum-Komponentenblock. Werden in Ihrer Edge-Konfiguration zusaetzliche oder andere Komponenten exportiert, koennen sich Registeradressen verschieben. Laden Sie die anlagenspezifische Registertabelle ueber das OpenEMS UI unter Systemprofil herunter, um dies zu pruefen.
Weitere OpenEMS-Vorlagen
Selbst sehen, wie es funktioniert?
