ZHA
Come configurare Home Assistant Connect ZBT-1 con ZHA
Configura Home Assistant Connect ZBT-1, già noto come Home Assistant SkyConnect, come coordinatore Zigbee con ZHA e verifica firmware, collegamento USB e pairing.
Prerequisiti & Hardware Necessario
- Hardware: Home Assistant Connect ZBT-1, precedentemente commercializzato come Home Assistant SkyConnect, con cavo di prolunga USB incluso. Il dispositivo usa Silicon Labs EFR32MG21, radio 2,4 GHz, USB 2.0 full-speed e alimentazione 5 V DC fino a 150 mA.
- Software: Home Assistant OS aggiornato e integrazione Zigbee Home Automation (ZHA). ZBT-1 è il coordinatore radio hardware; ZHA è l’integrazione software.
- Host: Home Assistant su Raspberry Pi 4/5, Home Assistant Green, VM o altro hardware compatibile. Per un host Raspberry Pi 5: Raspberry Pi 5 4GB con alimentatore ufficiale.
- Radio: per un nuovo impianto usa il firmware Zigbee dedicato. Il firmware multiprotocollo Zigbee/Thread è sperimentale e non è la scelta raccomandata per una nuova installazione.
Procedura passo-passo
- Aggiorna Home Assistant. Vai in Impostazioni → Sistema → Aggiornamenti e aggiorna Home Assistant OS, Supervisor e Core secondo le notifiche disponibili. Crea un backup completo prima di modificare il coordinatore.
- Collega il ZBT-1 con la prolunga. Inserisci il dongle in una porta USB 2.0 o in un hub USB 2.0 alimentato e tienilo lontano da porte USB 3.0, SSD NVMe e cavi di alimentazione. La prolunga non è un accessorio estetico: riduce interferenze a 2,4 GHz.
- Controlla che Home Assistant rilevi l’hardware. Apri Impostazioni → Sistema → Hardware e verifica la presenza del dispositivo Silicon Labs. L’integrazione hardware Connect ZBT-1 serve per le informazioni del dispositivo e non è una pagina di configurazione manuale di ZHA.
- Configura ZHA. Vai in Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Zigbee Home Automation. Seleziona il coordinatore ZBT-1 rilevato e lascia che Home Assistant proponga il tipo radio; non selezionare un percorso seriale appartenente a un altro dongle.
- Crea la rete Zigbee. Conferma la configurazione e annota il canale scelto. Se stai migrando da un’altra rete, non creare una seconda configurazione senza prima esportare il backup e decidere se migrare o rifare il pairing.
- Abbina un dispositivo Zigbee. In ZHA apri il pannello Zigbee, avvia l’aggiunta di un dispositivo e metti il sensore o attuatore in modalità pairing seguendo il manuale del produttore. Completa l’inclusione vicino al coordinatore, poi sposta il dispositivo nella posizione definitiva.
- Aggiungi router Zigbee alimentati. Prevedi lampade, prese o router Zigbee alimentati a rete per estendere la mesh. Un coordinatore con +20 dBm non sostituisce una rete mesh correttamente distribuita.
- Crea il backup ZHA. In Impostazioni → Dispositivi e servizi → Zigbee Home Automation → Configura apri le impostazioni di rete e crea un backup manuale. Scaricalo fuori dal dispositivo oltre al backup completo Home Assistant.
- Verifica il firmware e la modalità. Mantieni il firmware Zigbee dedicato se il tuo obiettivo è ZHA. Non installare il firmware multiprotocollo solo per usare Matter/Thread: la documentazione ufficiale lo considera sperimentale e non raccomandato per nuove configurazioni.
- Testa riavvio e pairing. Riavvia Home Assistant, verifica che ZHA torni disponibile e che almeno un dispositivo alimentato a batteria e un router mains-powered rispondano. Non scollegare il dongle durante un aggiornamento firmware o una migrazione.
Verifica del funzionamento
La configurazione è corretta quando ZHA mostra il coordinatore ZBT-1, il dispositivo di prova risponde, la rete mantiene il pairing dopo un riavvio e il backup Zigbee è stato salvato fuori dall’host. Se usi il marchio SkyConnect, considera che l’hardware è lo stesso del Connect ZBT-1; cambia il nome commerciale, non la procedura di base.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| ZHA non rileva il dongle | Porta USB, cavo o firmware non accessibile | Usa la prolunga inclusa, prova USB 2.0, controlla Hardware e aggiorna Home Assistant. |
| Dispositivi intermittenti | Interferenze USB 3 o coordinatore troppo vicino al server | Allontana il ZBT-1 con la prolunga e usa un canale Zigbee meno sovrapposto al Wi-Fi. |
| È comparsa una rete Thread ma ZHA non parte | Firmware multiprotocollo o gestione radio non coerente | Per una nuova rete Zigbee usa il firmware Zigbee dedicato e una sola integrazione proprietaria. |
| Pairing fallisce | Dispositivo già associato, distanza o inclusione disattivata | Ripristina il dispositivo secondo il produttore, avvia l’inclusione e avvicinalo al coordinatore. |
| SkyConnect e ZBT-1 sembrano diversi | Nome e confezione differenti | Sono lo stesso hardware e hanno la stessa capacità; non creare una procedura diversa. |
FAQ essenziali
Home Assistant Connect ZBT-1 è ancora supportato?
Il dispositivo è la versione rinominata di Home Assistant SkyConnect; hardware e capacità sono gli stessi. Per nuovi acquisti la linea è stata sostituita da generazioni successive, ma il ZBT-1/SkyConnect resta configurabile secondo la documentazione disponibile.
Posso usare ZBT-1 contemporaneamente per Zigbee e Thread?
Il multiprotocollo esiste ma è indicato come sperimentale e non raccomandato. Per stabilità usa il firmware Zigbee per ZHA oppure dedica un secondo radio a Thread.
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.