En Google, luchamos por la equidad racial de la comunidad negra. Más información

Termostato

Control de termostatos

El Nest Learning ThermostatTM es un dispositivo conectado a Internet que es intuitivo y fácil de usar, y aprende de forma continua sobre los patrones de uso en el hogar para optimizar la comodidad y ahorrar energía. Los usuarios pueden controlar la calefacción y el enfriamiento dondequiera que tengan acceso a una conexión a Internet.

La compatibilidad de estas funciones requiere un sistema de control sofisticado que vaya más allá de los programas simples basados en puntos de ajuste. Nest proporciona una amplia variedad de algoritmos (como Early On, True Radiant y AirwaveTM) que requieren una cantidad significativa de potencia de procesamiento en comparación con la mayoría de los termostatos. El Nest Thermostat 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 de HVAC sin interrumpir los algoritmos de Nest ni sorprender al usuario con comportamientos inesperados. y proporcionan acceso a los siguientes datos del Nest Thermostat:

  • Nombre de la estructura y nombre del dispositivo (ubicación del hogar)
  • Etiqueta personalizada del termostato
  • Información de estado de la conexión y última conexión
  • Temperaturas actual y final
  • Modo de temperatura
  • Temperaturas Eco
  • Tiempo para temperatura
  • Escala de temperatura (F/C)
  • Estado del 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, selecciona el permiso de lectura del termostato para tu cliente.

Para obtener acceso de lectura a todos los valores de datos de la API del termostato y acceso adicional de escritura a determinados valores, selecciona el permiso de lectura/escritura del termostato para tu cliente. Este nivel de permiso te permite actualizar lo siguiente:

  • Temperatura final
  • Modo de HVAC
  • Temporizadores de ventilador

A partir de la versión 5 de la función de lectura y escritura de tu termostato, también puedes actualizar lo siguiente:

  • Escala de temperatura
  • Etiqueta del termostato

Identificadores del termostato

Dispositivo

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

Cuando un dispositivo esté conectado a varios productos, cada desarrollador verá un ID diferente del mismo. En el caso de un dispositivo que instaló varios productos del mismo desarrollador, este verá el mismo ID.

Nombre

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

name

En estos ejemplos, name es un pasillo o pasillo (oeste).

Nombre Nombre (largo)

name_long

En este ejemplo, name_long es &Office (planta alta).

Nombre largo en un mensaje

Etiqueta

Donde nombre (etiqueta)
Donde nombre (etiqueta)

A partir de la versión 5 de los permisos, puedes agregar una etiqueta de termostato personalizada a través de la API. En la app de Nest, la etiqueta aparece entre paréntesis, después del nombre del lugar.

A partir de la versión 6 de los permisos, también puedes leer la etiqueta del termostato.

Explicación de los valores

where_id

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

Obtén más información sobre los nombres de los Nest Thermostat, los Nest Protect y las Nest Cams.

where_name

Cuando eliges cualquiera de los permisos del termostato, puedes 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 String que representa el firmware instalado actualmente en el dispositivo
structure_id Una string que representa de forma única esta estructura, que es la que está vinculada al dispositivo.
last_connection La marca de tiempo de la última conexión exitosa al servicio de Nest
is_online Estado de conexión. Esto lo determina Nest usando la hora last_connection y una ventana de reconexión esperada que es específica del dispositivo.

Funciones del termostato

Modos de termostato

Los sistemas de HVAC tienen cuatro estados (heat, cool, heat-cool, eco) y uno de apagado (off). Los usamos para administrar la comodidad y el ahorro de energía mediante hvac_mode y los valores de datos de temperatura.

  • Cuando se selecciona el modo Calor o Frío (heat, cool), el termostato ajusta la casa a la temperatura final.
  • Cuando se selecciona el modo Calor • Frío (heat-cool), el termostato mantendrá la casa cómoda, dentro del rango de temperatura preferido.
  • Cuando se seleccione Temperaturas Eco (eco), el termostato aplicará algoritmos de ahorro de energía para mantener la comodidad de la casa 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 cambia de En casa a Ausente, y los termostatos de la casa habilitarán Temperaturas Eco automáticamente.

Cómo funcionan en conjunto los valores de temperatura y hvac_mode

