Схема термостата Eco
sdm.devices.traits.ThermostatEco
Эта особенность относится к типам устройств ТЕРМОСТАТ, поддерживающим ЭКО-режимы.
Поля
Поле | Описание | Тип данных |
---|---|---|
availableModes | Список поддерживаемых режимов Eco. | array(string) Значение: ["MANUAL_ECO", "OFF"] |
mode | Текущий эко-режим термостата. | string Значения: «MANUAL_ECO», «OFF» |
heatCelsius | Самая низкая температура в градусах Цельсия, при которой термостат начинает нагреваться в экономичном режиме. | number Пример: 20,0 |
coolCelsius | Самая высокая температура в градусах Цельсия, при которой термостат начинает охлаждение в экономичном режиме. | 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
}
}
}
Команды
Установить режим
Измените режим термостата Eco.
Чтобы изменить режим термостата на HEAT, COOL или HEATCOOL, используйте команду SetMode свойства ThermostatMode.
Эта команда влияет на другие характеристики в зависимости от текущего состояния экономичного режима или изменений в нем:
- Если экономичный режим ВЫКЛ, режим термостата по умолчанию будет соответствовать последнему стандартному режиму (НАГРЕВ, ОХЛАЖДЕНИЕ, НАГРЕВ ОХЛАЖДЕНИЕ или ВЫКЛ), который был активен.
- Если экономичный режим MANUAL_ECO:
- Команды для признака ThermostatTemperatureSetpoint отклоняются.
- Уставки температуры не возвращаются чертой ThermostatTemperatureSetpoint .
Запрос и ответ 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» |
Ошибки
В связи с этим признаком могут быть возвращены следующие коды ошибок:
Сообщение об ошибке | ПКП | Поиск неисправностей |
---|---|---|
Команда не разрешена в текущем режиме термостата. | FAILED_PRECONDITION | Некоторые модели термостатов не поддерживают изменение режима Eco, когда режим термостата ВЫКЛЮЧЕН, согласно признаку ThermostatMode . Перед изменением экономичного режима необходимо изменить режим термостата на HEAT, COOL или HEATCOOL. |
Команда не разрешена, когда термостат находится в режиме MANUAL_ECO. | FAILED_PRECONDITION | Заданное значение температуры невозможно установить, когда термостат находится в ручном экономичном режиме. |
Полный список кодов ошибок API см. в Справочнике кодов ошибок API.