Alarma de humo + CO

Nest Protect está diseñado para detectar humo y monóxido de carbono (CO) en un ambiente residencial, con múltiples sensores para ayudar a entender lo que está pasando en el hogar.

La API Nido proporciona acceso a los siguientes datos en el Nest Protect:

• Estado de alarma de humo o monóxido de carbono (CO)
• Estado de salud de la batería
• Estado y marca de tiempo de la última prueba manual
• Estado en línea y última información de conexión
• Nombre de la estructura y dispositivo "donde nombre" (ubicación en la casa)

Permisos de humo + CO

Para acceso de lectura a todos los valores de datos de la API de alarma de humo + CO, seleccione el Humo + CO leer el permiso para su cliente.

No hay permisos de escritura disponibles para la API de alarma de humo + CO.

Identificadores de humo + CO

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. Así que una cortina de humo + co ID de la alarma de "RTMTKxs..." significa que se pueden cargar en el signo + co modelo de dispositivo detector de humo en devices/smoke_co_alarms/RTMTKxs... 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 este ejemplo, name es "Nest Protect".

name_long

En este ejemplo, name_long es "Basement Nest Protect".

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 el Humo + CO permiso de lectura , se puede acceder al dispositivo where_name del objeto de dispositivo ( devices/smoke_co_alarms ).

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.

Funciones de humo + CO

Salud de la batería

Usar la battery_health campo para ver el estado de salud de la batería.

Valor	Descripción
ok	Nivel de batería correcto
replace	Nivel de batería bajo, debe reemplazarse

Alarma de CO

Utilice la co_alarm_state campo para ver el estado de alarma de CO.

Valor	Descripción
ok	Operación normal
warning	Detección de niveles crecientes de CO
emergency	Niveles de CO demasiado altos, el usuario debe salir de la casa.

Alarma de humo

Usar la smoke_alarm_state campo para ver el estado de alarma de humo.

Valor	Descripción
ok	Operación normal
warning	Detección de aumento de los niveles de humo.
emergency	Niveles de humo demasiado altos, el usuario debe salir de la casa.

Prueba manual

Utilice estos campos para verificar si una prueba manual de humo o CO está actualmente activa y la última vez que se realizó una prueba de humo o CO con éxito.

• is_manual_test_active -returns true si un humo o de prueba está activo
• last_manual_test_time

Estado de color de la interfaz de usuario

Para que sea más fácil el diseño de una interfaz de usuario a través del producto coherente, hemos proporcionado el ui_color_state campo, lo que da una indicación de alto nivel del estado general del Nest Protect. Se deriva de is_online , battery_health , co_alarm_state , y smoke_alarm_state , proporcionando una condición de agregado que refleja los indicadores de color reales que aparecen en la aplicación Nest .

Error de mensajes

Para obtener información sobre lo que los errores de llamada a la API significan y cómo manejarlos, ver los mensajes de error .