Intégration MQTT

Car 2 Home est un client MQTT complet. Chaque capteur exposé par votre véhicule (OBD standard, PID étendus, métriques calculées, GPS, TPMS, état de diagnostic) est publié vers votre broker. Vous choisissez le format de publication : auto-découverte Home Assistant (par défaut), Homie 4.0, topics simples par capteur, JSON unifié, ou un préréglage ThingsBoard.

Si vous utilisez déjà Mosquitto, EMQX, HiveMQ ou tout autre broker, quelques champs suffisent pour une installation fonctionnelle. Car 2 Home ne dépend de nos serveurs pour rien de tout cela : la télémétrie va directement de l'application à votre broker.

MQTT contre Home Assistant natif

Les deux approches transportent les mêmes capteurs. La différence, c'est que MQTT transporte un état continu, tandis que l'intégration Home Assistant native transporte aussi des événements (trajet démarré, DTC détecté, accélération brusque). Si MQTT vous suffit, vous obtiendrez toutes les données en direct, mais les moments précis qui permettent les automatisations les plus intéressantes n'existent que dans l'intégration native.

Comment les données sont publiées

• Les charges utiles d'auto-découverte sont envoyées avec retain=true, afin que tout abonné du broker se connectant plus tard voie immédiatement le catalogue d'entités.
• Mises à jour delta uniquement : les valeurs ne sont republiées que lorsqu'elles changent, avec une limitation optionnelle, pour éviter de saturer le broker.
• Les PID énumérés sont décodés : le type de carburant « 1 » devient « Essence », le rapport d'équivalence commandé est exprimé sous forme de fraction, etc. Les valeurs brutes et lisibles sont toutes deux exposées en tant qu'attributs.
• Les icônes Material Design sont incluses dans les charges utiles de découverte, afin que les dashboards s'affichent correctement d'emblée.
• QoS configurable par classe de topic. L'état des capteurs est par défaut en QoS 0 ; les messages de cycle de vie utilisent la QoS 1.
• TLS et authentification pris en charge ; les identifiants sont stockés dans le Trousseau iOS / le Keystore Android.

Fonctionne avec

Tout ce qui parle MQTT, associé au bon format de publication (voir ci-dessus). Nous effectuons des tests réguliers avec :

• Home Assistant via l'intégration MQTT avec le format Home Assistant Discovery (détecté automatiquement).
• OpenHAB et ioBroker avec le format Homie 4.0 (binding MQTT Homie / adaptateur MQTT Client).
• Hubitat, Node-RED, Domoticz avec le format Topics simples.
• Grafana + Telegraf / InfluxDB et dashboards personnalisés avec le format JSON unifié.
• ThingsBoard CE / Cloud avec le préréglage ThingsBoard ; les ponts ESPHome et tout consommateur MQTT DIY avec les Topics simples ou le JSON unifié.

Formats de publication

Choisissez le format correspondant à votre plateforme de destination. Le format Home Assistant Discovery par défaut couvre HA d'emblée ; passez à l'un des autres pour OpenHAB, Hubitat, les dashboards génériques ou ThingsBoard.

Changez de format à tout moment dans Paramètres → MQTT → Format. Lorsque vous quittez Home Assistant ou Homie, l'application propose de nettoyer les topics de découverte conservés sur le broker afin que vous ne voyiez pas d'appareils fantômes côté consommateur.

Choisir un broker

Si vous n'en utilisez pas déjà un, voici un point de départ :

• Mosquitto : l'option la plus simple. S'exécute comme module complémentaire Home Assistant en un clic, ou de façon autonome dans Docker. Suffisant pour un foyer.
• EMQX : en cluster, se met bien à l'échelle, avec une interface web soignée. Intéressant si vous avez beaucoup d'appareils ou souhaitez une surveillance détaillée.
• HiveMQ : une solide option commerciale / cloud si vous ne voulez pas auto-héberger.

Configuration rapide

1. 1. Disposez d'un broker accessible depuis votre téléphone

   Soit sur votre réseau local, soit via un tunnel (Tailscale, Cloudflare Tunnel, Nabu Casa). Le MQTT doit être accessible pendant que vous conduisez pour que la télémétrie soit transmise en direct.

2. 2. Ouvrez Paramètres → MQTT dans l'application

   Saisissez l'hôte, le port, le nom d'utilisateur, le mot de passe et les réglages TLS optionnels. L'application valide la connexion et affiche l'état en temps réel.

3. 3. Abonnez-vous et regardez les entités arriver

   Les charges utiles d'auto-découverte sont publiées immédiatement. Dans Home Assistant, l'appareil apparaît sous Paramètres → Appareils et services → MQTT. Dans Node-RED ou tout explorateur MQTT, parcourez l'arborescence des topics sous le préfixe que vous avez configuré.