Skip to content

SolaX Gen4 X1-Hybrid no longer detected correctly in latest release #2226

Description

@finalbillybong

SolaX Gen4 X1-Hybrid no longer detected correctly in latest release

Describe the bug

After updating homeassistant-solax-modbus to the latest available version, my SolaX inverter was no longer detected correctly.

Initially, the integration failed to read the inverter serial number from all attempted register addresses and reported:

SolaX: reading serial number from address 0x0 failed; other address may succeed
SolaX: reading serial number from address 0x300 failed; other address may succeed
SolaX: reading serial number from address 0x1a10 failed; other address may succeed
SolaX: cannot find any serial number(s)
unrecognized inverter type - serial number : unknown

The Modbus connection also produced errors such as:

No response received after 1 retries
Cancel send, because not connected!

After restarting/power-cycling the Modbus connection, the inverter was detected, but the integration then produced repeated errors every polling cycle for multiple switch entities:

SolaX: Sensor charge_and_discharge_period2_enable corresponding to switch charge_and_discharge_period2_enable bit 0 has no integer value None
SolaX: Sensor device_lock corresponding to switch device_lock bit 0 has no integer value None
SolaX: Sensor hotstandby corresponding to switch hotstandby bit 0 has no integer value None
SolaX: Sensor battery_heating corresponding to switch battery_heating bit 0 has no integer value None
SolaX: Sensor mppt corresponding to switch mppt bit 0 has no integer value None
SolaX: Sensor peakshaving_charge_from_grid corresponding to switch peakshaving_charge_from_grid bit 0 has no integer value None
SolaX: Sensor manual_mode_control corresponding to switch manual_mode_control bit 0 has no integer value None
SolaX: Sensor schedule corresponding to switch schedule bit 0 has no integer value None

Downgrading the integration to 2026.06.6 and restarting Home Assistant restored normal operation.

This appears to be a regression introduced after version 2026.06.6, possibly involving inverter identification or the filtering/register mapping of switch entities for this inverter model.

Inverter details

  • Manufacturer: SolaX Power
  • Model: X1-Hybrid-5.0kW
  • Generation: Gen4
  • Serial prefix: H4502A
  • DSP firmware: 1.45
  • ARM firmware: 1.42

Integration versions

  • Working version: 2026.06.6
  • Broken version: Latest available release at the time of testing on 29 July 2026

Steps to reproduce

  1. Use a SolaX Gen4 X1-Hybrid-5.0kW inverter with serial prefix H4502A.
  2. Install or update to the latest version of homeassistant-solax-modbus.
  3. Restart Home Assistant.
  4. Observe that inverter identification may fail.
  5. Once connected, observe repeated has no integer value None errors for numerous switch entities.
  6. Downgrade to version 2026.06.6.
  7. Restart Home Assistant.
  8. Observe that the integration operates normally again.

Expected behaviour

The inverter should be detected correctly and only entities supported by this inverter model and firmware should be created or polled.

Actual behaviour

The latest release either fails to identify the inverter or creates switch entities whose underlying register values are None, resulting in repeated errors every polling cycle.

Additional context

No inverter firmware, network, Modbus device ID, wiring, or Home Assistant configuration changes were made at the time the issue appeared. The issue began immediately after updating the integration and stopped after downgrading to 2026.06.6.

I can provide full debug logs or test a development build if required.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions