POINTTAPI: add per-zone optimum start state sensor

- Add dynamic per-zone sensor for /zones/{id}/optimumStartState
- Keep raw state value (no interpretation mapping yet)
- Discover sensors from zone references to avoid ghost entities
- Add translation key for all supported locales (en/de/fr/it/nl/pl/sk)
- Add tests for discovery and raw-value passthrough

Author: jfhautenauven

custom_components/bosch/pointtapi_entities.py

@@ -1448,6 +1448,24 @@ def _pointtapi_zone_assigned_program_sensor_descriptions(
     )
 
 
+def _pointtapi_zone_optimum_start_state_sensor_descriptions(
+    data: dict[str, Any] | None = None,
+) -> tuple[BoschPoinTTAPISensorEntityDescription, ...]:
+    """Return one raw optimum-start-state sensor per zone when advertised."""
+    if not data:
+        return ()
+
+    zone_ids = _zone_ids_with_reference(data, "optimumStartState")
+    return tuple(
+        BoschPoinTTAPISensorEntityDescription(
+            key=f"/zones/{zone_id}/optimumStartState",
+            translation_key="optimum_start_state",
+            entity_category=EntityCategory.DIAGNOSTIC,
+        )
+        for zone_id in zone_ids
+    )
+
+
 def _pointtapi_electricity_average_sensor_descriptions(
     data: dict[str, Any] | None = None,
 ) -> tuple[BoschPoinTTAPISensorEntityDescription, ...]:
@@ -1837,6 +1855,7 @@ def _pointtapi_sensor_descriptions(
 
     descriptions.extend(_pointtapi_zone_valve_sensor_descriptions(data))
     descriptions.extend(_pointtapi_zone_assigned_program_sensor_descriptions(data))
+    descriptions.extend(_pointtapi_zone_optimum_start_state_sensor_descriptions(data))
     descriptions.extend(_pointtapi_electricity_average_sensor_descriptions(data))
     descriptions.extend(_pointtapi_thermostat_valve_sensor_descriptions(data))
     return tuple(descriptions)

custom_components/bosch/strings.json

@@ -229,6 +229,9 @@
       "assigned_program": {
         "name": "Assigned program"
       },
+      "optimum_start_state": {
+        "name": "Optimum start state"
+      },
       "electricity_day_average": {
         "name": "Electricity day average"
       },

custom_components/bosch/translations/de.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Zugewiesenes Programm"
       },
+      "optimum_start_state": {
+        "name": "Status optimaler Start"
+      },
       "electricity_day_average": {
         "name": "Tagesdurchschnitt Strom"
       },

custom_components/bosch/translations/en.json

@@ -229,6 +229,9 @@
       "assigned_program": {
         "name": "Assigned program"
       },
+      "optimum_start_state": {
+        "name": "Optimum start state"
+      },
       "electricity_day_average": {
         "name": "Electricity day average"
       },

custom_components/bosch/translations/fr.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Programme assigné"
       },
+      "optimum_start_state": {
+        "name": "État du démarrage optimal"
+      },
       "electricity_day_average": {
         "name": "Moyenne journalière électricité"
       },

custom_components/bosch/translations/it.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Programma assegnato"
       },
+      "optimum_start_state": {
+        "name": "Stato avvio ottimale"
+      },
       "electricity_day_average": {
         "name": "Media giornaliera elettricità"
       },

custom_components/bosch/translations/nl.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Toegewezen programma"
       },
+      "optimum_start_state": {
+        "name": "Status optimaal starten"
+      },
       "electricity_day_average": {
         "name": "Daggemiddelde elektriciteit"
       },

custom_components/bosch/translations/pl.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Przypisany program"
       },
+      "optimum_start_state": {
+        "name": "Stan optymalnego startu"
+      },
       "electricity_day_average": {
         "name": "Średnia dzienna energii elektrycznej"
       },

custom_components/bosch/translations/sk.json

@@ -158,6 +158,9 @@
       "assigned_program": {
         "name": "Priradený program"
       },
+      "optimum_start_state": {
+        "name": "Stav optimálneho štartu"
+      },
       "electricity_day_average": {
         "name": "Denny priemer elektriny"
       },

unittests/test_pointtapi_new_entities.py

@@ -672,6 +672,54 @@ def test_zone_assigned_program_sensors_are_discovered_from_zone_paths(self):
         assert "/zones/zn10/assignedProgramName" in descs
         assert descs["/zones/zn2/assignedProgramName"].translation_key == "assigned_program"
 
+    def test_zone_optimum_start_state_sensors_are_discovered_from_zone_references(self):
+        data = {
+            "/zones/zn2": {
+                "references": [
+                    {"id": "/zones/zn2/optimumStartState"},
+                ]
+            },
+            "/zones/zn1": {
+                "references": [
+                    {"id": "/zones/zn1/optimumStartState"},
+                ]
+            },
+            "/zones/zn3": {
+                "references": [
+                    {"id": "/zones/zn3/status"},
+                ]
+            },
+        }
+
+        descs = {d.key: d for d in _pointtapi_sensor_descriptions(data)}
+        assert "/zones/zn1/optimumStartState" in descs
+        assert "/zones/zn2/optimumStartState" in descs
+        assert "/zones/zn3/optimumStartState" not in descs
+        assert descs["/zones/zn1/optimumStartState"].translation_key == "optimum_start_state"
+
+    def test_zone_optimum_start_state_sensor_keeps_raw_value(self):
+        data = {
+            "/zones/zn2": {
+                "id": "/zones/zn2",
+                "references": [{"id": "/zones/zn2/optimumStartState"}],
+            },
+            "/zones/zn2/temperatureHeatingSetpoint": {"value": 20.0},
+            "/zones/zn2/optimumStartState": {"value": "idle"},
+        }
+
+        coord = _mock_coordinator(data)
+        desc = next(
+            d
+            for d in _pointtapi_sensor_descriptions(data)
+            if d.key == "/zones/zn2/optimumStartState"
+        )
+        ent = BoschPoinTTAPISensorEntity(coord, "entry1", "uuid1", desc)
+        ent.async_write_ha_state = MagicMock()
+
+        ent._handle_coordinator_update()
+
+        assert ent.native_value == "idle"
+
     def test_zone_assigned_program_sensor_resolves_base64_program_name(self):
         data = {
             "/zones/zn2": {"id": "/zones/zn2"},