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

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!