Car2Hass
Android-приложение, интеграция Home Assistant и облако для телеметрии автомобиля Android app, Home Assistant integration and cloud for vehicle telemetry
Как это работает How it works
1. Источники данных
Car2Hass стартует сам и определяет доступные источники: ADB-сервисы автомобиля, DiPlus (канал BYD DiLink), OBD-II адаптер (ELM327, Bluetooth/WiFi/TCP), системные датчики и GPS. Все включённые источники опрашиваются одновременно, а значение берётся с канала с наивысшим приоритетом. DiPlus — опциональный источник для BYD. Car2Hass starts on its own and detects available sources: vehicle ADB services, DiPlus (BYD DiLink channel), OBD-II adapter (ELM327, Bluetooth/WiFi/TCP), system sensors and GPS. All enabled sources are polled together and the value comes from the highest-priority channel. DiPlus is optional, for BYD.
2. Car2Hass
Наше Android-приложение собирает сигналы и GPS-координаты (снимки 1 Гц, отправка батчами), передаёт их в Home Assistant и, по желанию, синхронизирует с облачным аккаунтом mytechnic.ru. Работает на ГУ BYD DiLink, Voyah и любом Android-устройстве с адаптером ELM327. Our Android app collects signals and GPS coordinates (1 Hz snapshots, sent in batches), forwards them to Home Assistant and optionally syncs with your mytechnic.ru cloud account. Runs on BYD DiLink head units, Voyah and any Android device with an ELM327 adapter.
3. Интеграция HA 3. HA integration
Интеграция CARTelemetry принимает данные от любого приложения по открытому API-контракту и создаёт нативные сущности HA: сенсоры и бинарные сенсоры, трекер устройства, диагностическую сущность с уникальными для авто сенсорами, а также переключатели, числовые поля, списки и кнопки для управления. Батареи разделены: устройство, 12 В АКБ и тяговая. The CARTelemetry integration accepts data from any app via the open API contract and creates native HA entities: sensors and binary sensors, a device tracker, a diagnostics entity with car-unique sensors, plus switches, number inputs, selects and buttons to control the car. Batteries are separated: device, 12V aux and traction.
📥 Скачать 📥 Download
⚡ Быстрая установка ⚡ Quick start
- Установите Car2Hass на головное устройство. Для BYD DiLink также установите DiPlus (скачать APK) — для других источников шаг пропустите. Install Car2Hass on the head unit. For BYD DiLink also install DiPlus (download APK) — skip for other sources.
-
Установите интеграцию через HACS: меню ⋮ → Custom repositories → добавьте
github.com/krisproger/car2hass(Integration) → Download. Либо вручную: распакуйтеcartelemetry-v3.5.4.zipи скопируйте папкуcustom_components/cartelemetryв/config/custom_components/. Install the integration via HACS: ⋮ menu → Custom repositories → addgithub.com/krisproger/car2hass(Integration) → Download. Or manually: extractcartelemetry-v3.5.4.zipand copy thecustom_components/cartelemetryfolder to/config/custom_components/. - Перезапустите Home Assistant и добавьте интеграцию CARTelemetry — Vehicle Telemetry. Restart Home Assistant and add the CARTelemetry — Vehicle Telemetry integration.
- Установите car2hass-v3.5.4.apk на ГУ (через флешку, мессенджер или ADB). Install car2hass-v3.5.4.apk on the head unit (USB flash drive, messenger or ADB).
- В приложении укажите адрес HA, Long-Lived Access Token и имя автомобиля (точно такое же, как в интеграции). In the app enter the HA address, Long-Lived Access Token and car name (exactly as in the integration).
- На главном экране включите Отправлять в HA и выберите нужные сигналы в таблице. On the main screen enable Send data to HA and select the signals you need in the table.
- Настройте автозапуск и фоновую работу в системных настройках BYD. Configure auto-start and background work in the BYD system settings.
- Опционально: войдите в личный кабинет mytechnic.ru/account (email + TOTP, без пароля) и включите облачную синхронизацию телеметрии в приложении. Optional: sign in to your mytechnic.ru/account account (email + TOTP, no password) and enable cloud telemetry sync in the app.
Подробная инструкция Full guide Статья с примерами Article with examples Автоматизация по правилам Rule-based automations Руководство (manual) Full manual Подробнее о проекте About the project
🎛️ Возможности 🎛️ Features
Правила и автоматизация Rules & automation
Локальный движок правил: условия AND/OR/NOT, действия «иначе» (else), режим «один раз за поездку», состояние условий сохраняется между поездками — правила срабатывают только на реальное изменение. Local rules engine: AND/OR/NOT conditions, else actions, fire-once-per-trip mode, persistent condition state across trips — rules fire only on real changes.
Геозоны Geofence zones
Зоны на карте OpenStreetMap (тап по карте, ручной ввод координат, круг радиуса). Каждая зона — виртуальный датчик inside/outside, доступный в правилах: «дома», «работа», «зарядка». Zones on an OpenStreetMap editor (map tap, manual coordinates, radius circle). Each zone is a virtual inside/outside sensor usable in rules: "home", "work", "charger".
Телеметрия Telemetry
265 сигналов: скорость, SOC, пробег, давление в шинах, температуры батареи и салона, двери, замки, свет, ADAS и другое. Плюс вычисляемые сенсоры: агрегаты окон/дверей, «все двери закрыты», средняя скорость/мощность, время зарядки. 265 signals: speed, SOC, range, tire pressure, battery and cabin temperatures, doors, locks, lights, ADAS and more. Plus derived sensors: window/door aggregates, "all doors locked", average speed/power, charge time.
Местоположение Location
GPS-координаты автомобиля передаются в HA как device tracker и отображаются на карте. Vehicle GPS coordinates are sent to HA as a device tracker and shown on the map.
Управление из HA Control from HA
Переключатели (A/C, свет, замки), числовые поля (температура, окна), списки (режимы) и кнопки (открыть багажник). Switches (A/C, lights, locks), number inputs (temperature, windows), selects (modes) and buttons (open trunk).
Двуязычный интерфейс Bilingual UI
Приложение поддерживает английский и русский языки с ручным переключением в настройках. The app supports English and Russian with manual language switching in settings.
Фильтр сигналов Signal filter
Выбирайте атрибуты для HA прямо в таблице на главном экране. Чекбокс в шапке — выбрать/снять все, клик по заголовкам столбцов сортирует список. Pick HA attributes right in the main-screen table. The header checkbox selects/deselects all; clicking column headers sorts the list.
Отключённые сигналы Disabled-signals filter
Во вкладке «Телеметрия» сигналы сгруппированы по доступности (активные / ожидаемые / недостижимые / отключённые), а у активных виден канал-источник. Ненужные сигналы можно скрыть, чтобы таблица оставалась чистой. In the Telemetry tab signals are grouped by availability (active / expected / unreachable / disabled), and active ones show their source channel. Hide the signals you don't need to keep the table clean.
Настраиваемый дашборд Customizable dashboard
Располагайте плитки и пресеты (замки, окна, климат, громкость) так, как удобно; плитки показывают текущее значение и зоны ➖/➕, а набор пресетов обновляется по воздуху. Arrange tiles and presets (locks, windows, climate, volume) the way you like; tiles show the current value with ➖/➕ zones, and the preset pack updates over the air.
Внешний реестр команд External registry
Соответствие сигналов и команд загружается из JSON-реестра — новые возможности без пересборки приложения. Sensor↔command mapping is loaded from a JSON registry — add new capabilities without rebuilding the app.
Автозапуск Auto-start
После включения ГУ приложение кратковременно появляется на экране и сворачивается для надёжной работы в фоне. After boot the app briefly appears on screen and then minimizes for reliable background operation.
Логирование Logging
Подробный лог команд и ответов DiPlus, ротация при 5 МБ и экспорт в Downloads с меткой времени. Detailed log of commands and DiPlus responses, 5 MB rotation and export to Downloads with a timestamp.
Облако и личный кабинет Cloud & account
Опциональная облачная синхронизация телеметрии в личный кабинет mytechnic.ru. Вход без пароля (email + TOTP); в кабинете — сенсоры, GPS-трек на карте, файлы настроек и подключённые приложения. Optional cloud sync of telemetry to your mytechnic.ru account. Passwordless login (email + TOTP); the dashboard shows sensors, a GPS track on the map, settings files and connected apps.
OAuth2 / OIDC OAuth2 / OIDC
mytechnic.ru работает как OAuth2/OIDC-провайдер (authorization code + PKCE, id_token RS256, userinfo, discovery). Для своих приложений создавайте OAuth-клиенты в кабинете и управляйте ими: создание, редактирование, удаление. mytechnic.ru acts as an OAuth2/OIDC provider (authorization code + PKCE, RS256 id_token, userinfo, discovery). Create and manage OAuth clients for your own apps in the account: create, edit, delete.
Универсальная интеграция Universal integration
Интеграция принимает телеметрию от любого приложения по открытому API-контракту. Нативные сущности HA, отдельная диагностическая сущность с уникальными для авто сенсорами и раздельные батареи: устройство / 12 В АКБ / тяговая. The integration takes telemetry from any app via the open API contract. Native HA entities, a diagnostics entity with car-unique sensors and separated batteries: device / 12V aux / traction.
Марки и профили Brands & profiles
Автоопределение профиля по ответам сигналов: BYD DiLink (generic и Song Pro 2022) и Voyah (только чтение). Для других марок (Exeed, Chery и др.) доступны универсальные показатели OBD-II. Car profile auto-detection by signal-answer scoring: BYD DiLink (generic and Song Pro 2022) and Voyah (read-only). For other brands (Exeed, Chery and more) universal OBD-II readings are available.
Каналы обновлений Update channels
Переключайте приложение между стабильным и бета-каналом прямо в настройках; интеграция обновляется через HACS — для беты включите «Pre-release» у репозитория. Switch the app between the stable and beta channels right in settings; the integration updates via HACS — enable 'Pre-release' on the repository for beta.
🛣️ Что нового 🛣️ What's new
- Облачная синхронизация и личный кабинет Cloud sync & personal account — v3.4.0 (бета): опциональная синхронизация телеметрии с mytechnic.ru — вход по email + TOTP без пароля, авто-обновление токена, отправка батчами. В личном кабинете: сенсоры, GPS-трек на карте, файлы настроек и подключённые приложения. v3.4.0 (beta): optional telemetry sync with mytechnic.ru — email + TOTP passwordless login, automatic token refresh, batched upload. The account shows sensors, a GPS track on the map, settings files and connected apps.
- Вычисляемые сенсоры Derived sensors — агрегаты окон и дверей, «все двери закрыты» (doors_all_lock), средняя скорость/мощность, время зарядки — доступны в правилах и телеметрии (v3.3.10, v3.4.0-beta.2). window and door aggregates, "all doors locked" (doors_all_lock), average speed/power, charge time — available in rules and telemetry (v3.3.10, v3.4.0-beta.2).
- Универсальная интеграция Universal integration — v3.3.10: нативные сущности HA, отдельная диагностическая сущность с уникальными для авто сенсорами и раздельные батареи (устройство / 12 В АКБ / тяговая). v3.3.10: native HA entities, a diagnostics entity with car-unique sensors and separated batteries (device / 12V aux / traction).
- Бета-канал обновлений Beta update channel — v3.3.11: переключение «стабильный/бета» в настройках приложения; у интеграции своя бета-линия, в HACS включается «Pre-release». v3.3.11: stable/beta switch in app settings; the integration has its own beta line, enabled via the HACS "Pre-release" switch.
- Переработанные источники Reworked sources — v3.3.11: система всегда включена, остальные источники добавляются из списка (вкл/выкл, счётчик ожидаемых сенсоров), авто-запуск сервиса после обновления. v3.3.11: system is always on, other sources are added from a list (on/off, expected-sensor count), and the service auto-starts after an update.
- Мгновенный старт и «липкие» сенсоры Instant start & sticky sensors — v3.3.10–3.4.0: последние значения сенсоров восстанавливаются сразу, устаревшее значение гаснет до серого, а правила по изменению не срабатывают ложно. v3.3.10–3.4.0: last sensor values are restored immediately, a stale value fades to grey, and change-rules no longer fire falsely.
- Единое хранилище и событийные правила Single value store & event rules — v3.3.7–3.3.8: все включённые источники работают одновременно, значения берутся из единого хранилища (ValueStore), правила реагируют на изменение мгновенно, команды идут через очередь с проверкой по сенсору. v3.3.7–3.3.8: all enabled sources work together, values come from a single store (ValueStore), rules react to a change instantly, and commands go through a queue verified by a sensor.
- Voyah: 50 сенсоров Voyah: 50 sensors — v3.3.0: телеметрия расширена с 29 до 50 сенсоров (скорость, передача, ремни, люк/шторка, окна, свет, поворотники, круиз/ACC/удержание полосы, EPB, режим движения). v3.3.0: telemetry expanded from 29 to 50 sensors (speed, gear, seatbelts, sunroof/shade, windows, lights, turn signals, cruise/ACC/lane keep, EPB, drive mode).
- Надёжное автообновление Reliable in-app update — v3.3.2–3.4.0: проверка целостности APK по SHA-256, загрузка из реестра релизов, исправлены «Ошибка скачивания» и падение фонового сервиса на Android 15/16. v3.3.2–3.4.0: APK integrity checked with SHA-256, download from the release registry, fixed the "download failed" error and the foreground-service crash on Android 15/16.
- Фикс пропадания сенсоров из телеметрии Telemetry sensor loss fix — v2.3.1: обвал DiPlus больше не помечает исправные сигналы как «неподдерживаемые» (ошибка соединения — временное явление, а не свойство сигнала). Ранее один обвал мог навсегда скрыть до ~130 сенсоров из телеметрии; группа «известно неподдерживаемых» сигналов теперь периодически ре-изолируется. Плюс настройки переработаны (иконки разделов в одну строку с названием, «Геозоны» отдельным пунктом, язык/пресеты/импорт-экспорт в «Опции») и у исследования каналов появился прогресс-бар. v2.3.1: a DiPlus outage no longer marks healthy signals as "unsupported" (a connect error is transient, not a signal property). Previously one crash could hide up to ~130 sensors from telemetry for good; the known-unsupported group is now re-isolated periodically. Plus the settings rework (nav icons on one line with the item name, Geofences as a separate item, language/presets/import-export in Options) and a progress bar for vehicle research.
- Нативная запись команд (бета) Native command write (beta) — v2.3.0: команды идут через прямой канал записи autoservice в дополнение к DiPlus, с взаимным фоллбэком интерфейсов и верификацией по сенсору; в результате указывается использованный интерфейс и число фоллбэков. v2.3.0: commands run through a direct autoservice write channel in addition to DiPlus, with mutual interface fallback and sensor verification; the result reports the used interface and number of fallbacks.
- Правила стреляют на каждом паркинге Rules fire on every parking — v2.1.1: 30-минутный кулдаун больше не действует на правила по фронту — «открыть двери на паркинге» работает на каждом паркинге, включая короткие поездки. Плюс удержание условия (anti-flap), валидация пустых значений и подсказки inside/outside для геозон. v2.1.1: the 30-minute cooldown no longer applies to edge-triggered rules — "unlock on Park" works on every parking, including short trips. Plus condition hold (anti-flap), empty-value validation and inside/outside hints for geofences.
-
Геозоны в Home Assistant
Geofence zones in Home Assistant
—
каждая зона появляется в HA как
binary_sensor(on = внутри), а в списке зон видно время последнего посещения. each zone appears in HA as abinary_sensor(on = inside), and the zone list shows the last visit time. - Иконки и плитки дашборда Dashboard icons & tiles — PNG-иконки пресетов вместо эмодзи (можно подменить своими), новый трёхстрочный вид плиток с зонами ➖/➕ — значение больше не перекрывает кнопки. PNG preset icons instead of emoji (user-overridable), new three-row layout for dual-zone tiles — the value no longer overlaps the buttons.
- Правила: автодополнение и история Rules: autocomplete & history — подсказки значений команд (локализованные enum, диапазоны min..max), время последнего срабатывания прямой и else-ветки в списке правил. command value suggestions (localized enums, min..max ranges), last-fired times for both true and else branches in the rules list.
- Стабильность Stability — устранена потеря циклов телеметрии (ConcurrentModificationException), движок правил защищён от ложных срабатываний при старте, чище логи, кнопка принудительного обновления пресетов. fixed telemetry cycle loss (ConcurrentModificationException), rule engine protected from false triggers at startup, cleaner logs, force-refresh presets button.
- Геозоны с картой Geofence zones with map — создавайте зоны на карте (OpenStreetMap), задавайте радиус — и используйте их в правилах как датчики «внутри/снаружи». create zones on an OpenStreetMap editor with adjustable radius and use them in rules as inside/outside sensors.
- Правила: «иначе» и «один раз за поездку» Rules: else actions & fire-once-per-trip — действия при ложном условии (включил обдув при +25 → выключил при падении температуры), режим однократного срабатывания, состояние правил переживает перезапуск — больше никаких ложных срабатываний при включении авто. actions on false condition (seat vent on at +25 → off when it cools down), one-shot mode, persistent rule state across restarts — no more false triggers at car start.
- Дашборд: рабочие плитки и перевод Dashboard: working tiles & translation — исправлены 9 пресетов-переключателей (багажник, аварийка, детские замки и др.), плитки громкости/вентилятора/температуры показывают текущее значение и зоны ➖/➕, все пресеты переведены на русский, замки дверей переключаются одним тапом. fixed 9 toggle presets (trunk, hazard, child locks etc.), volume/fan/temp tiles show current value with ➖/➕ zones, all presets localized to Russian, door locks toggle with a single tap.
- Полный экспорт конфигурации Full config export — экспорт настроек теперь включает правила и геозоны — перенос на другое ГУ в один файл. settings export now includes rules and geofence zones — migrate to another head unit with a single file.
- Примеры правил при первом запуске Example rules on first run — пять готовых выключенных правил (обдув сидений, проветривание, открытие дверей на паркинге) — включите нужные и подстройте под себя. five ready-made disabled rules (seat ventilation, window venting, unlock doors on Park) — enable the ones you need and adjust.
- Автоматические действия по правилам Rule-based automatic actions — множественные условия (AND/OR/NOT), множественные действия, автодополнение значений, редактор с перестановкой строк. Подробнее → multiple conditions (AND/OR/NOT), multiple actions, value autocomplete, reorderable rows. Read more →
Обсуждение новых идей и сценариев автоматизаций — в Telegram. Discuss new ideas and automation scenarios in our Telegram group.
⚠️ Отказ от ответственности ⚠️ Disclaimer
Проект Car2Hass создаётся энтузиастами и не имеет отношения к компании BYD или разработчикам DiPlus. Все действия с программным обеспечением, настройками автомобиля и системой Home Assistant вы выполняете исключительно на свой страх и риск. Авторы не несут ответственности за возможные повреждения оборудования, изменение настроек автомобиля или потерю данных. Car2Hass is a community project and is not affiliated with BYD or DiPlus. All actions involving software, vehicle settings and Home Assistant are performed at your own risk. The authors are not liable for any possible hardware damage, vehicle setting changes or data loss.
📬 Связь и поддержка 📬 Contact & support
Вопросы, предложения и обсуждения — в Telegram: Questions, feedback and discussions are welcome in Telegram:
❤️ Поддержать проект
❤️ Support the project
Разработка и поддержка приложения и интеграции требуют времени. Любая поддержка приветствуется! Development and support of the app and integration take time. Any support is appreciated!
TFyRhHUTqixCzNnXLdZXXZoo3UBkJacWJk
1NhdHQ14JRx9iV3tshqq7Syj7aMaK38uxg
0x4100f28e4c650423eb351fc005c97b8d620d1494
Платежный агрегатор Payment aggregator
Банковские карты Bank cards
2200 7006 1069 1486
2200 1523 9377 1947
2202 2032 6583 9417
2200 2414 5379 1539