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.

Was den nativen Weg besonders macht, ist, dass er über das bloße Bereitstellen von Sensoren hinausgeht. Ihr Fahrzeug veröffentlicht Ereignisse auf dem Home-Assistant-Event-Bus, Fahrt gestartet, Fahrt beendet, DTC gefunden, starke Beschleunigung, ECU online, was bedeutet, dass Sie Automationen schreiben können, die auf Momente reagieren und nicht nur darauf, dass Zahlen Schwellenwerte überschreiten.

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 "Online"-Modus überträgt die Telemetrie in Echtzeit, während Sie fahren. Der "Nur WLAN"-Modus puffert die Daten in der App, während Sie unterwegs sind, und überträgt sie in dem Moment, in dem Ihr Smartphone einem WLAN-Netz beitritt: nützlich, wenn Sie keine öffentliche URL für Home Assistant haben oder mobile Daten sparen möchten.

Was Sie erhalten

Jedes Fahrzeug in Ihrer Garage wird in Home Assistant zu einem Gerät mit eigenen Entitäten. Die Namen folgen dem Muster car2home_{manufacturer}_{model}_{sensor}, sodass mehrere Fahrzeuge niemals kollidieren. Die Entitäten nutzen die RestoreSensor-Semantik von Home Assistant: Sie behalten ihren zuletzt bekannten Wert über Neustarts hinweg und werden nie nicht verfügbar, nur weil der Motor abgestellt wurde.

• 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 eine device_tracker-Entität für das Fahrzeug.
• 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.

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_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. Die vollständigen Einrichtungsblöcke finden Sie im Bereich Anleitungen.

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