Home-Assistant-Integration

Car 2 Home bringt eine erstklassige Home-Assistant-Integration mit, die Ihr Fahrzeug zu einem echten Teil Ihres Smart Homes macht und nicht nur zu einer weiteren Datenquelle. Sie funktioniert entweder als native Home-Assistant-Komponente (über HACS installiert, die direkt per WebSocket mit der App kommuniziert) oder als standardmäßiger MQTT-Client. Beide Wege werden unterstützt; wählen Sie den, der zu Ihrer Umgebung passt.

Das Besondere am nativen Weg ist, dass er über das reine Bereitstellen von Sensoren hinausgeht. Ihr Auto veröffentlicht Ereignisse auf dem Event-Bus von Home Assistant: Fahrt gestartet, Fahrt beendet, Auto geparkt, Fehler gefunden, hartes Beschleunigen, Steuergerät online. Damit können Sie Automationen schreiben, die auf den Moment reagieren, in dem etwas passiert, statt einen Wert abzufragen und zu raten.

Zwei Wege, dasselbe Ergebnis

Home-Assistant-Integration

Eine über HACS installierte, individuelle Home-Assistant-Integration. Home Assistant generiert einen 6-stelligen Kopplungscode, den Sie in die App eingeben. Keine Tokens zu verwalten, kein Broker zu installieren. Die Kommunikation läuft bidirektional über WebSocket: Home Assistant empfängt über die App jeden Sensor und jedes Ereignis aus dem Fahrzeug und kann Einstellungen wie den Sync-Modus ändern sowie weitere Aktionen auslösen, solange die App verbunden ist.

MQTT (beliebiger Broker)

Wenn Sie bereits Mosquitto, EMQX, HiveMQ oder einen anderen Broker betreiben oder wenn die Daten in Home Assistant oder andere Tools wie Node-RED, openHAB, ioBroker usw. fließen sollen, veröffentlicht Car 2 Home dieselben Sensoren mit vollständiger MQTT-Auto-Discovery für Home Assistant. Der Unterschied ist, dass der MQTT-Weg fortlaufenden Zustand überträgt, keine Ereignisse: Dinge wie trip_started oder dtc_found existieren nur in der nativen Integration.

So installieren Sie

1. 1. Über HACS installieren

   Öffnen Sie HACS in Home Assistant, fügen Sie Car 2 Home aus der Liste der Integrationen hinzu und starten Sie Home Assistant neu. (Falls Sie HACS noch nicht haben, installieren Sie es zuerst von hacs.xyz.)

2. 2. Die Integration hinzufügen

   Gehen Sie in Home Assistant zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suchen Sie nach "Car 2 Home". Home Assistant generiert einen Kopplungscode.

3. 3. Mit dem 6-stelligen Code koppeln

   Geben Sie Ihre öffentliche Home-Assistant-URL und den Kopplungscode in der App unter Einstellungen → Home Assistant → Integration ein, und schon sind Sie fertig!

4. 4. Einen Sync-Modus wählen

   Der Modus „Online“ überträgt die Telemetrie in Echtzeit, während Sie fahren. Der Modus „Zuhause“ sammelt die Daten in der App, solange Sie unterwegs sind, und schiebt sie ab, sobald das Telefon wieder in Ihrem Netz ist: nützlich, wenn Home Assistant nur zu Hause erreichbar ist. Die App wählt die Adresse nach der aktuellen Verbindung, also die lokale zu Hause und die entfernte unterwegs.

Was Sie erhalten

Jedes Fahrzeug in Ihrer Garage wird zu einem Gerät in Home Assistant mit eigenen Entitäten. Die Namen folgen dem Muster car2home_{brand}_{model}_{sensor}, mit dem Spitznamen, den Sie dem Auto gegeben haben, sofern vorhanden, damit zwei Autos desselben Modells nie kollidieren. Sie entscheiden, welche Sensoren exportiert werden, die Liste bleibt also so kurz oder so vollständig, wie Sie wollen. Die Auswahl treffen Sie in der App im Bildschirm Unterstützte Sensoren: Ein Sensor wird exportiert, solange er aktiv ist und sein HA/MQTT-Schalter eingeschaltet ist.

