[Modul] Goodwe

Modul für Goodwe für IP-Symcon

Dieses Modul ermöglicht, Daten von einem Goodwe Wechselricher mit/ohne Batterie und/oder einer Goodwe Wallbox abzufragen.

Unterstützt sind folgende Komponenten: Goodwe Wechselrichter (ET Plus+ 10kW). Andere Goodwe-Wechselrichter (insbesondere alle der Serie ET, EH, BH, BT) dürften ebenfalls kompatibel sein, da diese gemäss Doku über dieselben Register angesprochen werden. Goodwe Batterie (Lynx Home F Plus). Andere mit dem Wechslerichter kompatible Batterien dürften ebenfalls kompatibel sein, da diese über den Wechslerichter abgefragt werden. Goodwe Wallbox der 1. Generation (HCA-Serie) wird über die SEMS-API unterstützt, da diese kein Modbus beherrscht. Die Wallbox der 2. Generation (HCA-Serie G2)ist angekündigt ca. Mai 2025 und beherrscht dann Modbus und Phasenumschaltung. Falls ich diese anschaffe wird diese dann ebenfalls unterstützt sein.

Wichtig zu wissen zur Konfiguration des Moduls

Die Verbindung mit dem Goode Wechselrichter der ET-, EH-, BH-, oder BT-Serie wird über Modbus hergestellt. Die Register können nach Wunsch aus einer Liste via Konfigurationsformular ausgewählt werden. Es sind nicht alle möglichen Register in der Auswahl vorhanden. Gerne erweitere ich aber die Auswahl bei Bedarf. Die Verbindung mit der Goodwe Wallbox GW11K-HCA (1. Generation) wird über die SEMS-API hergestellt. Dazu werden die Zugangsdaten des SEMS-Portal und die Seriennummer der Goodwe Wallbox benötigt. Diese kann in der SEMS-APP in der Wallboxsteuerung nachgesehen werden. Während der Installation des Moduls wird automatisch ein Modbus-Gateway erstellt, sofern noch keines vorhanden ist. Besteht bereteits ein Gateway, kann dieses ausgewählt werden. Die Geräte-ID des Wechselrichters ist 247. Danach kann die IP-Adresse des Wechselrichters in den Client Socket eingetragen werden. Der Port ist standardmässig 502, sofern der Wechselrichter über das LAN-Modul direkt abgefragt wird. Ansonsten den Port des Modbus-Adapters verwenden, welcher dann über RS485 mit dem Wechselrichter verbunden ist.

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Software-Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. WebFront
  7. PHP-Befehlsreferenz
  8. Versionen

1. Funktionsumfang

  • Abfrage und Ansteuerung ausgewählter Register des Wechselrichters, gruppiert nach Smartmeter (SM), Batterie (BAT) und Wechselrichter (WR). Die Steuerung von SOC online/offline und EMS Power Mode ist möglich.
  • Abfrage und Steuerung der Wallbox. Die Steuerung der Ladeleistung (für Schnellladung), des Modus (Schnell, PV-Priorität oder PV&Batterie) ist möglich.

2. Voraussetzungen

  • IP-Symcon ab Version 7.0
  • Goodwe Wechselrichter der ET-, EH-, BH-, oder BT-Serie mit/ohne Batterie und/oder eine Goodwe Wallbox GW11K-HCA.

3. Software-Installation

  • Das Modul kann über den Modul-Store installiert werden.

4. Einrichten der Instanzen in IP-Symcon

  • Unter ‚Instanz hinzufügen‘ kann das ‚Goodwe‘-Modul mithilfe des Schnellfilters gefunden werden.
  • Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen

Konfigurationsseite:

