Add POINTTAPI heat demand type sensor from flame indication

Author: jfhautenauven

custom_components/bosch/pointtapi_entities.py

@@ -911,6 +911,17 @@ def _appliance_status_available(data: dict[str, Any]) -> bool:
     ) is not None
 
 
+def _heat_demand_type_state(data: dict[str, Any]) -> str | None:
+    """Map /heatSources/flameIndication to a stable demand-type state key."""
+    raw = _val(data, "/heatSources/flameIndication")
+    if not isinstance(raw, str):
+        return None
+    value = raw.strip().lower()
+    if value in {"off", "ch", "dhw"}:
+        return value
+    return None
+
+
 # Zone /status -> HVAC action. Unknown values map to None (unknown), never to
 # COOLING — these appliances are heating-only.
 _ZONE_STATUS_ACTIONS = {
@@ -1519,6 +1530,7 @@ def _pointtapi_sensor_descriptions(
             key="/system/appliance/causeCode",
             translation_key="cause_code",
             entity_category=EntityCategory.DIAGNOSTIC,
+            value_fn=_appliance_cause_code,
         ),
         BoschPoinTTAPISensorEntityDescription(
             key="/system/appliance/status",
@@ -1559,6 +1571,11 @@ def _pointtapi_sensor_descriptions(
             native_unit_of_measurement="%",
             icon="mdi:signal-cellular-2",
         ),
+        BoschPoinTTAPISensorEntityDescription(
+            key="/heatSources/flameIndication",
+            translation_key="heat_demand_type",
+            value_fn=_heat_demand_type_state,
+        ),
         BoschPoinTTAPISensorEntityDescription(
             key="/heatSources/returnTemperature",
             translation_key="return_temperature",

custom_components/bosch/strings.json

@@ -157,6 +157,14 @@
       "actual_modulation": {
         "name": "Actual modulation"
       },
+      "heat_demand_type": {
+        "name": "Demand type",
+        "state": {
+          "off": "No demand",
+          "ch": "Heating",
+          "dhw": "Domestic hot water"
+        }
+      },
       "collector_temperature": {
         "name": "Collector temperature"
       },

custom_components/bosch/translations/de.json

@@ -151,6 +151,14 @@
       "actual_modulation": {
         "name": "Aktuelle Modulationsleistung"
       },
+      "heat_demand_type": {
+        "name": "Anforderungsart",
+        "state": {
+          "off": "Keine Anforderung",
+          "ch": "Heizung",
+          "dhw": "Warmwasser"
+        }
+      },
       "gas_heating_today": {
         "name": "Gas Heizung heute"
       },

custom_components/bosch/translations/en.json

@@ -163,6 +163,14 @@
       "storage_temperature": {
         "name": "Storage temperature"
       },
+       "heat_demand_type": {
+         "name": "Demand type",
+         "state": {
+           "off": "No demand",
+           "ch": "Heating",
+           "dhw": "Domestic hot water"
+         }
+       },
       "pump_modulation": {
         "name": "Pump modulation"
       },

custom_components/bosch/translations/fr.json

@@ -151,6 +151,14 @@
       "actual_modulation": {
         "name": "Puissance de modulation actuelle"
       },
+      "heat_demand_type": {
+        "name": "Type de demande",
+        "state": {
+          "off": "Aucune demande",
+          "ch": "Chauffage",
+          "dhw": "Eau chaude sanitaire"
+        }
+      },
       "gas_heating_today": {
         "name": "Gaz chauffage aujourd'hui"
       },

custom_components/bosch/translations/it.json

@@ -151,6 +151,14 @@
       "actual_modulation": {
         "name": "Potenza di modulazione attuale"
       },
+      "heat_demand_type": {
+        "name": "Tipo di richiesta",
+        "state": {
+          "off": "Nessuna richiesta",
+          "ch": "Riscaldamento",
+          "dhw": "Acqua calda sanitaria"
+        }
+      },
       "gas_heating_today": {
         "name": "Gas riscaldamento oggi"
       },

custom_components/bosch/translations/nl.json

@@ -151,6 +151,14 @@
       "actual_modulation": {
         "name": "Huidige modulatiedruk"
       },
+      "heat_demand_type": {
+        "name": "Vraagtype",
+        "state": {
+          "off": "Geen vraag",
+          "ch": "Verwarming",
+          "dhw": "Warm tapwater"
+        }
+      },
       "gas_heating_today": {
         "name": "Gas verwarming vandaag"
       },

custom_components/bosch/translations/pl.json

@@ -154,6 +154,14 @@
       "gas_heating_today": {
         "name": "Gaz ogrzewanie dziś"
       },
+        "heat_demand_type": {
+          "name": "Typ zapotrzebowania",
+          "state": {
+            "off": "Brak zapotrzebowania",
+            "ch": "Ogrzewanie",
+            "dhw": "Ciepła woda użytkowa"
+          }
+        },
       "gas_hot_water_today": {
         "name": "Gaz ciepła woda dziś"
       },

custom_components/bosch/translations/sk.json

@@ -151,6 +151,14 @@
       "actual_modulation": {
         "name": "Aktuálna výkonová modulácia"
       },
+      "heat_demand_type": {
+        "name": "Typ požiadavky",
+        "state": {
+          "off": "Bez požiadavky",
+          "ch": "Vykurovanie",
+          "dhw": "Teplá úžitková voda"
+        }
+      },
       "gas_heating_today": {
         "name": "Plyn vykurovanie dnes"
       },

unittests/test_pointtapi_new_entities.py

@@ -344,6 +344,34 @@ def test_appliance_status_sensor_maps_0h_203_to_standby(self):
         assert desc.attributes_fn is not None
         assert desc.attributes_fn(data) == {"display_code": "0H", "cause_code": 203}
 
+    def test_cause_code_sensor_normalizes_float_to_int(self):
+        descs = {d.key: d for d in _pointtapi_sensor_descriptions()}
+        desc = descs["/system/appliance/causeCode"]
+        data = {"/system/appliance/causeCode": {"value": 201.0}}
+        assert desc.value_fn is not None
+        assert desc.value_fn(data) == 201
+
+    def test_heat_demand_type_sensor_is_described(self):
+        descs = {d.key: d for d in _pointtapi_sensor_descriptions()}
+        desc = descs["/heatSources/flameIndication"]
+        assert desc.translation_key == "heat_demand_type"
+        assert desc.value_fn is not None
+
+    def test_heat_demand_type_sensor_maps_known_values(self):
+        descs = {d.key: d for d in _pointtapi_sensor_descriptions()}
+        desc = descs["/heatSources/flameIndication"]
+        assert desc.value_fn is not None
+
+        assert desc.value_fn({"/heatSources/flameIndication": {"value": "off"}}) == "off"
+        assert desc.value_fn({"/heatSources/flameIndication": {"value": "ch"}}) == "ch"
+        assert desc.value_fn({"/heatSources/flameIndication": {"value": "dhw"}}) == "dhw"
+
+    def test_heat_demand_type_sensor_returns_none_for_unknown(self):
+        descs = {d.key: d for d in _pointtapi_sensor_descriptions()}
+        desc = descs["/heatSources/flameIndication"]
+        assert desc.value_fn is not None
+        assert desc.value_fn({"/heatSources/flameIndication": {"value": "unexpected"}}) is None
+
     def test_appliance_status_sensor_maps_unknown_pair_to_unknown(self):
         descs = {d.key: d for d in _pointtapi_sensor_descriptions()}
         desc = descs["/system/appliance/status"]