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 l'approche native particulière, c'est qu'elle va au-delà de la simple exposition des capteurs. Votre voiture publie des événements sur le bus d'événements de Home Assistant : trajet démarré, trajet terminé, DTC détecté, accélération brusque, ECU en ligne, ce qui vous permet d'écrire des automatisations qui réagissent à des moments, et pas seulement à des chiffres franchissant des seuils.

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 « Wi-Fi uniquement » met les données en mémoire tampon dans l'application en votre absence et les envoie dès que votre téléphone rejoint un réseau Wi-Fi : utile lorsque vous n'avez pas d'URL publique pour Home Assistant ou que vous souhaitez économiser vos données mobiles.

Ce que vous obtenez

Chaque véhicule de votre garage devient un appareil dans Home Assistant avec son propre ensemble d'entités. Les noms suivent le modèle car2home_{manufacturer}_{model}_{sensor}, de sorte que plusieurs véhicules n'entrent jamais en conflit. Les entités utilisent la sémantique RestoreSensor de Home Assistant : elles conservent leur dernière valeur connue après un redémarrage et ne deviennent jamais indisponibles simplement parce que le moteur s'est arrêté.

• 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 une entité device_tracker pour le véhicule.
• 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.

É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_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. Les blocs de configuration complets se trouvent dans la section Guides.

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