Integration for Home Assistant that retrieves PV data from GoodWe SEMS API.
The repository folder structure is compatible with HACS and is included by default in HACS.
Install HACS via: https://hacs.xyz/docs/installation/manual. Then search for "SEMS" in the Integrations tab (under Community).
Crude sensor for Home Assistant that scrapes from GoodWe SEMS portal. Copy all the files in custom_components/sems/
to custom_components/sems/
your Home Assistant config dir.
The required ID of your Power Station can be retrieved by logging in to the SEMS Portal with your credentials: https://www.semsportal.com
After login you'll see the ID in your URL, e.g.: https://semsportal.com/PowerStation/PowerStatusSnMin/12345678-1234-1234-1234-123456789012
In this example the ID of the Power Station is: 12345678-1234-1234-1234-123456789012
In the home assistant GUI, go to Configuration
> Integrations
and click the Add Integration
button. Search for GoodWe SEMS API
.
Fill in the required configuration and it should find your inverters.
Note that changed to configuration.yaml
are no longer necessary and can be removed.
Replace $NAME
with your inverter entity id.
- platform: template
sensors:
pv_temperature:
value_template: '{{ states.sensor.inverter_$NAME.attributes.tempperature }}'
unit_of_measurement: 'C'
friendly_name: "PV Temperature"
pv_eday:
value_template: '{{ states.sensor.inverter_$NAME.attributes.eday }}'
unit_of_measurement: 'kWh'
friendly_name: "PV energy day"
pv_etotal:
value_template: '{{ states.sensor.inverter_$NAME.attributes.etotal }}'
unit_of_measurement: 'kWh'
friendly_name: "PV energy total"
pv_iday:
value_template: '{{ states.sensor.inverter_$NAME.attributes.iday }}'
unit_of_measurement: '€'
friendly_name: "PV income day"
pv_itotal:
value_template: '{{ states.sensor.inverter_$NAME.attributes.itotal }}'
unit_of_measurement: '€'
friendly_name: "PV income total"
pv_excess:
value_template: '{{ states.sensor.inverter_$NAME.attributes.pmeter }}'
unit_of_measurement: 'W'
friendly_name: "PV spare"
# battery soc
pv_soc:
value_template: '{{ states.sensor.inverter_$NAME.attributes.soc }}'
unit_of_measurement: '%'
friendly_name: "Battery power"
Note that states.sensor.inverter_$NAME.state
contains the power output in W
.
Add the last line in configuration.yaml
in the relevant part of logger
:
logger:
default: info
logs:
custom_components.sems: debug
- Sometimes the SEMS API is a bit slow, so time-out messages may occur in the log as
[ERROR]
. The component should continue to work normally and try fetch again the next minute.
- Setup HA development environment using https://developers.home-assistant.io/docs/development_environment
- clone this repo in config directory:
cd core/config
git clone git@github.com:TimSoethout/goodwe-sems-home-assistant.git
- go to terminal in remote VSCode environment
cd core/config/custom_components
ln -s ../goodwe-sems-home-assistant/custom_components/sems sems
Inspired by https://github.com/Sprk-nl/goodwe_sems_portal_scraper and https://github.com/bouwew/sems2mqtt . Also supported by generous contributions by various helpful community members.