Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Термостат

Термостат управления

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

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

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

  • Структура имени и устройства «где имя» (местоположение в доме)
  • Специальная этикетка термостата
  • Онлайн статус и информация о последнем подключении
  • Текущие и целевые температуры
  • Температурный режим
  • Эко температуры
  • Время-температура
  • Температурная шкала (настройка F / C)
  • Состояние блокировки температуры и, если заблокировано, минимальные / максимальные заблокированные значения температуры
  • Продолжительность таймера вентилятора и режим HVAC
  • влажность
  • Sunblock

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

Чтобы получить доступ ко всем значениям данных API-интерфейса Thermostat, выберите разрешение на чтение Thermostat для своего клиента.

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

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

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

  • Шкала температуры
  • Этикетка термостата

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

устройство

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

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

название

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

name

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

названиеИмя длинное

name_long

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

Длинное имя в сообщении

метка

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

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

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

куда

where_id

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

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

where_name

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

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

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

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

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

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

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

  • Если выбран режим «Нагрев» или «Охлаждение» ( heat , cool ), термостат подгоняет дом к целевой температуре.
  • Когда выбран режим «Heat • Cool» ( heat-cool ), термостат будет поддерживать комфорт в доме в предпочтительном температурном диапазоне.
  • При выборе Eco Temperatures (eco) термостат будет применять энергосберегающие алгоритмы, чтобы поддерживать комфорт в доме и сокращать потребление энергии. Термостаты в этом режиме отображают ECO.

Структуры имеют два состояния, связанных с присутствием: дома или в гостях. Когда в доме не ощущается движение, структура изменится с дома на выезд, а термостаты в доме автоматически активируют эко-температуру.

Как 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 :

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

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

Экологические температуры позволяют пользователю экономить энергию независимо от того, дома они или нет. Подумайте о hvac_mode чтобы переключить hvac_mode в hvac_mode eco при реализации энергосберегающего поведения в вашем продукте.

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

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

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

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

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

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

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

  1. получить previous_hvac_mode
  2. установите hvac_mode в значение previous_hvac_mode
  3. подтвердите, что hvac_mode больше не установлен в "eco"

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

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

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

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

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

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

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

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

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

Время-температура

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

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

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

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

Шкала температуры

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

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

Поля Target и Ambient Temperature имеют _f и _c для согласованного округления при отображении температуры.

Дисплей температуры

Термостат

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

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

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

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

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

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

Температура в градусах Цельсия отображается в виде целого числа или десятичного значения, причем последняя цифра установлена ​​на «.5»:

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

лист

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

лист

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

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

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

влажность

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

Sunblock

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

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

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

Поклонник

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Узнайте больше о низком заряде батареи в Nest Learning Thermostat .

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

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

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

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

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