Skip to content

v1.0.1

Choose a tag to compare

@0xAHA 0xAHA released this 04 Jul 05:01

Fix: Battery SOC permanently stuck at 0% after VPP read failure (#340)

The optional VPP register range (31000+) was latched permanently into a skip-list after a single transient read failure. Any inverter that returned a timeout on first boot would report battery_soc = 0% for the entire session until HA restart.

Two-part fix:

  1. Time-based retry — failed ranges retry after 300 seconds. First failure logs WARNING; subsequent failures within the window log DEBUG.
  2. SOC cache — within the retry window, the last known-good SOC value is served instead of 0.0, with a WARNING log indicating cached value is in use.

New: Dry contact relay controls (#339)

SPH and MIN TL-X/TL-XH inverters have a hardware dry contact output that triggers when PV output crosses a configurable power threshold (V1.39 registers 3016/3017/3019/3119).

New entities (appear automatically when the profile contains the registers):

  • Dry Contact Enable (reg 3016) — select: Disabled / Enabled
  • Dry Contact On Rate (reg 3017) — number: 0.0–100.0%, step 0.1% — relay closes above this PV output threshold
  • Dry Contact Off Rate (reg 3019) — number: 0.0–100.0%, step 0.1% — relay opens below this threshold
  • Dry Contact State (reg 3119) — diagnostic sensor (disabled by default): Off / On

Profiles updated: SPH 3-6kW, SPH 7-10kW, SPH 8-10kW HU, SPH-TL3 3-10kW, MIN 3-6kW, MIN 7-10kW (and V2.01 variants).