DiPlus-to-hass

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

diplus2hass.zip Интеграция Home Assistant Home Assistant integration

Скачать Download

DiPlus-to-hass.apk Релизная сборка Android-приложения (v1.7.0) Release build of the Android app (v1.7.0)

Скачать Download

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

1. Подготовьте головное устройство: установите DiPlus (com.van.diplus). Prepare the head unit: install DiPlus (com.van.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 (com.van.diplus) или возможностью его установки. A BYD vehicle with DiLink head unit and DiPlus (com.van.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.zip. The DiPlus-to-hass APK and the diplus2hass.zip integration archive.

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

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

1. Скачайте файл diplus2hass.zip. Download diplus2hass.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. Restart Home Assistant.
5. Перейдите в Настройки → Устройства и службы → Добавить интеграцию. Go to Settings → Devices & Services → Add integration.
6. Найдите и выберите DiPlus-to-hass — BYD Vehicle Telemetry. Find 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.

Важно: Important: имя автомобиля в интеграции HA и в приложении должны совпадать. На это имя завязаны все сенсоры и трекер. the car name in the HA integration and in the Android app must match. All sensors and the tracker depend on this name.

Вариант B. Установка через HACS Option B — Installation via HACS

1. Откройте HACS → Интеграции. Open HACS → Integrations.
2. Нажмите + Добавить интеграцию. Click + Add integration.
3. Найдите DiPlus-to-hass — BYD Vehicle Telemetry и установите. Find DiPlus-to-hass — BYD Vehicle Telemetry and install it.
4. Перезапустите Home Assistant. Restart Home Assistant.
5. Добавьте интеграцию через UI, как описано в варианте A. Add the integration through the UI as described in Option A.

Если интеграции нет в каталоге HACS, используйте ручную установку через diplus2hass.zip. If the integration is not in the HACS catalog, use the manual installation from diplus2hass.zip.

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

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

DiPlus (com.van.diplus) — обязательное условие. DiPlus-to-hass читает данные из локального HTTP-API DiPlus на 127.0.0.1:8988. is mandatory. DiPlus-to-hass reads data from the local DiPlus HTTP API at 127.0.0.1:8988.

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, obtain the APK (for example, 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 responds:

   adb shell
   curl http://127.0.0.1:8988/api/getDiPars?text=SOC

Доступ по 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 DiPlus-to-hass.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.

✅ Проверка и диагностика ✅ 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.