Notice: We're retiring Works with Nest. See the home page for more information.
Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Termostato

Control del termostato

Nest Learning Thermostat ™ es un dispositivo conectado a Internet que es intuitivo y fácil de usar, que aprende continuamente sobre los patrones de uso en el hogar para optimizar la comodidad y ahorrar energía. Los usuarios pueden controlar su calefacción y refrigeración en cualquier lugar que tengan acceso a una conexión a Internet.

El soporte de estas características requiere un sistema de control sofisticado que va más allá de los simples programas basados ​​en puntos de ajuste. Nest proporciona una amplia gama de algoritmos (como Early On , True Radiant , Airwave ™ ) que requieren una cantidad significativa de potencia computacional en comparación con la mayoría de los termostatos. El termostato Nest tiene la potencia necesaria para proporcionar estas funciones avanzadas.

Nest API está diseñado para permitir que los productos controlen el sistema HVAC sin interrumpir los algoritmos de Nest o sorprender al usuario con comportamientos inesperados. Proporcionan acceso a los siguientes datos para el termostato Nest:

  • Nombre de la estructura y dispositivo "nombre del lugar" (ubicación en el hogar)
  • Etiqueta personalizada del termostato
  • Estado en línea e información de la última conexión
  • Temperaturas actuales y objetivo
  • Modo de temperatura
  • Temperaturas ecológicas
  • Tiempo de temperatura
  • Escala de temperatura (set F / C)
  • Estado de bloqueo de temperatura , y si está bloqueado, los valores de temperatura bloqueada mínima / máxima
  • Duración del temporizador del ventilador y modo HVAC
  • Humedad
  • Bloqueador solar

Permisos del termostato

Para obtener acceso de lectura a todos los valores de datos de la API del termostato, seleccione el permiso de lectura del termostato para su cliente.

Para obtener acceso de lectura a todos los valores de datos de la API del termostato y acceso de escritura adicional para seleccionar valores, seleccione el permiso de lectura / escritura del termostato para su cliente. Este nivel de permiso le permite actualizar lo siguiente:

  • Temperatura objetivo
  • Modo HVAC
  • Temporizadores de ventilador

A partir de la lectura / escritura del termostato v5, también puede actualizar lo siguiente:

  • La escala de temperatura
  • Etiqueta del termostato

Identificadores de termostato

Dispositivo

Los dispositivos Nest se enumeran por tipo como una matriz de ID, que se pueden utilizar para identificar de forma única un dispositivo a través de la ruta del dispositivo. Por lo tanto, una ID de termostato de "peyiJNo..." significa que puede cargar el modelo de devices/thermostats/peyiJNo... en devices/thermostats/peyiJNo... través de la API.

Cuando un dispositivo está conectado a varios productos, cada desarrollador verá una ID diferente para ese dispositivo. Para un dispositivo que ha instalado varios productos del mismo desarrollador, el desarrollador verá la misma ID.

Nombre

Se proporcionan dos atributos de nombre. El atributo de name más corto se muestra en las etiquetas de la interfaz de usuario, mientras que name_long se usa en texto de formato largo.

name

En estos ejemplos, el name es "Pasillo" o "Pasillo (Oeste)".

NombreNombre largo

name_long

En este ejemplo, name_long es "Office (Upstairs)".

Nombre largo en un mensaje

Etiqueta

Donde nombre (etiqueta)
Donde nombre (etiqueta)

A partir de la versión de permisos v5 , puede agregar una etiqueta de termostato personalizada a través de la API. En la aplicación Nest, la etiqueta aparece entre paréntesis, después del nombre where.

A partir de la versión de permisos v6 , también puede leer la etiqueta del termostato.

Dónde

where_id

  • Un identificador único generado por Nest que representa el name
  • where_id es de solo lectura y se crea automáticamente en la llamada para crear un name personalizado donde

Obtén más información sobre dónde están los nombres de los termostatos Nest , Nest Protects y Nest Cams .

where_name

Cuando elige cualquiera de los permisos del termostato , puede acceder al dispositivo where_name desde el objeto del dispositivo ( devices/thermostats ).

Otros metadatos

