Bump version to v1.1.9 — TL-XH profiles were unrenderable in the options flow (#361)

Reported by Richardmarkink: opening Configure to change the scan interval failed
with "value must be one of [...]" and no option could be saved.

Auto-detection assigns tl_xh_3000_10000_v201 for DTC 5100, but that profile had
no PROFILE_DISPLAY_NAMES entry. The options form resolves the stored profile ID
to a display name to pre-select it; with no entry,
get_display_name_for_profile() falls through to the profile's technical `name`,
which is not a key of available_profiles, so vol.In() rejected the default and
the whole form became unsavable. Every option was unreachable — not just the
profile selector.

Four profiles affected, all reachable via auto-detection: tl_xh_3000_10000,
tl_xh_us_3000_10000, tl_xh_3000_10000_v201, tl_xh_us_3000_10000_v201. Added two
dropdown entries covering them: "TL-XH (3-10kW)" and "TL-XH US (3-10kW)".

This is the same defect as the missing SPA entry fixed in v1.1.6, so two guards
are added rather than just the data:

- device_profiles.py asserts at import that every INVERTER_PROFILES key is
  reachable from PROFILE_DISPLAY_NAMES via 'base' or 'v201', and logs a warning
  naming any that are not. Audited: 32/32 profiles now reachable, 0 orphans.
- config_flow.py detects an unrenderable default and falls back to a valid one
  with a warning instead of building a form that cannot be submitted. The stored
  profile is untouched — only the form's pre-selected value changes.

Also diagnosed but NOT fixed here: solar reads zero on MIN TL-XH2 because
MIN_TL_XH_3000_10000_V201 unpacks VPP_V201_STATUS and VPP_V201_BATTERY2 but not
VPP_V201_PV2_INPUT (31010-31017), so PV is sourced from 3000-range registers the
hardware does not serve. Battery works because that profile's cluster-1 battery
registers are inline at 31200+, which does respond. Needs the dedicated TL-XH2
profile.

Battery register mapping now confirmed against the Growatt app by Richardmarkink:
31217 = SOC (75%) and 31214 = battery voltage both match.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: 0xAHA

README.md

@@ -3,7 +3,7 @@
 # Growatt Modbus Integration for Home Assistant ☀️
 
 ![HACS Badge](https://img.shields.io/badge/HACS-Custom-orange.svg)
-![Version](https://img.shields.io/badge/Version-1.1.8-blue.svg)
+![Version](https://img.shields.io/badge/Version-1.1.9-blue.svg)
 [![GitHub Issues](https://img.shields.io/github/issues/0xAHA/Growatt_ModbusTCP.svg)](https://github.com/0xAHA/Growatt_ModbusTCP/issues)
 [![GitHub Stars](https://img.shields.io/github/stars/0xAHA/Growatt_ModbusTCP.svg?style=social)](https://github.com/0xAHA/Growatt_ModbusTCP)
 

RELEASENOTES.md

@@ -4,6 +4,43 @@
 
 ---
 
+## v1.1.9
+
+Issues: #361
+
+- **Fix: auto-detected TL-XH inverters were locked out of the options flow entirely:**
+  Reported by @Richardmarkink. Opening **Configure** to change something unrelated — scan
+  interval, for example — failed to save with:
+
+  > value must be one of ['MIC (0.6-3.3kW)', … 'WIT (4-15kW)']
+
+  Auto-detection assigns `tl_xh_3000_10000_v201` for DTC 5100, but that profile had **no
+  entry in `PROFILE_DISPLAY_NAMES`**. The options form resolves the stored profile to a
+  display name to pre-select it; with no entry, the lookup fell through to the profile's
+  technical `name`, which isn't a valid dropdown key — so validation rejected the form
+  before any change could be saved. Every option was unreachable.
+
+  Four profiles were affected, all reachable via auto-detection:
+  `tl_xh_3000_10000`, `tl_xh_us_3000_10000`, `tl_xh_3000_10000_v201`,
+  `tl_xh_us_3000_10000_v201`.
+
+  Two new dropdown entries cover them — **TL-XH (3-10kW)** and **TL-XH US (3-10kW)**.
+
+- **Two guards so this cannot recur silently.** This was the same defect as the missing SPA
+  entry in v1.1.6, so an audit of all 32 profiles now runs at import and logs a warning for
+  any that no dropdown entry can reach (currently none). Separately, the options flow now
+  detects an unrenderable default and falls back to a valid one with a warning, rather than
+  presenting a form that cannot be saved. Your configured profile is not changed by that
+  fallback — only the value the form pre-selects.
+
+- **Note for MIN TL-XH2 owners — why solar still reads zero.** The `MIN TL-XH (V2.01)`
+  profile does not include the VPP PV register block (`31010-31017`), so PV is sourced from
+  the 3000-range registers your hardware does not serve. Battery works because that
+  profile's battery cluster is read from `31200+`, which does respond. This is not fixed by
+  a setting — it needs the dedicated TL-XH2 profile tracked in #361.
+
+---
+
 ## v1.1.8
 
 Issues: #361

custom_components/growatt_modbus/config_flow.py

@@ -900,6 +900,23 @@ async def async_step_init(
         # Convert current profile ID to display name for default
         current_display_name = get_display_name_for_profile(current_series)
 
+        # get_display_name_for_profile() falls back to the profile's technical `name` when
+        # the profile has no PROFILE_DISPLAY_NAMES entry. That value is not a valid dropdown
+        # key, so vol.In() below would reject the default and the user could not save ANY
+        # option change — locked out of scan interval, modbus delay, everything (Issue #361,
+        # where auto-detection assigned tl_xh_3000_10000_v201 for DTC 5100).
+        #
+        # The missing entries are added, but keep this guard: an unrenderable default should
+        # degrade to "profile shown as something else" rather than a dead options page.
+        if current_display_name not in available_profiles:
+            _LOGGER.warning(
+                "Profile '%s' has no display-name entry (resolved to '%s', which is not a "
+                "valid option). Falling back to the first available profile for the form "
+                "default — the configured profile is unchanged unless you select a new one.",
+                current_series, current_display_name,
+            )
+            current_display_name = next(iter(available_profiles), "MIN (7-10kW)")
+
         options_schema = vol.Schema({
             vol.Required(
                 "device_name",

custom_components/growatt_modbus/device_profiles.py

@@ -937,7 +937,40 @@
         "v201": "spa_3000_6000_tl_bl",  # Only one variant
         "description": "AC-coupled battery storage, no solar DC inputs",
     },
+
+    # TL-XH (non-MIN variants)
+    # Missing from this dict until v1.1.9 (Issue #361). Auto-detection assigns
+    # tl_xh_3000_10000_v201 for DTC 5100, but with no display-name entry the options flow
+    # could not render it: get_display_name_for_profile() fell through to the profile's
+    # technical `name`, which is not a valid dropdown key, so vol.In() rejected the default
+    # and the user was locked out of changing ANY option ("value must be one of [...]").
+    "TL-XH (3-10kW)": {
+        "base": "tl_xh_3000_10000",
+        "v201": "tl_xh_3000_10000_v201",
+        "description": "Single-phase hybrid with battery, legacy 0-124 + VPP ranges",
+    },
+    "TL-XH US (3-10kW)": {
+        "base": "tl_xh_us_3000_10000",
+        "v201": "tl_xh_us_3000_10000_v201",
+        "description": "US single-phase hybrid with battery (split-phase)",
+    },
+}
+
+# Every INVERTER_PROFILES key MUST be reachable from PROFILE_DISPLAY_NAMES via 'base' or
+# 'v201'. A profile that isn't cannot be rendered by the options flow — see the TL-XH note
+# above. This has bitten twice (SPA in #360, TL-XH in #361), so assert it at import time
+# rather than waiting for a user to hit it.
+_ORPHANED_PROFILES = {
+    pid for pid in INVERTER_PROFILES
+    if not any(pid in (info["base"], info["v201"]) for info in PROFILE_DISPLAY_NAMES.values())
 }
+if _ORPHANED_PROFILES:  # pragma: no cover — guards a developer error, not runtime state
+    import logging as _logging
+    _logging.getLogger(__name__).warning(
+        "Profiles with no PROFILE_DISPLAY_NAMES entry — these cannot be selected or "
+        "reconfigured in the options flow: %s",
+        ", ".join(sorted(_ORPHANED_PROFILES)),
+    )
 
 
 def resolve_profile_alias(series: str) -> str:

custom_components/growatt_modbus/manifest.json

@@ -12,5 +12,5 @@
     "pymodbus>=3.0.0",
     "pyserial>=3.4"
   ],
-  "version": "1.1.8"
+  "version": "1.1.9"
 }