Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Termostato

Control de termostato

El Nest Learning Thermostat ™ es un dispositivo conectado a Internet que es intuitivo y fácil de usar, aprender continuamente sobre los patrones de uso en el hogar para optimizar el confort y ahorro de 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 ofrece una amplia gama de algoritmos (como Early On , Verdadero radiante , 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.

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

  • Nombre de la 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)
  • Bloqueo de la temperatura de estado, y si está bloqueado, el min / max valores de temperatura bloqueados
  • 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 termostato, seleccionar el termostato leer el permiso para su cliente.

Para acceso de lectura a todos los valores de datos de API termostato y el acceso a escritura adicional para seleccionar los valores, seleccione el termostato de lectura / escritura permiso 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. Por lo que un termostato Identificación de "peyiJNo..." significa que se pueden cargar el modelo de dispositivo termostato a devices/thermostats/peyiJNo... a 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á el mismo ID.

Nombre

Se proporcionan dos atributos de nombre. Cuanto más corto sea name de atributo se muestra en las etiquetas de la interfaz de usuario, mientras que name_long se utiliza en texto largo formulario.

name

En estos ejemplos, 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 V5 permisos , puede agregar una costumbre termostato etiqueta 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 v6 permisos , también se puede leer la etiqueta del termostato.

Dónde

where_id

  • Un identificador único, generado Nest-que representa name
  • where_id es de sólo lectura, y se crea automáticamente en la llamada para crear una costumbre en name

Más información sobre dónde nombres para termostatos Nest ,Nido Protege y Nido de levas .

where_name

Cuando se elige cualquiera de los permisos del termostato , se puede acceder al dispositivo where_name del objeto de 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 se determina por Nest usando el last_connection tiempo y una ventana de reconexión de esperar que es un dispositivo específico.

Características del termostato

Modos de termostato

Sistemas de aire acondicionado tienen cuatro "en" estados ( heat , cool , heat-cool , eco ) y un "fuera" estado ( off ). Utilizamos estos estados para gestionar confort y ahorro energético a través hvac_mode valores de los datos y de la temperatura.

  • Cuando el calor o el modo de enfriamiento ( heat , cool está seleccionado), el termostato ajusta la casa a la temperatura deseada.
  • Cuando el calor • modo de enfriamiento ( heat-cool se ha seleccionado), el termostato mantendrá el hogar confortable, dentro de un intervalo de temperaturas preferido.
  • Cuando Temperaturas Eco está seleccionada (eco), el termostato aplicar algoritmos de ahorro de energía para mantener la casa cómoda y reducir el consumo 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 hvac_mode los valores de temperatura y trabajan juntos

Dependiendo del valor de hvac_mode , sólo ciertos valores de los datos de temperatura se puede acceder en el 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 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 ninguno

En algunos escenarios, hay reglas especiales alrededor cambiar hvac_mode :

Guión Puede hvac_mode ser cambiado?
Bloqueo de temperatura está activado
Parada de emergencia está activo No
El calor de emergencia está activado No
can_cool o can_heat valor es false No

Temperaturas Eco

Las Temperaturas Eco permiten al usuario ahorrar energía, esté o no en casa. Considere cambiar la hvac_mode a eco en la aplicación de los comportamientos de ahorro de energía en su producto.

Eco extremos de temperatura están disponibles en la API Nido comenzando con termostato leer y permisos de lectura / escritura v6.

Cambio entre 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. Cambio hvac_mode a otro valor distinto de eco
  2. Modificar los apropiado target_temperature valores de datos

Comenzando con termostato leer y permisos de lectura / escritura v6, se puede acceder a previous_hvac_mode a través de la API para ayudar con los cambios de estado de HVAC. previous_hvac_mode se utiliza para almacenar el hvac_mode del dispositivo antes de que la transición a la "eco".

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

  1. get previous_hvac_mode
  2. conjunto hvac_mode a la previous_hvac_mode valor
  3. confirman hvac_mode ya no se ajusta a "eco"

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

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

Cuando hvac_mode estado 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 el calor o el modo Cool ( heat , cool se selecciona), una sola target_temperature es conjunto
  • Cuando el calor • Modo Cool ( heat-cool se selecciona), dos target_temperature se establecen valores, que denota un rango objetivo, una más alta para la refrigeración y una inferior para la calefacción
  • Cuando el modo Eco ( eco se selecciona), el rango de temperatura de destino se establece 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

El tiempo de la temperatura que da acceso a estos valores de datos para el sistema de climatización:

  • time_to_target - El tiempo, en minutos, que tomará para que la estructura para 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 de la estimación de tiempo para alcanzar la temperatura deseada, el estado cambiará de training de 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 están organizadas en grados Celsius o Fahrenheit. El temperature_scale atributo será o bien "F" o "C", dependiendo de 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. Mantenga las preferencias del usuario en mente cuando se muestran los valores de temperatura.

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

Campos temperatura objetivo y ambientales tienen _f y _c variantes para acomodar redondeo consistente cuando se presentan temperaturas.

Pantalla de temperatura

Termostato

Cuando se muestra información de la temperatura objetivo, tenga en cuenta estos tres valores dependientes: temperature_scale , hvac_mode , y de la estructura away estado.

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 se establece en heat-cool , el nido termostato muestra el bajo y alto puntos de consigna separados por un carácter de viñeta (•), de lo contrario las pantallas termostato Nest sólo la temperatura objetivo
  • Cuando hvac_mode se establece en off , la palabra "OFF" se visualiza en el termostato Nest, en el idioma preferido del usuario
  • Cuando hvac_mode se establece en eco , la palabra "ECO" se visualiza 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 icono de la hoja está mostrando en la parte frontal del termostato, el termostato está ajustado 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 V5 permisos , se puede ver si la temperatura de bloqueo está activado por el control de is_locked , y si lo es, leer valores min Temperatura de bloqueo / max a través de la API:

Temperaturas de bloqueo deben especificarse en pares, tal como los valores máximos y mínimos, y sólo pueden ser escritas si is_locked = true .

Humedad

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

Bloqueador solar

Protector solar tecnología ajusta automáticamente la temperatura en el termostato Nest para compensar los picos de calor que se producen a partir de 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 de HVAC han integrado los aficionados, 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 establece en true , y los siguientes valores de los datos se puede configurar con termostato permisos de lectura / escritura:

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

Utilice estos valores juntos para iniciar el temporizador del ventilador (encender el ventilador) durante un período de tiempo específico. También puede utilizar el fan_timer_timeout valor para determinar la fecha y hora de cuando el ventilador está configurado para detener la ejecución.

Tenga en cuenta que siempre se puede cambiar fan_timer_duration - es independiente de hvac_mode o estado estructura de ocupación (de distancia).

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 una limitación 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 le indicará 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.

Más información sobre las condiciones de batería baja en el termostato Nest Learning .

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 lo que los errores de llamada a la API significan y cómo manejarlos, ver los 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.