GoodWe Inverter
mletenay/home-assistant-goodwe-inverter · vv0.9.9.31
Experimental version of Home Assistant integration for Goodwe solar inverters
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Local UDP/Modbus polling of GoodWe ET, ES, EH, DT and XS inverters. Firmware updates and WiFi/LAN kit versions are the most common sources of dropouts.
- Works2
- Partly works4
- Not working3
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| GoodWe DT series inverters | Works Local | DT series support mergedSaved copyI tried to create an implementation for the DT series. As far as I can tell it is pretty similar to ET except other prefix and command codes are used. I adapted a bit the code for ET to keep as much as possible common, I renamed the EtProtocolCommand to ModbusProtocolCommand because that's what it seems to be. I managed to find quite a lot of the sensors by comparing to SolarGo app (which works with my DT inverter), sniffing traffic and guessing (still not sure about the Running Hours since I can't view it anywhere in the app or on the device). I also managed to enable the setting of the … Excerpt saved from GitHub on 2026-10-23. | PR #27 · 2021-05 | |
| GoodWe GW10K-ET | Works Local | Tested for enum sensorsSaved copyIt's not possible to do it for `EnumBitmap22` and `EnumBitmap4` because the labels list does not contain all values (tested on my GW10K-ET). Excerpt saved from GitHub on 2026-10-23. | PR #264 · 2024-03 | |
| GoodWe 5048D-ES / SBP | Partly works Local | Connection drops on WiFi; LAN module more stableSaved copyCompletely different versions here. Inverter: 5048D-ES Firmware sems : Version(FW/BMS)1242417/0 Firmware ha: 2424H Wifi version: 1.0.3.8 Excerpt saved from GitHub on 2026-10-23. | Issue #174 · 2023-03 | |
| GoodWe EH series inverters | Partly works Local | Tentative support attempted; PR closedSaved copyI have a new EH inverter and it seems I can connect quite well with it using the same protocol as the ET series. By extending detection of the model on the serial number (containing "EHU"), I have good communication results. I am not using Home Assistant so that I only use the Python class. Excerpt saved from GitHub on 2026-10-23. | PR #31 · 2021-05 | |
| GoodWe ET G2 with WiFi/LAN Kit-20 | Partly works Local | TCP-only module gives wrong battery current; Modbus address 247 neededSaved copyI had the same issue! It depends on your Inverter if you should use the WIFI/LAN Kit 20 or the WIFI/LAN kit GA10081-69-00P. Wifi/lAn kit 2.0 should be used ET Series 15 and higher. Below you should use Wifi/Lan Kit. Anyhow, i have a GWK8ET+ and also by mistake the WIFI/LAN KIT 2.0. Which works fine upto a certain device FW. With V4.00 it works. As i updated it with SolorGo to V106075.00 i had the same issues like you. I reched out to Goodwe support and the downgraded my WIFI/LAN Kit 2.0 back to FW 4.0. As per today nomore issues Excerpt saved from GitHub on 2026-10-23. | Issue #366 · 2025-05 | |
| GoodWe GW5000D-NS | Partly works Local | Needs explicit inverter family; default AA55 probe disconnects WiFi moduleSaved copyI've just had a GW5000D-NS installed and the AA55 initial command results in my wifi module disconnecting from the inverter/network which requires a full inverter restart to recover from This PR is to add the option in to allow to define the inverter family via the GUI to skip the discovery step Excerpt saved from GitHub on 2026-10-23. | PR #149 · 2022-12 | |
| GoodWe GW2000-XS (XS2000) | Not working Local | Wrong PV power values after firmware V1.98.24Saved copyThe problem After updating my GoodWe XS2000 (GW2000-XS) inverter to firmware V1.98.24, the PV power values reported by Home Assistant no longer match the actual values shown on the inverter display. Environment ∙ Home Assistant Core version: 2026.1.2 ∙ GoodWe Integration version: 0.9.9.29 ∙ Inverter model: GoodWe GW2000-XS ∙ Firmware version after update: V1.98.24 ∙ Connection type: Local network integration Current behavior ∙ Inverter display shows: Pac = 85.3W (and earlier 101.5W) ∙ Home Assistant shows: PV1 Power = 20W, PV2 Power = 0W Expected behavior 1. Home Assistant Werte (erstes Bild) … Excerpt saved from GitHub on 2026-10-23. | Issue #412 · 2026-01 | |
| GoodWe GW6000-ES-20 (ES gen2) | Not working Local | Stopped after firmware upgrade; ES and ET family both failSaved copy… and after having the system work correctly for about a week, it stopped. I'm currently on inverter firmware version V5 and ARM version V2 according to GoodWe support and PV Master app. Below is a snapshot of the error in the log: _ Logger: goodwe.es Source: /usr/local/lib/python3.10/site-packages/goodwe/es.py:199 First occurred: 09:31:04 (6 occurrences) Last logged: 10:37:58 Error decoding firmware version ^B^B^E. Traceback (most recent call last): File "/usr/local/lib/python3.10/site-packages/goodwe/es.py", line 193, in read_device_info self.dsp1_version = int(self.firmware[0:2]) ValueError: … Excerpt saved from GitHub on 2026-10-23. | Issue #178 · 2023-03 | |
| GoodWe GW8000-ES-C10 with WiFi/LAN Kit-20 | Not working Local | Modbus ports 502 and 8899 closed; must enable via BluetoothSaved copyFeature Request / Question: Enabling Modbus TCP on WiFi/LAN Kit-20 (Ports 502/8899 Closed) ### Expected Behavior I am trying to connect a GoodWe GW8000-ES-C10 inverter to my local Home Assistant automation server using Modbus TCP via a WiFi/LAN Kit-20 dongle. I expect local Modbus ports `502` or `8899` to be open for local data polling. ### Current Behavior The local Modbus ports `502` and `8899` appear to be closed at the firmware level, preventing any local connection. ### Question Has anyone successfully requested GoodWe support to remotely enable Modbus TCP on the WiFi/LAN Kit-20 dongle … Excerpt saved from GitHub on 2026-10-23. | Issue #465 · 2026-05 | |
| GoodWe HomeKit HK1000 smart meter | Won’t be supported | Not reachable directly; data only via inverter or SEMS cloudSaved copyHk1000 is a smart meter attached to your electricity meter to show how much solar you are producing, energy consumption from solar and grid and how much you are sending it back to the grid. The inverter only shows you how much you are producing. On Fri, 15 Jul 2022 at 11:11 pm, SniperHilton *@*.*> wrote: > Isn't the hk1000 just the meter? > >, > Reply to this email directly, view it on GitHub > , > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/ASK5K6E6FFIBUIWP Excerpt saved from GitHub on 2026-10-23. | Discussion #113 · 2022-02 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 1,482 (0.21%) |
|---|---|
| GitHub stars | 240 |
| Latest version | v0.9.9.31 (2026-07-01) |
| Set up in the UI | Yes |
| Maintainers | @mletenay, @starkillerOG, @fizcris |
| License | MIT |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| Samorja/home-assistant-goodwe-inverter Newer code | ★ 0 | 2026-10-20 | Experimental version of Home Assistant integration for Goodwe solar inverters |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.