Según el valor de hvac_mode, solo se puede acceder a algunos valores de datos de temperatura en la API:

Modo de HVAC Valores de datos de temperatura a los que puedes 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 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 none

En algunas situaciones, hay reglas especiales para cambiar hvac_mode:

Situación ¿Se puede cambiar hvac_mode?
El bloqueo de temperatura está habilitado
El Corte de emergencia está activo. No
El calefactor de emergencia está habilitado. No
El valor de can_cool o can_heat es false No

Temperaturas Eco

Las Temperaturas Eco permiten que los usuarios ahorren energía, ya sea que estén en casa o no. Considera cambiar el hvac_mode a eco cuando implementes comportamientos de ahorro de energía en tu producto.

Los extremos de temperatura Eco están disponibles en la API de Nest a partir de los permisos de lectura y escritura v6 del termostato.

Cambia entre los modos ecológico y no ecológico

Tu producto no debería tener que administrar las temperaturas finales directamente en el modo Eco. Cuando la casa se configura en Ausente, la temperatura final no se muestra, pero se configura internamente en función de la selección del usuario. Cuando el termostato se desactiva, no se observan temperaturas objetivo.

Si debes cambiar la temperatura final de forma directa, asegúrate de realizar el cambio en dos llamadas separadas:

  1. Cambia hvac_mode a cualquier otro valor, excepto eco.
  2. Modifica los valores de datos de target_temperature adecuados

A partir de los permisos de lectura y escritura v6 del termostato, puedes acceder a previous_hvac_mode a 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 la transición a "eco".

Por ejemplo, si el Nest Thermostat usa Temperaturas Eco (hvac_mode = "eco"), está disponible previous_hvac_mode, y quieres que tu producto establezca target_temperature, primero debes hacer lo siguiente:

  1. obtener previous_hvac_mode
  2. configura hvac_mode con el valor previous_hvac_mode
  3. confirma que hvac_mode ya no está configurado en "eco"

Después de seguir estos pasos, establece las temperaturas finales según corresponda.

Según el valor de 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 final

La temperatura final es el valor más importante para el sistema de HVAC; es la temperatura deseada, por lo general, establecida por el usuario. La mayoría de las acciones y las decisiones se basan en esto. En la API, los productos Works with Nest pueden escribir la temperatura final como parte de un proceso más grande.

Siempre se establece una temperatura final cuando el sistema está encendido.

  • Cuando se selecciona el modo frío o calor (heat, cool), se establece un solo target_temperature
  • Cuando se selecciona el modo Calor • Frío (heat-cool), se configuran dos valores target_temperature, que denotan un rango objetivo: uno más alto para el enfriamiento y uno más bajo para la calefacción.
  • Cuando se selecciona el modo Eco (eco), el rango de temperatura final se establece internamente

También hay temperaturas de seguridad que son un límite para evitar las tuberías heladas o las temperaturas excesivamente altas en la casa.

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

Tiempo para temperatura

El Tiempo para temperatura te brinda acceso a estos valores de datos para el sistema de HVAC:

  • time_to_target: tiempo, en minutos, que se necesitará para que la estructura alcance la temperatura final
  • time_to_target_training
    • Estado del entrenamiento
    • A medida que el termostato aprende cómo responde el sistema de HVAC, ajusta la estimación para alcanzar la temperatura final.
    • Cuando el termostato tenga una certeza razonable de la hora estimada para alcanzar la temperatura final, el estado cambiará de training a ready

Temperatura ambiental

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

Escala de temperatura

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

A partir de la versión 5 de los permisos, puedes cambiar la escala de temperatura a través de la API.

Los campos Temperatura objetivo y Temperatura ambiente tienen variantes _f y _c para adaptarse de manera coherente a las temperaturas.

Pantalla de temperatura

Termostato

Cuando muestres la información de la temperatura final, considera estos tres valores dependientes: temperature_scale, hvac_mode y el estado away de la estructura.

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

  • Cuando hvac_mode se establece en heat-cool, el Nest Thermostat muestra los puntos de ajuste bajo y alto separados por una viñeta (•); de lo contrario, el Nest Thermostat muestra solo la temperatura final.
  • Cuando hvac_mode se establece en off, la palabra " se muestra en el Nest Thermostat, en el idioma preferido del usuario.
  • Cuando hvac_mode se establece en eco, la palabra "ECO" se muestra en el Nest Thermostat, en el idioma de preferencia del usuario.

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

