Modbus/TCP - Lese-/Schreibzugriff
Über Modbus/TCP können andere Geräte in Ihrem Netzwerk die Werte Ihres SOLIO direkt abfragen, zum Beispiel eine Gebäudeleittechnik, eine Steuerung oder ein Visualisierungssystem. Mit dem Schreibzugriff kann ein externes System außerdem vorgeben, wie stark Ihr Speicher lädt oder entlädt.
Diese Seite richtet sich an Installateure, Elektrofachkräfte und Systemintegratoren. Als Hausbesitzer brauchen Sie die Schnittstelle in der Regel nicht.
Wofür brauche ich das?
Modbus/TCP ist ein weit verbreiteter Standard, mit dem Geräte im lokalen Netzwerk Daten austauschen. Typische Einsätze:
- Eine Gebäudeleittechnik oder SPS zeigt Ladezustand, Netzbezug und Erzeugung an oder wertet sie aus.
- Ein übergeordnetes Energiemanagement oder ein Direktvermarkter gibt die Lade- und Entladeleistung des Speichers vor.
- Ein eigenes Visualisierungs- oder Smart-Home-System liest die Werte regelmäßig aus.
Werte auslesen. Gehört zum Standardumfang.
Lade- und Entladeleistung vorgeben. Wird bei Bedarf freigeschaltet.
Die vollständige Tabelle Ihrer Anlage als Excel-Datei.
Voraussetzungen
- Das zugreifende Gerät, zum Beispiel ein PC oder eine Steuerung, ist im selben Netzwerk wie das SOLIO und erreicht dessen IP-Adresse direkt.
- Sie kennen die IP-Adresse des SOLIO, zum Beispiel aus der Geräteliste Ihres Routers.
- Gleichzeitig sind bis zu fünf Verbindungen möglich.
Modbus/TCP kennt keine Anmeldung. Jedes Gerät, das Ihr SOLIO im Netzwerk erreicht, kann die Werte lesen und bei freigeschaltetem Schreibzugriff auch Vorgaben senden. Geben Sie den Port 502 deshalb nie ins Internet frei.
Lesezugriff
Der Lesezugriff gehört zum Standardumfang. Im App Center ist dafür die App Modbus/TCP lesend installiert.
| Parameter | Wert |
|---|---|
| Geräteadresse | IP-Adresse des SOLIO, z. B. 192.168.178.30 |
| Port | 502 |
| Unit-ID | 1 |
| Function Codes | 03 (Read Holding Registers), 04 (Read Input Registers) |
| Adressierung | Basisadresse 0 |
| Byte-Reihenfolge | Big Endian |
Standardmäßig stellt die Schnittstelle die Summenwerte der Anlage bereit (Komponente _sum). Weitere Komponenten, zum Beispiel einzelne Speicher oder Zähler, können projektbezogen freigegeben werden.
Registertabelle herunterladen
Die Register hängen davon ab, welche Komponenten freigegeben sind. Die passende Tabelle für Ihre Anlage erhalten Sie direkt aus dem Portal:
Öffnen Sie im Menü Profil → Systemeinstellungen und klicken Sie bei Anlagenprofil auf Öffnen.
Scrollen Sie zur Liste der Komponenten bis zum Eintrag der Modbus/TCP-Schnittstelle.
Klicken Sie auf Protokoll Herunterladen. Sie erhalten eine Excel-Datei mit allen Registern.
Wichtige Register (Auszug)
Die folgende Tabelle zeigt die wichtigsten Summenwerte. Maßgeblich ist immer die Tabelle Ihrer Anlage.
| Adresse | Name | Typ | Beschreibung | Einheit |
|---|---|---|---|---|
| 0 | Hash of „OpenEMS“ | uint16 | Kennung 0x6201 | |
| 2–4 | OpenEMS Version Major/Minor/Patch | uint16 | Softwareversion | |
| 5 | Manufacturer | string16 | Hersteller | |
| 200 | Component-ID | string16 | _sum | |
| 222 | _sum/State | enum16 | 0: Ok, 1: Info, 2: Warning, 3: Fault | |
| 302 | _sum/EssSoc | uint16 | Ladezustand des Speichers | % |
| 303 | _sum/EssActivePower | float32 | Speicherleistung AC, negativ = Laden, positiv = Entladen | W |
| 315 | _sum/GridActivePower | float32 | Netzleistung, negativ = Einspeisung, positiv = Bezug | W |
| 327 | _sum/ProductionActivePower | float32 | Gesamte Erzeugung | W |
| 331 | _sum/ProductionAcActivePower | float32 | Erzeugung AC | W |
| 339 | _sum/ProductionDcActualPower | float32 | Erzeugung DC | W |
| 343 | _sum/ConsumptionActivePower | float32 | Verbrauch | W |
| 351 | _sum/EssActiveChargeEnergy | float64 | Energie Speicherbeladung | Wh |
| 355 | _sum/EssActiveDischargeEnergy | float64 | Energie Speicherentladung | Wh |
| 359 | _sum/GridBuyActiveEnergy | float64 | Energie Netzbezug | Wh |
| 363 | _sum/GridSellActiveEnergy | float64 | Energie Netzeinspeisung | Wh |
| 367 | _sum/ProductionActiveEnergy | float64 | Energie Erzeugung | Wh |
| 379 | _sum/ConsumptionActiveEnergy | float64 | Energie Verbrauch | Wh |
| 391–395 | _sum/EssActivePowerL1 … L3 | float32 | Speicherleistung je Phase | W |
| 397–401 | _sum/GridActivePowerL1 … L3 | float32 | Netzleistung je Phase | W |
| 403–407 | _sum/ProductionAcActivePowerL1 … L3 | float32 | Erzeugung AC je Phase | W |
| 409–413 | _sum/ConsumptionActivePowerL1 … L3 | float32 | Verbrauch je Phase | W |
| 415 | _sum/EssDischargePower | float32 | Tatsächliche Entladeleistung AC, negativ = Laden | W |
| 417 | _sum/GridMode | enum16 | 1: On-Grid, 2: Off-Grid |
Ein float32 belegt zwei Register, ein float64 vier.
Beispiel: Ladezustand mit QModMaster lesen
Das kostenlose Programm QModMaster eignet sich gut für einen ersten Test. Gelesen wird der Ladezustand aus Register 302 (_sum/EssSoc, uint16).
QModMaster beginnt ab Werk bei Adresse 1. Stellen Sie die Base Address auf 0, sonst sind alle Adressen um eins verschoben.
Tragen Sie unter Modbus TCP Settings die IP-Adresse des SOLIO als Slave IP und 502 als TCP Port ein.
Wählen Sie als Function Code Read Input Registers (0x04), als Start Address 302 und bei Number of Registers 1. Klicken Sie auf Read/Write. Der Wert erscheint im unteren Bereich.
Zum Vergleich können Sie den Wert mit dem Ladezustand im Portal abgleichen.
Schreibzugriff
Mit dem Schreibzugriff kann ein externes System die Wirk- und Blindleistung des Speichers vorgeben. Er gehört nicht zum Standardumfang, kann aber jederzeit über die App Modbus/TCP Schreibzugriff freigeschaltet werden. Sprechen Sie uns dazu an.
| Parameter | Wert |
|---|---|
| Geräteadresse | IP-Adresse des SOLIO |
| Port | 502 |
| Unit-ID | 1 |
| Function Codes | 03, 04 (Lesen), 06 (Write Single Register), 16 (Write Multiple Registers) |
| Timeout | 60 Sekunden (Standard) |
Beschreibbare Register
Die Register gehören zum Block des Speichers (ess0). Die Adressen unten gelten für eine typische Anlage. Prüfen Sie sie in der Registertabelle Ihrer Anlage.
| Adresse | Name | Typ | Bedeutung | Einheit |
|---|---|---|---|---|
| 706 | ess0/SetActivePowerEquals | float32 | Vorgabe Wirkleistung | W |
| 708 | ess0/SetReactivePowerEquals | float32 | Vorgabe Blindleistung | var |
| 710 | ess0/SetActivePowerLessOrEquals | float32 | Vorgabe maximaler Entladeleistung | W |
| 712 | ess0/SetReactivePowerLessOrEquals | float32 | Vorgabe maximaler Blindleistung | var |
| 714 | ess0/SetActivePowerGreaterOrEquals | float32 | Vorgabe maximaler Beladeleistung | W |
| 716 | ess0/SetReactivePowerGreaterOrEquals | float32 | Vorgabe minimaler Blindleistung | var |
- Vorzeichen: Negative Werte laden den Speicher, positive Werte entladen ihn.
- Timeout: Eine Vorgabe gilt nur für die Dauer des Timeouts, standardmäßig 60 Sekunden. Senden Sie den Wert deshalb regelmäßig neu. Kommt keine neue Vorgabe, übernimmt wieder die normale Regelung.
- Tatsächlicher Wert: Die Grenzen des Speichers gelten weiter. Die tatsächliche Leistung kann deshalb von der Vorgabe abweichen.
Anzeige im Portal
Ist der Schreibzugriff eingerichtet, finden Sie im Menü unter Speichersystem einen eigenen Eintrag für die Schnittstelle. Er zeigt den Aktuellen Status (Externe Vorgabe wird berücksichtigt oder Keine externe Vorgabe vorhanden), die zuletzt geschriebene Vorgabe und den Tatsächlichen Wert. Über Protokoll Herunterladen erhalten Sie dort ebenfalls die Registertabelle.
Beispiel: Entladeleistung mit QModMaster vorgeben
Im Beispiel soll der Speicher mit 4.000 W entladen. Geschrieben wird ess0/SetActivePowerEquals in Register 706 (float32, zwei Register).
Base Address steht auf 0, Endian auf Big.
Wählen Sie als Function Code Write Multiple Registers (0x10), als Start Address 706, bei Number of Registers 2 und als Data Format Float. Tragen Sie 4000 ein und klicken Sie auf Read/Write.
Im Portal sehen Sie unter Speichersystem, dass der Speicher entlädt. Nach 60 Sekunden ohne neue Vorgabe endet sie.
