Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Termostato

Control de 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 de cálculo en comparación con la mayoría de los termostatos. El termostato Nest tiene la energía necesaria para proporcionar estas funciones avanzadas.

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

  • Nombre de estructura y dispositivo "donde nombre" (ubicación en la casa)
  • Etiqueta de termostato personalizada
  • Estado en línea y última información de conexión
  • Temperaturas actual y objetivo
  • Modo de temperatura
  • Temperaturas Eco
  • Tiempo hasta temperatura
  • Escala de temperatura (establecer F / C)
  • Estado de bloqueo de temperatura y, si está bloqueado, los valores de temperatura bloqueados mín. / Máx.
  • Duración del temporizador del ventilador y modo HVAC
  • Humedad
  • Bloqueador solar

Permisos del termostato

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

Para acceso de lectura a todos los valores de datos de la API del termostato y acceso de escritura adicional a los valores seleccionados, 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 Thermostat read / write 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 serie de ID, que se pueden usar para identificar de forma única un dispositivo a través de la ruta del dispositivo. Entonces, un 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á un ID diferente para ese dispositivo. Para un dispositivo que ha instalado varios productos del mismo desarrollador, el desarrollador verá el mismo 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 el 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 "Oficina (arriba)".

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 where personalizado

Obtén más información sobre los nombres de los termostatosNest ,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 código de idioma y 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 forma única esta estructura; esta es la estructura con la que está emparejado el dispositivo
last_connection La marca de tiempo de la última conexión exitosa al servicio Nest
is_online Estado en línea. Esto lo determina Nest 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 HVAC tienen cuatro estados "encendido" ( heat , cool , heat-cool , eco ) y un estado "apagado" ( off ). Usamos estos estados para administrar el confort y el ahorro de energía a través de hvac_mode y valores de datos de temperatura.

  • Cuando se selecciona el modo Calor o Frío ( heat , cool ), el termostato ajusta la casa 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 Temperaturas (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: En casa o Ausente. Cuando no se detecta movimiento en la casa, la estructura cambiará de Casa a Ausente y los termostatos de la casa habilitarán las Temperaturas Eco automáticamente.

Cómo funcionan juntos hvac_mode y los valores de 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 o target_temperature_c
heat-cool target_temperature_low_f y target_temperature_high_f
o
target_temperature_low_c 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
La calefacción de emergencia está habilitada No
can_cool valor de can_cool o can_heat es false No

Temperaturas Eco

Las Temperaturas Eco permiten al usuario ahorrar energía, esté o no en casa. Considere cambiar hvac_mode a eco cuando implemente comportamientos de ahorro de energía en su producto.

Los puntos finales de temperatura ecológica están disponibles en la API de Nest a partir de los permisos v6 de lectura y lectura / escritura del termostato.

Cambio entre los modos eco y no eco

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

Si es absolutamente necesario 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. Modificar los valores de datos de target_temperature apropiados

Comenzando con los permisos v6 de lectura y lectura / 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 su transición a "eco".

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

  1. obtener previous_hvac_mode
  2. establecer hvac_mode en el valor previous_hvac_mode
  3. confirmar que hvac_mode ya no está configurado como "eco"

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

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

Cuando el estado de 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 él. 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 Heat • Cool ( heat-cool ), se establecen dos valores de target_temperature , que denotan un rango objetivo, uno más alto para enfriar y uno más bajo para calentar
  • Cuando se selecciona el modo Eco ( eco ), el rango de temperatura objetivo se configura internamente

También existen temperaturas de seguridad que son un tope para evitar la congelación de las tuberías o temperaturas excesivamente altas en el hogar.

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

Tiempo hasta temperatura

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

  • time_to_target : el tiempo, en minutos, que la estructura tardará en alcanzar la temperatura objetivo
  • time_to_target_training
    • Estado de entrenamiento
    • 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 a la escala de temperatura preferida del usuario.

La escala de temperatura

Las variables de temperatura ambiente y objetivo se organizan en grados Celsius o Fahrenheit. El atributo temperature_scale será "F" o "C", según la preferencia del usuario. Esta propiedad la establece cada termostato, por lo que es posible que en una sola estructura un usuario tenga dos termostatos, uno en cada escala de temperatura. Tenga en cuenta las preferencias del usuario al mostrar los 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 de temperatura ambiente y objetivo tienen variantes _f y _c para adaptarse al redondeo constante al mostrar temperaturas.

Pantalla de temperatura

Termostato

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

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

  • Cuando hvac_mode está configurado en 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 la temperatura de visualización también depende de la escala de temperatura seleccionada (F / C).

Las temperaturas en grados 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 ícono 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 lo está, 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áximo y mínimo, y solo se pueden escribir 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 de bloqueador solar ajusta automáticamente la temperatura en el termostato Nest para compensar los picos de calor que ocurren 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 de 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 activar 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 los permisos de lectura / escritura del termostato:

  • fan_timer_active - booleano, devuelve true si el temporizador del ventilador está activado durante un tiempo preprogramado
  • fan_timer_duration - int, la cantidad de tiempo (en minutos) que el ventilador está configurado para funcionar

Utilice 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 en que 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, en un horario, o debido a un ciclo de calefacción / refrigeración HVAC).

Limitación de velocidad

Aplicamos límites de tarifas para proteger contra llamadas excesivas a dispositivos, que pueden afectar el rendimiento del sistema o de la batería. En condiciones normales, los dispositivos Nest cargan la batería con los cables de bajo voltaje del sistema de calefacción y refrigeración. Pero si se hacen demasiadas llamadas en un corto período de tiempo y el nivel de la batería es bajo, 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 realizar a un dispositivo dentro de un período de tiempo definido. Si supera este límite, recibirá una respuesta de error y un mensaje que indica que ha superado su límite.

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

Limitaciones de poder

En algunos casos, es posible que el termostato no tenga suficiente carga de 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, deje que la batería se recargue antes de volver a intentarlo.

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

Error de mensajes

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

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

Problema de conexión / Wi-Fi

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 interfaz de usuario de manera adecuada.