MQTT-Integration

Jeder Broker. Jede Plattform, die MQTT spricht.

Car 2 Home ist ein voll ausgestatteter MQTT-Client. Jeder Sensor, den Ihr Fahrzeug bereitstellt – Standard-OBD, erweiterte PIDs, berechnete Kennzahlen, GPS, TPMS, Diagnosezustand – wird an Ihren Broker veröffentlicht. Sie wählen das Veröffentlichungsformat: Home-Assistant-Auto-Discovery (die Voreinstellung), Homie 4.0, einfache Topics je Sensor, einheitliches JSON oder ein ThingsBoard-Preset.

Wenn Sie bereits Mosquitto, EMQX, HiveMQ oder einen anderen Broker betreiben, sind Sie nur ein paar Felder von einer funktionierenden Einrichtung entfernt. Car 2 Home ist dafür nicht auf unsere Server angewiesen, die Telemetrie geht direkt von der App an Ihren Broker.

MQTT vs. native Home-Assistant-Integration

Beide Wege übertragen dieselben Sensoren. Der Unterschied ist, dass MQTT fortlaufenden Zustand überträgt, während die native Home-Assistant-Integration zusätzlich Ereignisse überträgt (Fahrt gestartet, DTC gefunden, starke Beschleunigung). Wenn Sie nur MQTT benötigen, erhalten Sie alle Live-Daten, aber die einzelnen Momente, die die interessantesten Automationen antreiben, gibt es nur in der nativen Integration.

FunktionMQTTNatives HA
Fortlaufender Zustand
Sensorwerte werden veröffentlicht, sobald sie sich ändern.
✓✓
Ereignisse
trip_started, trip_ended, dtc_found, harsh_event, ecu_online/offline.
—✓
Bidirektionale Befehle
Home Assistant kann das Fahrzeug auffordern, nach DTCs zu scannen oder Sensoren erneut anzukündigen.
—✓

Wie die Daten veröffentlicht werden

  • Auto-Discovery-Nutzlasten werden mit retain=true gesendet, sodass jeder Broker-Abonnent, der später online geht, den Entitätskatalog sofort sieht.
  • Nur Delta-Updates: Werte werden nur dann erneut veröffentlicht, wenn sie sich ändern, mit optionaler Drosselung, um den Broker nicht zu überfluten.
  • Aufgezählte PIDs werden decodiert: Aus Kraftstoffart "1" wird "Benzin", das angeforderte Äquivalenzverhältnis wird als Bruchteil ausgegeben usw. Sowohl Rohwerte als auch menschenlesbare Werte werden als Attribute bereitgestellt.
  • Material-Design-Symbole sind in den Discovery-Nutzlasten enthalten, sodass Dashboards von Anfang an korrekt dargestellt werden.
  • Konfigurierbares QoS je Topic-Klasse. Der Sensorzustand verwendet standardmäßig QoS 0; Lebenszyklus-Nachrichten verwenden QoS 1.
  • TLS und Authentifizierung werden unterstützt; Anmeldedaten werden in der iOS-Keychain / im Android-Keystore gespeichert.

Funktioniert mit

Allem, was MQTT spricht, kombiniert mit dem passenden Veröffentlichungsformat (siehe oben). Wir testen regelmäßig gegen:

  • Home Assistant über die MQTT-Integration mit dem Home-Assistant-Discovery-Format (automatisch erkannt).
  • openHAB und ioBroker mit dem Homie-4.0-Format (MQTT-Homie-Binding / MQTT-Client-Adapter).
  • Hubitat, Node-RED, Domoticz mit dem Format Einfache Topics.
  • Grafana + Telegraf / InfluxDB und individuelle Dashboards mit dem Format Einheitliches JSON.
  • ThingsBoard CE / Cloud mit dem ThingsBoard-Preset; ESPHome-Bridges und jeder Eigenbau-MQTT-Konsument mit Einfachen Topics oder Einheitlichem JSON.

Veröffentlichungsformate

Wählen Sie das Format, das zu Ihrer Zielplattform passt. Das standardmäßige Home-Assistant-Discovery deckt HA von Anfang an ab; wechseln Sie zu einem der anderen für openHAB, Hubitat, generische Dashboards oder ThingsBoard.

