feat: Add floor heating device (#415)

* Create zigbee_fht.json

* add floorheating

* add tests

* Update PyViCareFloorHeatingDevice.py

* Update test_zigbee_fht.py

* Update PyViCareFloorHeatingDevice.py

* Update zigbee_fht.json

* correct class name

* fix test case

* update test data

* rename

* add autodetect entry

* fix import

* fix test case

* add FloorHeatingChannel class

* add sample data

* move files

* ignore unused data points

* add test cases

* sort testdata

Author: CFenner

PyViCare/PyViCareDeviceConfig.py

@@ -2,6 +2,7 @@
 import logging
 import re
 
+from PyViCare.PyViCareFloorHeating import FloorHeating, FloorHeatingChannel
 from PyViCare.PyViCareFuelCell import FuelCell
 from PyViCare.PyViCareGazBoiler import GazBoiler
 from PyViCare.PyViCareHeatingDevice import HeatingDevice
@@ -51,6 +52,12 @@ def asHybridDevice(self):
     def asRadiatorActuator(self):
         return RadiatorActuator(self.service)
 
+    def asFloorHeating(self):
+        return FloorHeating(self.service)
+
+    def asFloorHeatingChannel(self):
+        return FloorHeatingChannel(self.service)
+
     def asRoomSensor(self):
         return RoomSensor(self.service)
 
@@ -92,6 +99,8 @@ def asAutoDetectDevice(self):
             (self.asVentilation, r"E3_ViAir", ["type:ventilation;central"]),
             (self.asVentilation, r"E3_VitoPure", ["type:ventilation;purifier"]),
             (self.asRadiatorActuator, r"E3_RadiatorActuator", ["type:radiator"]),
+            (self.asFloorHeating, r"Smart_zigbee_fht_main|E3_FloorHeatingCircuitDistributorBox", ["type:fhtMain"]),
+            (self.asFloorHeatingChannel, r"Smart_zigbee_fht_channel", ["type:fhtChannel"]),
             (self.asRoomSensor, r"E3_RoomSensor", ["type:climateSensor"]),
             (self.asRepeater, r"E3_Repeater", ["type:repeater"]),
             (self.asGateway, r"E3_TCU41_x04", ["type:gateway;TCU100"]),

PyViCare/PyViCareFloorHeating.py

@@ -0,0 +1,32 @@
+from PyViCare.PyViCareDevice import ZigbeeDevice, Device
+from PyViCare.PyViCareUtils import handleAPICommandErrors, handleNotSupported
+
+
+class FloorHeating(ZigbeeDevice):
+
+    @handleNotSupported
+    def getSupplyTemperature(self) -> float:
+        return float(self.service.getProperty("fht.sensors.temperature.supply")["properties"]["value"]["value"])
+
+    @handleNotSupported
+    def getActiveMode(self) -> str:
+        return str(self.service.getProperty("fht.operating.modes.active")["properties"]["value"]["value"])
+
+
+class FloorHeatingChannel(Device):
+
+    @handleNotSupported
+    def getSerial(self) -> str:
+        return str(self.service.getProperty("device.name")["deviceId"])
+
+    @handleNotSupported
+    def getName(self) -> str:
+        return str(self.service.getProperty("device.name")["properties"]["name"]["value"])
+
+    @handleAPICommandErrors
+    def setName(self, name: str) -> None:
+        self.service.setProperty("device.name", "setName", {'name': name})
+
+    @handleNotSupported
+    def getValvePosition(self) -> str:
+        return str(self.service.getProperty("fht.valve.state")["properties"]["status"]["value"])

tests/response/zigbee_zk03838_fht_channel.json

@@ -0,0 +1,72 @@
+{
+  "data": [
+    {
+      "apiVersion": 1,
+      "commands": {
+        "setName": {
+          "isExecutable": true,
+          "name": "setName",
+          "params": {
+            "name": {
+              "constraints": {
+                "maxLength": 40,
+                "minLength": 1,
+                "regEx": "^[\\p{L}0-9]+( [\\p{L}0-9]+)*$"
+              },
+              "required": true,
+              "type": "string"
+            }
+          },
+          "uri": "https://api.viessmann-climatesolutions.com/iot/v2/features/installations/#######/gateways/################/devices/zigbee-################-2/features/device.name/commands/setName"
+        }
+      },
+      "deviceId": "zigbee-################-2",
+      "feature": "device.name",
+      "gatewayId": "################",
+      "isEnabled": true,
+      "isReady": true,
+      "properties": {
+        "name": {
+          "type": "string",
+          "value": "Zone EG Bad"
+        }
+      },
+      "timestamp": "2025-10-05T14:18:35.990Z",
+      "uri": "https://api.viessmann-climatesolutions.com/iot/v2/features/installations/#######/gateways/################/devices/zigbee-################-2/features/device.name"
+    },
+    {
+      "apiVersion": 1,
+      "commands": {},
+      "deviceId": "zigbee-################-2",
+      "feature": "fht.valve",
+      "gatewayId": "################",
+      "isEnabled": true,
+      "isReady": true,
+      "properties": {
+        "type": {
+          "type": "string",
+          "value": "normallyClosed"
+        }
+      },
+      "timestamp": "2025-10-05T14:18:35.990Z",
+      "uri": "https://api.viessmann-climatesolutions.com/iot/v2/features/installations/#######/gateways/################/devices/zigbee-################-2/features/fht.valve"
+    },
+    {
+      "apiVersion": 1,
+      "commands": {},
+      "deviceId": "zigbee-################-2",
+      "feature": "fht.valve.state",
+      "gatewayId": "################",
+      "isEnabled": true,
+      "isReady": true,
+      "properties": {
+        "status": {
+          "type": "string",
+          "value": "closed"
+        }
+      },
+      "timestamp": "2025-10-05T14:18:35.990Z",
+      "uri": "https://api.viessmann-climatesolutions.com/iot/v2/features/installations/#######/gateways/################/devices/zigbee-################-2/features/fht.valve.state"
+    }
+  ]
+}