Схема ThermostatEco

Термостат Nest

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:

Запрос и ответ 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.