Інтеграція з Home Assistant

Car 2 Home має повноцінну інтеграцію з Home Assistant, яка робить ваше авто справжнім учасником розумного дому, а не черговим джерелом даних. Вона працює або як нативний компонент Home Assistant (встановлюється через HACS і спілкується із застосунком напряму через WebSocket), або як звичайний клієнт MQTT. Підтримуються обидва шляхи, оберіть той, що пасує вашій установці.

Нативний шлях особливий тим, що не обмежується публікацією датчиків. Ваше авто надсилає події у шину подій Home Assistant: поїздка почалася, поїздка завершилася, знайдено код несправності, різке прискорення, ЕБК у мережі. Отже, можна писати автоматизації, які реагують на моменти, а не лише на числа, що перетинають поріг.

Два шляхи, один результат

Інтеграція з Home Assistant

Власна інтеграція Home Assistant, що встановлюється через HACS. Home Assistant створює шестизначний код прив'язки, який ви вводите в застосунку. Жодних токенів і жодного брокера. Обмін іде в обидва боки через WebSocket: Home Assistant отримує через застосунок кожен датчик і кожну подію з авто і, доки застосунок на зв'язку, може змінювати налаштування на кшталт режиму синхронізації та запускати інші дії.

MQTT (будь-який брокер)

Якщо у вас уже працює Mosquitto, EMQX, HiveMQ чи інший брокер, або ви хочете, щоб дані йшли до Home Assistant чи до інших інструментів на кшталт Node-RED, openHAB, ioBroker, Car 2 Home публікує ті самі датчики з повним автовизначенням MQTT для Home Assistant. Різниця в тому, що шлях MQTT несе неперервний стан, а не події: такі речі, як trip_started чи dtc_found, існують лише в нативній інтеграції.

Як встановити

1. 1. Встановіть через HACS

   Відкрийте HACS у Home Assistant, додайте Car 2 Home зі списку інтеграцій і перезапустіть Home Assistant. (Якщо HACS ще немає, спершу встановіть його з hacs.xyz.)

2. 2. Додайте інтеграцію

   У Home Assistant перейдіть до Налаштування → Пристрої та служби → Додати інтеграцію і знайдіть "Car 2 Home". Home Assistant створить код прив'язки.

3. 3. Прив'яжіть шестизначним кодом

   У застосунку, в Налаштування → Home Assistant → Інтеграція, вкажіть публічну адресу вашого Home Assistant і код прив'язки. Готово.

4. 4. Оберіть режим синхронізації

   Режим "Онлайн" передає телеметрію в реальному часі, поки ви за кермом. Режим "Лише Wi-Fi" накопичує дані в застосунку, поки вас немає, і вивантажує їх тієї миті, коли телефон під'єднується до мережі Wi-Fi. Зручно, якщо у Home Assistant немає публічної адреси або ви бережете мобільний трафік.

Що ви отримуєте

Кожен автомобіль у вашому гаражі стає пристроєм у Home Assistant із власним набором сутностей. Імена будуються за зразком car2home_{brand}_{model}_{sensor}, з додаванням прізвиська, яке ви дали авто, якщо воно задане, тож кілька автомобілів ніколи не переплутаються. Сутності використовують механізм RestoreSensor: вони зберігають останнє відоме значення попри перезапуски і не стають недоступними лише через те, що двигун заглушено.

• Стандартні датчики OBD-II: швидкість, оберти, температура охолоджувальної рідини, рівень палива, положення дросельної заслінки, лямбда й решта каталогу SAE J1979, який підтримує ваше авто.
• Датчики конкретної марки та моделі: розширені PID, що різняться за брендом і моделлю, знаходяться автоматично.
• Обчислювані датчики: миттєва витрата, ковзна витрата (вікна 10, 50 і 100 км), потужність на колесах, запас ходу, пройдена відстань.
• Місце розташування: висота, точність і сутність device_tracker для автомобіля.
• TPMS: тиск, температура та ідентифікатор датчика для кожного колеса.
• Стан діагностики: лампа Check увімкнена чи вимкнена, кількість кодів, стоп-кадр, напруга адаптера, ЕБК у мережі чи ні, стан зв'язку з Home Assistant або MQTT.
• Манера водіння: поточні оцінки безпеки та економності, лічильники різких подій, історія за місяцями.

Події в шині подій Home Assistant

Саме це вирізняє нативну інтеграцію. Ваші автоматизації можуть слухати окремі моменти замість опитувати стан.

• car2home_trip_started: спрацьовує в мить початку поїздки (запуск двигуна плюс рух). У даних ідуть ідентифікатор авто та місце виїзду.
• car2home_trip_ended: спрацьовує наприкінці поїздки, з повним підсумком: відстань, тривалість, середня та максимальна швидкість, витрачене паливо, адреса паркування.
• car2home_dtc_found: діагностичне сканування завершилося й знайшло коди. У даних ідуть режим сканування та переліки підтверджених, очікуваних і постійних кодів.
• car2home_harsh_event: виявлено різке прискорення, гальмування або поворот. Корисно для сповіщень про безпечну їзду, надто з водіями-початківцями.
• car2home_ecu_online / car2home_ecu_offline: спрацьовує щоразу, коли зв'язок з ЕБК з'являється або зникає, тож ви відрізните "авто їде просто зараз" від "авто припарковане".

Приклади автоматизацій

Кілька ідей, щоб було від чого відштовхнутися. Повні блоки налаштувань лежать у посібниках.

• Відчинити ворота гаража й увімкнути світло біля входу, коли ви заїжджаєте на свою вулицю (геозона плюс trip_started).
• Сповістити родину адресою паркування й посиланням на карту тієї миті, коли поїздка завершується.
• Надіслати сповіщення в Telegram, коли сканування знаходить коди, із кількістю підтверджених, очікуваних і постійних.
• Заздалегідь охолодити дім тієї миті, коли ви виїжджаєте з офісу (геозона роботи плюс trip_started).

Сумісність і вимоги

• Home Assistant 2024.12 або новіший.
• Працює з Nabu Casa Cloud, Cloudflare Tunnel, Tailscale або будь-яким зворотним проксі, якому ви вже довіряєте.
• Кілька автомобілів: кожне авто в гаражі з'являється окремим пристроєм Home Assistant, із власними сутностями та власною історією.
• Токени зберігаються у зв'язці ключів iOS або в Android Keystore, але не в налаштуваннях застосунку.