Skip to content

ant0nkr/ev-pro-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BYD EV Pro

A small ecosystem for BYD electric vehicles: a car app on the DiLink head unit, an optional companion phone app, an optional T-Box hardware module, and Telegram / Home Assistant integrations.

The car app alone runs without a phone, an OBD adapter, or any cloud account. Add the phone app for remote control, Sentry mode and live camera. Add the T-Box for 24/7 connectivity, GPS tracking, keyless proximity unlock, and remote start with the car fully off.

New here? Read How It Works for a friendly overview, an architecture diagram, and answers to common new-user questions ("what is T-Box?", "do I need a phone?", "is internet required?").


Невелика екосистема для електромобілів BYD: додаток на головному пристрої DiLink, опційний companion-додаток на телефон, опційний апаратний модуль T-Box та інтеграції з Telegram та Home Assistant.

Сам додаток в авто працює без телефону, без OBD-адаптера та без облікового запису у хмарі. Додайте додаток на телефон для віддаленого керування, режиму Sentry та живих камер. Додайте T-Box для постійного зв'язку, GPS-трекінгу, безключового доступу за наближенням та віддаленого запуску, коли авто повністю вимкнене.

Вперше тут? Почніть з Як це працює — простий огляд, схема архітектури та відповіді на типові питання новачка ("що таке T-Box?", "чи потрібен телефон?", "чи потрібен інтернет?").

Features / Функції

Free / Безкоштовно

  • Dashboard / Панель — Real-time SOC, power flow, range, voltage, current, motor temps, cell voltage spread / SOC, потік енергії, запас ходу, напруга, струм, температури моторів, розкид комірок
  • Charging Tracking / Зарядка — Automatic session detection with SOC, energy, duration, avg speed / Автоматичне відстеження сесій з SOC, енергією, тривалістю, середньою швидкістю
  • Trip History / Історія поїздок — Per-ignition-cycle records: distance, energy, efficiency, avg speed / Записи по циклах запалення: відстань, енергія, ефективність, середня швидкість
  • Automation / Автоматизація — IF/THEN rules triggered on vehicle state transitions; includes predefined winter/summer comfort rules / Правила ЯКЩО/ТОДІ при зміні стану авто; включає зимові/літні правила комфорту
  • Voice Assistant / Голосовий помічник — 36 bilingual (EN/UK) offline voice commands via VOSK / 36 двомовних офлайн голосових команд через VOSK
  • Bluetooth(Feature in development / Функція у розробці)
  • Quick Actions Overlay / Швидкі дії — Floating pill with one-tap climate and seat controls / Плаваюча кнопка з керуванням кліматом та сидіннями
  • Debug Control Panel / Панель налагодження — Verify that vehicle commands reach the car and read back actual CAN values / Перевірка, що команди доходять до авто, зчитування фактичних значень CAN
  • Diagnostic Export / Діагностика — Full diagnostic bundle for troubleshooting / Повний діагностичний пакет для аналізу

Subscription (14-day free trial) / Підписка (14 днів безкоштовно)

  • Telegram Notifications / Telegram-сповіщення — Automatic alerts for charging events, gun connection, trip summaries; bot registration with multi-user support / Автоматичні сповіщення про зарядку, підключення пістолета, підсумки поїздок; реєстрація бота з підтримкою кількох користувачів
  • Home Assistant Integration / Інтеграція з Home Assistant — Push live vehicle sensors to HA via webhook; voice-triggered HA service calls; HACS custom component included / Передача датчиків авто в HA через webhook; голосові команди для сервісів HA; HACS-компонент включено
  • WiFi / 4G / Bluetooth Keep-Alive / Утримання WiFi / 4G / Bluetooth — Automatically re-enables WiFi, mobile data, and Bluetooth after ignition off / Автоматично відновлює WiFi, мобільний інтернет та Bluetooth після вимкнення запалення

Activate the trial from the About tab in the app. No payment required for the first 14 days.

Активуйте пробний період у вкладці Про додаток. Оплата не потрібна перші 14 днів.

Supported Vehicles / Підтримувані автомобілі

Developed and tested on BYD Song Plus EV 2025 (DiLink 5.0). Compatible with BYD vehicles running DiLink 3.0 through 6.0. See the compatibility table (EN | UA) for the full list.

Розроблено та протестовано на BYD Song Plus EV 2025 (DiLink 5.0). Сумісний з автомобілями BYD на DiLink 3.0–6.0. Повний список — у таблиці сумісності (EN | UA).

Documentation / Документація

# Guide (EN) Guide (UA) Description / Опис
00 How It Works Як це працює Architecture diagram + new-user FAQ / Схема та FAQ для новачків
01 Overview Огляд App description, features / Опис додатку, функції
02 Installation Встановлення Install, first launch, in-app updates / Встановлення, перший запуск, оновлення з додатка
03 Dashboard Панель SOC, power flow, range / SOC, потік енергії, запас ходу
04 Climate Клімат AC, temperature, seats / Кондиціонер, температура, сидіння
05 Charging Зарядка Session tracking / Відстеження сесій
06 Trip History Поїздки Trip records / Записи поїздок
07 Automation Автоматизація Rules, sensors, actions / Правила, датчики, дії
08 Voice Assistant Голосовий асистент Bilingual offline voice / Двомовний офлайн-голос
09 Quick Actions Швидкі дії Floating overlay / Плаваюча панель
10 Settings Налаштування All settings / Усі налаштування
11 Diagnostics Діагностика Log viewer, debug panel, export / Перегляд логів, панель налагодження, експорт
12 Compatibility Сумісність Supported models / Підтримувані моделі
13 Troubleshooting Вирішення проблем Common issues / Поширені проблеми
14 Telegram Telegram Telegram bot integration / Інтеграція з Telegram-ботом
15 Home Assistant Home Assistant HA webhook integration / Інтеграція з HA через webhook
16 Free vs Subscription Free vs Підписка Tier comparison, security / Порівняння рівнів, безпека
17 Companion App Companion-додаток Phone app: pair, dashboard, control / Телефон: пара, дашборд, керування
18 Sentry Mode Режим Sentry Motion detection clips / Кліпи з виявленням руху
19 Live Camera Жива камера Direct car-to-phone streaming / Прямий стрім авто-телефон

Home Assistant (HACS)

The Home Assistant custom component lives in the standalone ev-pro-ha-integration repository. To install:

  1. Open HACS in Home Assistant
  2. Go to Integrations → Custom repositories
  3. Add ant0nkr/ev-pro-ha-integration with category Integration
  4. Install BYD EV Pro and restart Home Assistant
  5. Configure the webhook URL and access token in the integration settings

Requires an active subscription in the app.


Користувацький компонент для Home Assistant знаходиться в окремому репозиторії ev-pro-ha-integration. Для встановлення:

  1. Відкрийте HACS в Home Assistant
  2. Перейдіть до Інтеграції → Користувацькі репозиторії
  3. Додайте ant0nkr/ev-pro-ha-integration з категорією Integration
  4. Встановіть BYD EV Pro та перезапустіть Home Assistant
  5. Налаштуйте webhook URL та токен доступу в налаштуваннях інтеграції

Потребує активну підписку в додатку.

Releases / Релізи

APK releases with release notes are published on the GitHub Releases page.

APK-релізи з нотатками публікуються на сторінці GitHub Releases.

Languages / Мови

English and Ukrainian. Language can be changed in Settings.

Англійська та українська. Мову можна змінити в Налаштуваннях.

Author / Автор

Anton Kramskyi / Антон Крамський

About

Releases and Documentation for BYD EV Pro

Resources

Stars

Watchers

Forks

Contributors