Der neue Monatsrückblick für Mai und Juni 2026 ist online!

[typhos]

Hallo zusammen,

der Adapter goodwe ist im latest-Repository verfügbar und ich würde mich über Tester und Feedback freuen.

Der Adapter liest GoodWe-Wechselrichter der Serien ET / EH / BH / BT lokal über das GoodWe-EMS-Modbus-Protokoll v1.7 (UDP, Port 8899) aus. Es wird keine Cloud und kein Herstellerkonto benötigt.

Der Adapter basiert auf der ursprünglichen Arbeit von Thomas Schönberger.

Eckdaten

Adapter	goodwe
Version	1.1.1
Repository	latest
Typ	energy
Anbindung	lokal, Polling per UDP (Port 8899)
Lizenz	MIT
GitHub	https://github.com/typhosj/ioBroker.goodwe
npm	https://www.npmjs.com/package/iobroker.goodwe

Voraussetzungen

• Node.js 22 oder neuer
• js-controller 6.0.11 oder neuer
• admin 7.8.23 oder neuer
• GoodWe-Wechselrichter der Serie ET, EH, BH oder BT, per LAN/WLAN im gleichen Netz erreichbar

Installation

Über die ioBroker-Admin-Oberfläche aus dem latest-Repository installieren.

Alternativ direkt von GitHub:

iobroker url https://github.com/typhosj/ioBroker.goodwe

Konfiguration

Auf der Basis-Seite reicht die IP-Adresse des Wechselrichters. Zusätzlich gibt es dort zwei Hilfsfunktionen:

• Validate inverter IP – prüft die eingetragene Adresse und schickt eine GoodWe-ID-Anfrage an UDP-Port 8899.
• Discover inverters – scannt ein konfigurierbares /24-Subnetz (z. B. 192.168.178.0/24) und listet gefundene Geräte mit IP, Modellname, Seriennummer und Version auf.

Auf der erweiterten Seite lassen sich Poll-Zyklus, UDP-Timeout (1000–30000 ms), Anzahl der Retries (0–5) sowie die optionalen Registergruppen einzeln zuschalten.

Was wird ausgelesen

• Geräteinformationen inkl. optionaler SIMCCID
• Laufzeitdaten: PV1–PV4, Netz L1–L3, Backup L1–L3, Batterie, Tages- und Gesamtenergiezähler
• Externe Kommunikations- und erweiterte Zählerdaten (Smart Meter)
• Flash-Informationen
• BMS-Informationen und BMS-Detaildaten
• CEI-Autotest-Daten
• Power-Limit- und Dispatch-Daten

Modus-Werte liegen als numerische States mit ioBroker-Enum-Beschriftung vor. Wichtige Bitfelder werden zusätzlich als Text-States dekodiert, z. B. aktive Wechselrichterfehler (RunningData.ErrorMessageActive), Diagnosestatus (RunningData.DiagStatusActive), BMS-Alarme (BMSInfo.ErrorCodeActive) und DRM-Status (BMSInfo.DRMStatusActive).

Eine vollständige Übersicht der State-Bereiche steht in der README.

Bekannte Einschränkungen

Die optionalen Registergruppen hängen von Modell, Firmware und angeschlossener Hardware ab. Wird eine Gruppe nicht unterstützt, überspringt der Adapter sie nach einem Timeout-Backoff und hält die Hauptverbindung online.

Modellabhängig sind vor allem:

• pollBmsDetail – oft nicht verfügbar, wenn das BMS keine Detailregister liefert
• pollPowerLimit – oft nicht verfügbar auf Geräten ohne Power-Limit-Telemetrie
• pollCeiAutoTest – nur auf Geräten/Firmware mit CEI-Autotest-Unterstützung

Zeigt das Log Timeouts für optionale Register, bitte die betroffene Gruppe in den erweiterten Einstellungen abschalten. Bei instabiler Netzwerkverbindung zuerst timeoutMs erhöhen, retries erst danach – Retries verlängern auch einen Poll-Zyklus.

Changelog

1.1.1 (2026-07-16)

• Adapter benötigt jetzt admin >= 7.8.23
• Admin-Konfigurationsseite überarbeitet und Übersetzungen ergänzt
• Admin-Bundle wird bei GitHub-Installationen nicht mehr neu gebaut
• CHANGELOG_OLD.md aus dem npm-Paket ausgeschlossen

1.1.0 (2026-06-24)

• Adapter-Laufzeit auf TypeScript migriert
• Mindestversion Node.js 22
• Zusätzliche *Text-Modus-States durch Enum-Beschriftungen an den numerischen States ersetzt

1.0.9 (2026-06-23)

• Validierung der Wechselrichter-IPv4-Adresse
• GoodWe-UDP-Erreichbarkeitsprüfung aus der Admin-Konfiguration
• /24-Netzwerk-Discovery für GoodWe-Wechselrichter
• Auswahl gefundener Wechselrichter mit Modell- und Seriennummerangabe

Der vollständige Changelog steht in der README.

Feedback

Bitte bei Rückmeldungen mit angeben:

• Wechselrichter-Modell und Firmware-Stand
• Adapter-Version, js-controller- und admin-Version
• Node.js-Version
• welche optionalen Registergruppen aktiv sind
• bei Fehlern: Log-Auszug auf Debug-Level

Fehler und Verbesserungsvorschläge gerne hier im Thema oder direkt als Issue auf GitHub:
https://github.com/typhosj/ioBroker.goodwe/issues

Danke fürs Testen!