DiPlus-to-hass

Что это What it is

DiPlus-to-hass — это связка из Android-приложения и пользовательской интеграции Home Assistant, которая позволяет получать телеметрию автомобиля BYD и управлять некоторыми его функциями прямо из Home Assistant. DiPlus-to-hass is a bundle of an Android app and a custom Home Assistant integration that lets you receive telemetry from a BYD vehicle and control some of its functions directly from Home Assistant.

Проект не является официальным продуктом BYD или DiPlus. Он создан энтузиастами для владельцев автомобилей BYD с головным устройством DiLink. The project is not an official BYD or DiPlus product. It is made by enthusiasts for owners of BYD vehicles with DiLink head units.

Архитектура Architecture

• DiPlus — приложение на головном устройстве BYD. Обязательно: без него DiPlus-to-hass работать не будет. the app running on the BYD head unit. Mandatory: DiPlus-to-hass will not work without it.
• DiPlus-to-hass Android app — опрашивает DiPlus, собирает сигналы и координаты, формирует снимки состояния и отправляет их в Home Assistant. polls DiPlus, collects signals and coordinates, builds state snapshots and forwards them to Home Assistant.
• Home Assistant integration — принимает пакеты, создаёт сенсоры, бинарные сенсоры, трекер устройства, а также сущности для управления: переключатели, числовые поля, списки и кнопки. receives the batches, creates sensors, binary sensors, a device tracker, and control entities: switches, number inputs, selects and buttons.

Возможности Features

• Передача более 130 сигналов автомобиля: скорость, SOC, пробег, давление в шинах, температуры, двери, замки, свет, ADAS и другие. Transmission of more than 130 vehicle signals: speed, SOC, range, tire pressure, temperatures, doors, locks, lights, ADAS and more.
• GPS-координаты автомобиля как device tracker на карте Home Assistant. Vehicle GPS coordinates as a device tracker on the Home Assistant map.
• Управление из Home Assistant: A/C, свет, замки, окна, багажник, режимы и другие команды. Control from Home Assistant: A/C, lights, locks, windows, trunk, modes and other commands.
• Фильтр атрибутов прямо на главном экране: чекбокс «выбрать/снять все», сортировка по заголовкам столбцов. Attribute filter right on the main screen: select/deselect-all checkbox, sort by column headers.
• Управление авто из HA (выключено по умолчанию): переключатели, числовые поля, списки и кнопки. Control car from HA (disabled by default): switches, number inputs, selects and buttons.
• Автозапуск сервиса при включении головного устройства: приложение кратковременно появляется и сворачивается для фоновой работы. Service auto-start on head unit boot: the app briefly appears and then minimizes for background operation.
• Двуязычный интерфейс приложения (русский/английский) с ручным переключением. Bilingual app UI (Russian/English) with manual switching.
• Импорт и экспорт конфигурации для быстрой настройки нескольких устройств. Configuration import/export for quick setup of multiple devices.
• Подробный лог с ротацией при 5 МБ и экспортом в Downloads. Detailed log with 5 MB rotation and export to Downloads.
• v2.1.0: геозоны в Home Assistant — каждая зона становится binary_sensor.<car>_geofence_<name> (on = внутри), в списке зон видно время последнего посещения. v2.1.0: geofence zones in Home Assistant — each zone becomes a binary_sensor.<car>_geofence_<name> (on = inside), and the zone list shows the last visit time.
• v2.1.0: PNG-иконки пресетов вместо эмодзи (с возможностью подмены своими файлами), новый трёхстрочный вид плиток с зонами ➖/➕. v2.1.0: PNG preset icons instead of emoji (user-overridable), new three-row layout for dual-zone tiles.
• v2.1.0: автодополнение значений команд в редакторе правил, время последнего срабатывания правила (обе ветки), кнопка принудительного обновления пресетов с версией. v2.1.0: command value autocomplete in the rule editor, rule last-fired times (both branches), force-refresh presets button with version display.
• v2.0.0: движок правил — локальные автоматизации на ГУ: множественные условия (AND/OR/NOT), несколько действий, else-ветка, «один раз за поездку», экспорт/импорт. v2.0.0: rules engine — local automations on the head unit: multiple conditions (AND/OR/NOT), multiple actions, else branch, fire-once-per-trip, export/import.
• v2.0.0: геозоны с редактором на карте OpenStreetMap — виртуальные датчики geo_<id> для использования в правилах. v2.0.0: geofence zones with an OpenStreetMap editor — virtual geo_<id> sensors usable in rules.
• v1.9.1: фоновый режим при выключенном авто — продолжает собирать телеметрию и выполнять команды после ACC off. Встроенный помощник ADB-команд. v1.9.1: background mode when the car is off — keeps collecting telemetry and executing commands after ACC off. Built-in ADB command helper.
• v1.9.1: лог сразу пишется в файл и сбрасывается при остановке сервиса для отладки работы на выключенном авто. v1.9.1: logs are written to disk immediately and flushed on service shutdown for ACC-off debugging.
• v1.9.0: стабильная работа в фоне — явная остановка сервиса не вызывает рестарт, уведомление при загрузке без звука. v1.9.0: stable background service — explicit stop does not restart, boot notification is silent.
• v1.9.0: надёжность очереди команд в HA — дедупликация, удаление устаревших команд, корректный таймаут. v1.9.0: reliable HA command queue — deduplication, stale-command expiry, correct timeout.
• v1.9.0: исправление online-сENSORа и корректная работа пресета окон на дашборде. v1.9.0: online sensor fix and correct windows preset evaluation on the dashboard.
• v1.9.0: краш-логи сохраняются в Downloads; журнал команд теперь прокручивается. v1.9.0: crash logs saved to Downloads; command journal is now scrollable.

🛣️ Планы развития 🛣️ Roadmap

• Автоматические действия по правилам Rule-based automatic actions — например, если температура за бортом выше 25 °C, автоматически включать обдув сидений на 100 % на местах, где сидят пассажиры. for example, if the outside temperature is above 25 °C, automatically turn on seat ventilation to 100 % for occupied seats.

❤️ Поддержать проект ❤️ Support the project

Разработка и поддержка приложения и интеграции требуют времени. Любая поддержка приветствуется! Development and support of the app and integration take time. Any support is appreciated!

Платежный агрегатор Payment aggregator

Банковские карты Bank cards

Лицензия и поддержка License and support

Проект распространяется под лицензией MIT. Поддержка ведётся в Telegram: The project is distributed under the MIT License. Support is provided via Telegram: @BYDiPlus2HASS.