Humo + CO Alarma

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:

• El humo o monóxido de carbono (CO) de estado de alarma
• Estado de salud de la batería
• Última estado de la prueba manual y marca de tiempo
• El estado de conexión y la información de la última conexión
• nombre de la estructura y el dispositivo "en nombre" (lugar de la casa)

Humo permisos + 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 para el Humo + CO API de alarma.

Humo identificadores + CO

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. 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á 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 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 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.

Humo Características + CO

estado de la batería

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

Valor	Descripción
ok	ok nivel de la batería
replace	nivel de batería baja, debe ser reemplazado

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	La detección de aumento de los niveles de CO
emergency	Los niveles de CO demasiado alta, 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	La detección del aumento de los niveles de humo
emergency	Los niveles de humo demasiado alta, el usuario debe salir de la casa

Prueba manual

Utilice estos campos para comprobar si un humo manual o prueba de CO se activa, y la última vez que se realizó una prueba de humo de tabaco o CO.

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

estado de color UI

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 .