Home Assistant
Home Assistant SkyConnect / ZBT-1: Errore Failed to probe /dev/ttyACM0 e Bootloader locked
SkyConnect e Connect ZBT-1 (lo stesso prodotto rinominato) smettono di rispondere con Failed to probe: la guida libera la porta seriale, reinstalla il firmware Zigbee dall'interfaccia o dal browser e riconfigura ZHA.
A cosa serve questa guida
Home Assistant SkyConnect e Home Assistant Connect ZBT-1 sono la stessa chiavetta USB: nel 2024 SkyConnect è stata rinominata ZBT-1. Il successore vero è Connect ZBT-2, uscito nel 2025.
L'errore Failed to probe su /dev/ttyACM0 o /dev/ttyUSB0 compare quando ZHA non riesce a dialogare con la radio. Le cause sono quasi sempre tre: un'altra app occupa la porta, sulla chiavetta c'è il firmware sbagliato (Thread o multiprotocollo) oppure un aggiornamento del firmware si è interrotto. Questa guida le esclude nell'ordine, dalla più semplice.
Cosa ti serve per continuare
- Home Assistant 2026.9 (le pagine Connettività → Seriale e Connettività → Zigbee sono state introdotte nel 2026).
- Per l'eventuale reinstallazione manuale del firmware: un computer con Chrome o Edge (servono le API Web Serial, assenti in Firefox e Safari).
Fase 1: Controlla chi sta usando la porta seriale
Una porta seriale può essere usata da un solo programma alla volta. Se Zigbee2MQTT, l'app Silicon Labs Multiprotocol o OpenThread Border Router la stanno già usando, ZHA non può sondarla.
- Apri Impostazioni → Connettività → Seriale: la pagina elenca le porte collegate e, per ognuna, quali integrazioni o app la usano.
- Se la porta della chiavetta risulta usata da un'app (Zigbee2MQTT, Silicon Labs Multiprotocol, OpenThread Border Router), apri Impostazioni → Applicazioni, entra in quell'app e premi Arresta. Disattiva anche Esegui dall'avvio, se non la userai più.
- Se la chiavetta non compare affatto, scollegala, attendi 10 secondi e ricollegala a una porta USB diretta del server, con la prolunga ma senza hub: deve comparire tra le porte collegate.
Fase 2: Installa il firmware Zigbee dall'interfaccia
ZHA funziona solo se sulla chiavetta c'è il firmware Zigbee. Home Assistant lo installa da solo, senza strumenti esterni.
- Apri Impostazioni → Sistema → Hardware, individua Connect ZBT-1 (o SkyConnect) e premi Configura.
- Scegli l'opzione per usare la chiavetta con Zigbee e conferma: Home Assistant scrive il firmware e, se ZHA non è ancora configurato, avvia la sua configurazione.
- Quando la procedura chiede come configurare la rete, scegli di ripristinare un backup automatico se esiste (ritrovi i dispositivi già abbinati), altrimenti di creare una nuova rete.
Fase 3: Se il firmware è danneggiato, reinstallalo dal browser
Se la Fase 2 fallisce o la chiavetta non risponde più dopo un aggiornamento interrotto, reinstalla il firmware dal computer con il Device Toolbox della Open Home Foundation.
- Scollega la chiavetta dal server e collegala al computer.
- Apri
https://toolbox.openhomefoundation.org/home-assistant-connect-zbt-1/install/con Chrome o Edge e premi il pulsante di installazione. - Nella finestra del browser seleziona la porta della chiavetta, scegli il firmware Zigbee e attendi la fine della scrittura senza scollegarla.
- Ricollega la chiavetta al server e ripeti la configurazione di ZHA.
Secondo la pagina ufficiale, l'installazione dal browser è disponibile per tutte le SkyConnect e per le ZBT-1 acquistate dopo il 20 ottobre 2024. Per le ZBT-1 precedenti usa la procedura dall'interfaccia della Fase 2 o contatta l'assistenza Nabu Casa.
Verifica e test operativo
- Apri Impostazioni → Connettività → Zigbee e controlla che i dispositivi non risultino non disponibili.
- Aziona una luce o una presa Zigbee e verifica che risponda.
Cosa fare se qualcosa non funziona
| Sintomo | Controllo | Azione |
|---|---|---|
| Su Linux generico (Container) la porta sparisce dopo il collegamento | systemctl status ModemManager: il servizio scambia la chiavetta per un modem. | Disattivalo con sudo systemctl disable --now ModemManager e ricollega la chiavetta. |
| Il browser non vede la chiavetta | Stai usando Chrome o Edge e nessun altro programma del computer usa la porta. | Chiudi gli altri programmi, usa un altro cavo o porta USB, ricarica la pagina. |
| Dopo il cambio di firmware i dispositivi non rispondono | È stata creata una rete nuova invece di ripristinare il backup. | In ZHA usa la migrazione o il ripristino da backup; in mancanza, riabbina i dispositivi. |
| Il percorso della porta cambia dopo un riavvio | ZHA configurato su /dev/ttyACM0. | Usa il percorso stabile /dev/serial/by-id/usb-Nabu_Casa_… mostrato in Connettività → Seriale. |
Requisiti e risorse ufficiali
- Home Assistant: integrazione ZHA
- Home Assistant: Thread e firmware delle chiavette Connect
- Open Home Foundation: Device Toolbox per Connect ZBT-1
Se il coordinatore continua a dare problemi anche dopo il ripristino, un'alternativa supportata sia da ZHA sia da Zigbee2MQTT è il SONOFF Zigbee 3.0 USB Dongle Plus ZBDongle-P.
Verifica su Home Assistant 2026.9 e sulla documentazione ufficiale: 2 ottobre 2026.