iobroker.goodwe-pv

Versions

Sentry

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information on how to disable error reporting, see Sentry-Plugin Documentation!

goodwe-pv adapter for ioBroker

Communication with GoodWe hybrid inverters of the ET, EH, BH and BT series via the local UDP interface (port 8899). No cloud connection required — the adapter talks directly to the inverter on your LAN.

Supported devices

All GoodWe hybrid inverters that expose the local Modbus-over-UDP interface on port 8899:

ET series (e.g. GW5-ET, GW8-ET, …)
EH series
BH series
BT series

Configuration

IP address — Local IP address of the GoodWe inverter (default: 127.0.0.1). Find it in your router's DHCP lease table or in the SEMS portal / ShinePhone app under "Device Info". A static IP or DHCP reservation is recommended.

Poll cycle — How often in seconds each data group is re-read from the inverter (default: 10). The four data groups (DeviceInfo, RunningData, ExtComData, BMSInfo) are staggered so only one UDP request is in flight per second.

Tip: Find the inverter's IP address in your router's DHCP lease table, or check the GoodWe SEMS portal / ShinePhone app under "Device Info". Assigning a static IP or DHCP reservation is recommended so the address does not change.

Based on

Donate

If you enjoyed this project — or just feeling generous, consider buying me a beer. Cheers! :beers:

Changelog

WORK IN PROGRESS

(hombach) switch to iobroker testing 6.x
(hombach) added node 26 tests
(hombach) updated dependencies

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