Alarme de fumaça + CO

Nest Protect é projetado para detectar fumaça e monóxido de carbono (CO) em um ambiente residencial, com vários sensores para ajudar a entender o que está acontecendo na casa.

A API Nest fornece acesso aos seguintes dados sobre Nest Protect:

• Status de alarme de fumaça ou monóxido de carbono (CO)
• Estado de saúde da bateria
• Último status de teste manual e carimbo de data / hora
• Status online e última informação de conexão
• Nome da estrutura e dispositivo "onde nome" (localização na casa)

Permissões de fumaça + CO

Para acesso de leitura a todos os valores de dados de alarme API + CO fumo, selecione o Smoke + CO ler permissão para o seu cliente.

Não há permissões de gravação disponíveis para a API de alarme Smoke + CO.

Identificadores de fumaça + CO

Dispositivo

Os dispositivos Nest são listados por tipo como uma série de IDs, que podem ser usados ​​para identificar exclusivamente um dispositivo por meio do caminho do dispositivo. Então a + co ID alarme de fumo de "RTMTKxs..." significa que você pode carregar o + co modelo de dispositivo de alarme de fumaça em devices/smoke_co_alarms/RTMTKxs... por meio da API.

Quando um dispositivo é conectado a vários produtos, cada desenvolvedor verá uma ID diferente para aquele dispositivo. Para um dispositivo que instalou vários produtos do mesmo desenvolvedor, o desenvolvedor verá o mesmo ID.

Nome

Dois atributos de nome são fornecidos. Quanto mais curto name atributo é exibido em etiquetas de interface do usuário, enquanto name_long é utilizado em longo texto formulário.

name

Neste exemplo, name é "Nest Protect".

name_long

Neste exemplo, name_long é "Basement Nest Protect".

Onde

where_id

• Um identificador exclusivo, gerado-Nest que representa name
• where_id é só de leitura, e é criado automaticamente na chamada para criar um personalizado, onde name

Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

where_name

Quando você escolhe o Smoke + CO permissão de leitura , você pode acessar o dispositivo where_name do objeto de dispositivo ( devices/smoke_co_alarms ).

Outros metadados

Todos os valores de dados são somente leitura, a menos que seja especificado de outra forma.

Valor de Dados	Descrição
locale	O idioma e o código do país atribuídos a este dispositivo
software_version	Uma string que representa o firmware atualmente instalado no dispositivo
structure_id	Uma string que representa exclusivamente essa estrutura; esta é a estrutura com a qual o dispositivo está emparelhado
last_connection	O carimbo de data / hora da última conexão bem-sucedida com o serviço Nest
is_online	Status online. Isto é determinado pelo ninho usando o last_connection tempo e de uma janela de religação esperado que é específico do dispositivo.

Recursos do Smoke + CO

Saúde da bateria

Use o battery_health campo para ver o estado de saúde da bateria.

Valor	Descrição
ok	Nível de bateria ok
replace	Nível de bateria baixo, deve ser substituído

Alarme CO

Use o co_alarm_state campo para ver o estado de alarme CO.

Valor	Descrição
ok	Operação normal
warning	Detecção de níveis crescentes de CO
emergency	Níveis de CO muito altos, o usuário deve sair de casa

Alarme de fumo

Use o smoke_alarm_state campo para ver o estado de alarme de fumaça.

Valor	Descrição
ok	Operação normal
warning	Detecção de níveis crescentes de fumaça
emergency	Níveis de fumaça muito altos, o usuário deve sair de casa

Teste manual

Use esses campos para verificar se um teste manual de fumaça ou CO está ativo no momento e a última vez que um teste de fumaça ou CO foi realizado com sucesso.

• is_manual_test_active -retorna true se um fumo ou teste está ativo
• last_manual_test_time

Estado da cor da IU

Para torná-lo mais fácil de projetar uma interface entre produtos coerente, nós fornecemos o ui_color_state campo, o que dá uma indicação de alto nível do estado geral do Nest Protect. É derivado de is_online , battery_health , co_alarm_state e smoke_alarm_state , proporcionando uma condição de agregado que reflete os indicadores de cor reais exibidos no app Nest .

Mensagens de erro

Para obter informações sobre o que os erros de chamadas API significa e como lidar com eles, ver mensagens de erro .