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.

To, co wyróżnia drogę natywną, to że nie kończy się na udostępnianiu czujników. Twoje auto publikuje zdarzenia na magistrali zdarzeń Home Assistant: trasa rozpoczęta, trasa zakończona, znaleziony kod usterki, gwałtowne przyspieszenie, sterownik online. Dzięki temu możesz pisać automatyzacje reagujące na chwile, a nie tylko na liczby przekraczające próg.

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 żywo podczas jazdy. Tryb "Tylko Wi-Fi" buforuje dane w aplikacji, gdy jesteś poza domem, i wysyła je w chwili, gdy telefon połączy się z siecią Wi-Fi. Przydatne, gdy nie masz publicznego adresu do Home Assistant albo chcesz oszczędzać transfer komórkowy.

Co dostajesz

Każdy pojazd w twoim garażu staje się urządzeniem w Home Assistant z własnym zestawem encji. Nazwy mają postać car2home_{brand}_{model}_{sensor}, z wplecioną nazwą własną auta, jeśli ją nadasz, więc kilka pojazdów nigdy się nie pomiesza. Encje korzystają z mechanizmu RestoreSensor w Home Assistant: zachowują ostatnią znaną wartość mimo restartów i nigdy nie stają się niedostępne tylko dlatego, że zgasłeś silnik.

• 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ść oraz encja device_tracker dla pojazdu.
• 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.

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_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. Pełne bloki konfiguracji znajdziesz w poradnikach.

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