Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Esta página se ha traducido con Cloud Translation API.
Switch to English

Termostato

control del 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 cualquier lugar que tenga acceso a una conexión a Internet.

El apoyo a estas características requiere un sofisticado sistema de control que va más allá de simples programas basados ​​en la consigna. 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 potencia 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. Ellos proporcionan el acceso a los siguientes datos para el termostato Nest:

  • nombre de la estructura y el dispositivo "en nombre" (lugar de la casa)
  • etiqueta personalizada termostato
  • El estado de conexión y la información de la última conexión
  • Las temperaturas actuales y de destino
  • Seleccione una temperatura de
  • Temperaturas Eco
  • Time-to-Temperatura
  • Escala de temperatura (set F / C)
  • Bloqueo de la temperatura de estado, y si está bloqueado, el min / max valores de temperatura bloqueados
  • la duración del temporizador del ventilador y el modo de climatización
  • Humedad
  • Bloqueador solar

permisos 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 autorización le permite actualizar la siguiente:

  • temperatura objetivo
  • el modo de climatización
  • temporizadores ventilador

Comenzando con termostato de lectura / escritura v5, también puede actualizar la siguiente:

  • La escala de temperatura
  • etiqueta termostato

identificadores del termostato

Dispositivo

dispositivos Nest se enumeran por tipo como una matriz de ID, que se puede utilizar para identificar de manera ú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á un ID diferente para ese dispositivo. Para un dispositivo que ha instalado varios productos del mismo desarrollador, el desarrollador va a 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, etiqueta aparece entre paréntesis, después del nombre de dónde.

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 los datos son de sólo lectura, a menos que se especifique lo contrario.

Valor de los datos Descripción
locale El código de idioma y el país asignada a este dispositivo
software_version Una cadena que representa el firmware instalada actualmente en el dispositivo
structure_id Una cadena que representa de forma única esta estructura; esta es la estructura que el dispositivo está emparejado con
last_connection La fecha y hora de la última conexión correcta con el servicio Nido
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. Termostatos de este modo ECO pantalla.

Estructuras tienen dos estados relacionados con la presencia: en casa o fuera. Cuando hay movimiento es detectado en la casa, la estructura va a cambiar de casa para el otro lado, y los termostatos en el hogar permitirá automáticamente Temperaturas Eco.

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:

el modo de climatización valores de los datos de temperatura se 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 ninguna

En algunos escenarios, hay reglas especiales alrededor cambiar hvac_mode :

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

Temperaturas Eco

Temperaturas eco permiten al usuario ahorrar energía, ya sean en casa o no. 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.

El cambio entre los modos ecológicos y no ecológicos

Su producto no debe necesitar para gestionar directamente las temperaturas objetivo en el modo Eco. Cuando la casa se encuentra a distancia, no se muestra la temperatura objetivo, pero se pone internamente, en base a la selección del usuario. Cuando el termostato está ajustado a OFF, entonces no se observan temperaturas objetivo.

Si es absolutamente necesario cambiar directamente las temperaturas objetivo, 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, establecer las temperaturas objetivo, según proceda.

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ía

temperatura objetivo

temperatura objetivo es el valor más importante para el sistema HVAC - es la temperatura deseada, normalmente establecida por el usuario. La mayoría de las acciones y decisiones se basan en él. A partir de la API, trabaja con productos Nest puede escribir la temperatura objetivo como parte de un proceso más amplio.

Siempre hay una temperatura establecido como objetivo 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 hay temperaturas de seguridad que son un respaldo para evitar la congelación de las tuberías o temperaturas excesivamente altas en el hogar.

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

Time-to-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 se entera de cómo responde el sistema de climatización, que 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. Visualizar el valor que se corresponde con la escala de temperatura preferido del usuario.

La escala de temperatura

Las variables de temperatura ambiente y de destino están organizados por Celsius o Fahrenheit escala. El temperature_scale atributo será o bien "F" o "C", dependiendo de la preferencia del usuario. Esta propiedad se establece por cada termostato, por lo que es posible que en una única estructura de un usuario podría tener 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.

visualización de la 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 trabajan en conjunto para determinar lo que 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 visualización de la temperatura también depende de la escala de temperatura seleccionado (F / C).

temperaturas Fahrenheit se muestran como números enteros:

  • temperatura de destino: 55 ° F
  • Temperatura ambiente: 62 ° F

temperaturas Celsius se muestran como un número entero o un valor decimal, con el último conjunto de dígitos a" 0,5" :

  • temperatura de destino: 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 de modo que sólo se puede ajustar dentro de un rango de temperaturas 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

La humedad, en formato de porcentaje (%), medido en el dispositivo, redondeado 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 protector solar está activado y / o corregir 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 ningún modo de apagado de ventiladores integrados, ya que las necesidades ventilador funcione cuando la calefacción o enfriamiento está encendido.

Sin embargo, si el sistema de climatización es compatible, el ventilador se puede activar de forma explícita en medio de la API, con el fin de hacer que los ocupantes más cómodo, sin comprometer el sistema de climatización completa.

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 en conjunto para iniciar el temporizador del ventilador (encienda el ventilador) durante un período específico de tiempo. 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).

Usted puede esperar que estas respuestas en el éxito o el fracaso:

  • 200 OK
  • 400 Petición Incorrecta

Si el comando para activar el ventilador no produce el resultado esperado, puede ser porque el ventilador ya está comprometida (ya sea manualmente por el usuario, o en un horario, o debido a un ciclo de calor HVAC / frío).

Limitación de velocidad

Aplicamos la limitación de velocidad para proteger contra llamadas excesivas a los dispositivos, que pueden afectar el sistema o el rendimiento de la batería. En condiciones normales, dispositivos Nest cargar la batería a partir de los cables de bajo voltaje en el sistema de calefacción y refrigeración. Pero si las llamadas se hacen excesivas en un corto período de tiempo y el nivel de la batería está baja, el termostato Nest desactivar Wi-Fi para poder conservar.

En la práctica, esto significa que limitan el número de llamadas que se pueden hacer 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 .

restricciones de energía

En algunos casos, el termostato puede no tener suficiente energía de la batería para dar servicio a una petición de modificación. En este caso, usted recibirá una respuesta de error y un mensaje que indica que el dispositivo no puede procesar la solicitud en este momento. Si esto sucede, dar a la batería de un tiempo para recargar antes de intentarlo de nuevo.

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

Error de mensajes

Algunos estados hacen que determinadas funciones no disponible. Estas reglas están en su lugar para conservar la energía o proporcionan 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 .

Wi-Fi emisión / conexión

Si un dispositivo está desconectado, no se permiten modificaciones. Se puede observar el estado en línea del dispositivo en el modelo de datos y mostrar la interfaz de usuario adecuada.