hvac_ac

Кондиционер — устройство, которое может менять температуру и другие характеристики воздуха в комнате.

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

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

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

Функция Обязательная? Описание
hvac_air_flow_direction Направление потока воздуха
hvac_air_flow_power Скорость вентиляторов
hvac_humidity_set Настройка влажности воздуха
hvac_ionization Режим ионизации
hvac_night_mode Ночной режим работы
hvac_temp_set ✔︎ Настройка температуры воздуха
hvac_work_mode Режим работы кондиционера
on_off ✔︎ Удаленное включение и выключение устройства
online ✔︎ Доступность устройства: офлайн или онлайн

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

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

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный кондиционер Xiaqara",
   "category": "hvac_ac",
   "features": [
      "online",
      "on_off",
      "hvac_temp_set",
      "hvac_air_flow_direction",
      "hvac_air_flow_power",
      "hvac_humidity_set",
      "hvac_night_mode",
      "hvac_work_mode"
   ]
}

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

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

{
   "id": "ABCD_004",
   "name": "Мой кондиционер",
   "default_name": "Умный кондиционер",
   "nicknames": [
      "Смарт-кондиционер",
      "Управляемый кондиционер",
   ],
   "home": "Мой дом",
   "room": "Гостиная",
   "groups": [
      "Климат",
      "Охлаждение",
   ],
   "model_id": "QWERTY124",
   "hw_version": "3.1",
   "sw_version": "5.6"
}