OpenEMS Modbus-API (grid)
Die OpenEMS Modbus-API ist eine Softwareschnittstelle des OpenEMS Edge Energiemanagementsystems. Als Netzzählpunkt-Komponente konfiguriert, stellt sie Echtzeitdaten über Modbus TCP auf Port 502 bereit. Diese Modbus-Vorlage liest zwei Kanäle: die momentane Netzwirkleistung an Adresse 315 sowie die kumulierte Netzenergie an Adresse 359, jeweils als Gleitkommawerte aus dem OpenEMS _sum-Komponentenblock. Verbinden Sie den ModbusCloud Gateway mit dem Netzwerk Ihrer OpenEMS Edge-Installation und importieren Sie die Vorlage, um kontinuierliche Netzpunkttransparenz im ModbusCloud-Portal zu erhalten.
- 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 | |||
| energy | Wh | 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
- Überwachen Sie die momentane Netzbezugs- und Einspeiseleistung, um das Eigenverbrauchsverhältnis PV-gekoppelter Anlagen zu prüfen.
- Verfolgen Sie die kumulierte Netzenergie über Abrechnungsperioden, um Zählerstände des Netzbetreibers zu verifizieren.
- Setzen Sie Alarme bei anhaltendem Netzbezug oberhalb eines Schwellenwerts, um unerwartete Lastanstiege frühzeitig zu erkennen.
- Vergleichen Sie Netzleistungsverläufe vor und nach der Inbetriebnahme eines Batteriespeichers, um Spitzenlastreduzierung nachzuweisen.
- Erstellen Sie tägliche und monatliche Netzenergie-Berichte für Energieleistungsverträge oder Netzbetreiber-Meldungen.
Installation
Aktivieren Sie den Modbus-API Controller in der OpenEMS Edge-Konfiguration unter Apps oder Komponenten, und stellen Sie sicher, dass TCP-Port 502 konfiguriert und die _sum-Komponente exportiert ist.
Verbinden Sie den ModbusCloud Gateway mit demselben IP-Netzwerk wie das OpenEMS Edge-Gerät, und stellen Sie sicher, dass Port 502 durch keine Firewall oder Router-ACL blockiert wird.
Fügen Sie in Ihrem ModbusCloud-Portal den Gateway hinzu, importieren Sie die Vorlage OpenEMS Modbus-API (grid), und setzen Sie die Modbus-Unit-ID auf 1, die Standard-Slave-Adresse des OpenEMS Modbus-API Controllers.
Prüfen Sie Register 315 in der Live-Registeransicht des Portals: ein float32-Wert im Bereich der erwarteten Netzwirkleistung Ihrer Anlage bestätigt eine korrekte Verbindung.
Zu beachten
Der Gateway verbindet sich, aber beide Register liefern keinen Wert. Was nun?
Prüfen Sie, ob der Modbus-API Controller in OpenEMS Edge aktiv ist und die _sum-Komponente in der Exportkonfiguration enthalten ist. Ist der Controller deaktiviert oder die Komponente nicht exportiert, existiert der Adressblock mit den Registern 315 und 359 nicht, und jede Leseanfrage gibt eine Exception zurück.
Register 315 liefert einen plausiblen Wert, Register 359 bleibt null oder NaN.
Adresse 359 ist ein float64, der vier aufeinanderfolgende Holding-Register belegt (FC3). Einige Modbus-Master lesen standardmäßig nur zwei Register pro Adresse. Stellen Sie sicher, dass die ModbusCloud-Vorlage den Typ float64 verwendet, damit der Gateway alle vier Register in einer einzigen Transaktion anfordert. Eine unvollständige Lesung erzeugt einen ungültigen Wert.
Ich erhalte eine Verbindungsabweisung auf Port 502. Wie behebe ich das?
Der OpenEMS Edge Modbus-API Controller muss aktiv und an die Netzwerkschnittstelle des Edge-Geräts gebunden sein. Prüfen Sie, ob der Controller in der OpenEMS-Konfiguration aktiviert ist, Port 502 durch keine lokale Firewall blockiert wird, und ob Sie die korrekte IP-Adresse des Edge-Hosts verwenden und nicht eine NAT- oder Gateway-Adresse.
Nach einem OpenEMS Edge Firmware-Update sind meine Registerwerte verschoben oder verschwunden.
Die OpenEMS Modbus-API generiert eine dynamische Registertabelle abhängig von den konfigurierten Komponenten. Ein Firmware-Update oder eine Komponentenänderung kann Block-Offsets verschieben. Laden Sie das System-Profile-Excel erneut über die OpenEMS UI herunter, um zu bestätigen, dass Adressen 315 und 359 in Ihrer aktualisierten Installation weiterhin den erwarteten Netzleistungs- und Energiekanälen entsprechen.
Weitere OpenEMS-Vorlagen
Selbst sehen, wie es funktioniert?
