GoodWe Inverter

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.

Note

If you can’t communicate with the inverter despite your model is listed above, it is possible you have an old ARM firmware version. You should ask manufacturer support to upgrade your ARM firmware (not just inverter firmware) to be able to communicate with the inverter via UDP.

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.

配置

要将 GoodWe Inverter integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

Energy dashboard

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 interval

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"
  triggers:
    - trigger: time_pattern
      hours: "*"
      minutes: "*"
      seconds: "/30"
  actions:
    - action: homeassistant.update_entity
      target:
        entity_id: sensor.ppv

Note

It has been observed in some rare situations that frequent polling conflicts with updates to the Goodwe SEMS cloud portal and do not receive any updates anymore. Reducing polling frequency to 30 seconds or 1 minute seems to help in such cases.

For more detailed steps on how to define a custom polling interval, follow the procedure below.

Defining a custom polling interval

如果您想要定义一个特定的间隔来轮询您的设备以获取数据,可以禁用默认的轮询间隔并创建自己的轮询自动化。

要添加自动化:

  1. 转到 设置 > 设备与服务,并选择您的集成。
  2. 在集成条目上,选择
    • 然后,选择 系统选项 并切换按钮以禁用轮询。 禁用轮询以获取更新
  3. 要定义您的自定义轮询间隔,创建一个自动化。
  4. 保存您的新自动化以轮询数据。