Home Assistant-koppeling

Car 2 Home heeft een volwaardige Home Assistant-koppeling die je auto tot een echte deelnemer in je smart home maakt, en niet zomaar tot nog een gegevensstroom. Het werkt als native Home Assistant-component (geïnstalleerd via HACS, die rechtstreeks met de app praat over een WebSocket) of als gewone MQTT-client. Beide wegen worden ondersteund; kies wat bij je opstelling past.

Wat de native route bijzonder maakt, is dat ze verder gaat dan sensoren beschikbaar stellen. Uw auto publiceert gebeurtenissen op de eventbus van Home Assistant: rit gestart, rit beëindigd, auto geparkeerd, foutcode gevonden, hard optrekken, ECU online. Zo schrijft u automatiseringen die reageren op het moment waarop iets gebeurt, in plaats van een waarde te pollen en te gokken.

Twee wegen, hetzelfde resultaat

Home Assistant-koppeling

Een eigen Home Assistant-integratie, geïnstalleerd via HACS. Home Assistant maakt een koppelcode van zes cijfers die je in de app invoert. Geen tokens om te beheren, geen broker om te installeren. De communicatie loopt in twee richtingen over WebSocket: Home Assistant ontvangt via de app elke sensor en elke gebeurtenis uit de auto, en kan instellingen zoals de synchronisatiestand wijzigen en andere acties starten, zolang de app verbonden is.

MQTT (elke broker)

Draai je al Mosquitto, EMQX, HiveMQ of een andere broker, of wil je dat de gegevens naar Home Assistant of andere gereedschappen als Node-RED, openHAB of ioBroker stromen, dan publiceert Car 2 Home dezelfde sensoren met volledige MQTT-autodetectie voor Home Assistant. Het verschil is dat de MQTT-weg doorlopende toestand draagt, geen gebeurtenissen: dingen als trip_started of dtc_found bestaan alleen in de native koppeling.

Zo installeer je het

1. 1. Installeren via HACS

   Open HACS in Home Assistant, voeg Car 2 Home toe uit de lijst met integraties en start Home Assistant opnieuw op. (Heb je nog geen HACS, installeer die dan eerst via hacs.xyz.)

2. 2. De integratie toevoegen

   Ga in Home Assistant naar Instellingen → Apparaten en diensten → Integratie toevoegen en zoek op "Car 2 Home". Home Assistant maakt dan een koppelcode aan.

3. 3. Koppelen met de zescijferige code

   Vul in de app onder Instellingen → Home Assistant → Koppeling je publieke Home Assistant-adres en de koppelcode in, en klaar is het.

4. 4. Kies een synchronisatiestand

   De modus "Online" stuurt telemetrie in realtime terwijl u rijdt. De modus "Thuis" bewaart de gegevens in de app terwijl u weg bent en stuurt ze door zodra de telefoon terug op uw netwerk is: handig wanneer Home Assistant alleen thuis bereikbaar is. De app kiest het adres op basis van de verbinding van dat moment, dus het lokale adres thuis en het externe onderweg.

Wat je krijgt

Elk voertuig in uw garage wordt een apparaat in Home Assistant met een eigen set entiteiten. De namen volgen het patroon car2home_{brand}_{model}_{sensor}, met de bijnaam die u de auto gaf als die er is, zodat twee auto's van hetzelfde model nooit botsen. U kiest zelf welke sensoren worden geëxporteerd, dus de lijst blijft zo kort of zo volledig als u wilt. De keuze maakt u in het scherm Voertuigondersteunde sensoren van de app: een sensor wordt geëxporteerd zolang hij actief is en zijn HA/MQTT-schakelaar aanstaat.

• Standaard OBD-II-sensoren: snelheid, toerental, koelvloeistof, brandstofniveau, gaskleppositie, lambda en de rest van de SAE J1979-lijst die je auto ondersteunt.
• Sensoren per merk en model: uitgebreide PID's die per merk en model verschillen, automatisch herkend.
• Berekende sensoren: brandstofverbruik per uur, voortschrijdend verbruik (over 10, 50 en 100 km), vermogen aan de wielen, geschatte actieradius, ritafstand.
• Locatie: hoogte, nauwkeurigheid en een device_tracker die laat zien waar de auto geparkeerd staat, met adres en aankomsttijd. De GPS van de telefoon zendt alleen tijdens een rit.
• TPMS: druk, temperatuur en sensor-id per wiel.
• Diagnosetoestand: motorlampje aan of uit, aantal foutcodes, freeze frame, adapterspanning, ECU online of offline, en de status van de verbinding met Home Assistant of MQTT.
• Rijgedrag: live veiligheidsscore en zuinigheidsscore, tellers voor harde gebeurtenissen, maandelijkse historie.
• Vehicle Hub: prognose voor de volgende tankbeurt, eerstvolgend onderhoud, eerstvolgende herinnering, maandtotalen en verbruik, plus de markeringen voor te laat en bijna verlopen. Ze verschijnen alleen voor de functies die u daadwerkelijk gebruikt.

Gebeurtenissen op de eventbus van Home Assistant

Dit is wat de native koppeling apart zet. Je automatiseringen kunnen naar losse momenten luisteren in plaats van toestand af te vragen.

• car2home_trip_started: gaat af op het moment dat een rit begint (motor gestart plus beweging). De payload bevat het voertuig-id en de vertreklocatie.
• car2home_trip_ended: gaat af wanneer een rit eindigt, met een volledige samenvatting: afstand, duur, gemiddelde en hoogste snelheid, verbruikte brandstof, parkeeradres.
• car2home_parking_detected: gaat af zodra de auto parkeert, met de plek, de duur en afstand van de rit, en de resterende brandstof en actieradius. Hier hangt u "ik ben thuis" aan op.
• car2home_dtc_found: een diagnosescan is klaar en heeft codes gevonden. De payload draagt de scanstand en de lijsten met bevestigde, in behandeling zijnde en permanente codes.
• car2home_harsh_event: hard optrekken, hard remmen of hard sturen gedetecteerd. Handig voor meldingen over veilig rijden, zeker bij beginnende bestuurders.
• car2home_ecu_online / car2home_ecu_offline: gaat af zodra de verbinding met de ECU tot stand komt of wegvalt, zodat je "er wordt nu gereden" kunt onderscheiden van "de auto staat geparkeerd".

Voorbeelden van automatiseringen

Een paar ideeën om je op weg te helpen.

• Open de garagepoort en doe de buitenlampen aan zodra je je straat in rijdt (geofence plus trip_started).
• Stuur het gezin een bericht met het parkeeradres en een kaartlink op het moment dat een rit eindigt.
• Geef een seintje via Telegram wanneer een scan codes vindt, met hoeveel er bevestigd, in behandeling en permanent zijn.
• Koel het huis alvast op het moment dat je van kantoor vertrekt (geofence werk plus trip_started).

Compatibiliteit en vereisten

• Home Assistant 2024.12 of nieuwer.
• Werkt met Nabu Casa Cloud, Cloudflare Tunnel, Tailscale of elke reverse proxy die je al vertrouwt.
• Meerdere auto's: elke auto in je garage verschijnt als eigen Home Assistant-apparaat, met eigen entiteiten en eigen historie.
• Tokens worden bewaard in de iOS Keychain of de Android Keystore, nooit in de voorkeuren van de app.