GoodWe SEMS API
TimSoethout/goodwe-sems-home-assistant · v11.13.0
Home Assistant integration for monitoring GoodWe SEMS+ solar inverters, batteries, smart meters, and energy data.
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…) | |
select | Mode picker (as switches) |
What people report
GoodWe inverters and smart meters work via the SEMS cloud. Powerflow ('HomeKit') sensors have had duplicate and sign issues.
- Works2
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| GoodWe GW5000D-NS inverter with smart meter | Works Cloud | Beta caches meter data when inverter drops offlineSaved copyIs your feature request related to a problem? Yes. My station has two devices: a GW5000D-NS inverter and a GoodWe smart meter. When the inverter's comms drop, the meter stays online and the SEMS app keeps showing a full, live powerflow, solar, grid and load, because the station derives it from the meter. The integration, however, goes completely blind, because it only ever reads the inverter. On 25 Sep 2026 the inverter went offline at 11:47 in full sun. The app showed: [code] The integration reported `status: Waiting`, `eday` frozen at 5.20 kWh, and every powerflow sensor unavailable. … Excerpt saved from GitHub on 2026-10-23. | Issue #236 · 2026-09 | |
| GoodWe smart meter | Works Cloud | Import/export and load values fixedSaved copyReplaces #233, which unintentionally also picked up unrelated EV charger work from my fork's `master`. This PR contains only the two smart meter bug fixes. ## Tested Both fixes are tested and proven working on a live installation (GoodWe inverter + GoodWe smart meter, SEMS+ account): - SEMS Import / Export (daily) and SEMS Total Import / Total Export report correct values again, on the existing entities, so Energy dashboard history continues. - HomeKit Load and HomeKit Load (Legacy) show positive household consumption again, including while exporting. The meter counter handling is also … Excerpt saved from GitHub on 2026-10-23. | PR #239 · 2026-09 | |
| GoodWe SEMS powerflow load sensors | Partly works Cloud | Duplicate load entities after inverter replacement; load sometimes negativeSaved copyDescribe the bug I am seeing 2 load entities: - sensor.homekit_homekit_load - sensor.homekit_homekit_load_2 I only have 1 power station (although the inverter was replaced and Goodwe support had to remove the old inverter and add the new inverter). The `sensor.homekit_homekit_load` entity shows the correct values with `pv`, `load`, `loadStatus`, `grid` and a lot of other attributes. The `sensor.homekit_homekit_load_2` entity only has the load value populated in the state. It does not contain any other attributes. The strange thing is that the value can sometimes become negative, so for … Excerpt saved from GitHub on 2026-10-23. | Issue #202 · 2026-06 |
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
Cloud polling
Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.
Details
| Installs (analytics) | 1,294 (0.18%) |
|---|---|
| GitHub stars | 147 |
| Latest version | 11.13.0 (2026-10-23) |
| Set up in the UI | Yes |
| Maintainers | @TimSoethout |
| License | MIT |
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.
