hvac_underfloor_heating

Last updated on May 25, 2023

Underfloor heating.

Available device functions

The device can have all the functions listed below or some of them. E.g. if the heated floor cannot manage the heating speed, there is no need in including the hvac_heating_rate function in its model description.

The device has two mandatory functions: online, on_off. All heated floors must have them.

Function	Mandatory?	Description
hvac_heating_rate		Heating speed
hvac_temp_set		Desired temperature
hvac_thermostat_mode		Thermostat operation mode
on_off	✔︎	Turning the device on and off remotely
online	✔︎	Device availability: offline or online
temperature		Current temperature

Heated floor model description example

The model shall be described in accordance with the model structure. The example describes a heated floor equipped with all functions except for managing the heating speed.

Besides, allowed values for the hvac_temp_set function (target temperature) of the model are changed: devices of this model can be heated from 25 to 50 C at an interval of 5 C.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Xiaqara smart heated floor",
   "category": "hvac_underfloor_heating",
   "features": [
      "hvac_temp_set",
      "hvac_thermostat_mode",
      "on_off",
      "online",
      "temperature"
   ],
   "allowed_values": {
      "hvac_temp_set": {
         "type": "INTEGER",
         "integer_values": {
            "min": "25",
            "max": "50",
            "step": "5"
         }
      }
   }
}

User's heated floor description example

The device shall be describe in accordance with the device structure. The example contains no heated floor model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).

{
    "id": "ABCD_004",
    "name": "My heated floor",
    "default_name": "Smart heated floor",
    "nicknames": ["Clever heated floor", "Manageable heated floor"],
    "home": "My home",
    "room": "Living room",
    "groups": ["Climate", "Water"],
    "model_id": "QWERTY124",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A"
    },
}