Todos los valores de datos son de solo lectura, a menos que se especifique lo contrario.

Valor de los datos Descripción
locale El idioma y el código de país asignado a este dispositivo
software_version Una cadena que representa el firmware actualmente instalado en el dispositivo
structure_id Una cadena que representa de manera única esta estructura; esta es la estructura con la que se empareja el dispositivo
last_connection La marca de tiempo de la última conexión exitosa al servicio Nest
is_online Estado en línea. Nest determina esto utilizando el tiempo de last_connection y una ventana de reconexión esperada que es específica del dispositivo.

Características del termostato

Modos de termostato

Los sistemas de HVAC tienen cuatro estados "encendido" ( heat , cool , heat-cool , eco ) y un estado "apagado" ( off ). Utilizamos estos estados para gestionar la comodidad y el ahorro de energía a través de los valores de datos hvac_mode y temperatura.

  • Cuando se selecciona el modo de calor o frío ( heat , cool ), el termostato ajusta el hogar a la temperatura objetivo.
  • Cuando se selecciona el modo Calor • Frío ( heat-cool ), el termostato mantendrá la casa cómoda, dentro de un rango de temperatura preferido.
  • Cuando se selecciona Eco Temperatures (eco), el termostato aplicará algoritmos de ahorro de energía para mantener la casa cómoda y reducir el uso de energía. Los termostatos en este modo muestran ECO.

Las estructuras tienen dos estados relacionados con la presencia: local o visitante. Cuando no se detecta movimiento en la casa, la estructura cambiará de Hogar a Ausente, y los termostatos en el hogar permitirán automáticamente las Eco Temperaturas.

Cómo funcionan juntos los valores hvac_mode y temperatura

Dependiendo del valor de hvac_mode , solo se puede acceder a ciertos valores de datos de temperatura en la API:

Modo HVAC Valores de datos de temperatura a los que puede acceder
heat o cool target_temperature_f or target_temperature_c
heat-cool target_temperature_low_f y target_temperature_high_f
o
target_temperature_low_c y target_temperature_high_c
eco eco_temperature_low_f y eco_temperature_high_f
o
eco_temperature_low_c y eco_temperature_high_c
off ninguna

En algunos escenarios, existen reglas especiales para cambiar hvac_mode :

Guión ¿ hvac_mode puede cambiar hvac_mode ?
El bloqueo de temperatura está habilitado si
El apagado de emergencia está activo No
El calor de emergencia está habilitado No
can_cool valor de can_cool o can_heat es false No

Temperaturas ecológicas

Las temperaturas ecológicas permiten al usuario ahorrar energía, ya sea que esté en casa o no. Considere cambiar hvac_mode a eco cuando implemente comportamientos de ahorro de energía en su producto.

Los puntos finales de Eco Temperature están disponibles en Nest API, comenzando con los permisos de lectura y escritura v6 del termostato.

Cambiar entre modos eco y no eco

Su producto no debería necesitar gestionar las temperaturas objetivo directamente en modo Eco. Cuando la casa se establece como ausente, la temperatura objetivo no se muestra, sino que se establece internamente, según la selección del usuario. Cuando el termostato está en OFF, no se observan temperaturas objetivo.

Si absolutamente debe cambiar las temperaturas objetivo directamente, asegúrese de realizar el cambio en dos llamadas separadas:

  1. Cambie hvac_mode a cualquier otro valor excepto eco
  2. Modifique los valores de datos apropiados de target_temperature

Comenzando con los permisos v6 de lectura y escritura del termostato, puede acceder a previous_hvac_mode través de la API para ayudar con las transiciones del modo HVAC. previous_hvac_mode se usa para almacenar el hvac_mode del dispositivo antes de que pase a "eco".

Por ejemplo, si el termostato Nest está utilizando temperaturas de Eco ( hvac_mode = "eco" ), previous_hvac_mode está disponible y desea que su producto establezca la target_temperature , entonces primero debe:

  1. get previous_hvac_mode
  2. establecer hvac_mode en el valor previous_hvac_mode
  3. confirme que hvac_mode ya no está configurado en "eco"

Después de estos pasos, establezca las temperaturas objetivo según corresponda.

