The GoodWe Inverter Solar Sensor component will retrieve data from a GoodWe inverter connected to local network.
It has been tested on GoodWe ET, ES and EM families of inverters.
It may work for other inverters as well, as long as they listen on UDP port 8899 and respond to one of supported communication protocols.
The values will be presented as sensors in Home Assistant.
Your inverter needs to be connected to your local network, as this custom component will utilise the UDP protocol to read data from inverter. All you need to know is the IP address of the inverter and you are good to go.
Add this component using HACS by searching for GoodWe Inverter Solar Sensor (UDP - no cloud) on the Integrations page.
Create a directory called goodwe in the <config directory>/custom_components/ directory on your Home Assistant instance.
Install this component by copying all files in /custom_components/goodwe/ folder from this repo into the new <config directory>/custom_components/goodwe/ directory you just created.
This is how your custom_components directory should look like:
custom_components
├── goodwe
│ ├── __init__.py
│ ├── goodwe_inverter.py
│ ├── manifest.json
│ └── sensor.pyTo enable this sensor, add the following lines to your configuration.yaml file:
sensor:
- platform: goodwe
ip_address: 192.168.100.100
#scan_interval: 30
#sensor_name_prefix: GoodWeThe optional sensor_name_prefix config may be used to change the prefix of the individual sensor's default entity names.
The sensor values reported by the inverter are instant measurements.
To report summary values like daily/monthly sell or buy (in kWh), these values have to be aggregated over time.
(The only exception are the "total/daily" sensors like e_total, e_day where the inverter itselfs keeps intenal counters.)
Riemann Sum integration can be used to convert these instant (W) values into cumulative values (Wh).
Utility Meter can report these values as human readable statistical values.
Template Sensor can be used to separate buy and sell values.
sensor:
- platform: template
sensors:
# Template sensor for values of energy bought (active_power < 0)
energy_buy:
friendly_name: "Energy Buy"
unit_of_measurement: 'W'
value_template: >-
{% if states('sensor.goodwe_active_power')|float < 0 %}
{{ states('sensor.goodwe_active_power')|float * -1 }}
{% else %}
{{ 0 }}
{% endif %}
# Template sensor for values of energy sold (active_power > 0)
energy_sell:
friendly_name: "Energy Sell"
unit_of_measurement: 'W'
value_template: >-
{% if states('sensor.goodwe_active_power')|float > 0 %}
{{ states('sensor.goodwe_active_power')|float }}
{% else %}
{{ 0 }}
{% endif %}
# Sensor for Riemann sum of energy bought (W -> Wh)
- platform: integration
source: sensor.energy_buy
name: energy_buy_sum
unit_prefix: k
round: 1
method: left
# Sensor for Riemann sum of energy sold (W -> Wh)
- platform: integration
source: sensor.energy_sell
name: energy_sell_sum
unit_prefix: k
round: 1
method: left
utility_meter:
energy_buy_daily:
source: sensor.energy_buy_sum
cycle: daily
energy_buy_monthly:
source: sensor.energy_buy_sum
cycle: monthly
energy_sell_daily:
source: sensor.energy_sell_sum
cycle: daily
energy_sell_monthly:
source: sensor.energy_sell_sum
cycle: monthly
house_consumption_daily:
source: sensor.house_consumption_sum
cycle: daily
house_consumption_monthly:
source: sensor.house_consumption_sum
cycle: monthlyTo test whether the inverter properly responds to UDP request, just execute the inverter_test.py script