iobroker.goodwe-pv

Versionen

Posten

Dieser Adapter verwendet Sentry-Bibliotheken, um Ausnahmen und Codefehler automatisch an die Entwickler zu melden. Weitere Informationen und Hinweise zum Deaktivieren der Fehlerberichterstattung finden Sie unter [Link einfügen]. Sentry-Plugin-Dokumentation !

goodwe-pv Adapter für ioBroker

Die Kommunikation mit GoodWe -Hybridwechselrichtern der Serien ET, EH, BH und BT erfolgt über die lokale UDP-Schnittstelle (Port 8899). Eine Cloud-Verbindung ist nicht erforderlich – der Adapter kommuniziert direkt mit dem Wechselrichter in Ihrem LAN.

Unterstützte Geräte

Alle GoodWe-Hybridwechselrichter, die die lokale Modbus-over-UDP-Schnittstelle an Port 8899 bereitstellen:

ET-Serie (z. B. GW5-ET, GW8-ET, …)
EH-Serie
BH-Serie
BT-Serie

Konfiguration

IP-Adresse — Lokale IP-Adresse des GoodWe-Wechselrichters (Standard:127.0.0.1 Sie finden die IP-Adresse in der DHCP-Leasetabelle Ihres Routers oder im SEMS-Portal/in der ShinePhone-App unter „Geräteinformationen“. Eine statische IP-Adresse oder eine DHCP-Reservierung wird empfohlen.

Abfragezyklus – Wie oft in Sekunden jede Datengruppe vom Wechselrichter neu eingelesen wird (Standard:10 Die vier Datengruppen (DeviceInfo, RunningData, ExtComData, BMSInfo) sind so gestaffelt, dass pro Sekunde nur eine UDP-Anfrage gesendet wird.

Tipp: Die IP-Adresse des Wechselrichters finden Sie in der DHCP-Leasetabelle Ihres Routers oder im GoodWe SEMS-Portal bzw. in der ShinePhone-App unter „Geräteinformationen“. Es wird empfohlen, eine statische IP-Adresse zuzuweisen oder eine DHCP-Reservierung vorzunehmen, damit sich die Adresse nicht ändert.

Bezogen auf

Spenden

Wenn dir dieses Projekt gefallen hat – oder du einfach nur großzügig sein möchtest –, spendiere mir doch ein Bier. Prost! 😉

Changelog

1.0.0 (2026-09-06)

(hombach) version for stable release
(hombach) updated dependencies

0.2.4 (2026-08-07)

(hombach) add missing descriptions to DeviceInfo and BMSInfo states
(hombach) remove placeholder desc "-" from states without a meaningful description
(hombach) remove unused Rtc field from GoodWeRunningData type
(hombach) updated dependencies

0.2.3 (2026-07-18)

(hombach) replace deprecated role value.power.consumption with value.energy.consumed
(hombach) replace value.power.produced with value.energy.produced for accumulated kWh states
(hombach) replace invalid roles value.power.apparent and value.signal with valid alternatives

0.2.2 (2026-07-12)

(hombach) assign semantic ioBroker roles to many states
(hombach) fix PowerFactor scaling: signed int / 1000 instead of uint / 100
(hombach) fix TotalReactivePower sign: use signed int (VAR can be negative)
(hombach) fix EnergyTotalSell/Buy unit: GM3000 meter float is in Wh, divide by 1000

0.2.1 (2026-07-12)

(hombach) add GoodWe manufacturer link to README
(hombach) remove debug code (checkPasswordAsync/checkGroupAsync) from onReady
(hombach) disable unused onStateChange handler (no writable states)
(hombach) add runtime validation for pollCycle config parameter
(hombach) expose DerateFlag as ioBroker state in RunningData
(hombach) fix UTF-8 encoding corruption in all i18n translation files

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

GoodWe PV