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 weg bijzonder maakt, is dat hij verder gaat dan sensoren tonen. Je auto publiceert gebeurtenissen op de eventbus van Home Assistant: rit gestart, rit beëindigd, foutcode gevonden, hard optrekken, ECU online. Daardoor kun je automatiseringen schrijven die reageren op momenten, en niet alleen op getallen die een grens passeren.

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 stand "Online" stuurt telemetrie in realtime door terwijl je rijdt. De stand "Alleen wifi" bewaart de gegevens in de app terwijl je onderweg bent en verstuurt ze zodra je telefoon met een wifinetwerk verbindt: handig als je geen publiek adres voor Home Assistant hebt of mobiele data wilt sparen.

Wat je krijgt

Elke auto in je 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 je de auto gaf erin verwerkt als je er een instelt, zodat meerdere auto's elkaar nooit in de weg zitten. Entiteiten gebruiken de RestoreSensor-werking van Home Assistant: ze houden hun laatst bekende waarde vast over herstarts heen en worden nooit niet beschikbaar alleen omdat de motor uitging.

• 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-entiteit voor het voertuig.
• 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.

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_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. De volledige configuratieblokken staan in de handleidingen.

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