Integracja z Home Assistant

Car 2 Home ma pełnoprawną integrację z Home Assistant, która czyni z twojego auta rzeczywistego uczestnika inteligentnego domu, a nie kolejne źródło danych. Działa jako natywny komponent Home Assistant (instalowany przez HACS, rozmawiający z aplikacją wprost po WebSocket) albo jako zwykły klient MQTT. Obie drogi są obsługiwane, wybierz tę, która pasuje do twojej instalacji.

Ścieżka natywna jest wyjątkowa dlatego, że nie kończy się na udostępnianiu czujników. Twoje auto publikuje zdarzenia na szynie zdarzeń Home Assistant: przejazd rozpoczęty, przejazd zakończony, auto zaparkowane, znaleziony błąd, gwałtowne przyspieszenie, sterownik online. Dzięki temu piszesz automatyzacje reagujące na moment, w którym coś się dzieje, zamiast odpytywać wartość i zgadywać.

Dwie drogi, ten sam efekt

Integracja z Home Assistant

Własna integracja Home Assistant instalowana przez HACS. Home Assistant generuje sześciocyfrowy kod parowania, który wpisujesz w aplikacji. Żadnych tokenów do pilnowania, żadnego brokera do stawiania. Komunikacja jest dwukierunkowa po WebSocket: Home Assistant odbiera przez aplikację każdy czujnik i każde zdarzenie z auta, a dopóki aplikacja jest połączona, może też zmieniać ustawienia, jak tryb synchronizacji, i uruchamiać inne działania.

MQTT (dowolny broker)

Jeśli masz już Mosquitto, EMQX, HiveMQ albo inny broker, albo chcesz, żeby dane trafiały do Home Assistant lub innych narzędzi jak Node-RED, openHAB czy ioBroker, Car 2 Home publikuje te same czujniki z pełnym automatycznym wykrywaniem MQTT dla Home Assistant. Różnica polega na tym, że droga MQTT niesie ciągły stan, a nie zdarzenia: rzeczy takie jak trip_started czy dtc_found istnieją wyłącznie w integracji natywnej.

Jak zainstalować

1. 1. Zainstaluj przez HACS

   Otwórz HACS w Home Assistant, dodaj Car 2 Home z listy integracji i uruchom Home Assistant ponownie. (Jeśli nie masz jeszcze HACS, zainstaluj go najpierw z hacs.xyz.)

2. 2. Dodaj integrację

   W Home Assistant wejdź w Ustawienia → Urządzenia i usługi → Dodaj integrację i wyszukaj "Car 2 Home". Home Assistant wygeneruje kod parowania.

3. 3. Sparuj sześciocyfrowym kodem

   W aplikacji, w Ustawienia → Home Assistant → Integracja, podaj publiczny adres swojego Home Assistant i kod parowania. To wszystko.

4. 4. Wybierz tryb synchronizacji

   Tryb „Online” przesyła telemetrię na bieżąco podczas jazdy. Tryb „Dom” gromadzi dane w aplikacji, gdy jesteś poza domem, i wysyła je w chwili, gdy telefon wraca do Twojej sieci: przydatne, gdy Home Assistant jest osiągalny tylko z domu. Aplikacja wybiera adres według bieżącego połączenia, więc w domu korzysta z lokalnego, a w trasie ze zdalnego.

Co dostajesz

Każdy pojazd w Twoim garażu staje się w Home Assistant urządzeniem z własnym zestawem encji. Nazwy idą według wzorca car2home_{brand}_{model}_{sensor}, z pseudonimem nadanym autu, jeśli taki jest, więc dwa auta tego samego modelu nigdy się nie zderzą. To Ty wybierasz, które czujniki są eksportowane, więc lista pozostaje tak krótka albo tak pełna, jak chcesz. Wyboru dokonujesz na ekranie Czujniki obsługiwane przez pojazd w aplikacji: czujnik jest eksportowany, dopóki jest aktywny i ma włączony przełącznik HA/MQTT.

