Huawei solar integration

Third party integrations
21

Hello,

I have a Huawei SUN2000-5KTL-L1 inverter configured in Home Assistant using modbusTCP as you can see in the image below.

image
image440×435 21.1 KB

After I update the Huawei Solar to version 1.5.6 from hacs now i can’t monitor the inverter and i don’t have values.

If I go to devices, says to reload. Once I reload i have this error.

image
image818×507 23.6 KB

Looking in logs of home assistant i see this:

2025-08-17 13:32:42.182 ERROR (MainThread) [homeassistant.config_entries] Error setting up entry SUN2000-5KTL-L1 for huawei_solar
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 749, in __async_setup_with_context
    result = await component.async_setup_entry(hass, self)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/config/custom_components/huawei_solar/__init__.py", line 96, in async_setup_entry
    primary_bridge = await create_tcp_bridge(
                     ^^^^^^^^^^^^^^^^^^^^^^^^
    ...<3 lines>...
    )
    ^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/bridge.py", line 680, in create_tcp_bridge
    return await _create(await AsyncHuaweiSolar.create(host, port, slave_id), slave_id)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/bridge.py", line 712, in _create
    product_info = await HuaweiSolarProductInfo.retrieve_from_device(client, slave_id)
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/bridge.py", line 67, in retrieve_from_device
    ) = await client.get_multiple(
        ^^^^^^^^^^^^^^^^^^^^^^^^^^
    ...<8 lines>...
    )
    ^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/huawei_solar.py", line 292, in get_multiple
    response = await self._read_registers(
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^
    ...<3 lines>...
    )
    ^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/huawei_solar.py", line 429, in _read_registers
    return await _do_read()
           ^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/backoff/_async.py", line 151, in retry
    ret = await target(*args, **kwargs)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/backoff/_async.py", line 151, in retry
    ret = await target(*args, **kwargs)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/huawei_solar/huawei_solar.py", line 377, in _do_read
    response = await self._client.read_holding_registers(
                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        register,
        ^^^^^^^^^
        count=length,
        ^^^^^^^^^^^^^
        slave=slave or self.slave_id,
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
TypeError: ModbusClientMixin.read_holding_registers() got an unexpected keyword argument 'slave'

Please, someone can help me or know what it is happening?

Thanks

22

I have same issue since 1.5.6 update.

In my case is not Modbus, it is network but the error log is the same.

No entities available.

23

Rolled back to 1.5.5 and it’s working again.

24

When it broke, did you also upgrade to 2025.8 for HA or did you only upgrade the Huawei Solar integration?

25

In my case HA was 2025.7.4.

26

Ah! I might be mistaken but, based on the release notes, this patch was launched to fix a problem introduced in 2025.8 so its fair to assume it can break for people still in 2025.7.
I’ll update both next week and report back.

27

I can confirm that HA 2025.8.2 plus Huawei 1.5.6 is working.

Thanks

28

Same issue here

29

Solved by upgrading Home Assistant to 2025.8.2

30

Hi can you please tell me how you connect to the emma, using the fusionsolar application and connecting to the wifi of the emma ?

31

Tell us exactly what you want to do, what you tried, and what is not working.

For connecting from the HAss integration, the steps are in the documentation . For enabling Modbus over TCP support on the EMMA, I posted some steps here .

32

I’m using this integration with EMMA, but I can’t see entities for grid consumption phase A, B and C. There is some entitie that I’m missing?

33

Hi, I got a notification for a new update today, ver 2.0.1.

Do I loose any configured entities, will they be recreated with a new Id or name ?
Or may I just update and everything will continue running ?

My config is using Modbus TCP, and HA is communicating the an EMMA A02.

Kind regards