Google is committed to advancing racial equity for Black communities. See how.

Термостат

Управление термостатом

Nest Learning Thermostat ™ является подключенного к Интернету устройство , которое является интуитивно понятным и простым в использовании, постоянно узнавая о модели использования в домашних условиях для комфорта оптимизируют и экономии энергии. Пользователи могут управлять своим обогревом и охлаждением везде, где есть доступ к Интернету.

Для поддержки этих функций требуется сложная система управления, которая выходит за рамки простых программ, основанных на заданных значениях. Nest предоставляет широкий спектр алгоритмов (например , на ранних стадиях , Истинный Radiant , Airwave ™ ) , которые требуют значительного количества вычислительной мощности по сравнению с большинством термостатов. Термостат Nest обладает мощностью, необходимой для обеспечения этих расширенных функций.

Nest API разработан , чтобы позволить продукты для управления системой вентиляции и кондиционирования , не нарушая алгоритмы Nest или удивляя пользователь с неожиданным поведением. Они обеспечивают доступ к следующим данным для термостата Nest:

  • Название структуры и устройство "где имя" (местонахождение в доме)
  • Пользовательская этикетка термостата
  • Информация о онлайн-статусе и последнем подключении
  • Текущая и целевая температуры
  • Температурный режим
  • Эко температуры
  • Время до температуры
  • Температурная шкала (установка F / C)
  • Блокировка температура состояние, и если он заблокированы, мин / макс заблокированных значения температуры
  • Продолжительность таймера вентилятора и режим HVAC
  • Влажность
  • Крем для загара

Разрешения термостата

Для чтения доступа ко всем значениям данных API Термостат, выберите термостат чтение разрешения для вашего клиента.

Для чтения доступа ко всем значениям данных Термостат API и дополнительный доступ к записи для выбора значений, выберите термостат чтения / записи разрешения для вашего клиента. Этот уровень разрешений позволяет обновлять следующее:

  • Целевая температура
  • Режим HVAC
  • Таймеры вентилятора

Начиная с версии 5 для чтения / записи термостата, вы также можете обновить следующее:

  • Температурная шкала
  • Этикетка термостата

Идентификаторы термостата

Устройство

Вложенные устройства перечислены по типу в виде массива идентификаторов, которые можно использовать для однозначной идентификации устройства по пути к устройству. Так термостате идентификатор "peyiJNo..." означает , что вы можете загрузить модель термостата устройства на devices/thermostats/peyiJNo... через API.

Когда устройство подключено к нескольким продуктам, каждый разработчик будет видеть свой идентификатор для этого устройства. Для устройства, на котором установлено несколько продуктов от одного разработчика, разработчик увидит один и тот же идентификатор.

Имя

Предусмотрены два атрибута имени. Чем короче name атрибут отображаются в интерфейсе пользователя этикетках, в то время как name_long используются в длинной форме текста.

name

В этих примерах name является «Коридор» или «Прихожие (West)».

ИмяИмя длинное

name_long

В этом примере, name_long является «Офис (Наверху)».

Имя в сообщении

Этикетка

Где имя (метка)
Где имя (метка)

Начиная с разрешением версии v5 , вы можете добавить настраиваемый термостат ярлыка через API. В приложении Nest метка отображается в скобках после имени where.

Начиная с разрешением версии v6 , вы также можете прочитать этикетку термостата.

Где

where_id

  • Уникальный, гнездо сгенерированный идентификатор , который представляет собой name
  • where_id только для чтения, и создается автоматически при вызове , чтобы создать пользовательские где name

Узнайте больше о том, где названия Nest термостатов ,гнездо защищает и гнездо Cams .

where_name

При выборе любого из разрешений Термостата , вы можете получить доступ к устройству where_name от устройства объекта ( devices/thermostats ).

Другие метаданные

Все значения данных доступны только для чтения, если не указано иное.