Name Beschreibung
Selected Registers Hier können die Register für die Modbus-Abfrage ausgewählt werden. Diese sind nach WR (Wechselrichter), BAT (Batterie) und SM (Smartmeter) gruppiert. Die Variablen werden automatisch erstellt oder gelöscht.
Intervall Intervall für die Abfrage der Modbus-Register. Standard ist 5 sek.
SEMS-API-Konfiguration Die Konfiguration ist nur bei vorhandener Goodwe-Wallbox erforderlich, da sich diese nicht über Modbus abfragen lässt. Der Timer ist hier Standardmässig auf 15 sec eingestellt. Die Wallbox Variablen (WB) werden automatisch nach der Eingabe der Zugangsdaten erstellt bzw. gelöscht. Vorsicht, nicht zu häufig abfragen, sonst blockiert die API.
Werte lesen Hiermit können alle aktvierten Datenpunkte abgefragt werden

5. Statusvariablen und Profile

Die Statusvariablen/Kategorien werden automatisch angelegt bzw. gelöscht, je nach Auswahl der Register im Konfigurationsformulars.

Steuervariablen

Aktuell sind folgende Ansteuerung möglich:

Wallbox:

  • WB - Ladevorgang (Starten oder Stoppen des Ladevorganges)
  • WB - Leistung Soll (Soll Leistung der Wallbox (4.2-11kW), nur relevant im Modus ‚Schnell‘)
  • WB - Modus Soll (Soll Modus der Wallbox (Schnell, PV-Rriorität, PV&Batterie))

Batterie/Wechselrichter:

  • BAT - Min SOC online (Minimaler SOC der Batterie bei vorhandener Stromnetz-Verbindung)
  • BAT - Min SOC offline (Minimaler SOC der Batterie bei nicht vorhandener Stromnetz-Verbindung)
  • BAT - EMSPowerMode (Modus des EnergieManagentSystems in Zusammenhang mit der Batterie (wenn du weist was du tust, der Modus ‚Auto‘ ist zu bevorzugen))
  • BAT - EMSPowerSet (zugehörige Leistung bei Auswahl eines anderen EMSPowerMode als ‚Auto‘ (max. 10000 Watt)).

Statusvariablen

Es werden Variablen je nach Wahl der Register erstellt. Bei Abwahl dieses Registers wird die Variable gelöscht. Die Variablen der Wallbox werden nach der Eingabe der Zugangsdaten zur SEMS-API automatisch erstellt. Beim löschen eines der Felder für die Zugangsdaten werden die die Variablen wieder gelöscht.

Profile

Name Typ
Goodwe.EMSPowerMode Integer
Goodwe.WB_State Integer
Goodwe.WB_Mode Integer
Goodwe.WB_Power_W Integer
Goodwe.Mode Integer
Goodwe.WB_Workstate Integer
Goodwe.Watt Integer
Goodwe.Percent Integer
Goodwe.WattEMS Integer

6. WebFront

Alle Variablen mit Aktion können aus der Visualisierung heraus gesteuert werden.

7. PHP-Befehlsreferenz

Befehl Beschreibung
Goodwe_FetchAll(12345); Alle Datenpunkte aktualisieren
Goodwe_FetchWallboxData(12345); Datenpunkte der Wallbox aktualisieren (Über SEMS-API)
Goodwe_FetchInverterData(12345); Datenpunkte des Wechselrichters akualisieren (Über Modbus)

8. Versionen

Version 2.3 (4.05.2025)

  • Ein Problem wurde behoben, welches die Ansteuerung durch den Energiemanager verhinderte.
  • Ein Problem mit dem doppelten setzen des Timers nach einem Modulupdate wurde behoben.
  • Wenn der Sollwert der Ladeleistung verändert wird, wird der Modus direkt auf ‚Schnell‘ gesetzt.

Version 2.2 (29.04.2025)

  • Die maximal freigegeben Leistung für Laden und Entladen des Speichers kann nun Variable ausgegeben werden. Dies wird vom Modul berechnet, da Goodwe keinen Datenpunkt dazu zur Verfügung stellt. Eventuell kann dieser Datenpunkt in Zukunft als Info für den Energiemanger genutzt werden.
  • Ein Fehler wurde behoben, dass nach einer Aktualisierung des Moduls die neuen Register nicht zur Auswahl standen.

