Lost connectivity when updating from 2.1.2 to 2.1.3

[MEKadan]

Could not file a bug report. becaus I don't know whether it's a bug or not and the information required for bug report is too extensive.

However, after updating to 2.1.3 all my entities shows undefined in device info. The integration is in error state and reloading does not help. From the log I got:

Logger: custom_components.huawei_solar
Source: config_entries.py:798
Integration: Huawei Solar (documentation, issues)
First occurred: 15:24:49 (6 occurrences)
Last logged: 15:32:24

Error setting up entry SUN2000-4KTL-M1SUN2000-5KTL-M for huawei_solar
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 798, in __async_setup_with_context
    result = await component.async_setup_entry(hass, self)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/config/custom_components/huawei_solar/__init__.py", line 219, in async_setup_entry
    primary_device_data = await _setup_device_data(
                          ^^^^^^^^^^^^^^^^^^^^^^^^^
    ...<3 lines>...
    )
    ^
  File "/config/custom_components/huawei_solar/__init__.py", line 545, in _setup_device_data
    return await _setup_inverter_device_data(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        hass, entry, device, via_device_id=via_device_id
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/config/custom_components/huawei_solar/__init__.py", line 357, in _setup_inverter_device_data
    ha_device = device_registry.async_get_or_create(
        config_entry_id=entry.entry_id,
    ...<5 lines>...
        via_device_id=via_device_id,
    )
TypeError: DeviceRegistry.async_get_or_create() got an unexpected keyword argument 'via_device_id'. Did you mean 'via_device'?

After downgrading to 2.1.2 it is OK again.

Any ideas?

[andrix988]

I'm exaxctly in the same situation!

[MEKadan]

Although I didn't notice it being said anywhere in release notes, 2.1.3 seem to require core 2026.8.x. After updating core, Huawei Solar 2.1.3 works OK for me.

[JoergO]

I'm running 2026.9.1 and 2.1.3, but have a similar error:

Traceback (most recent call last):
  File "/usr/local/lib/python3.14/site-packages/huawei_solar/modbus_client.py", line 194, in get_file
    start_upload_response = await self.execute(
                            ^^^^^^^^^^^^^^^^^^^
    ...<4 lines>...
    )
    ^
  File "/usr/local/lib/python3.14/site-packages/tmodbus/client/async_client.py", line 152, in execute
    return await self.transport.send_and_receive(self.unit_id, pdu)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/huawei_solar/modbus_client.py", line 153, in send_and_receive
    response: RT = await super().send_and_receive(unit_id, pdu)
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tmodbus/transport/async_smart.py", line 332, in send_and_receive
    async for attempt in self.response_retry_strategy:
    ...<4 lines>...
            attempt.retry_state.set_result(response)
  File "/usr/local/lib/python3.14/site-packages/tenacity/asyncio/__init__.py", line 170, in __anext__
    do = await self.iter(retry_state=self._retry_state)
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tenacity/asyncio/__init__.py", line 157, in iter
    result = await action(retry_state)
             ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tenacity/_utils.py", line 111, in inner
    return call(*args, **kwargs)
  File "/usr/local/lib/python3.14/site-packages/tenacity/__init__.py", line 393, in <lambda>
    self._add_action_func(lambda rs: rs.outcome.result())
                                     ~~~~~~~~~~~~~~~~~^^
  File "/usr/local/lib/python3.14/concurrent/futures/_base.py", line 447, in result
    return self.__get_result()
           ~~~~~~~~~~~~~~~~~^^
  File "/usr/local/lib/python3.14/concurrent/futures/_base.py", line 396, in __get_result
    raise self._exception
  File "/usr/local/lib/python3.14/site-packages/tmodbus/transport/async_smart.py", line 334, in send_and_receive
    response = await self._reconnect_send_and_receive(unit_id, pdu)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tmodbus/transport/async_smart.py", line 325, in _reconnect_send_and_receive
    return await self.base_transport.send_and_receive(unit_id, pdu)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tmodbus/transport/async_tcp.py", line 159, in send_and_receive
    return await self._protocol.send_and_receive(unit_id, pdu)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/tmodbus/transport/async_tcp.py", line 299, in send_and_receive
    raise error_code_to_exception_map[exception_code](function_code)
tmodbus.exceptions.IllegalFunctionError: Modbus Exception 0x01 for function code 0x41

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/config/custom_components/huawei_solar/__init__.py", line 454, in _setup_inverter_device_data
    await device.get_optimizer_system_information_data()
  File "/usr/local/lib/python3.14/site-packages/huawei_solar/device/sun2000.py", line 254, in get_optimizer_system_information_data
    file_data = await self.read_file(OptimizerSystemInformationDataFile.FILE_TYPE)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/huawei_solar/device/base.py", line 301, in read_file
    return await self.client.get_file(file_type, customized_data)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.14/site-packages/huawei_solar/modbus_client.py", line 224, in get_file
    raise ReadException(msg, modbus_exception_code=err.error_code) from err
huawei_solar.exceptions.ReadException: Failed to read file 0x45: received IllegalFunctionError

Might this be the same root cause?

[MEKadan]

@JoergO , Just for general interest, I asked AI about your err. msg. The outcome was:

Your Home Assistant integration (huawei_solar) is trying to download the system information file for solar optimizers, but your inverter is rejecting the request.

The integration assumes you have Huawei Solar Optimizers installed on your panels and is trying to pull file type 0x45 (Optimizer System Information) using that proprietary Modbus command (0x41), which your inverter does not support or has blocked.

How to Fix This in Home Assistant

Scenario A: You DO NOT have physical optimizers on your panels

If you do not have optimizers, Home Assistant is trying to fetch data that doesn't exist.

1. Go to Settings > Devices & Services > Huawei Solar.
2. Click Configure on your inverter entry.
3. Look for a setting related to "Fetch optimizer data", "Enable optimizers", or "Advanced/Diagnostic Files" and uncheck/disable it.
4. Reload or restart the integration.

Scenario B: You DO have physical optimizers installed

If you have optimizers and want to see them in Home Assistant, your inverter is blocking the request due to one of two reasons:

1. Wrong Modbus ID: The integration is asking the wrong device (like the Smart Dongle or Battery unit) for the file. In your Home Assistant Huawei Solar integration setup, ensure the Inverter Modbus ID is targeted correctly (usually 1).
2. Outdated Inverter/Dongle Firmware: Older Huawei firmware versions do not support or have bugs related to file transfers over Modbus TCP. You will need to log into the FusionSolar app as an installer and update both your Inverter and your Smart Dongle (SDongleA) firmware to the latest available versions.

======
Pls note that I take no responsibility of these instructions, because they are generated by AI, but hopefully it is of help in diagnosing the problem.

[JoergO]

Thx. Is fixed with 2.1.5