Значение данных Описание
locale Язык и код страны, присвоенные этому устройству.
software_version Строка, представляющая прошивку, установленную в данный момент на устройстве.
structure_id Строка, однозначно представляющая эту структуру; это структура, с которой связано устройство
last_connection Отметка времени последнего успешного подключения к службе Nest.
is_online Статус онлайн. Это определяется гнездом с использованием last_connection времени и ожидаемое окна повторного соединения, которое конкретное устройство.

Особенности термостата

Режимы термостата

Системы вентиляции и кондиционирования имеют четыре «на» состояниях ( heat , cool , heat-cool , eco ) и один «выключено» ( off ). Мы используем эти состояния для управления комфорта и экономии энергии за счет hvac_mode значений данных и температуры.

  • Когда тепло или холодный режим ( heat , cool выбран), термостат регулирует дом до заданной температуры.
  • Когда тепло • Режим Холодного ( heat-cool выбран), то термостат будет держать дома комфортно, в предпочтительном температурном диапазоне.
  • Когда Eco температура выбрана (эко) Термостат будет использовать алгоритмы энергосбережения , чтобы сохранить дом комфортным и снизить потребление энергии. Термостаты в этом режиме показывают ECO.

У структур есть два состояния, связанных с присутствием: дома или вдали. Когда в доме не наблюдается движения, структура изменится с дома на прочь, а термостаты в доме автоматически включат режим Eco Temperatures.

Как hvac_mode и температурные значения работают вместе

В зависимости от значения hvac_mode , только определенные значения данных температур могут быть доступны в API:

Режим HVAC Доступные значения температурных данных
heat или cool target_temperature_f или target_temperature_c
heat-cool target_temperature_low_f и target_temperature_high_f
или же
target_temperature_low_c и target_temperature_high_c
eco eco_temperature_low_f и eco_temperature_high_f
или же
eco_temperature_low_c и eco_temperature_high_c
off никто

В некоторых случаях существуют специальные правила вокруг изменяющегося hvac_mode :

Сценарий Может hvac_mode быть изменен?
Температура Блокировка включена да
Аварийный запорно активен Нет
Аварийное тепло включено Нет
can_cool или can_heat значение false Нет

Эко температуры

Eco Temperatures позволяет пользователю экономить электроэнергию вне зависимости от того, дома он или нет. Рассмотрим переключение hvac_mode к eco при внедрении энергосберегающих поведения в вашем продукте.

Eco температуры оконечные доступны в гнезде API , начиная с термостатом чтения и чтения / разрешения v6 записи.

Переключение между экономичным и неэкономичным режимами

Вашему продукту не требуется регулировать целевую температуру непосредственно в экономичном режиме. Когда дом находится вдали от дома, целевая температура не отображается, но устанавливается внутри на основе выбора пользователя. Когда термостат выключен, заданные температуры не наблюдаются.

Если вам абсолютно необходимо изменить целевую температуру напрямую, обязательно сделайте это двумя отдельными вызовами:

  1. Изменение hvac_mode в любое другое значение , кроме eco
  2. Изменить соответствующие target_temperature значения данных

Начиная с термостатом чтения и чтения / записи разрешения v6, вы можете получить доступ к previous_hvac_mode через API , чтобы помочь с переходами режима вентиляции и кондиционирования. previous_hvac_mode используется для хранения hvac_mode устройства , прежде чем он перешел к «эко».

Например, если гнездо Термостат использует Eco Температуры ( hvac_mode = "eco" ), previous_hvac_mode доступен, и вы хотите , чтобы ваш продукт , чтобы установить target_temperature , то вы должны сначала:

  1. прибудете previous_hvac_mode
  2. Набор hvac_mode к previous_hvac_mode значению
  3. подтверждение hvac_mode больше не установлен в «эко»

После этих шагов установите нужные целевые температуры.

В зависимости от hvac_mode значения, это как previous_hvac_mode изменения:

Когда hvac_mode состояние ... Затем previous_hvac_mode может быть ...
eco heat , cool , heat-cool или off
heat , cool , heat-cool или off пустой / пустой

Целевая температура

Целевая температура является наиболее важным значением для системы отопления, вентиляции и кондиционирования воздуха - это желаемая температура, обычно устанавливаемая пользователем. На нем основано большинство действий и решений. Из API продукты Works with Nest могут записывать целевую температуру как часть более крупного процесса.

Когда система включена, всегда устанавливается заданная температура.

  • Когда нагрев или охлаждение режим ( heat , cool выбрано), один target_temperature находится множество
  • Когда тепло • Режим Холодный ( heat-cool выбран), два target_temperature значение установлено, обозначающим целевой диапазон, более высокий один для охлаждения и более низкой для отопления
  • При включении режима Eco ( eco выбран), диапазон заданной температуры внутренне установлен

Существуют также безопасные температуры, которые предотвращают замерзание труб или чрезмерно высокие температуры в доме.

Когда термостат выключен, целевые температуры не устанавливаются.

Время до температуры

Время-температура дает доступ к этим значениям данных для системы вентиляции и кондиционирования:

  • time_to_target - время, в течение нескольких минут, что потребуется для структуры , чтобы достичь заданной температуры
  • time_to_target_training
    • Статус обучения
    • Когда термостат изучает реакцию системы отопления, вентиляции и кондиционирования воздуха, он корректирует оценку достижения заданной температуры.
    • Когда термостат с достаточной степенью уверенности в оценке времени для достижения заданной температуры, состояние изменится от training к ready

Температура окружающей среды

Температура, измеренная возле термостата. Отобразите значение, соответствующее предпочтительной шкале температуры пользователя.

Температурная шкала

Переменные окружающей и целевой температуры организованы по шкале Цельсия или Фаренгейта. temperature_scale атрибут будет либо «F» , или «С», в зависимости от предпочтений пользователя. Это свойство устанавливается каждым термостатом, поэтому возможно, что в одной структуре пользователь может иметь два термостата, по одному в каждой шкале температур. Держите предпочтения пользователей в виде при отображении значений температуры.

Начиная с разрешением версии v5 , вы можете изменить масштаб температуры через API.

Целевые и Окружающие температурных полей имеют _f и _c варианты для размещения последовательного округления при отображении температуры.

Отображение температуры

Термостат

При отображении информации о температуре цели, рассмотрим эти три зависимые значения: temperature_scale , hvac_mode , а структура в away состояние.

Многие значения данных работают вместе, чтобы определить, что отображается на дисплее термостата Nest и как он себя ведет.

  • Когда hvac_mode установлен в heat-cool , гнездо термостат отображает низкий и высокие заданные значения отделено друг от друга символа маркеров (•), в противном случае отображается гнездо Термостат только заданная температура
  • Когда hvac_mode установлен в положение off , слово «OFF» отображается на гнездо термостата, в предпочтительном языке пользователя
  • Когда hvac_mode установлен в eco , слово «ECO» отображается на гнездо термостата, в предпочтительном языке пользователя

Формат отображения температуры также зависит от выбранной шкалы температур (F / C).

Температуры по Фаренгейту отображаются целыми числами:

  • Целевая температура: 55 ° F
  • Температура окружающей среды: 62 ° F

Температуры по Цельсию отображаются в виде целого числа или десятичного числа с последней цифрой ".5":

  • Целевая температура: 12 ° C
  • Температура окружающей среды: 16,5 ° C

Лист

Когда значок листьев показывает на передней панели термостата, термостат установлен до температуры энергосберегающей и has_leaf = true .

Лист

Блокировка температуры

Пользователи могут заблокировать термостат Nest, чтобы его можно было регулировать только в ограниченном диапазоне температур. Начиная с разрешения версии v5 , вы можете увидеть , если температура блокировки включается проверка is_locked , и если да, то прочитайте Температура блокировки мин / макс значения через API:

Температуры блокировки должны быть указаны в парах, так как максимальных и минимальных значений, и может быть записана только в том случае is_locked = true .

Влажность

Влажность в формате процентов (%), измеренная на устройстве, с округлением до ближайших 5%.

Крем для загара

Sunblock технология автоматически регулирует температуру на Nest Термостат для компенсации тепловых пиков , которые происходят от прямого солнечного света на единицу.

Эти значения данных сообщат вам, включен ли солнцезащитный крем и / или активно ли корректируется температура.

  • sunlight_correction_enabled
    • логическое значение, возвращает true , если Sunblock включен
  • sunlight_correction_active - булевы, возвращается true , если Sunblock активен, указывая , что термостат находится под прямыми солнечными лучами

Поклонник

Многие системы HVAC имеют встроенные вентиляторы, что означает , что вентилятор не может управляться независимо друг от друга . Для встроенных вентиляторов нет режима выключения, потому что вентилятор должен работать при включенном обогреве или охлаждении.

Однако, если система HVAC совместима, вентилятор можно явно включить через API, чтобы повысить комфорт пассажиров, не задействуя всю систему HVAC.

Если вентилятор можно регулировать независимо друг от друга, has_fan будет установлен true , и следующие значения данных могут быть установлены с помощью термостата разрешения на чтение / запись:

  • fan_timer_active - логическое, возвращает true , если таймер вентилятор включен на запрограммированный период
  • fan_timer_duration - INT, длительность времени (в минутах) , что вентилятор установлен для запуска

Используйте эти значения вместе, чтобы запустить таймер вентилятора (включить вентилятор) на определенный период времени. Вы можете также использовать fan_timer_timeout значение для определения метки времени , когда вентилятор установлен , чтобы остановить работу.

Обратите внимание , что вы всегда можете изменить fan_timer_duration - это не зависит от hvac_mode или структура занятости государства (прочь).

Вы можете ожидать этих ответов в случае успеха или неудачи:

  • 200 ОК
  • ошибка 400, неверный запрос

Если команда на включение вентилятора не дает ожидаемого результата, это может быть связано с тем, что вентилятор уже включен (вручную пользователем, по расписанию или из-за цикла обогрева / охлаждения HVAC).

Ограничение скорости

Мы применяем ограничение скорости для защиты от чрезмерных вызовов устройств, которые могут повлиять на работу системы или аккумулятора. В нормальных условиях устройства Nest заряжают аккумулятор от низковольтных проводов системы отопления и охлаждения. Но если за короткий период времени будет совершено слишком много звонков и уровень заряда батареи станет низким, термостат Nest отключит Wi-Fi для экономии энергии.

На практике это означает, что мы ограничиваем количество вызовов, которые могут быть сделаны на устройство в течение определенного периода времени. Если вы превысите этот лимит, вы получите ответ об ошибке и сообщение о том, что вы превысили лимит.

Для получения дополнительной информации см скорости передачи данных Limits .

Ограничения мощности

В некоторых случаях термостату может не хватить заряда батареи для обслуживания запроса на модификацию. В этом случае вы получите ответ об ошибке и сообщение о том, что устройство не может в данный момент обработать запрос. В этом случае дайте аккумулятору немного подзарядиться, прежде чем пытаться снова.

Подробнее об условиях низкой батареи в самообучающийся термостат Nest .

Сообщения об ошибках

В некоторых штатах некоторые функции недоступны. Эти правила действуют для экономии энергии или обеспечения комфорта и безопасности.

Для получения информации о том , что означают ошибки API вызова и как обращаться с ними, увидеть сообщения об ошибках .

Проблема с Wi-Fi / подключением

Если устройство не в сети, модификации не разрешены. Вы можете наблюдать за онлайн-состоянием устройства в модели данных и соответствующим образом отображать пользовательский интерфейс.