DiPlus-to-hass

📦 Файлы для загрузки 📦 Download files

diplus2hass-v2.1.6.zip Интеграция Home Assistant (v2.1.6) Home Assistant integration (v2.1.6)

Скачать Download

diplus2hass-v2.1.6.apk Релизная сборка Android-приложения (v2.1.6) Release build of the Android app (v2.1.6)

Скачать Download

✨ Что нового в v1.9.1 ✨ What's new in v1.9.1

• Фоновый режим при выключенном авто — приложение продолжает собирать телеметрию и выполнять команды после выключения ACC. Встроенный помощник ADB-команд. Background mode when the car is off — the app keeps collecting telemetry and executing commands after ACC off. Built-in ADB command helper.
• Помощник ADB — одним нажатием пытается выдать нужные разрешения, включить allow_online_while_car_off и добавить приложение в белый список Doze. При блокировке ГУ показывает команды для ручного выполнения с ПК. ADB helper — one-tap attempt to grant required permissions, enable allow_online_while_car_off, and whitelist the app from Doze. If the head unit blocks it, the app shows commands to run manually from a PC.
• Лог в файл сразу после старта — запись на диск и сброс буфера при остановке сервиса для отладки работы на выключенном авто. Immediate file logging — logs are written to disk right after app start and flushed on service shutdown for ACC-off debugging.

🛠️ Порядок установки 🛠️ Order of installation

1. Подготовьте головное устройство: установите DiPlus. Prepare the head unit: install DiPlus.
2. Установите интеграцию Home Assistant. Install the Home Assistant integration.
3. Установите и настройте Android-приложение DiPlus-to-hass. Install and configure the DiPlus-to-hass Android app.
4. Настройте автозапуск и исключите приложение из списка очистки в системных настройках BYD. Configure auto-start and whitelist the app in the BYD system settings.

📋 Что понадобится 📋 Requirements

• Автомобиль BYD с головным устройством DiLink и установленным приложением DiPlus или возможностью его установки. A BYD vehicle with DiLink head unit and DiPlus installed, or the ability to install it.
• Компьютер с установленным adb (только для продвинутых пользователей). A computer with adb installed (for advanced users only).
• Home Assistant с правами на установку custom integrations. Home Assistant with permission to install custom integrations.
• Long-Lived Access Token из Home Assistant. A Home Assistant Long-Lived Access Token.
• APK-файл DiPlus-to-hass и архив интеграции diplus2hass-v2.1.6.zip. The DiPlus-to-hass APK and the diplus2hass-v2.1.6.zip integration archive.

🏠 Установка интеграции Home Assistant 🏠 Installing the Home Assistant integration

Вариант A. Через HACS (рекомендуется) Option A — via HACS (recommended)

1. Убедитесь, что в Home Assistant установлен HACS. Make sure HACS is installed in Home Assistant.
2. Откройте HACS → Integrations → меню ⋮ (вверху справа) → Custom repositories. Open HACS → Integrations → ⋮ menu (top right) → Custom repositories.
3. В поле Repository вставьте https://github.com/krisproger/diplustohass, выберите категорию Integration и нажмите Add. Paste https://github.com/krisproger/diplustohass into Repository, choose the Integration category and click Add.
4. Найдите в HACS DiPlus-to-hass — BYD Vehicle Telemetry и нажмите Download. Find DiPlus-to-hass — BYD Vehicle Telemetry in HACS and click Download.
5. Перезапустите Home Assistant. Restart Home Assistant.
6. Перейдите в Настройки → Устройства и службы → Добавить интеграцию и выберите DiPlus-to-hass — BYD Vehicle Telemetry. Go to Settings → Devices & Services → Add integration and select DiPlus-to-hass — BYD Vehicle Telemetry.
7. Введите имя автомобиля (например, BYDSongPRO). Оно должно совпадать с именем в приложении. Enter the car name (for example, BYDSongPRO). It must match the name used in the app.

Обновления интеграции будут приходить через HACS автоматически. Integration updates will arrive via HACS automatically.

Вариант B. Ручная установка через архив Option B — Manual installation from archive

1. Скачайте файл diplus2hass-v2.1.6.zip. Download diplus2hass-v2.1.6.zip.
2. Распакуйте архив. Внутри будет папка custom_components/diplus2hass/. Extract the archive. Inside you will find custom_components/diplus2hass/.
3. Скопируйте папку diplus2hass в директорию конфигурации Home Assistant: Copy the diplus2hass folder to your Home Assistant configuration directory:

   cp -r custom_components/diplus2hass /config/custom_components/

4. Перезапустите Home Assistant и добавьте интеграцию через UI, как описано в варианте A (шаги 6–7). Restart Home Assistant and add the integration through the UI as described in Option A (steps 6–7).

