Схема термостата Eco

Термостат Nest

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 .

Некоторые модели термостатов не поддерживают изменение экономичного режима, когда режим термостата ВЫКЛЮЧЕН, согласно свойству ThermostatMode . Перед изменением режима Eco необходимо изменить режим термостата на HEAT, COOL или HEATCOOL.

Запрос и ответ 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	Некоторые модели термостатов не поддерживают изменение экономичного режима, когда режим термостата ВЫКЛЮЧЕН, согласно свойству ThermostatMode . Перед изменением режима Eco необходимо изменить режим термостата на HEAT, COOL или HEATCOOL.
Команда не разрешена, когда термостат находится в режиме MANUAL_ECO.	FAILED_PRECONDITION	Заданное значение температуры невозможно установить, когда термостат находится в ручном экономичном режиме.

Полный список кодов ошибок API см. в Справочнике кодов ошибок API.