Intégration Home Assistant

Car 2 Home propose une intégration Home Assistant de premier ordre qui fait de votre voiture un véritable acteur de votre maison connectée, et pas seulement un flux de données de plus. Elle fonctionne soit comme un composant natif de Home Assistant (installé via HACS, communiquant directement avec l'application par WebSocket), soit comme un client MQTT standard. Les deux approches sont prises en charge ; choisissez celle qui convient à votre installation.

Ce qui rend la voie native particulière, c'est qu'elle va au-delà de l'exposition de capteurs. Votre voiture publie des événements sur le bus d'événements de Home Assistant : trajet démarré, trajet terminé, voiture garée, défaut trouvé, accélération brusque, calculateur en ligne. Vous pouvez donc écrire des automatisations qui réagissent au moment où quelque chose se produit, au lieu d'interroger une valeur et de deviner.

Deux approches, même résultat

Intégration Home Assistant

Une intégration Home Assistant personnalisée installée via HACS. Home Assistant génère un code d'appairage à 6 chiffres que vous saisissez dans l'application. Aucun jeton à gérer, aucun broker à installer. La communication est bidirectionnelle par WebSocket : Home Assistant reçoit chaque capteur et chaque événement de la voiture via l'application, et peut modifier des réglages comme le mode de synchronisation ainsi que déclencher d'autres actions, tant que l'application est connectée.

MQTT (n'importe quel broker)

Si vous utilisez déjà Mosquitto, EMQX, HiveMQ ou tout autre broker, ou si vous souhaitez que les données alimentent Home Assistant ou d'autres outils comme Node-RED, openHAB, ioBroker, etc., Car 2 Home publie les mêmes capteurs avec la prise en charge complète de l'auto-découverte MQTT de Home Assistant. La différence, c'est que l'approche MQTT transporte un état continu, et non des événements : des éléments comme trip_started ou dtc_found n'existent que dans l'intégration native.

Comment l'installer

1. 1. Installer via HACS

   Ouvrez HACS dans Home Assistant, ajoutez Car 2 Home depuis la liste des intégrations, puis redémarrez Home Assistant. (Si vous n'avez pas encore HACS, installez-le d'abord depuis hacs.xyz.)

2. 2. Ajouter l'intégration

   Allez dans Paramètres → Appareils et services → Ajouter une intégration dans Home Assistant et recherchez « Car 2 Home ». Home Assistant génère un code d'appairage.

3. 3. Appairer avec le code à 6 chiffres

   Saisissez l'URL publique de votre Home Assistant et le code d'appairage dans l'application, sous Paramètres → Home Assistant → Intégration, et le tour est joué !

4. 4. Choisir un mode de synchronisation

   Le mode « En ligne » diffuse la télémétrie en temps réel pendant que vous conduisez. Le mode « Maison » accumule les données dans l'application pendant votre absence et les envoie dès que le téléphone retrouve votre réseau : utile quand Home Assistant n'est joignable qu'à la maison. L'application choisit l'adresse selon la connexion du moment, donc la locale à la maison et la distante sur la route.

Ce que vous obtenez

Chaque véhicule de votre garage devient un appareil Home Assistant avec son propre jeu d'entités. Les noms suivent le motif car2home_{brand}_{model}_{sensor}, avec le surnom que vous avez donné à la voiture quand il existe, pour que deux voitures du même modèle n'entrent jamais en collision. Vous choisissez quels capteurs sont exportés : la liste reste aussi courte ou aussi complète que vous voulez. Le choix se fait dans l'écran Capteurs supportés de l'application : un capteur est exporté tant qu'il est actif et que son interrupteur HA/MQTT est activé.

• Capteurs OBD-II standard : vitesse, régime, liquide de refroidissement, niveau de carburant, position du papillon, lambda, et le reste du catalogue SAE J1979 pris en charge par votre voiture.
• Capteurs spécifiques au constructeur/modèle : PID étendus qui varient selon la marque et le modèle, découverts automatiquement.
• Capteurs calculés : débit de carburant, consommation glissante (fenêtres de 10/50/100 km), puissance à la roue, autonomie estimée, distance du trajet.
• Localisation : altitude, précision et un device_tracker qui indique où la voiture est garée, avec l'adresse et l'heure d'arrivée. Le GPS du téléphone n'émet que pendant un trajet.
• TPMS : pression, température et identifiant de capteur par roue.
• État de diagnostic : MIL allumé/éteint, nombre de DTC, freeze frame, tension de l'adaptateur, ECU en ligne/hors ligne, état de la connexion à Home Assistant ou MQTT.
• Comportement de conduite : Safe Score et Eco Score en direct, compteurs d'événements brusques, historique mensuel.
• Vehicle Hub : prévision du prochain plein, prochain entretien, prochain rappel, totaux et consommation du mois, plus les indicateurs de retard et d'échéance proche. Ils n'apparaissent que pour les fonctions que vous utilisez réellement.

Événements sur le bus d'événements de Home Assistant

C'est ce qui distingue l'intégration native. Vos automatisations peuvent écouter des moments précis au lieu d'interroger l'état en continu.

• car2home_trip_started : se déclenche au moment où un trajet commence (démarrage du moteur + mouvement). La charge utile inclut l'identifiant du véhicule et le lieu de départ.
• car2home_trip_ended : se déclenche à la fin d'un trajet, avec un récapitulatif complet : distance, durée, vitesse moyenne / maximale, carburant consommé, adresse de stationnement.
• car2home_parking_detected : se déclenche quand la voiture se gare, avec la place, la durée et la distance du trajet, le carburant et l'autonomie restants. C'est l'événement des automatisations « je suis rentré ».
• car2home_dtc_found : une analyse de diagnostic s'est terminée et a trouvé des codes. La charge utile porte le mode d'analyse et les listes de codes confirmés, en attente et permanents.
• car2home_harsh_event : accélération brusque, freinage brusque ou virage brusque détecté. Utile pour les notifications de conduite sûre, en particulier avec les conducteurs novices.
• car2home_ecu_online / car2home_ecu_offline : se déclenche chaque fois que la connexion à l'ECU s'établit ou se coupe, ce qui vous permet de distinguer « la voiture est en train de rouler » de « la voiture est garée ».

Exemples d'automatisations

Quelques idées pour inspirer les vôtres.

• Ouvrez le portail du garage et allumez les lumières du porche lorsque vous arrivez dans votre rue (geofence + trip_started).
• Prévenez la famille avec l'adresse de stationnement et un lien vers la carte dès qu'un trajet se termine.
• Alertez sur Telegram quand une analyse trouve des codes, en indiquant combien sont confirmés, en attente et permanents.
• Préclimatisez la maison au moment où vous quittez le bureau (geofence travail + trip_started).

Compatibilité et prérequis

• Home Assistant 2024.12 ou ultérieur.
• Fonctionne avec Nabu Casa Cloud, Cloudflare Tunnel, Tailscale ou tout reverse proxy auquel vous faites déjà confiance.
• Multivéhicule : chaque voiture de votre garage apparaît comme son propre appareil Home Assistant, avec des entités et un historique indépendants.
• Les jetons sont stockés dans le Trousseau iOS / le Keystore Android, jamais dans les préférences de l'application.