Dependiendo del valor hvac_mode , así es como cambia previous_hvac_mode :

Cuando el estado hvac_mode es ... Entonces, previous_hvac_mode puede ser ...
eco heat , cool , heat-cool o off
heat , cool , heat-cool o off en blanco / vacío

Temperatura objetivo

La temperatura objetivo es el valor más importante para el sistema HVAC: es la temperatura deseada, generalmente establecida por el usuario. La mayoría de las acciones y decisiones se basan en ello. Desde la API, los productos Works with Nest pueden escribir la temperatura objetivo como parte de un proceso más amplio.

Siempre hay una temperatura objetivo establecida cuando el sistema está encendido.

  • Cuando se selecciona el modo Calor o Frío ( heat , cool ), se establece una única target_temperature
  • Cuando se selecciona el modo Calor • Frío ( heat-cool ), se establecen dos valores de target_temperature objetivo, que denotan un rango objetivo, uno más alto para enfriar y otro más bajo para calentar
  • Cuando se selecciona el modo Eco ( eco ), el rango de temperatura objetivo se establece internamente

También hay temperaturas de seguridad que evitan el congelamiento de tuberías o temperaturas excesivamente altas en el hogar.

Cuando el termostato está apagado, no se establecen temperaturas objetivo.

Tiempo de temperatura

Time-to-Temperature le da acceso a estos valores de datos para el sistema HVAC:

  • time_to_target - El tiempo, en minutos, que le tomará a la estructura alcanzar la temperatura objetivo
  • time_to_target_training
    • Estado de la formación
    • A medida que el termostato aprende cómo responde el sistema HVAC, ajusta la estimación para alcanzar la temperatura objetivo
    • Cuando el termostato está razonablemente seguro del tiempo estimado para alcanzar la temperatura objetivo, el estado cambiará de training a ready

Temperatura ambiente

La temperatura medida cerca del termostato. Muestra el valor que corresponde con la escala de temperatura preferida del usuario.

La escala de temperatura

Las variables de temperatura ambiente y objetivo están organizadas por escala Celsius o Fahrenheit. El atributo temperature_scale será "F" o "C", según las preferencias del usuario. Cada termostato establece esta propiedad, por lo que es posible que en una sola estructura un usuario pueda tener dos termostatos, uno en cada escala de temperatura. Tenga en cuenta las preferencias del usuario cuando muestre valores de temperatura.

A partir de la versión de permisos v5 , puede cambiar la escala de temperatura a través de la API.

Los campos Objetivo y Temperatura ambiente tienen variantes _f y _c para acomodar el redondeo constante cuando se muestran temperaturas.

Visualización de la temperatura

Termostato

Cuando muestre información de temperatura objetivo, hvac_mode cuenta estos tres valores dependientes: temperature_scale , hvac_mode y el estado de away la estructura.

Muchos valores de datos trabajan juntos para determinar qué se muestra en la pantalla del termostato Nest y cómo se comporta.

  • Cuando hvac_mode está configurado para heat-cool , el termostato Nest muestra los hvac_mode ajuste bajo y alto separados por un carácter de viñeta (•), de lo contrario, el termostato Nest muestra solo la temperatura objetivo
  • Cuando hvac_mode está off , la palabra "OFF" se muestra en el termostato Nest, en el idioma preferido del usuario
  • Cuando hvac_mode se establece en eco , la palabra "ECO" se muestra en el termostato Nest, en el idioma preferido del usuario

El formato de temperatura de la pantalla también depende de la escala de temperatura seleccionada (F / C).

Las temperaturas Fahrenheit se muestran como números enteros:

  • Temperatura objetivo: 55 ° F
  • Temperatura ambiente: 62 ° F

Las temperaturas en grados Celsius se muestran como un número entero o un valor decimal, con el último dígito establecido en ".5":

  • Temperatura objetivo: 12 ° C
  • Temperatura ambiente: 16,5 ° C

Hoja

Cuando el icono de la hoja se muestra en la parte frontal del termostato, el termostato está configurado a una temperatura de ahorro de energía y has_leaf = true .

Hoja

Bloqueo de temperatura

