ym88659208ym87991671
Устройство hvac_ac | Документация для разработчиков

hvac_ac

Обновлено 30 августа 2023

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

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

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

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

ФункцияОбязательная?Описание
humidityТекущая влажность
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✔︎Доступность устройства: офлайн или онлайн
temperatureТекущая температура

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

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

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

{
"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"
],
"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"
},
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.