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

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