• Standard-OBD-II-Sensoren: Geschwindigkeit, Drehzahl, Kühlmittel, Tankfüllstand, Drosselklappenstellung, Lambda und der Rest des von Ihrem Fahrzeug unterstützten SAE-J1979-Katalogs.
• Hersteller-/modellspezifische Sensoren: erweiterte PIDs, die je nach Marke und Modell variieren und automatisch erkannt werden.
• Berechnete Sensoren: Kraftstoffdurchfluss, gleitender Verbrauch (Fenster von 10/50/100 km), Radleistung, geschätzte Reichweite, Fahrtdistanz.
• Standort: Höhe, Genauigkeit und ein device_tracker, der zeigt, wo das Auto geparkt steht, mit Adresse und Ankunftszeit. Das GPS des Telefons sendet nur während einer Fahrt.
• TPMS: Druck, Temperatur und Sensor-ID je Rad.
• Diagnosezustand: MIL ein/aus, DTC-Anzahl, Freeze Frame, Adapterspannung, ECU online/offline, Status der Verbindung zu Home Assistant oder MQTT.
• Fahrverhalten: Live Safe Score und Eco Score, Zähler für starke Ereignisse, Monatsverlauf.
• Vehicle Hub: Prognose fürs nächste Tanken, nächste Wartung, nächste Erinnerung, Monatssummen und Verbrauch, dazu die Markierungen für überfällig und bald fällig. Sie erscheinen nur für die Funktionen, die Sie tatsächlich nutzen.

Ereignisse auf dem Home-Assistant-Event-Bus

Genau diese heben die native Integration hervor. Ihre Automationen können auf einzelne Momente lauschen, statt den Zustand abzufragen.

• car2home_trip_started: wird in dem Moment ausgelöst, in dem eine Fahrt beginnt (Motorstart + Bewegung). Die Nutzlast enthält die Fahrzeug-ID und den Startort.
• car2home_trip_ended: wird ausgelöst, wenn eine Fahrt endet, mit vollständiger Fahrtzusammenfassung: Distanz, Dauer, Durchschnitts-/Höchstgeschwindigkeit, verbrauchter Kraftstoff, Parkadresse.
• car2home_parking_detected: löst aus, wenn das Auto parkt, mit dem Stellplatz, Dauer und Strecke der Fahrt sowie Restfüllstand und Reichweite. Das Ereignis für „ich bin zu Hause“-Automationen.
• car2home_dtc_found: Ein Diagnoselauf ist beendet und hat Codes gefunden. Die Nutzlast enthält den Scan-Modus sowie die Listen der bestätigten, ausstehenden und permanenten Codes.
• car2home_harsh_event: starke Beschleunigung, starkes Bremsen oder starkes Kurvenfahren erkannt. Nützlich für Hinweise zum sicheren Fahren, besonders bei Fahranfängern.
• car2home_ecu_online / car2home_ecu_offline: wird immer ausgelöst, wenn die Verbindung zur ECU zustande kommt oder abbricht, sodass Sie "Fahrzeug wird gerade gefahren" von "Fahrzeug ist geparkt" unterscheiden können.

Beispiel-Automationen

Ein paar Ideen, die Ihre eigenen anregen sollen.

• Das Garagentor öffnen und die Veranda-Beleuchtung einschalten, wenn Sie in Ihre Straße einbiegen (Geofence + trip_started).
• Die Familie benachrichtigen mit der Parkadresse und einem Kartenlink, sobald eine Fahrt endet.
• Per Telegram warnen, wenn ein Diagnoselauf Codes findet, mit der Anzahl der bestätigten, ausstehenden und permanenten Codes.
• Das Haus vorkühlen, sobald Sie das Büro verlassen (Geofence Arbeit + trip_started).

Kompatibilität & Voraussetzungen

• Home Assistant 2024.12 oder neuer.
• Funktioniert mit Nabu Casa Cloud, Cloudflare Tunnel, Tailscale oder jedem Reverse-Proxy, dem Sie bereits vertrauen.
• Mehrere Fahrzeuge: Jedes Fahrzeug in Ihrer Garage erscheint als eigenes Home-Assistant-Gerät mit unabhängigen Entitäten und eigenem Verlauf.
• Tokens werden in der iOS-Keychain / im Android-Keystore gespeichert, niemals in den App-Einstellungen.