Важно: Important: при ручном обновлении сначала полностью удалите старую папку /config/custom_components/diplus2hass/, затем копируйте новую — перезапись поверх приводит к ошибкам импорта. Имя автомобиля в интеграции HA и в приложении должны совпадать. when upgrading manually, fully delete the old /config/custom_components/diplus2hass/ folder first, then copy the new one — overwriting leaves a mixed set of files and import errors. The car name in the HA integration and in the Android app must match.

🚗 Подготовка головного устройства BYD 🚗 Preparing the BYD head unit

Установка DiPlus Installing DiPlus

DiPlus — обязательное условие: без него DiPlus-to-hass работать не будет. is mandatory — DiPlus-to-hass will not work without it.

1. Если DiPlus уже установлен и работает, пропустите этот шаг. If DiPlus is already installed and running, skip this step.
2. Если DiPlus не установлен, скачайте APK (diplus.1.3.8-beta18.apk) и установите его с флешки, из мессенджера или файлового менеджера. If DiPlus is not installed, download the APK (diplus.1.3.8-beta18.apk) and install it from a USB flash drive, messenger or file manager.
3. Запустите DiPlus на головном устройстве и убедитесь, что он работает. Launch DiPlus on the head unit and make sure it is running.

Доступ по ADB (для продвинутых пользователей) ADB access (for advanced users)

ADB не требуется для обычной установки. Он нужен только для отладки, извлечения логов или установки APK с компьютера. ADB is not required for normal installation. It is only needed for debugging, log extraction or installing APKs from a computer.

1. На головном устройстве откройте Настройки → О системе. On the head unit open Settings → About system.
2. Найдите Версия ПО (или Номер сборки) и нажмите 7–10 раз, пока не появится сообщение о режиме разработчика. Find Software version (or Build number) and tap it 7–10 times until developer mode is enabled.
3. Включите Отладку по USB. Enable USB debugging.
4. Подключите компьютер к USB-порту автомобиля и выполните: Connect the computer to the car USB port and run:

   adb devices

Установка DiPlus-to-hass через ADB Installing DiPlus-to-hass via ADB

adb install -r diplus2hass-v2.1.6.apk

⚙️ Настройка DiPlus-to-hass ⚙️ Configuring DiPlus-to-hass

Разрешения Permissions

• Местоположение — для передачи координат в HA. Location — for sending coordinates to HA.
• Уведомления — foreground service использует постоянное уведомление. Notifications — the foreground service uses a persistent notification.
• Автозапуск — сервис стартует после перезагрузки ГУ. Auto-start — the service starts after the head unit reboots.
• Фоновая работа / Отключение оптимизации батареи — разрешите для DiPlus-to-hass в настройках BYD. Background activity / Battery optimization ignore — allow for DiPlus-to-hass in the BYD settings.

Настройка подключения к HA Configuring the HA connection

1. В приложении нажмите ⚙ → Настройки. In the app tap ⚙ → Settings.
2. Укажите: Enter:
   • Адрес сервера — домен или IP Home Assistant. Server address — domain or IP of Home Assistant.
   • Порт — обычно 443 для HTTPS или 8123 для HTTP. Port — usually 443 for HTTPS or 8123 for HTTP.
   • Long-Lived Access Token — токен из профиля пользователя HA. Long-Lived Access Token — token created in the HA user profile.
   • Имя автомобиля — должно совпадать с именем в интеграции HA. Car name — must match the name entered in the HA integration.
   • HTTPS — включите, если HA работает по HTTPS. HTTPS — enable if HA uses HTTPS.
3. Вернитесь на главный экран и включите переключатель Отправлять в HA. Приложение начнёт опрашивать DiPlus и отправлять снимки в HA. Return to the main screen and enable the Send data to HA switch. The app will start polling DiPlus and sending snapshots to HA.

Важно: Important: даже если подключение к HA отсутствует, приложение будет собирать данные из DiPlus и выводить их на экран. При появлении связи данные отправятся в HA. even if the connection to HA is unavailable, the app will keep collecting data from DiPlus and displaying it. When connectivity appears, the data will be sent to HA.

Управление авто из HA Control car from HA

По умолчанию приложение не обрабатывает команды из Home Assistant. Чтобы включить управление: By default the app does not process commands from Home Assistant. To enable control:

1. Откройте ⚙ → Настройки. Open ⚙ → Settings.
2. Включите Управление авто из HA. Enable Control car from HA.
3. Приложение начнёт опрашивать webhook HA и передавать команды в DiPlus. The app will start polling the HA webhook and forwarding commands to DiPlus.

Получение Long-Lived Access Token Getting a Long-Lived Access Token

