hvac_humidifier

Обновлено 13 апреля 2025

Увлажнитель воздуха.

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

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

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

Функция	Обязательная?	Описание
humidity		Текущая влажность
hvac_air_flow_power		Скорость вентилятора
hvac_humidity_set		Влажность воздуха, которую необходимо достичь
hvac_ionization		Режим ионизации
hvac_night_mode		Ночной режим работы
hvac_replace_filter		Нужно ли менять фильтр
hvac_replace_ionizator		Нужно ли менять ионизатор
hvac_water_level		Количество воды в баке в литрах
hvac_water_low_level		Закончилась ли вода в баке
hvac_water_percentage		Количество воды в баке в процентах
on_off	✔︎	Удаленное включение и выключение устройства
online	✔︎	Доступность устройства: офлайн или онлайн

Пример описания модели увлажнителя воздуха

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

Кроме того, у модели изменены доступные значения для функции hvac_air_flow_power (скорость вентилятора): эта модель не поддерживает тихий режим работы quiet, он исключен.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный увлажнитель воздуха Xiaqara",
   "category": "hvac_humidifier",
   "features": [
      "humidity",
      "hvac_air_flow_power",
      "hvac_humidity_set",
      "hvac_ionization",
      "hvac_night_mode",
      "hvac_replace_filter",
      "hvac_replace_ionizator",
      "hvac_water_low_level",
      "hvac_water_percentage",
      "on_off",
      "online"
   ],
   "allowed_values": {
      "hvac_air_flow_power": {
         "type": "ENUM",
         "enum_values": {
            "values": [
               "auto",
               "high",
               "low",
               "medium",
               "turbo"
            ]
         }
      }
   }
}

Пример описания увлажнителя воздуха пользователя

Устройство описывается в соответствии со структурой 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"
    },
}