Початок роботи з Car App

Car App — це byd_ev_pro, Flutter-застосунок для авто BYD з головними пристроями DiLink. Код підтверджує показ телеметрії авто, локальні дії там, де їх відкриває DiLink, історію поїздок і зарядок, голосові команди, автоматизації, шляхи Companion App через реле та підтримку webhook Home Assistant.

Що робить Car App

Показує живі дані DiLink: заряд батареї, запас ходу, потужність, температури, пробіг, швидкість, двері, замки, вікна, TPMS, підігрів сидінь/керма та дані двигунів, якщо авто їх повідомляє.
Виконує локальні дії через рівень керування DiLink, зокрема клімат і доступ, якщо це підтримує прошивка авто.
Записує історію поїздок і зарядок.
Підтримує голосові команди та правила автоматизації, якщо є потрібні дозволи застосунку та можливості авто.
Публікує стан авто і події через Cloud для функцій через реле, зокрема Companion App, Telegram і шляхів T-Box.
Надсилає webhook-дані в Home Assistant, якщо sync налаштований.
Показує та керує сполученням/оновленням T-Box, якщо T-Box присутній.

Головний екран

Головний екран показує стан авто в реальному часі. Основні значення: заряд батареї, запас ходу, поточна потужність, пробіг, швидкість, температури батареї та двигунів, стан дверей, замків, вікон, багажника, TPMS і підігрівів. Якщо авто не передає певний датчик, Car App показує порожнє або недоступне значення замість того, щоб підставляти оцінку.

На панелі також є розрахункові показники. Car App може показувати прогнозований запас ходу на основі заряду, ємності батареї та попередньої ефективності, а також поточний запас ходу за даними активної поїздки. Такі розрахунки стають кориснішими після кількох завершених циклів заряджання.

Батарея і заряджання

Розділ батареї призначений для швидкої перевірки високовольтної батареї. Якщо модель авто надає ці дані, Car App показує SOH, напругу, струм, потужність, мінімальну й максимальну температуру батареї, напругу найслабшої та найсильнішої комірки, а також різницю між ними.

Різниця напруги між комірками допомагає помітити дисбаланс батареї. Це довідковий показник для власника, а не заміна офіційної діагностики сервісу BYD.

Car App також записує історію заряджання: завершені сесії, додану енергію, зміну заряду, час і пов’язані показники, якщо вони доступні з DiLink.

Поїздки і ефективність

Car App веде статистику поточної поїздки, поточного циклу між заряджаннями та загальні локальні підсумки. У цих розділах можна перевірити відстань, витрачену енергію, середню швидкість, час руху й ефективність у кВт·год/100 км.

Окремі показники можуть враховувати споживання клімату та інші витрати, якщо авто передає їх у DiLink. Історія поїздок корисна для порівняння маршруту, погоди, стилю їзди й реального запасу ходу.

Голосове керування

Car App має голосовий асистент для команд українською та англійською мовами. Розпізнавання працює на головному пристрої через VOSK, без API ключів і без надсилання голосу у Cloud.

Голосові команди можуть запускати навігацію або музику, керувати кліматом, підігрівом, вентиляцією сидінь, вікнами, люком, шторкою, замками й багажником. Доступність кожної дії залежить від моделі авто, прошивки DiLink, дозволів Car App і того, чи налаштований відповідний застосунок, наприклад навігація.

У налаштуваннях можна увімкнути режим голосової фрази або push-to-talk, вибрати застосунок навігації, вимкнути непотрібні команди й налаштувати поведінку кнопки швидких дій.

Автоматизації і швидкі дії

Автоматизації виконують дію, коли авто переходить у потрібний стан і виконується умова датчика. Наприклад, правило може вмикати підігрів керма або сидіння в холодну погоду чи відкривати шторку панорами після запуску авто, якщо така дія підтримується конкретною моделлю.

