iobroker.goodwe-pv

Versions

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) updated dependencies

1.1.0 (2026-10-17)

(hombach) fixed repoChecker warnings
(hombach) updated dependencies
(hombach) fix 4-byte unsigned values with bit 31 set
(hombach) add battery mode as text (RunningData.Battery1.ModeText)
(hombach) fix EnergyDayDischarge (35211) read as 2 bytes
(hombach) add work mode as text (RunningData.WorkModeText)
(hombach) read BMS PackTemperature as signed value
(hombach) decode DiagStatusL bits into RunningData.DiagStatus
(hombach) read extended BMS info (37010-37014) and decode BMS error/warning bits

1.0.1 (2026-10-11)

(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

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