Home Assistant: Entità non disponibile, come risolvere

La comparsa dello stato Non disponibile in Home Assistant rappresenta uno degli inconvenienti più frequenti per gli utenti che gestiscono un sistema domotico. Questa condizione si verifica quando il Core perde la comunicazione con il dispositivo fisico o con il servizio cloud associato all'entità. La presente guida illustra un metodo di diagnosi progressiva, pensato per utenti di livello intermedio, che permette di risalire alla causa radice del disservizio partendo dai controlli fisici e di rete più semplici fino all'analisi approfondita dei registri di sistema. Per applicare correttamente questa procedura sono necessari i privilegi di amministratore sull'istanza di Home Assistant e, ove richiesto, l'accesso fisico ai dispositivi smart o ai componenti di rete come router e switch. Ricorda che la stabilità della domotica dipende in larga misura da un'infrastruttura di rete solida e da una gestione coerente dei nomi identificativi.

Verifica dell'alimentazione e dello stato fisico dei dispositivi

Il primo livello di analisi, spesso trascurato, riguarda l'integrità fisica dell'hardware e la sua alimentazione elettrica. Molti sensori a batteria o attuatori intelligenti possono interrompere le comunicazioni a causa di un blackout temporaneo, di un riavvio imprevisto o dell'esaurimento energetico della cella di alimentazione.

Controllo dei dispositivi alimentati a batteria

I sensori basati su protocolli radio a basso consumo come Zigbee, Z-Wave o Bluetooth inviano aggiornamenti periodici. Se un sensore non trasmette segnale per un tempo superiore all'intervallo di timeout predefinito, Home Assistant contrassegna l'entità come non disponibile. Verifica che la batteria non sia completamente scarica misurandone la tensione con un multimetro o sostituendola temporaneamente con una nuova. Tieni presente che alcuni dispositivi economici non aggiornano correttamente il livello della batteria prima di spegnersi improvvisamente.

Dispositivi connessi alla rete elettrica

Per relè, prese intelligenti e attuatori fissi collegati direttamente alla tensione di rete (230V), assicurati che l'interruttore magnetotermico o differenziale di zona sia attivo. Attenzione: qualsiasi intervento diretto sui cablaggi elettrici o sui morsetti di alimentazione deve essere eseguito esclusivamente da personale qualificato, come un elettricista abilitato, per evitare rischi di folgorazione o cortocircuito. Se il dispositivo è alimentato tramite un adattatore USB, verifica che l'alimentatore eroghi la corrente nominale richiesta e che il cavo non sia danneggiato.

Diagnosi della connettività di rete e dei protocolli radio

Una volta esclusi i problemi di alimentazione, il collo di bottiglia più comune risiede nella connettività di rete. Home Assistant comunica con i dispositivi tramite Wi-Fi locale, LAN cablata o gateway dedicati per protocolli mesh.

Stabilità della rete Wi-Fi e indirizzamento IP

Se il dispositivo smart utilizza il protocollo Wi-Fi, verifica che il punto di accesso o il router non abbiano subito variazioni di configurazione, come la modifica della password della rete wireless o l'attivazione di filtri MAC restrittivi. È altamente raccomandato assegnare indirizzi IP statici o prenotati (DHCP Reservation) tramite il pannello di controllo del router per tutti i componenti domotici. Un cambio di indirizzo IP dinamico rende istantaneamente irraggiungibile l'entità configurata tramite integrazioni locali basate su IP.

Analisi dei gateway Zigbee e Z-Wave

Nel caso di reti mesh Zigbee o Z-Wave, un'entità non disponibile può indicare la perdita del percorso di routing ottimale. Se un dispositivo router intermedio (ad esempio una presa intelligente Shelly Plus Plug IT sempre alimentata) viene scollegato, i dispositivi figli a esso collegati potrebbero rimanere isolati. Verifica lo stato del coordinatore USB (chiavetta Zigbee/Z-Wave) e assicurati che non sia soggetto a interferenze elettromagnetiche, posizionandolo ad esempio lontano da porte USB 3.0 o router Wi-Fi tramite una prolunga USB schermata.

Analisi delle integrazioni e dei registri di sistema

Se l'hardware e la rete risultano perfettamente funzionanti, l'anomalia risiede solitamente nell'integrazione software che gestisce la comunicazione o nel motore Core di Home Assistant.

Controllo dello stato delle integrazioni

Accedi al pannello di controllo di Home Assistant e naviga nella sezione dedicata alle Integrazioni. Un'icona di errore o un messaggio di avviso sotto il nome dell'integrazione suggerisce un problema di autenticazione, la scadenza di un token API o un blocco temporaneo imposto da un servizio cloud esterno (come nel caso di integrazioni meteo, antifurti o termostati connessi).

Consultazione dei registri (Log) e delle notifiche

Il registro di sistema rappresenta lo strumento diagnostico principale. Vai su Impostazioni, seleziona Sistema e infine Registri. Cerca eventuali errori contrassegnati dai livelli ERROR o WARNING associati al dominio dell'entità problematica. Spesso troverai eccezioni Python, errori di timeout nella ricezione dei pacchetti o avvisi di connessione rifiutata che circoscrivono con precisione millimetrica l'origine del guasto.

