Integrazione con Home Assistant

Car 2 Home offre un'integrazione di prim'ordine con Home Assistant che trasforma la tua auto in un vero partecipante della tua smart home, non solo in un'altra fonte di dati. Funziona sia come componente nativo di Home Assistant (installato tramite HACS, comunicando direttamente con l'app via WebSocket) sia come normale client MQTT. Entrambe le strade sono supportate; scegli quella più adatta alla tua configurazione.

Quello che rende speciale la via nativa è che va oltre l'esposizione dei sensori. La tua auto pubblica eventi sul bus eventi di Home Assistant: viaggio iniziato, viaggio finito, auto parcheggiata, guasto trovato, accelerazione brusca, centralina online. Puoi così scrivere automazioni che reagiscono al momento in cui qualcosa accade, invece di interrogare un valore e tirare a indovinare.

Due strade, stesso risultato

Integrazione con Home Assistant

Un'integrazione personalizzata di Home Assistant installata tramite HACS. Home Assistant genera un codice di abbinamento a 6 cifre che digiti nell'app. Nessun token da gestire, nessun broker da installare. La comunicazione è bidirezionale via WebSocket: Home Assistant riceve ogni sensore ed evento dall'auto tramite l'app, e può modificare impostazioni come la modalità di sincronizzazione e attivare altre azioni, purché l'app sia connessa.

MQTT (qualsiasi broker)

Se utilizzi già Mosquitto, EMQX, HiveMQ o qualsiasi altro broker, oppure se vuoi che i dati confluiscano in Home Assistant o in altri strumenti come Node-RED, openHAB, ioBroker, ecc., Car 2 Home pubblica gli stessi sensori con il rilevamento automatico MQTT completo di Home Assistant. La differenza è che la strada MQTT trasporta lo stato continuo, non gli eventi: cose come trip_started o dtc_found esistono solo nell'integrazione nativa.

Come installare

1. 1. Installa tramite HACS

   Apri HACS in Home Assistant, aggiungi Car 2 Home dall'elenco delle integrazioni e riavvia Home Assistant. (Se non hai ancora HACS, installalo prima da hacs.xyz.)

2. 2. Aggiungi l'integrazione

   Vai su Impostazioni → Dispositivi e servizi → Aggiungi integrazione in Home Assistant e cerca "Car 2 Home". Home Assistant genererà un codice di abbinamento.

3. 3. Abbina con il codice a 6 cifre

   Inserisci l'URL pubblico del tuo Home Assistant e il codice di abbinamento nell'app, in Impostazioni → Home Assistant → Integrazione, e il gioco è fatto!

4. 4. Scegli una modalità di sincronizzazione

   La modalità «Online» trasmette la telemetria in tempo reale mentre guidi. La modalità «Casa» accumula i dati nell'app mentre sei fuori e li scarica appena il telefono rientra nella tua rete: utile quando Home Assistant è raggiungibile solo da casa. L'app sceglie l'indirizzo in base alla connessione del momento, quindi quello locale a casa e quello remoto in viaggio.

Cosa ottieni

Ogni veicolo del tuo garage diventa un dispositivo in Home Assistant con le sue entità. I nomi seguono lo schema car2home_{brand}_{model}_{sensor}, con il soprannome che hai dato all'auto quando c'è, così due auto dello stesso modello non si sovrappongono mai. Sei tu a scegliere quali sensori vengono esportati, quindi l'elenco resta corto o completo quanto vuoi. La scelta si fa nella schermata Sensori supportati dell'app: un sensore viene esportato finché è attivo e il suo interruttore HA/MQTT è acceso.

• Sensori OBD-II standard: velocità, RPM, liquido di raffreddamento, livello carburante, posizione della valvola a farfalla, lambda e il resto del catalogo SAE J1979 supportato dalla tua auto.
• Sensori specifici di produttore/modello: PID estesi che variano per marca e modello, rilevati automaticamente.
• Sensori calcolati: portata carburante, consumo medio mobile (finestre da 10/50/100 km), potenza alle ruote, autonomia stimata, distanza del viaggio.
• Posizione: quota, precisione e un device_tracker che mostra dove è parcheggiata l'auto, con indirizzo e ora di arrivo. Il GPS del telefono trasmette solo durante un viaggio.
• TPMS: pressione per ruota, temperatura, ID sensore.
• Stato diagnostico: MIL on/off, conteggio DTC, freeze frame, tensione dell'adattatore, ECU online/offline, stato della connessione a Home Assistant o MQTT.
• Comportamento di guida: Safe Score ed Eco Score live, contatori degli eventi bruschi, cronologia mensile.
• Vehicle Hub: previsione del prossimo rifornimento, prossima manutenzione, prossimo promemoria, totali e consumo del mese, più gli indicatori di scaduto e in scadenza. Compaiono solo per le funzioni che usi davvero.

Eventi sul bus eventi di Home Assistant

Sono questi a distinguere l'integrazione nativa. Le tue automazioni possono ascoltare momenti discreti invece di interrogare continuamente lo stato.

• car2home_trip_started: si attiva nel momento in cui inizia un viaggio (avvio motore + movimento). Il payload include l'id del veicolo e la posizione di partenza.
• car2home_trip_ended: si attiva quando un viaggio termina, con il riepilogo completo del viaggio: distanza, durata, velocità media / massima, carburante usato, indirizzo del parcheggio.
• car2home_parking_detected: scatta quando l'auto parcheggia, con il posto, durata e distanza del viaggio, carburante e autonomia rimasti. È l'evento per le automazioni «sono arrivato a casa».
• car2home_dtc_found: una scansione diagnostica è terminata e ha trovato dei codici. Il payload porta la modalità di scansione e gli elenchi dei codici confermati, in attesa e permanenti.
• car2home_harsh_event: rilevata accelerazione brusca, frenata brusca o curva brusca. Utile per le notifiche di guida sicura, specialmente con i neopatentati.
• car2home_ecu_online / car2home_ecu_offline: si attiva ogni volta che la connessione all'ECU si stabilisce o cade, così puoi distinguere "l'auto è in marcia in questo momento" da "l'auto è parcheggiata".

Esempi di automazioni

Qualche idea per ispirare le tue.

• Apri il cancello del garage e accendi le luci del portico quando imbocchi la tua via (geofence + trip_started).
• Avvisa la famiglia con l'indirizzo del parcheggio e un link alla mappa nel momento in cui un viaggio termina.
• Invia un avviso su Telegram quando una scansione trova dei codici, indicando quanti sono confermati, in attesa e permanenti.
• Pre-raffredda la casa nel momento in cui lasci l'ufficio (geofence ufficio + trip_started).

Compatibilità e requisiti

• Home Assistant 2024.12 o successivo.
• Funziona con Nabu Casa Cloud, Cloudflare Tunnel, Tailscale o qualsiasi reverse proxy di cui ti fidi già.
• Multi-veicolo: ogni auto del tuo garage compare come dispositivo Home Assistant a sé stante, con entità e cronologia indipendenti.
• I token sono memorizzati nel Keychain di iOS / Keystore di Android, mai nelle preferenze dell'app.