Los usuarios pueden bloquear un termostato Nest para que solo se pueda ajustar dentro de un rango de temperatura limitado. A partir de la versión de permisos v5 , puede ver si el bloqueo de temperatura está habilitado marcando is_locked , y si es así, lea los valores mínimo / máximo de bloqueo de temperatura a través de la API:

Las temperaturas de bloqueo deben especificarse en pares, como valores máximos y mínimos, y solo pueden escribirse si is_locked = true .

Humedad

Humedad, en formato de porcentaje (%), medida en el dispositivo, redondeada al 5% más cercano.

Bloqueador solar

La tecnología Sunblock ajusta automáticamente la temperatura en el termostato Nest para compensar los picos de calor que se producen por la luz solar directa en la unidad.

Estos valores de datos le dirán si Sunblock está habilitado y / o corrige activamente la temperatura.

Ventilador

Muchos sistemas HVAC tienen ventiladores integrados, lo que significa que el ventilador no se puede controlar de forma independiente . No hay modo apagado para los ventiladores integrados, porque el ventilador debe funcionar cuando la calefacción o la refrigeración están encendidas.

Sin embargo, si el sistema HVAC es compatible, el ventilador se puede encender explícitamente a través de la API, para que los ocupantes se sientan más cómodos, sin utilizar el sistema HVAC completo.

Si el ventilador se puede controlar de forma independiente, has_fan se establecerá en true y los siguientes valores de datos se pueden configurar con permisos de lectura / escritura del termostato:

  • fan_timer_active - boolean, devuelve true si el temporizador del ventilador está activado por una duración preprogramada
  • fan_timer_duration - int, la cantidad de tiempo (en minutos) que el ventilador está configurado para ejecutarse

Use estos valores juntos para iniciar el temporizador del ventilador (encienda el ventilador) durante un período de tiempo específico. También puede usar el valor fan_timer_timeout para determinar la marca de tiempo de cuándo el ventilador está configurado para dejar de funcionar.

Tenga en cuenta que siempre puede cambiar fan_timer_duration : es independiente de hvac_mode o del estado de ocupación de la estructura (ausente).

Puede esperar estas respuestas en caso de éxito o fracaso:

  • 200 OK
  • 400 Petición Incorrecta

Si el comando para encender el ventilador no produce el resultado esperado, puede deberse a que el ventilador ya está activado (ya sea manualmente por el usuario, o en un horario, o debido a un ciclo de calefacción / refrigeración HVAC).

Limitación de velocidad

Aplicamos un límite de velocidad para proteger contra llamadas excesivas a los dispositivos, lo que puede afectar el rendimiento del sistema o la batería. En condiciones normales, los dispositivos Nest cargan la batería desde los cables de bajo voltaje del sistema de calefacción y refrigeración. Pero si se realizan llamadas excesivas en un corto período de tiempo y el nivel de batería baja, el termostato Nest apagará el Wi-Fi para ahorrar energía.

En la práctica, esto significa que limitamos la cantidad de llamadas que se pueden hacer a un dispositivo dentro de un período de tiempo definido. Si excede este límite, recibirá una respuesta de error y un mensaje que indica que ha excedido su límite.

Para obtener más información, consulte Límites de velocidad de datos .

Restricciones de poder

En algunos casos, el termostato puede no tener suficiente batería para atender una solicitud de modificación. En este caso, recibirá una respuesta de error y un mensaje que indica que el dispositivo no puede atender la solicitud en este momento. Si esto sucede, dé tiempo a la batería para que se recargue antes de volver a intentarlo.

Obtén más información sobre las condiciones de batería baja en el Nest Learning Thermostat .

Error de mensajes

Algunos estados hacen que ciertas funciones no estén disponibles. Estas reglas están vigentes para conservar energía o brindar comodidad y seguridad.

Para obtener información sobre qué significan los errores de llamadas de API y cómo manejarlos, consulte Mensajes de error .

Wi-Fi / problema de conexión

Si un dispositivo está fuera de línea, no se permiten modificaciones. Puede observar el estado en línea del dispositivo en el modelo de datos y mostrar la IU de manera adecuada.