• Standardowe czujniki OBD-II: prędkość, obroty, temperatura płynu, poziom paliwa, położenie przepustnicy, sonda lambda i reszta katalogu SAE J1979 obsługiwana przez twoje auto.
• Czujniki producenta i modelu: rozszerzone PID-y różniące się marką i modelem, wykrywane automatycznie.
• Czujniki obliczane: chwilowe zużycie paliwa, średnia krocząca (okna 10, 50 i 100 km), moc na kołach, szacowany zasięg, dystans trasy.
• Lokalizacja: wysokość, dokładność i device_tracker pokazujący, gdzie auto stoi zaparkowane, z adresem i godziną przyjazdu. GPS telefonu nadaje tylko w trakcie przejazdu.
• TPMS: ciśnienie, temperatura i identyfikator czujnika dla każdego koła.
• Stan diagnostyczny: kontrolka silnika włączona lub wyłączona, liczba kodów usterek, zamrożona ramka, napięcie adaptera, sterownik online lub offline, stan połączenia z Home Assistant albo MQTT.
• Styl jazdy: bieżąca ocena bezpieczeństwa i ekonomii, liczniki gwałtownych zdarzeń, historia miesięczna.
• Vehicle Hub: prognoza najbliższego tankowania, najbliższy przegląd, najbliższe przypomnienie, sumy i zużycie w miesiącu, a do tego znaczniki po terminie i wkrótce. Pojawiają się tylko dla funkcji, z których naprawdę korzystasz.

Zdarzenia na magistrali Home Assistant

To właśnie wyróżnia integrację natywną. Twoje automatyzacje mogą nasłuchiwać pojedynczych chwil zamiast odpytywać stan.

• car2home_trip_started: uruchamia się w chwili rozpoczęcia trasy (start silnika plus ruch). Ładunek zawiera identyfikator pojazdu i miejsce wyjazdu.
• car2home_trip_ended: uruchamia się po zakończeniu trasy, z pełnym podsumowaniem: dystans, czas, prędkość średnia i maksymalna, zużyte paliwo, adres parkowania.
• car2home_parking_detected: uruchamia się przy zaparkowaniu, z miejscem, czasem i dystansem przejazdu oraz pozostałym paliwem i zasięgiem. To na nim wiesza się automatyzacje „jestem w domu”.
• car2home_dtc_found: skan diagnostyczny zakończył się i znalazł kody. Ładunek niesie tryb skanowania oraz listy kodów potwierdzonych, oczekujących i trwałych.
• car2home_harsh_event: wykryto gwałtowne przyspieszenie, hamowanie albo zakręt. Przydatne przy powiadomieniach o bezpiecznej jeździe, zwłaszcza u początkujących kierowców.
• car2home_ecu_online / car2home_ecu_offline: uruchamia się, gdy połączenie ze sterownikiem zostaje nawiązane albo zerwane, więc odróżnisz "auto właśnie jedzie" od "auto stoi zaparkowane".

Przykładowe automatyzacje

Kilka pomysłów na początek.

• Otwórz bramę garażu i zapal światła przy wejściu, gdy wjeżdżasz w swoją ulicę (geofence plus trip_started).
• Powiadom rodzinę adresem parkowania i odnośnikiem do mapy w chwili zakończenia trasy.
• Wyślij alert na Telegram, gdy skan znajdzie kody, z liczbą potwierdzonych, oczekujących i trwałych.
• Wychłodź dom z wyprzedzeniem w chwili, gdy wyjeżdżasz z biura (geofence pracy plus trip_started).

Zgodność i wymagania

• Home Assistant 2024.12 lub nowszy.
• Działa z Nabu Casa Cloud, Cloudflare Tunnel, Tailscale albo dowolnym reverse proxy, któremu już ufasz.
• Wiele pojazdów: każde auto w garażu pojawia się jako osobne urządzenie Home Assistant, z własnymi encjami i własną historią.
• Tokeny są przechowywane w iOS Keychain albo Android Keystore, nigdy w preferencjach aplikacji.