Home Assistant Discovery

Voreinstellung. Auto-Discovery-Nutzlasten unter homeassistant/<component>/<deviceId>/<sensor>/config. Das Fahrzeug erscheint in HA automatisch unter Einstellungen → Geräte & Dienste → MQTT. Der fortlaufende Zustand wird als JSON-Batch auf <prefix>/<deviceId>/state veröffentlicht.

Homie 4.0

Offener Standard mit Discovery über eine homie/<deviceId>/$nodes-Topologie und Metadaten je Eigenschaft ($datatype / $unit / $format). Natives Ziel für openHAB (MQTT-Homie-Binding) und ioBroker (MQTT-Client-Adapter). Passt auch zu ESPHome-Ökosystemen.

Einfache Topics

Ein MQTT-Topic pro Sensor, kein Discovery. Die Nutzlast wechselt zwischen dem Rohwert (z. B. 1850) oder {value, ts}-JSON. Funktioniert mit Hubitat, Node-RED, Domoticz und jedem generischen MQTT-Konsumenten.

Einheitliches JSON

Jeder Sensor in einer einzigen JSON-Nutzlast an ein konfigurierbares Topic, zurückbehalten für spät hinzukommende Abonnenten. Gut geeignet für Grafana, InfluxDB / Telegraf und individuelle Dashboards, die lieber ein einziges Topic abonnieren und den vollständigen Fahrzeug-Snapshot auswerten.

ThingsBoard

Natives Preset für ThingsBoard CE und ThingsBoard Cloud. Veröffentlicht Telemetrie an v1/devices/me/telemetry und statische Sensoren (VIN, Kraftstoffart, CalID) an v1/devices/me/attributes. Ihr Zugriffstoken gehört in das Feld Benutzername; lassen Sie das Passwort leer.

Wechseln Sie das Format jederzeit unter Einstellungen → MQTT → Format. Wenn Sie von Home Assistant oder Homie weg wechseln, bietet die App an, die auf dem Broker zurückgebliebenen Discovery-Topics zu bereinigen, damit Sie auf der Konsumentenseite keine Geistergeräte sehen.

Einen Broker wählen

Falls Sie noch keinen betreiben, hier ein Ausgangspunkt:

  • Mosquitto: die einfachste Option. Läuft mit einem Klick als Home-Assistant-Add-on oder eigenständig in Docker. Reicht für einen Haushalt.
  • EMQX: clusterfähig, skaliert gut, hat eine aufgeräumte Web-Oberfläche. Lohnt sich, wenn Sie viele Geräte haben oder eine detaillierte Überwachung wünschen.
  • HiveMQ: solide kommerzielle / Cloud-Option, wenn Sie nicht selbst hosten möchten.

Schnelle Einrichtung

  1. 1. Einen Broker bereithalten, der von Ihrem Smartphone aus erreichbar ist

    Entweder in Ihrem lokalen Netzwerk oder über einen Tunnel (Tailscale, Cloudflare Tunnel, Nabu Casa). MQTT muss während der Fahrt erreichbar sein, damit die Telemetrie live fließen kann.

  2. 2. In der App Einstellungen → MQTT öffnen

    Geben Sie Host, Port, Benutzername, Passwort und optionale TLS-Einstellungen ein. Die App prüft die Verbindung und zeigt den Status in Echtzeit an.

  3. 3. Abonnieren und zusehen, wie die Entitäten eintreffen

    Auto-Discovery-Nutzlasten werden sofort veröffentlicht. In Home Assistant erscheint das Gerät unter Einstellungen → Geräte & Dienste → MQTT. In Node-RED oder einem beliebigen MQTT-Explorer durchsuchen Sie den Topic-Baum unter dem von Ihnen konfigurierten Präfix.

Zur Schritt-für-Schritt-Einrichtungsanleitung →

Matter / SmartThings / Google Home / Alexa

Wir entwickeln ein Matterbridge-Plugin, das dieselben MQTT-Daten erneut als Matter-Geräte exportiert und Ihr Fahrzeug so in Apple Home, Google Home, SmartThings und Alexa auffindbar macht, ganz ohne Broker auf der Konsumentenseite. Demnächst verfügbar.