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.

Ciò che rende speciale la strada nativa è che va oltre la semplice esposizione dei sensori. La tua auto pubblica eventi sul bus eventi di Home Assistant: viaggio iniziato, viaggio terminato, DTC rilevato, accelerazione brusca, ECU online, il che significa che puoi scrivere automazioni che reagiscono a momenti, non solo a numeri che superano delle soglie.

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à "Solo Wi-Fi" memorizza i dati sull'app mentre sei in giro e li scarica nel momento in cui il telefono si connette a una rete Wi-Fi: utile quando non hai un URL pubblico per Home Assistant o vuoi risparmiare dati mobili.

Cosa ottieni

Ogni veicolo del tuo garage diventa un dispositivo in Home Assistant con il proprio set di entità. I nomi seguono lo schema car2home_{manufacturer}_{model}_{sensor}, così i veicoli multipli non vanno mai in conflitto. Le entità usano la semantica RestoreSensor di Home Assistant: mantengono il loro ultimo valore noto tra un riavvio e l'altro e non diventano mai non disponibili solo perché il motore si è spento.

• 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: altitudine, precisione e un'entità device_tracker per il veicolo.
• 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.

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_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. I blocchi di configurazione completi si trovano nella sezione Guide.

• 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.