Gestione della ridenominazione e degli ID entità

Un errore frequente commesso durante la configurazione avanzata riguarda la modifica manuale o automatica dei nomi e degli ID delle entità (entity_id).

Impatto sui file di automazione e sulle dashboard

Quando si sostituisce un dispositivo fisico guasto con uno nuovo, l'assegnazione automatica potrebbe generare un nuovo entity_id con un suffisso numerico (ad esempio sensor.temperatura_stanza_2 anziché sensor.temperatura_stanza). Di conseguenza, tutte le automazioni, gli script e le schede della dashboard (Lovelace) che facevano riferimento al vecchio ID perderanno il collegamento, restituendo lo stato di entità non disponibile. Per risolvere, accedi alle impostazioni dell'entità e ripristina manualmente l'ID originale oppure aggiorna i riferimenti nei file di configurazione YAML e nelle automazioni visuali.

Procedura passo dopo passo

1. Accedi al pannello di controllo principale di Home Assistant Green con credenziali di amministratore e individua l'entità contrassegnata come non disponibile.
2. Verifica fisicamente che il dispositivo smart associato sia correttamente alimentato e che eventuali spie LED di stato siano attive.
3. Accedi al pannello di amministrazione del tuo router Wi-Fi per controllare se il dispositivo risulta connesso alla rete locale e se il suo indirizzo IP è rimasto invariato.
4. Riavvia il singolo dispositivo scollegandolo temporaneamente dall'alimentazione elettrica per circa dieci secondi e ricollegandolo.
5. Vai su Impostazioni, seleziona Dispositivi e Servizi, individua l'integrazione di riferimento e verifica la presenza di eventuali errori di autenticazione o stato di errore.
6. Consulta la sezione Registri di sistema in Impostazioni per individuare eventuali eccezioni software o timeout di connessione generati dal componente.
7. Se hai recentemente sostituito o rinominato il dispositivo, verifica che l'entity_id corrisponda esattamente a quello utilizzato nelle automazioni e nelle dashboard.
8. Riavvia l'intera istanza di Home Assistant Green tramite il menu Strumenti di sviluppo o Riavvio di sistema se il problema persiste dopo aver verificato tutti i punti precedenti.

Verifica del risultato

Al termine della procedura di diagnosi e risoluzione, è necessario accertarsi che il sistema sia tornato in uno stato di piena operatività. Accedi alla dashboard principale di Home Assistant e osserva l'entità precedentemente segnalata: lo stato non deve più mostrare la dicitura Non disponibile o Sconosciuto, bensì il valore numerico o booleano aggiornato (ad esempio la temperatura attuale o lo stato di accensione). Verifica inoltre che le automazioni collegate a quell'entità eseguano correttamente le azioni programmate senza generare errori nei registri di sistema. Si consiglia di monitorare il comportamento del dispositivo per almeno ventiquattro ore per escludere disconnessioni intermittenti legate alla saturazione della memoria o a interferenze radio temporanee.

Problemi comuni

Domande frequenti

Perché un'entità diventa improvvisamente non disponibile dopo un riavvio di Home Assistant?

Questo fenomeno si verifica solitamente quando Home Assistant si avvia più rapidamente rispetto ai dispositivi di rete o ai gateway locali (come bridge Zigbee o hub Philips Hue). Il Core tenta di interrogare i dispositivi prima che questi abbiano completato la fase di boot e stabilito la connessione di rete, contrassegnandoli temporaneamente come non disponibili. Nella maggior parte dei casi il sistema si riconsueta autonomamente nel giro di pochi minuti.

Come posso evitare che la ridenominazione di un dispositivo rompa le automazioni?

Quando modifichi il nome di un dispositivo direttamente dall'interfaccia di Home Assistant, il sistema chiede solitamente se si desidera aggiornare anche l'ID entità correlato. È consigliabile mantenere invariato l'chiuso in virgoletteentity_id originale se questo è già ampiamente utilizzato all'interno di script, automazioni e dashboard complesse, limitandosi a modificare unicamente il nome amichevole (friendly_name).

Cosa fare se un'integrazione ufficiale continua a dare errori di timeout?

Gli errori di timeout indicano che il dispositivo non risponde entro il tempo limite imposto dall'integrazione. Questo può dipendere da un carico eccessivo sulla CPU dell'hardware su cui gira Home Assistant (ad esempio un Raspberry Pi con scheda SD usurata), da un segnale di rete estremamente debole o da firmware obsoleti sul dispositivo stesso. Verifica gli aggiornamenti firmware del produttore e controlla l'utilizzo delle risorse di sistema.

È possibile creare un'automazione per ricevere una notifica quando un'entità diventa non disponibile?

Sì, è possibile configurare un'automazione avanzata impostando come trigger lo stato di un'entità che passa a unavailable o unknown. Per evitare falsi positivi dovuti a brevi instabilità di rete, è consigliabile aggiungere una condizione di durata (for:), imponendo che lo stato anomali persista ad esempio per almeno cinque minuti prima di inviare la notifica sullo smartphone.