bouwew / sems2mqtt

GoodWe SEMS MQTT-componenent for Home Assistant

UPDATE: I no longer own a GoodWe solar inverter but I am happy to maintain this code. Just let me know what needs to change, by creating a Pull request or an Issue, or start a Discussion.

GoodWe SEMS Portal MQTT Component for Home Assistant

Home Assistant component for accessing the GoodWe SEMS Portal API. Adapted from https://github.com/TimSoethout/goodwe-sems-home-assistant but altered to use the SEMS API. API adaption by hesselonline, heavily inspired by https://github.com/markruys/gw2pvo. Adapted furthermore by bouwew, using MQTT messages using HA-discovery to create separate sensors.

NOTE: this component requires an MQTT-broker to be present in your network. There is one available in the Hassio Official Add-ons.

Installation of this component is done by copying the files __init__.py and manifest.json to the [homeassistant_config]/custom_components/sems2mqtt folder.

In configuration.yaml add the custom_component as follows:

sems2mqtt:
  broker: 192.168.1.10          mqtt broker IP
  broker_user: username         mqtt broker login
  broker_pw: password1          mqtt broker password
  username: [e-mail]  sems login (full email-address*)
  password: password2           sems password
  station_id: your-station-ID   see remark below
  client: sems2mqtt             (optional, MQTT cient-id, default is 'sems2mqtt')
  scan_interval: 150            (optional, default is 300 seconds, keep to 300 seconds or less!)

• If you are using the SEMS Portal app on Android or IOS, it is strongly suggested to create a Visitor account with a different email address and use the credentials of the Visitor account for this custom_component. In the Adroid app, a visitor account can be added on the 'Modify Plant Info' page, scroll down to the bottom of the page to find the 'add visitor'-button.

This component use MQTT-disovery to find the sensors. The various parameters collected from the API will be shown as separate sensors, not as one sensor with several attributes. When you have performed the MQTT discovery, via Configuration --> Integrations --> configure the new MQTT-item on the top of the page (if you have other MQTT-integrations and the new sensors do not show up, delete the existing MQTT-integrations, restart HA and perform the MQTT-integration again), you will need to restart HA once more for the new sensors to show up.

Station ID can be found by logging on to the SEMS portal (part of URL after https://www.semsportal.com/PowerStation/PowerStatusSnMin/).