The GoodWe integration will poll a GoodWe solar inverter over the local network and present its runtime values as sensors in Home Assistant.
It works with GoodWe ET, EH, BT, BH, ES, EM, DT, MS, D-NS, XS and BP families of inverters. Different inverter families/models expose different sets of sensors, the newer models have usually broader support.
It may work on other inverter families as well, as long as they listen on UDP port 8899 and respond to one of the supported communication protocols. In general, if you can communicate with the inverter via an official mobile application (PvMaster, SolarGo), it is very likely the integration will work too.
Adding GoodWe Inverter to your Home Assistant instance can be done via the user interface, by using this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
Browse to your Home Assistant instance.
In the sidebar click on Settings.
From the configuration menu select: Devices & Services.
In the bottom right, click on the Add Integration button.
From the list, search and select “GoodWe Inverter”.
Follow the instruction on screen to complete the set up.
The plugin provides several values suitable for the energy dashboard.
The best supported are the inverters of ET/EH families, where the sensors
Meter Total Energy (export),
Meter Total Energy (import),
Total PV Generation,
Total Battery Charge and
Total Battery Discharge are the most suitable for the dashboard measurements and statistics.
For the other inverter families, if such sensors are not directly available by the inverter, they can be calculated from existing sensors. Template Sensor can be used to separate buy and sell power values and Riemann Sum can be used to convert these instant power (W) values into cumulative energy values (Wh), which then can be used within the energy dashboard.
Inverter polling frequency
The integration will poll the inverter for new values every 10 seconds. If you wish to receive fresh inverter data less (or more) frequently, you can disable the automatic refresh in the integration’s system options (Enable polling for updates) and create your own automation with your desired polling frequency.
- alias: "Goodwe inverter data polling" trigger: - platform: time_pattern hours: "*" minutes: "*" seconds: "/30" action: - service: homeassistant.update_entity target: entity_id: sensor.ppv