Las temperaturas de Fahrenheit se muestran como números enteros:

  • Temperatura final: 12 °C
  • Temperatura ambiente: 15 °C

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

  • Temperatura final: 12 °C
  • Temperatura ambiente: 16.5 °C

Hoja

Cuando se muestra el ícono de hoja en la parte frontal del termostato, este se establece en una temperatura de ahorro de energía y has_leaf = true.

Hoja

Bloqueo de temperatura

Los usuarios pueden bloquear un Nest Thermostat para que solo se pueda ajustar dentro de un rango de temperatura limitado. A partir de la versión 5 de los permisos, puedes verificar si está habilitado el bloqueo de temperatura. Para ello, marca la opción is_locked y, si es así, lee los valores mínimo y máximo de bloqueo de temperatura mediante la API:

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

Humedad

Humedad, en porcentaje (%), que se mide en el dispositivo, redondeado al 5% más cercano.

Bloqueador solar

La tecnología Bloqueador solar ajusta automáticamente la temperatura del Nest Thermostat para compensar los aumentos de calor que ocurren por la luz solar directa de la unidad.

Estos valores de datos te indicarán si el Bloqueador solar está habilitado o si se corrige la temperatura de forma activa.

Ventilador

Muchos sistemas de HVAC tienen ventiladores integrados, lo que significa que no se puede controlar de forma independiente. No hay un modo de apagado para los ventiladores integrados, ya que el ventilador debe funcionar cuando la calefacción o el enfriamiento estén encendidos.

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

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

  • fan_timer_active: booleano, muestra true si el temporizador del ventilador está activo durante un período programado previamente
  • fan_timer_duration: int, el tiempo (en minutos) que el ventilador está configurado para funcionar

Usa estos valores en conjunto para iniciar el temporizador del ventilador (encenderlo) durante un período específico. También puedes usar el valor fan_timer_timeout a fin de determinar la marca de tiempo de cuándo se configura el ventilador para que deje de funcionar.

Ten en cuenta que siempre puedes cambiar fan_timer_duration. Es independiente de hvac_mode o del estado de ocupación de la estructura (Ausente).

Puedes esperar que estas respuestas se realicen correctamente o no:

  • 200 OK
  • 400 Bad Request

Si el comando para encender el ventilador no produce el resultado esperado, puede ser porque el ventilador ya está en funcionamiento (ya sea de forma manual por el usuario, o bien por un programa, o debido a un ciclo de calefacción/frío de HVAC).

Límite de frecuencia

Aplicamos un límite de frecuencia para evitar llamadas excesivas a los dispositivos, lo que puede afectar el rendimiento del sistema o de la batería. En condiciones normales, los dispositivos Nest cargan la batería de los cables de bajo voltaje del sistema de calefacción y enfriamiento. Sin embargo, si se realizan llamadas excesivas en un período corto y el nivel de la batería está bajo, el Nest Thermostat desactivará la conexión Wi-Fi para conservar 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 definido. Si superas este límite, recibirás una respuesta de error y un mensaje que indica que superaste el límite.

Para obtener más información, consulta Límites de la frecuencia de datos.

Limitaciones de energía

En algunos casos, es posible que el termostato no tenga suficiente batería para atender una solicitud de modificación. En este caso, recibirás una respuesta de error y un mensaje que indica que el dispositivo no puede atender la solicitud en este momento. Si esto sucede, permite que la batería se cargue un poco antes de volver a intentarlo.

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

Mensajes de error

Algunos estados hacen que algunas funciones no estén disponibles. Estas reglas se aplican para conservar energía o proporcionar comodidad y seguridad.

Para obtener información sobre el significado de los errores de llamada a la API y cómo manejarlos, consulta Mensajes de error.

Problema de conexión o Wi-Fi

Si un dispositivo no tiene conexión, no se permite realizar modificaciones. Puedes observar el estado en línea del dispositivo en el modelo de datos y mostrar la IU de manera adecuada.