Come integrare Philips Hue in Home Assistant tramite Hue Bridge

L’integrazione Philips Hue di Home Assistant controlla localmente lampade, sensori e telecomandi collegati a un Hue Bridge. Il Bridge è l’hardware; l’integrazione Hue è il software Home Assistant. Le scene vengono create e gestite nell’app Hue e importate in Home Assistant, mentre le zone e le stanze possono essere esposte come luci raggruppate.

Prerequisiti & Hardware Necessario

• Philips Hue Bridge collegato via Ethernet alla LAN e alimentato dal suo alimentatore.
• Una o più lampade, sensori di movimento o telecomandi Philips Hue associati al Bridge tramite app Hue.
• Home Assistant nella stessa rete IP del Bridge, oppure routing/firewall che permetta la comunicazione locale.
• Accesso alla rete locale e al pulsante fisico centrale del Bridge per autorizzare l’integrazione.
• Nessun link d’acquisto è necessario: la guida usa un Bridge già disponibile. Le lampade Philips Hue Bluetooth senza Bridge seguono invece l’integrazione separata Philips Hue BLE.

Procedura passo-passo

1. Collega il Bridge. Collega l’alimentazione e un cavo Ethernet dal Bridge al router o switch. Attendi i LED e verifica nel router l’indirizzo IP assegnato; crea una prenotazione DHCP per evitare che cambi.
2. Completa la configurazione Hue. Nell’app Philips Hue aggiungi il Bridge, aggiorna il firmware quando richiesto e associa lampade, sensori e telecomandi. Organizza i dispositivi in stanze e zone prima di importarli in Home Assistant.
3. Verifica la rete. Dal server Home Assistant verifica che il Bridge risponda al suo IP. Se hai VLAN, consenti il traffico tra Home Assistant e la subnet del Bridge e gestisci discovery/mDNS secondo la topologia; non esporre il Bridge su Internet.
4. Aggiungi l’integrazione Hue. In Home Assistant apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione e cerca Philips Hue. Il Bridge viene normalmente scoperto automaticamente; se non compare, avvia la configurazione manuale e inserisci il suo hostname o IP quando richiesto.
5. Autorizza il collegamento. Quando Home Assistant lo chiede, premi il pulsante fisico sul Bridge entro il tempo indicato. Non premere il pulsante di una lampada o di un telecomando: l’autorizzazione avviene sul Bridge.
6. Controlla le entità. Verifica che ogni lampada, sensore e telecomando sia presente nell’integrazione. I relay/telecomandi Hue possono apparire come trigger di dispositivo e, se alimentati a batteria, come sensori di batteria.
7. Abilita le luci raggruppate se servono. Home Assistant crea le luci delle zone/stanze Hue ma le lascia disabilitate di default. Apri le entità dell’integrazione Philips Hue e abilita i gruppi che vuoi usare nelle dashboard o automazioni.
8. Gestisci le scene nell’app Hue. Crea o modifica le scene nell’app ufficiale Hue. Home Assistant importa le scene disponibili come entità scene; la loro creazione o modifica non è supportata direttamente dall’integrazione Hue.
9. Usa le scene per gruppi di lampade. Per accendere più lampade insieme preferisci l’azione hue.activate_scene o la scena importata. Il Bridge può applicare la scena in modo più fluido rispetto all’invio di comandi separati a ogni lampada.
10. Configura automazioni. Usa sensori di movimento, telecomandi Hue o stati delle lampade come trigger. Per i telecomandi verifica il dispositivo e il tipo di evento nella UI prima di creare l’automazione; non copiare gli eventi di un modello diverso.
11. Proteggi l’accesso locale. Mantieni il Bridge sulla LAN, aggiorna firmware e router e non configurare port forwarding verso l’IP del Bridge. L’accesso remoto deve passare da Home Assistant Cloud, VPN o reverse proxy HTTPS correttamente configurato.
12. Considera il Bridge V1. Il Bridge V1 rotondo è fuori supporto del produttore. Home Assistant lo mantiene con limitazioni tecniche: scene e aggiornamenti di stato possono comportarsi diversamente. Per una nuova installazione usa un Bridge corrente compatibile.

Verifica del funzionamento

1. In Home Assistant verifica che l’integrazione Hue sia disponibile e che il Bridge riporti l’IP corretto.
2. Accendi, spegni e regola una lampada dal dashboard; lo stato fisico deve aggiornarsi in Home Assistant.
3. Attiva una scena Hue dall’app e verifica che l’entità scena corrispondente venga aggiornata.
4. Muoviti davanti a un sensore Hue e controlla evento, luminosità, temperatura e batteria quando esposti dal modello.
5. Riavvia Home Assistant: il Bridge e le entità devono ricomparire senza una nuova autorizzazione.

Problemi comuni

FAQ essenziali

Posso usare le lampade Hue senza Bridge?

Sì, alcuni modelli Bluetooth possono usare l’integrazione Philips Hue BLE, che è diversa dall’integrazione Philips Hue basata su Bridge. Verifica modello, portata e compatibilità prima di scegliere il metodo.

Home Assistant deve avere accesso al cloud Hue?

No. L’integrazione Philips Hue usa comunicazione locale con il Bridge. Il cloud può essere usato dall’app Hue per funzioni esterne, ma non è necessario per il controllo locale da Home Assistant.