Alarme de fumaça + monóxido de carbono

O Nest Protect foi 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 no Nest Protect:

• Status do alarme de fumaça ou monóxido de carbono (CO)
• Estado de integridade da bateria
• Carimbo de data/hora e status do último teste manual
• Status on-line e informações sobre a última conexão
• Estrutura do nome e do dispositivo: nome da empresa (local na casa)

Permissões de fumaça + CO

Para acesso de leitura a todos os valores de dados da API Smoke+CO alarm, selecione a permissão Smoke+CO read para o 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 matriz de IDs, que podem ser usados para identificar exclusivamente um dispositivo por meio do caminho dele. Portanto, um ID de alarme de fumaça+co de "RTMTKxs..." significa que você pode carregar o modelo de dispositivo de alarme de fumaça+co em devices/smoke_co_alarms/RTMTKxs... pela API.

Quando um dispositivo está conectado a vários produtos, cada desenvolvedor vê um código diferente para o dispositivo. Para um dispositivo que tenha instalado vários produtos do mesmo desenvolvedor, ele verá o mesmo ID.

Nome

Dois atributos de nome são fornecidos. O atributo name mais curto é exibido nos rótulos da interface do usuário, enquanto name_long é usado em textos de formato longo.

name

Neste exemplo, name é "Nest Protect".

name_long

Neste exemplo, name_long é "Basement Nest Protect".

Em que

where_id

• Um identificador exclusivo gerado pelo Nest que representa name.
• where_id é somente leitura e criado automaticamente na chamada para criar um personalizado onde name

Saiba mais sobre os nomes dos Nest Thermostats, Nest Protects e Nest Cams.

where_name

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

Outros metadados

Todos os valores de dados são somente leitura, salvo especificação em contrário.

Valor dos dados	Descrição
locale	O código de idioma e de país atribuídos a este dispositivo
software_version	Uma string que representa o firmware instalado no dispositivo
structure_id	Uma string que representa exclusivamente essa estrutura; é a estrutura com que o dispositivo está pareado
last_connection	O carimbo de data/hora da última conexão bem-sucedida com o serviço Nest
is_online	Status on-line. Isso é determinado pelo Nest usando o tempo last_connection e uma janela de reconexão específica do dispositivo.

Recursos de fumaça e monóxido de carbono

Integridade da bateria

Use o campo battery_health para ver o estado de integridade da bateria.

Valor	Descrição
ok	Nível da bateria correto
replace	Nível da bateria baixo. Deve ser substituído

Alarme de monóxido de carbono

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

Valor	Descrição
ok	Operação normal
warning	Detecção de níveis crescentes de CO
emergency	O nível de CO está muito alto. O usuário precisa sair da casa

Detector de fumaça

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

Valor	Descrição
ok	Operação normal
warning	Detecção de níveis elevados de fumaça
emergency	Os níveis de fumaça estão muito altos. O usuário precisa sair da casa

Teste manual

Use esses campos para verificar se um teste de fumaça ou CO manual está ativo e na última vez que um teste de fumaça ou monóxido de carbono foi concluído.

• is_manual_test_active: retorna true se houver um fumaça ou teste ativo
• last_manual_test_time

Estado da cor da IU

Para facilitar o design de uma IU coerente entre produtos, fornecemos o campo ui_color_state, que fornece 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, fornecendo uma condição agregada que reflete os indicadores de cor reais exibidos no app Nest.

Mensagens de erro

Para mais informações sobre o que significam erros de chamada de API e como lidar com eles, consulte Mensagens de erro.