# Guia da Philips Hue — passo a passo bem fácil

**O que é isto, em uma frase:** ligar as **lâmpadas, sensores e interruptores Philips
Hue** ao Nexus, para acender/apagar e monitorar pelo sistema.

**Como funciona (sem susto):** o Nexus conversa direto com a **Bridge Hue** (aquela
caixinha branca ligada no seu roteador), tudo dentro da sua rede. É um **extra** — se
não configurar, nada muda no Nexus.

**Você vai precisar de:** a **Bridge Hue** ligada na rede, uns **10 minutos** e acesso
de administrador ao Nexus.

---

## Passo 1 — Descobrir o IP da Bridge

1. Abra o app **Philips Hue** no celular → **Configurações → Luzes/Bridge → Informações da rede**.
   Anote o **endereço IP** (algo como `172.16.0.30`).
2. Não achou? Entre no painel do seu roteador e procure um aparelho chamado **Philips-hue**.

✅ **Deu certo se:** você tem o IP da Bridge anotado.

---

## Passo 2 — Gerar a "chave de aplicativo" (app key)

A Bridge só obedece quem tem uma chave. Você gera essa chave apertando o botão dela.

1. Abra o **Prompt de Comando** (Menu Iniciar → digite `cmd` → Enter).
2. **Aperte o botão redondo grande** no topo da Bridge (o de "link").
3. **Nos 30 segundos seguintes**, copie e cole a linha abaixo (troque o IP pelo seu) e aperte Enter:

```
curl -k -X POST http://172.16.0.30/api -H "Content-Type: application/json" -d "{\"devicetype\":\"nexus#server\"}"
```

4. A resposta vem assim:

```
[{"success":{"username":"AbCdEf123...umaSequenciaLonga..."}}]
```

Copie **o valor de `username`** — essa é a sua **chave de aplicativo** (app key).

✅ **Deu certo se:** você tem a chave (a sequência longa) copiada.

> Deu `link button not pressed`? Você demorou. Aperte o botão de novo e repita o comando na hora.

---

## Passo 3 — Cadastrar o canal Hue no Nexus

1. No Nexus, vá em **Automação → Canais/Contas → Novo canal**.
2. Em **Provedor**, escolha **Philips Hue**.
3. O formulário já traz o modelo. Preencha:
   - `host` = o **IP** da Bridge (Passo 1), ex.: `172.16.0.30`
   - `app_key` = a **chave** (Passo 2)
4. Salve.

✅ **Deu certo se:** o canal Hue aparece salvo na lista de canais.

---

## Passo 4 — Buscar as lâmpadas e sensores

1. Vá em **Automação → Dispositivos → Novo dispositivo**.
2. Em **Driver**, escolha **Philips Hue (Bridge local)** e selecione o **canal** que você criou.
3. Clique em **"Buscar do canal"**: aparece a lista de lâmpadas e sensores da sua casa.
4. Escolha uma **lâmpada** → o campo `light_id` é preenchido. Dê um nome e salve.
   - Para um **sensor** (presença/temperatura/botão), no modelo troque `kind` para `sensor`
     e informe o `sensor_id` (também vem do "Buscar do canal").

✅ **Deu certo se:** o dispositivo aparece no painel de Automação e você consegue **ligar/
desligar** a lâmpada. Sensores aparecem como **"somente monitoramento"** (mostram o valor,
sem botão).

---

## Deu problema?

**"Buscar do canal" não traz nada.** Confira o **IP** e a **chave** no canal (Passo 3).
Teste no navegador do servidor: `http://172.16.0.30/api/SUA_CHAVE/lights` deve mostrar um
texto com as luzes.

**A lâmpada não liga pelo Nexus.** Veja se ela está **alcançável** (a Bridge mostra
"reachable"). Lâmpada sem energia ou fora de alcance não responde.

**Desliguei sem querer no painel de Módulos.** Vá em **Configurações → Módulos** e ligue
o **Philips Hue** de novo. (Esse painel é o "freio geral" das integrações.)

**Troquei a Bridge de lugar/rede e parou.** O IP pode ter mudado. Descubra o novo IP
(Passo 1) e atualize no canal.

---

Pronto! Suas luzes e sensores Hue agora fazem parte do Nexus — e entram nas cenas,
agendas e automações como qualquer outro dispositivo.