hvac_boiler

Обновлено 13 октября 2023

Котел, контроллер отопления.

Доступные функции устройства

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если котел не умеет управлять скоростью нагрева, включать функцию hvac_heating_rate в описание его модели не нужно.

У устройства есть две обязательные функции: online, on_off. Они должны быть у всех котлов.

Функция	Обязательная?	Описание
hvac_heating_rate		Скорость нагрева
hvac_temp_set		Температура, которую необходимо достичь
hvac_thermostat_mode		Режим работы термостата
on_off	✔︎	Удаленное включение и выключение устройства
online	✔︎	Доступность устройства: офлайн или онлайн
temperature		Текущая температура

Пример описания модели котла

Модель описывается в соответствии со структурой model. В примере описан котел, который обладает всеми функциями, кроме управления скоростью нагрева.

Кроме того, у модели изменены доступные значения для функции hvac_temp_set (целевая температура): указано, что устройства этой модели умеют нагревать воду в диапазоне от 25 до 80 °C с шагом в 5 °C.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный водонагреватель Xiaqara",
   "category": "hvac_boiler",
   "features": [
      "hvac_temp_set",
      "hvac_thermostat_mode",
      "on_off",
      "online",
      "temperature"
   ],
   "allowed_values": {
      "hvac_temp_set": {
         "type": "INTEGER",
         "integer_values": {
            "min": "25",
            "max": "80",
            "step": "5"
         }
      }
   }
}

Пример описания котла пользователя

Устройство описывается в соответствии со структурой device. В примере нет описания модели котла — считаем, что модели описаны отдельно, поэтому достаточно указать только ID модели (здесь — QWERTY124).

{
   "id": "ABCD_004",
   "name": "Мой водонагреватель",
   "default_name": "Умный водонагреватель",
   "nicknames": ["Смарт-водонагреватель", "Управляемый водонагреватель"],
   "home": "Мой дом",
   "room": "Гостиная",
   "groups": ["Климат", "Вода"],
   "model_id": "QWERTY124",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "partner_meta": {
      "internal-id": 1234,
      "specificity": "microchip 2A"
   },
}