GoodWe smart home integration, free and open source
GoodWe solar inverters and batteries: production, grid, house and battery, local or SEMS cloud.
Published by gboulvin
- Devices
- Version 1.0.0
- Requires Gladys >=5.1.0
- ★ 0
Follow your GoodWe solar installation in Gladys: solar production, house consumption, grid import/export and battery, live, with scenes and dashboard widgets.
Supported inverters
| Family | Models | Local (LAN) | SEMS cloud |
|---|---|---|---|
| ET (hybrid, battery) | ET, EH, BT, BH, ET Plus, EHA/ESA G20, GEH… | ✅ + settings | ✅ |
| ES (hybrid, battery) | ES, EM, BP, SBP | ✅ + settings | ✅ |
| DT (grid-tied) | DT, SDT, MT, MS, D-NS, XS, GEP… | ✅ | ✅ |
The inverter needs its GoodWe WiFi or LAN module (Wi-Fi Kit, WiFi/LAN Kit, Ezlink…) connected to your home network.
Two ways to reach the inverter
Local (recommended). Gladys talks directly to the inverter on your network (UDP port 8899): values every minute, daily energy, meter indexes, temperature, and settings available in scenes. No account, no Internet needed.
SEMS cloud (optional). The account of the SEMS Portal / SEMS+ app. Works when Gladys is not on the same network as the inverter, and serves as a fallback when the local connection fails. Read-only, refreshed every 5 minutes (the portal throttles faster requests).
With both configured, each inverter is one device: read locally, it switches to the cloud when the local connection is lost (an orange dot on the "cloud" badge shows it), and back. The standard Prefer the local connection toggle chooses the channel tried first.
Configuration
- Install the integration from Integrations → GoodWe.
- Local connection:
- leave Search the network for GoodWe inverters on: Gladys broadcasts the GoodWe discovery request on your network;
- if the inverter is not found (another subnet, a VLAN, a router that blocks broadcasts), enter its IP address. Give it a fixed address in your router (DHCP reservation) so it does not change.
- Cloud (optional): enter the e-mail address and password of your SEMS account. Tip: create a dedicated visitor account in the SEMS app (Plant → Visitors) rather than giving the owner account.
- Click Test the connection: each inverter found is listed with its model and serial number.
- Open the Discovery tab and add your inverter(s).
Device features
Depending on the model and the connection, each inverter publishes:
| Feature | Unit | Notes |
|---|---|---|
| Solar production | W | all |
| Production today / total | kWh | local |
| Grid power | W | import > 0, export < 0 (meter required) |
| Grid import / export index | kWh | ET, DT with smart meter |
| House consumption | W | meter required |
| Battery level | % | hybrids with battery |
| Battery charge/discharge | W | hybrids with battery |
| Battery charged/discharged | kWh | ET |
| Inverter temperature | °C | local |
| Grid voltage | V | local |
Scenes
Triggers:
- Solar production started / stopped (sunrise, sunset; the energy of the day is available as a variable);
- Solar surplus started / ended: the power injected into the grid exceeds the threshold of the configuration (500 W by default). Ideal to start the water heater, a washing machine or the car charge;
- Inverter fault (error code and description as variables);
- Inverter unreachable / back online.
Actions:
- Read the GoodWe inverter: fresh values usable in the next actions (production, grid, consumption, battery);
- Set the GoodWe operation mode (ET family: general, backup, eco, peak shaving, self-use);
- Limit the GoodWe grid export (in W, 0 = zero export);
- Set the GoodWe battery depth of discharge (%).
Settings need the local connection. An action that the inverter cannot perform returns Applied = no instead of failing: test it in the scene.
Dashboard widgets
- GoodWe inverter: live solar, house, grid and battery tiles, the state of the inverter, its connection and a Refresh button;
- GoodWe production: production and consumption chart (24 h to a month) and the energy balance of the day (produced, imported, exported, self-sufficiency).
Troubleshooting
- No inverter found: check that the inverter answers in the SEMS app, enter its IP address, and allow UDP port 8899 between Gladys and the inverter. Some recent dongles only talk to the cloud: use the SEMS account.
- Cloud: "login refused": check the e-mail and password on semsportal.com. The portal limits the request rate: after a "slow down" message the integration waits 5 minutes on its own.
- No grid / consumption values: a grid-tied (DT) inverter needs a GoodWe smart meter for them.
GoodWe is a trademark of GoodWe Technologies Co., Ltd. This community integration is not affiliated with GoodWe.
Configuration settings
These are the settings GoodWe asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Local connection (recommended) | section | No | The inverter is read on your network (UDP port 8899 of its WiFi/LAN module): every minute, detailed values, settings available in scenes. Leave the network scan on to find it, or enter its IP address (give it a fixed address in your router). |
| Inverter IP addresses | string | No | Optional, separated by commas. Needed when the network scan does not find the inverter. |
| Search the network for GoodWe inverters | boolean | No | |
| SEMS cloud (optional) | section | No | The account of the SEMS Portal / SEMS+ app. Used when the inverter is not reachable on the network, or as a fallback. Read-only, refreshed every 5 minutes. A visitor account created in the SEMS app is enough. |
| SEMS e-mail address | string | No | |
| SEMS password | secret | No | |
| Refresh interval (s) | number | No | How often the inverters are read, in seconds (one minute minimum, 5 minutes for the cloud). |
| Surplus threshold (W) | number | No | Power injected into the grid above which the "Solar surplus started" scene trigger fires. |
How to install GoodWe in Gladys
- In Gladys, open Integrations: GoodWe appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/gboulvin/gladys-goodwe-solar:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/gboulvin/Gladys-GoodWe-Solar.
GoodWe requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
GoodWe is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by gboulvin, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation