This integration splits out the various values that are fetched from your Huawei Solar inverter into separate HomeAssistant sensors. These are properly configured to allow immediate integration into the HA Energy view.
This integration supports two connection modes to SUN2000 inverters:
- direct serial connection to the RS485A1 and RS485B1 pins of the COM port
- network connection
Detailed information can be found on the 'Connecting to the inverter' Wiki-page
-
Install this integration with HACS, or copy the contents of this repository into the
custom_components/huawei_solardirectory -
Restart HA
-
Start the configuration flow:
- Or: Go to
Configuration->Integrationsand click the+ Add Integration. SelectHuawei Solarfrom the list
-
Choose whether you want to connect via serial or network connection
- Select the "USB to RS485 converter" that you connected to the RS485A1 and RS485B1 pins of your inverter. The Slave ID should be identical to the Com address set in the RS485_1 settings.
- Enter the IP address and port on which the Modbus-TCP interface is available (when connecting to the inverter AP the host IP is typically
192.168.200.1and the port is either502or6607). The slave id is typically0. You should only check theAdvanced: elevate permissionscheckbox if you intend to dynamically change your inverter and battery settings, or want access to the optimizer data.
- When using the
elevate permissionsfeature, you will be asked to enter the credentials to theinstalleraccount in a next step. These are the credentials used to connect to the inverter in the "Device Commissioning" section of the FusionSolar App. The default password is00000a.
The integration will poll the inverter for new values every 30 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: "Huawei Solar inverter data polling"
trigger:
- platform: time_pattern
hours: "*"
minutes: "*"
seconds: "/10"
action:
- service: homeassistant.update_entity
target:
entity_id: sensor.daily_yieldNote that optimizer data is refreshed only every 5 minutes, which matches how frequently the inverter refreshes this data.
Q: Why do I get the error "Connection succeeded, but failed to read from inverter." while setting up this integration?
A: While the integration was able to setup the initial connection to the Huawei Inverter, it did not respond to any queries in time. This is either caused by using an invalid slave ID (typically 0 or 1, try both or ask your installer if unsure), or because an other device established a connection with the inverter, causing the integration to lose it's connection
Q: Will the FusionSolar App still work when using this integration?
A: The inverter will still send it's data to the Huawei cloud, and you will still be able to see live statistics from your installation in the FusionSolar App. However, if you are using this integration via the network, and you (or your installer) need to use the 'Device commissioning' feature of the app, you will need to disable this integration.
Q: The "Daily Yield" value reported does not match with the value from FusionSolar?
A: The "Daily Yield" reported by the inverter is the output yield of the inverter, and not the input from your solar panels. It therefore includes the yield from discharging the battery, but misses the yield used to charge the battery. FusionSolar computes the "Yield" by combining the values from "Daily Yield", "Battery Day Charge" and "Battery Day Discharge". More information on the Wiki ...
Q: I can't get this integration to work. What am I doing wrong?
A: First make sure that 'Modbus TCP' access is enabled in the settings of your inverter. Next, check if the port is correct. Some inverters use port 6607 instead of 502 (this can change for you after a firmware update!). If that doesn't work for you, and you intend to write an issue, make sure you have the relevant logs included. For this integration, you can enable all relevant logs by including the following lines in your configuration.yaml:
logger:
logs:
pymodbus: debug # only include this if you're having connectivity issues
huawei_solar: debug
homeassistant.components.huawei_solar: debugBy providing logs directly when creating the issue, you will likely get help much faster.