Схема ThermostatEco
sdm.devices.traits.ThermostatEco
Данная характеристика свойственна типам устройств ТЕРМОСТАТ, поддерживающим ЭКО-режимы.
Поля
Поле | Описание | Тип данных |
---|---|---|
availableModes | Список поддерживаемых эко-режимов. | array(string) Значение: ["MANUAL_ECO", "OFF"] |
mode | Текущий Эко-режим термостата. | string Значения: «MANUAL_ECO», «OFF» |
heatCelsius | Самая низкая температура в градусах Цельсия, при которой термостат начинает обогрев в режиме Eco. | number Пример: 20.0 |
coolCelsius | Самая высокая температура в градусах Цельсия, при которой термостат начинает охлаждение в режиме Eco. | number Пример: 22.0 |
Пример запроса GET и ответа
Запрос
GET /enterprises/project-id/devices/device-id
Ответ
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatEco
" : {
"availableModes" : ["MANUAL_ECO", "OFF"],
"mode" : "MANUAL_ECO",
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Команды
Установить режим
Измените режим термостата на Эко.
Чтобы изменить режим термостата на HEAT, COOL или HEATCOOL, используйте команду SetMode свойства ThermostatMode.
Эта команда влияет на другие характеристики в зависимости от текущего состояния или изменений в режиме Eco:
- Если режим Eco выключен, режим термостата по умолчанию будет соответствовать последнему стандартному режиму (HEAT, COOL, HEATCOOL или OFF), который был активен.
- Если режим Eco — MANUAL_ECO:
- Команды для Заданная температура термостата признак отвергается.
- Уставки температуры не возвращаются Заданная температура термостата черта.
Запрос и ответ SetMode
Запрос
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
Ответ
{}
Поля запроса SetMode
Поле | Описание | Тип данных |
---|---|---|
mode | Эко-режим, в который следует переключить термостат. | string Значения: «MANUAL_ECO», «OFF» |
Ошибки
В отношении этого признака могут быть возвращены следующие коды ошибок:
Сообщение об ошибке | RPC | Поиск неисправностей |
---|---|---|
Команда не разрешена в текущем режиме термостата. | FAILED_PRECONDITION | Некоторые модели термостатов не поддерживают изменение режима Eco, когда режим термостата выключен, согласно Режим термостата Перед изменением режима Eco необходимо изменить режим термостата на HEAT, COOL или HEATCOOL. |
Команда не допускается, когда термостат находится в режиме MANUAL_ECO. | FAILED_PRECONDITION | Заданное значение температуры невозможно задать, если термостат находится в ручном режиме Eco. |
Полный список кодов ошибок API см. в Справочнике кодов ошибок API.