Version 2.1 (25.03.2025)

  • Wallbox Soll- und Ist-Leistung wird nun in Watt angezeigt statt kW. Allenfalls müssen die beiden Variablen ‚WB - Leistung Soll‘ und ‚WB - Leistung ist‘ manuell gelöscht werden, sie werden dann automatisch wieder erstellt.

Version 2.0 (15.02.2025)

  • Neues Variablenprofil für die Regelung von EMSPowerSet (Leistungsvorgabe) auf 10000 Watt beschränkt.
  • EMSPowermode (Priorität der Energiequelle) auf alle möglichen Modis erweitert.
  • Version um die Store-Kompatibilität zu erlangen.
  • Doku angepasst
  • Einige interne Anpassungen

Version 1.3 (25.01.2025)

  • Register 35105 und 35109 war falsch konfiguriert und lieferte keinen Wert.

Version 1.2 (19.01.2025)

  • Eigenes Variablenprofil für Prozent auf 1% abgestuft
  • Interne Umbenennung einiger Funktionen und Timer
  • Doku angepasst

Version 1.1 (14.01.2025)

  • Steuerung von EMS-Power Mode (Netzladen der Batterie)
  • Steuerung von SOC online/offline (maximale Entladung der Batterie)
  • Fehlermeldung in Register Auswahlmenu behoben

Version 1.0 (12.01.2025)

  • Initiale Version

Hallo Stefan,

Vielen Dank für dein Modul, es hat sich bisher als sehr nützlich erwiesen.

Seit einige Wochen habe ich einen ET Plus+ 10kW auf Nord/West mit 14,5kWp und derzeit 5kWh Lynx-D.
Weiterhin eine Bestandsanlage mit 10kWp Süd/Ost und Danfoss Wechselrichter auf 70% hart limitiert, also max 7kW.

Ich habe jetzt den Effekt, dass das EMS vom Goodwe die PV Erzeugung drosselt wenn die Gesamtleistung ( Danfoss + Goodwe ) 10 kW erreicht und das System nicht im Auto Modus ist.

In SolarGo habe ich unter Erweiterte Einstellungen/Leistungsgrenze 16000 eingetragen ( 70% /7kW Danfoss + 60%/9kW GoodWe = 16kW).
Im Auto Modus funktionert das EMS dann einwandfrei und es wird erst bei Leistungsgrenze von 16kW die PV Erzeugung gedrossel, darüber spring die Batterie ein. bei dem Wetter heute konnte ich das mit mehren Werten nachvollziehen und gut testen.

Da ich morgens des Speicher gerne entladen möchte und um die Mittagszeit den leeren Speicher für die Spitzen nutzen möchte ( wenn der GoodWe über 10kW geht ) muss ich mehrfach am Tag den Betriebsmodus wechseln.

Meine Frage ?

Gibt es ModbusRegister welches hierfür zuständig ist ?

Grüße
Guido

Wenn ich richtig verstehe regelst du mit SolarGo, nicht nicht Symcon?
Relevant für die manuelle Steuerung des EMS sind Register 47511 (EMSPowerMode) und 47512 (EMSPowerSet)

Du findest hier alle Register gut beschrieben, wobei ich natürlich nur einen Bruchteil integriert habe, unter anderem eben diese oben erwähnten Register.
1703579717824-arm.745.esg2.et30.modbus.protocol.map.20221231…v1.pdf (848,3 KB)

Danke,
ich schaut in die Doku rein und Probieren ggf. ausserhalb deines Moduls welche Register in Frage kommen.

Ich habe nächste Woche Abnahme durch den Elektriker.
Für den wäre es mir lieb wenn der Wechserichter die Leistungsgrenzen regelt und ich mich später um die Optimierung und reduzierung dee Überschüsse kümmer. Für unseren Tesla und Panasonic WP läuft das seit einigen Jahren ganz gut.

Ich mag es allgemein wenn die Systeme auch ohne Symcon laufen.

Wie erwähnt dürften dass 47511 und 47512 sein, welche im Modul integriert sind.
Wenn du andere relevante Register findest kannst du mir dies auch gerne mitteilen, allenfalls integriere ich sie ins Modul.