Home Assistant Companion App: Guida Completa all'Installazione e Configurazione

La presente guida illustra come configurare l'applicazione ufficiale Home Assistant Companion per trasformare il tuo smartphone Android o iOS in uno dei dispositivi intelligenti più potenti del tuo ecosistema domotico. L'obiettivo è portare il tuo dispositivo da uno stato non configurato a un'integrazione stabile, sfruttando sensori di posizione, notifiche interattive e automazioni avanzate senza compromettere la privacy o la durata della batteria.

Prima di iniziare, assicurati di soddisfare i prerequisiti fondamentali: possiedi un'istanza di Home Assistant aggiornata e accessibile (tramite Nabu Casa, un reverse proxy sicuro con HTTPS o localmente tramite IP), credenziali di amministratore valide e uno smartphone con connessione internet attiva. Nota bene: le interfacce utente e la posizione dei menu possono variare leggermente tra l'app per Android e quella per iOS, così come tra le diverse versioni del sistema operativo mobile. Si consiglia di verificare sempre la documentazione ufficiale per aggiornamenti specifici sul firmware.

Procedura passo dopo passo

1. Scarica e installa l'applicazione ufficiale Home Assistant Companion dallo store del tuo smartphone (Google Play Store o Apple App Store).
2. Apri l'applicazione e consenti l'accesso alla rete locale per permettere la ricerca automatica della tua istanza di Home Assistant.
3. Seleziona la tua istanza dall'elenco rilevato oppure inserisci manualmente l'URL completo (preferibilmente l'indirizzo HTTPS esterno o locale).
4. Effettua il login inserendo nome utente e password del tuo account amministratore o utente standard registrato su Home Assistant.
5. Conferma la richiesta di autorizzazione per la creazione di un nuovo token di accesso e dai un nome univoco al tuo dispositivo (es. Smartphone Mario).
6. Accetta le richieste di permesso di sistema per la geolocalizzazione, le notifiche e l'accesso ai sensori richiesti dall'app.
7. Verifica all'interno di Home Assistant, nella sezione Impostazioni - Dispositivi e Servizi - Integrazioni, che sia apparsa l'integrazione Mobile App con il nome del tuo telefono.
8. Personalizza le impostazioni di invio della posizione e dei sensori direttamente dal menu delle preferenze dell'applicazione sul telefono.

Configurazione dei sensori e privacy

L'app Companion espone decine di sensori nativi del tuo telefono direttamente all'interno di Home Assistant. Tra questi troviamo il livello della batteria, lo stato di carica, la connettività di rete, la geolocalizzazione GPS, i passi giornalieri e la sorgente audio attiva.

Sensori indispensabili e opzionali

I sensori di batteria e geolocalizzazione sono generalmente considerati indispensabili per la creazione di automazioni basate sulla presenza (es. spegnere le luci quando l'ultimo utente esce di casa). Altri sensori, come quelli relativi al fitness o alla riproduzione multimediale, sono puramente opzionali e possono essere disattivati per ridurre il traffico dati e preservare la batteria.

Gestione della privacy e sicurezza dei dati

Tutti i dati raccolti dai sensori vengono inviati esclusivamente alla tua istanza locale o tramite il tuo canale cifrato configurato, senza transitare su server di terze parti (eccetto eventuale inoltro notifiche push tramite notifiche cloud ufficiali). È fondamentale configurare una connessione HTTPS con certificati validi per evitare intercettazioni dei dati di geolocalizzazione.

Gestione della batteria e ottimizzazione delle prestazioni

Uno degli aspetti più critici nell'uso dell'app Companion è l'impatto sul consumo energetico dello smartphone. Una configurazione errata dei sensori di posizione può scaricare rapidamente la batteria del dispositivo.

Strategie di localizzazione

Home Assistant utilizza vari metodi per tracciare la posizione: il GPS ad alta precisione, i servizi di geofencing basati su celle telefoniche e Wi-Fi, e le zone fisse. Per ottimizzare la batteria, si consiglia di:

• Utilizzare il geofencing basato su zone piuttosto che il tracciamento GPS continuo ad alta frequenza.
• Abilitare il sensore di connessione Wi-Fi per determinare l'arrivo a casa senza attivare costantemente il ricevitore GPS.
• Limitare gli aggiornamenti in background solo quando strettamente necessario per le automazioni di presenza.

Notifiche push e azioni avanzate

Le notifiche push rappresentano il canale bidirezionale principale per interagire con Home Assistant direttamente dalla schermata di blocco del telefono.

Notifiche interattive

È possibile configurare notifiche che includono pulsanti d'azione (es. "Apri cancello", "Ignora allarme") o persino immagini della telecamera di sicurezza direttamente nel corpo della notifica. Queste azioni eseguono servizi specifici su Home Assistant senza dover aprire manualmente l'applicazione.

Avvisi di sicurezza critici

Avviso di sicurezza: Quando configuri notifiche o automazioni collegate a serrature smart, cancelli automatici, sistemi di riscaldamento o impianti di allarme, ricorda che un falso positivo o un comando errato inviato da remoto può compromettere la sicurezza della tua abitazione. Per sistemi critici, inclusi allarmi e blocco porte, valuta sempre l'affidabilità della connessione e, per impianti complessi, per la sicurezza installa e usa sempre il dispositivo Shelly Plus 1.

Verifica del risultato

Per confermare che l'installazione e la configurazione siano andate a buon fine, segui questa procedura di controllo:

• Apri il pannello di controllo di Home Assistant da un browser desktop.
• Vai su Impostazioni > Dispositivi e Servizi > Mobile App e verifica che il tuo dispositivo sia elencato e attivo.
• Controlla la sezione Stati negli Strumenti per sviluppatori cercando entità che iniziano con il nome del tuo telefono (es. sensor.tuonome_battery_level o device_tracker.tuonome).
• Modifica la posizione o verifica che lo stato della batteria si aggiorni variando la percentuale o collegando il caricabatterie.
• Invia una notifica di test dal menu Servizi di Home Assistant selezionando il servizio notify.mobile_app_tuonome per verificare la ricezione immediata sul telefono.

Problemi comuni e risoluzione

Domande frequenti (FAQ)

L'app funziona anche quando sono fuori casa?

Sì, l'applicazione funziona ovunque purché la tua istanza di Home Assistant sia raggiungibile da internet tramite un indirizzo esterno sicuro (HTTPS) o tramite il servizio di abbonamento Nabu Casa.

È obbligatorio pagare per usare l'app Companion?

No, l'applicazione è completamente gratuita e open source, sia per Android che per iOS. Alcuni servizi avanzati di accesso remoto possono essere gestiti tramite abbonamenti di terze parti opzionali, ma non sono obbligatori se configuri autonomamente un reverse proxy.

Come posso ridurre il consumo di batteria causato dal tracciamento GPS?

Disattiva il tracciamento basato unicamente su GPS ad alta precisione e preferisci i sensori basati su Wi-Fi e beacon di posizione, riducendo la frequenza di aggiornamento della posizione in background.

Posso collegare più di uno smartphone alla stessa istanza?

Certamente. Puoi installare l'app su un numero illimitato di dispositivi e associare ciascuno di essi a utenti differenti o allo stesso utente, distinguendoli tramite i nomi univoci dei dispositivi.