Home Assistant
Come configurare Matter e Thread in Home Assistant
Configura Matter Server e Thread in Home Assistant, distinguendo protocollo applicativo, rete radio e Thread Border Router, con verifica IPv6 e commissioning.
Prerequisiti & Hardware Necessario
- Hardware: Home Assistant OS su host 64-bit, smartphone con app Home Assistant e un Thread Border Router compatibile. Home Assistant Connect ZBT-1/SkyConnect può svolgere questo ruolo, ma per nuovi impianti il multiprotocollo non è raccomandato. Un host possibile è Raspberry Pi 5 4GB con alimentatore ufficiale.
- Software: Matter Server app, integrazione Matter, integrazione Thread e OpenThread Border Router quando il Border Router è gestito da Home Assistant. Matter è il protocollo applicativo; Thread è il trasporto mesh IPv6; il Border Router è il componente che collega Thread alla LAN.
- Rete: IPv6 abilitato, Home Assistant e smartphone sulla rete corretta e multicast non filtrato durante il commissioning. VLAN, Wi-Fi isolation e firewall possono impedire il rilevamento.
- Dispositivo: dispositivo Matter con QR code o codice numerico di configurazione. Per un dispositivo Matter over Thread serve anche una rete Thread operativa.
Procedura passo-passo
- Aggiorna e fai backup. Aggiorna Home Assistant OS e crea un backup completo. Matter Server non è supportato su piattaforme 32-bit secondo la documentazione Home Assistant.
- Installa Matter Server. In Home Assistant OS vai in Impostazioni → App → Negozio delle app, installa l’app ufficiale Matter Server e avviala. L’integrazione Matter si collega al server; non confondere l’app con un dispositivo radio.
- Configura l’integrazione Matter. Vai in Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Matter. Seleziona il Matter Server rilevato automaticamente e completa la configurazione. In un’installazione Container devi gestire il Matter Server separatamente.
- Controlla Thread. Apri Impostazioni → Dispositivi e servizi → Thread. Se l’integrazione non compare, aggiungila e verifica che sia visibile almeno una rete Thread. Thread da solo non controlla dispositivi: serve Matter o un altro protocollo applicativo.
- Prepara il Border Router. Se usi Connect ZBT-1/SkyConnect, segui la procedura ufficiale per abilitarlo come Thread Border Router. Il dispositivo viene fornito normalmente con firmware Zigbee; il passaggio a Thread o multiprotocollo modifica la funzione radio e può richiedere una procedura firmware.
- Sincronizza le credenziali Thread. In Thread seleziona la rete preferita e usa l’opzione per inviare le credenziali allo smartphone quando richiesto. Senza credenziali il telefono può non riuscire a commissionare un dispositivo Thread.
- Verifica IPv6 e VLAN. Controlla nel router che IPv6 sia abilitato e che Home Assistant, smartphone, Border Router e dispositivo siano raggiungibili. Durante il primo test usa una rete LAN semplice, senza isolamento client o multicast filtering.
- Metti il dispositivo Matter in pairing. Apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Matter, scegli l’aggiunta di un dispositivo e scansiona il QR code con l’app Home Assistant. Per Thread resta vicino al Border Router e al dispositivo.
- Seleziona la rete corretta. Quando richiesto, scegli la rete Thread gestita da Home Assistant. Non creare una nuova rete se il dispositivo deve entrare nella rete Thread già esistente.
- Verifica fabric e controllo. Dopo il commissioning assegna il dispositivo a un’area, controlla entità e comandi e salva le credenziali Thread e il backup Matter fuori dal server.
Verifica del funzionamento
La configurazione è corretta quando Matter Server è attivo, l’integrazione Matter è disponibile, Thread mostra una rete e il dispositivo viene commissionato senza errore “border router required”. Testa un comando locale, riavvia Home Assistant e verifica che dispositivo e Border Router tornino disponibili.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| “Border router required” | Rete Thread assente o credenziali non sincronizzate | Configura Thread, attiva il Border Router e sincronizza le credenziali con lo smartphone. |
| QR code non completa il pairing | Telefono su VLAN diversa, IPv6/multicast filtrati o dispositivo fuori portata | Usa la stessa LAN, disabilita isolamento temporaneamente e avvicina telefono e dispositivo. |
| Matter Server non disponibile | App non installata, server non avviato o piattaforma 32-bit | Controlla app e log; usa Home Assistant OS 64-bit. |
| ZBT-1 non funziona più come Zigbee | Firmware passato a Thread o multiprotocollo | Decidi se usare Zigbee o Thread e ripristina il firmware dedicato previsto dalla documentazione. |
| Dispositivo rilevato ma non controllabile | Border Router non raggiungibile o fabric incompleta | Controlla Thread, IPv6, integrazione Matter e log del Matter Server. |
FAQ essenziali
Matter e Thread sono la stessa tecnologia?
No. Matter definisce dispositivi, comandi e sicurezza a livello applicativo; Thread è una rete mesh IPv6 a basso consumo. Matter può funzionare su Thread o Wi-Fi/Ethernet.
Posso usare il multiprotocollo sul Connect ZBT-1?
È una modalità sperimentale e non raccomandata per una nuova configurazione. Per stabilità usa un firmware Zigbee o Thread dedicato, oppure due radio separate.
Prodotti consigliati
Hardware pertinente alla guida
I collegamenti portano alle pagine dei prodotti indicati. Il prezzo Amazon, quando disponibile, proviene dall’API ufficiale ed è aggiornato con data e ora; prezzo e disponibilità finali sono quelli della pagina Amazon.
SONOFF ZigBee 3.0 USB Dongle Plus, TI CC2652P Coordinator, universale USB ZigBee Hub, Gateway ZigBee per Home AssistantProdotto correlatoDisponibilità da verificare
AmazonVedi prezzo
AliExpressPDP non verificata