Кожне правило має назву, перемикач увімкнення, умову, стан авто для запуску та дію. Для деяких дій доступний таймер автоповернення, наприклад вимкнення клімату або підігріву через заданий час.

Плаваюча кнопка швидких дій дає доступ до частих команд поверх інших застосунків на головному пристрої. Якщо увімкнений push-to-talk, коротке натискання може запускати голосову команду, а довге натискання відкриває панель швидких дій.

Зв’язок та інтеграції

Cloud використовується для функцій, яким потрібне реле: ліцензії, сполучення Companion App, Telegram, віддалені команди, логи та маршрути T-Box. Для локального показу даних DiLink головному екрану не обов’язково мати Cloud у кожен момент, але інтеграції без інтернету не працюватимуть.

Home Assistant отримує дані через webhook, якщо інтеграція встановлена і URL додано в Car App. Telegram може надсилати сповіщення про заряджання, підключення зарядного пістолета, підсумки поїздок та інші події, якщо ця функція доступна у вашій ліцензії та версії Car App.

У деяких версіях Car App є налаштування утримання Wi-Fi активним після вимкнення авто. Використовуйте його тільки якщо воно є у вашій версії та відповідає вашому сценарію підключення.

Сумісність

Код орієнтований на авто BYD DiLink. У Car App є таблиця прошивок DiLink 3.0, 4.0, 5.0, 5.1 і 6.0 та модельних сімейств Song Plus, Song L, Tang, Han, Seal, Seagull, Atto 3, Denza та інших.

Статус встановлення

У репозиторії є результати збірки Android APK, зокрема byd-ev-pro/build/app/outputs/flutter-apk/app-release.apk і byd-ev-pro/build/app/outputs/apk/release/byd_ev_pro.apk.

TODO: Product clarification needed — Which public download channel should users use for the Car App APK, and what exact sideloading flow is officially supported for BYD DiLink head units?

Поки це не уточнено, не використовуйте старі чернеткові інструкції з конкретною сторінкою релізу, форматом USB або шляхом через файловий менеджер.

Передумови

Авто BYD з головним пристроєм DiLink, на якому може працювати Car App.
Затверджене продуктом джерело APK і шлях встановлення. Ця документація ще не визначає їх.
Інтернет на головному пристрої для перевірок ліцензії через реле, сполучення, віддалених команд і логів.
Дозволи, які запитує Car App, зокрема доступ DiLink там, де прошивка його відкриває.
Доступ до потрібних системних дозволів DiLink/ADB, якщо офіційний шлях встановлення або підтримка просить їх увімкнути.
Обладнання T-Box потрібне тільки для поведінки, яка залежить від T-Box: розблокування за наближенням, T-Box GPS/стан або маршрутизація команд T-Box.

Перший запуск

Відкрийте BYD EV Pro на головному пристрої DiLink.
Тримайте головний пристрій активним, поки застосунок підключається до рівня даних DiLink.
Переконайтеся, що панель отримує живі значення авто.
Відкрийте ліцензійний розділ, щоб відновити наявну ліцензію або явно запустити пробний період, якщо застосунок показує таку дію.
Налаштовуйте опційні інтеграції тільки після появи живих даних авто.

Car App завантажує зашифрований ресурс daemon з APK, тож панель може стартувати з вбудованого коду навіть без Cloud. Cloud все одно використовується для ліцензій, сполучення, віддалених команд, логів і функцій через реле.

Додаткові кроки

Сполучіть Companion App через QR.
Додайте T-Box, якщо потрібні наближення, T-Box GPS або маршрутизація команд T-Box.
Налаштуйте Home Assistant, якщо потрібні webhook-сенсори та device tracker.

Усунення проблем

Якщо панель не отримує дані авто, тримайте головний пристрій активним і перезапустіть Car App один раз. Якщо не працюють тільки функції через реле, перевірте інтернет і статус ліцензії.

TODO: Product clarification needed — What user-visible status labels should support ask users to report for DiLink connection failures?