Skip to content

[Bug]: Growatt unrecognized inverter type — add serial prefix SZG and firmware prefix TJ1 #2261

Description

@hugotanure

Describe the bug

The Growatt plugin does not recognize an inverter whose serial number starts with SZG and whose firmware version starts with TJ1.

Modbus communication itself works (serial/firmware are read successfully), but detection fails with:

unrecognized Growatt inverter type - firmware version : TJ1.0

As a result, the inverter is not classified correctly and entities are not created properly.

Inverter details (known)

Field Value
Integration solax_modbus (wills106 / HACS)
Plugin plugin_growatt.py
Serial (as read / entity) SZGDCL505K (prefix SZG)
Firmware (as logged) TJ1.0 (prefix TJ1)
Phases / topology observed 3-phase grid-tied PV, 2 MPPT strings
Exact nameplate model / kW Unknown / not confirmed from nameplate
Notes on rating Integration reported inverter_power_kw: 5 after local fix; plant peak AC output observed around ~13.8 kW, so the 5 kW figure may be wrong or incomplete — please do not treat it as confirmed nameplate data

Local fix that worked

Adding the following mappings as PV | GEN2 | X3 fixed detection and allowed the normal PV entity set to populate:

# SERIAL_PREFIX_TYPES
"SZG": PV | GEN2 | X3,  # 3-phase PV, 2 MPPT (serial SZGDCL505K)

# FIRMWARE_PREFIX_TYPES
"TJ1": PV | GEN2 | X3,  # firmware TJ1.0 (SZG serials)

Suggested placement in current plugin_growatt.py (main):

  • Near other serial prefixes such as "RPH": PV | GEN2 | X3 in SERIAL_PREFIX_TYPES
  • Near other firmware prefixes such as "DM1": PV | GEN2 | X3 | MPPT4 in FIRMWARE_PREFIX_TYPES

Optional secondary log (may be unrelated)

After entities started appearing, Home Assistant also logged:

Platform solax_modbus does not generate unique IDs. ID Growatt_SZGDCL505K_inverter_temperature already exists

Included in case it helps triage duplicate entity creation / reload behavior.

Expected behavior

SZG / TJ1 should be recognized so the Growatt plugin classifies the inverter and creates the appropriate PV entities without a local patch.

Actual behavior

Log shows unrecognized inverter type for firmware TJ1.0; classification fails until SZG and TJ1 are added to the prefix maps.

Additional context

Happy to provide more Modbus register dumps or entity lists if useful. Exact commercial model string from the nameplate is not available at filing time; classification as PV | GEN2 | X3 was validated empirically (3-phase voltages/currents and 2 PV strings reading correctly after the local mapping).

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