1. Откройте Home Assistant в браузере. Open Home Assistant in a browser.
2. Нажмите на профиль пользователя (левый нижний угол). Click your user profile (bottom-left corner).
3. Пролистайте вниз до раздела Long-Lived Access Tokens и нажмите Создать токен. Scroll to the Long-Lived Access Tokens section and click Create Token.
4. Введите название, например DiPlus-to-hass, и нажмите OK. Enter a name, for example DiPlus-to-hass, and click OK.
5. Сразу скопируйте сгенерированный токен — HA не покажет его повторно. Copy the generated token immediately — HA will not show it again.

🔧 Дополнительные настройки 🔧 Additional settings

Фильтр атрибутов для HA Attribute filter for HA

По умолчанию приложение передаёт в Home Assistant все доступные сигналы. Чтобы ограничить набор, на главном экране отметьте галочками только нужные атрибуты. Чекбокс в шапке таблицы быстро выбирает или снимает все сигналы, а клик по заголовкам столбцов сортирует таблицу. Фильтр сохраняется в настройках и включается в экспорт/импорт конфигурации. By default the app sends all available signals to Home Assistant. To limit the set, on the main screen check only the attributes you need. The header checkbox quickly selects or deselects all signals, and clicking column headers sorts the table. The filter is saved in settings and included in config import/export.

Импорт и экспорт конфигурации Configuration import/export

В Настройках доступны кнопки Импорт конфига и Экспорт конфига. Экспорт сохраняет настройки (включая фильтр сигналов, флаг управления из HA и флаг подробного лога) в JSON-файл в папку загрузок с именем вида config_diplus2hass_YYYYMMDD-HHmmss.json. Импорт ищет файлы по маске config_diplus2hass_*.json в папке загрузок и в других доступных приложению папках. In Settings the Import config and Export config buttons are available. Export saves settings (including the signal filter, control-from-HA flag and detailed-log flag) to a JSON file in the Downloads folder with a name like config_diplus2hass_YYYYMMDD-HHmmss.json. Import looks for files matching config_diplus2hass_*.json in the Downloads folder and in other folders accessible to the app.

Автозапуск и фоновая работа Auto-start and background work

1. В меню приложения откройте Автозапуск (BYD). In the app menu open Auto-start (BYD).
2. В открывшемся системном окне разрешите DiPlus-to-hass автозапускаться. В старых версиях BYD окно может содержать список запрета автозапуска — в этом случае уберите галочку напротив DiPlus-to-hass. In the system window that opens allow DiPlus-to-hass to auto-start. On older BYD versions the window may show an auto-start prohibition list — in that case remove the checkmark next to DiPlus-to-hass.
3. Откройте Фоновая работа и добавьте приложение в белый список фоновой активности. Open Background work and add the app to the background activity whitelist.

После загрузки ГУ приложение кратковременно появляется на экране и сворачивается — это повышает надёжность работы в фоне. After the head unit boots, the app briefly appears on screen and then minimizes — this improves background reliability.

Автоматическое применение фонового режима через ADB Automatic background mode via ADB

При нажатии Применить режим фона приложение пытается автоматически выдать разрешения и настроить фон по ADB over TCP (127.0.0.1:5555 по умолчанию). При первом подключении на экране ГУ может появиться запрос «Разрешить отладку по USB?» / «Разрешить отладку ADB?» — его нужно принять. Если автоматическое применение не сработает, приложение покажет список команд для ручного выполнения с ПК. Для использования беспроводного ADB сначала выполните: When you tap Apply background mode, the app tries to automatically grant permissions and configure background mode over ADB over TCP (127.0.0.1:5555 by default). On the first connection, the head unit may show an “Allow USB debugging?” / “Allow ADB debugging?” prompt — accept it. If automatic application fails, the app shows a list of commands to run manually from a PC. To use wireless ADB, first run:

adb tcpip 5555

✅ Проверка и диагностика ✅ Verification and diagnostics

В Home Assistant должны появиться: In Home Assistant you should see:

• Сенсоры (скорость, SOC, пробег, давление в шинах и др.) Sensors (speed, SOC, range, tire pressure, etc.)
• Бинарные сенсоры (двери, замки, свет, зарядка и др.) Binary sensors (doors, locks, lights, charging, etc.)
• Трекер устройства (координаты автомобиля на карте) Device tracker (vehicle coordinates on the map)

Для диагностики включите Писать подробный лог в настройках — тогда в лог будут записываться команды и ответы DiPlus. Лог в памяти ротируется при 5 МБ и экспортируется в Downloads с меткой времени. Лог-файлы также можно извлечь через ADB: For diagnostics enable Write detailed log in settings — commands and DiPlus responses will be recorded. The in-memory log rotates at 5 MB and can be exported to Downloads with a timestamp. Log files can also be extracted via ADB:

adb shell run-as com.diplustohass ls files/
adb logcat -s DiPlusToHass:D

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

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

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

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

🛣️ Планы развития 🛣️ 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.