Быстрый старт¶
Полная установка занимает 15–20 минут. Порядок важен: сначала DiPlus, потом интеграция HA, потом наше приложение.
Шаг 1. Установите DiPlus на головное устройство¶
Приложение DiPlus — источник данных об автомобиле. Без него DiPlus-to-hass работать не будет.
- Скачайте diplus.1.3.8-beta18.apk.
- Установите на ГУ любым способом (флешка, мессенджер, ADB).
- Запустите DiPlus и выдайте ему запрошенные разрешения.
- Проверьте, что DiPlus видит автомобиль: на главном экране DiPlus появляются данные (скорость, SOC и т.д.).
Шаг 2. Установите интеграцию Home Assistant¶
Есть два способа — через HACS (рекомендуется) или вручную.
Способ A. Через HACS (рекомендуется)¶
- Убедитесь, что в HA установлен HACS.
- HACS → Integrations → меню ⋮ (вверху справа) → Custom repositories.
- В поле Repository вставьте
https://github.com/krisproger/diplustohass, категория — Integration → Add. - Найдите в HACS DiPlus-to-hass — BYD Vehicle Telemetry и нажмите Download.
- Перезапустите Home Assistant.
Обновления интеграции будут приходить через HACS автоматически.
Способ B. Вручную (без HACS)¶
- Скачайте diplus2hass-v2.4.0.zip и распакуйте.
-
Скопируйте папку
custom_components/diplus2hassв/config/custom_components/.Обновление с предыдущей версии
Сначала полностью удалите старую папку
/config/custom_components/diplus2hass/, затем копируйте новую. Перезапись поверх оставляет смешанный набор файлов и приводит к ошибкам импорта при запуске. -
Перезапустите Home Assistant.
Добавление интеграции¶
- Настройки → Устройства и службы → Добавить интеграцию → найдите DiPlus-to-hass — BYD Vehicle Telemetry.
- Введите имя автомобиля (латиницей, без пробелов — например,
BYDSongPRO). Оно станет префиксом всех сущностей.
Шаг 3. Создайте Long-Lived Access Token¶
- В HA откройте профиль пользователя (внизу слева) → раздел Long-Lived Access Tokens.
- Создайте токен с понятным именем (например,
diplus-car) и скопируйте его — он показывается один раз.
Шаг 4. Установите приложение DiPlus-to-hass¶
- Скачайте diplus2hass-v2.4.0.apk.
- Установите на ГУ (флешка, мессенджер или
adb install -r). - При первом запуске выдайте разрешения: местоположение (в т.ч. в фоне) — нужно для трекера и геозон.
Шаг 5. Привяжите приложение к Home Assistant¶
В приложении откройте Настройки:
- HA адрес сервера — адрес HA в формате
host:port, например192.168.1.10:8123. Если порт не указан, подставляется8123(или443при включённом HTTPS). - HTTPS — включите, если HA работает по HTTPS (чекбокс в строке адреса).
- Токен — Long-Lived Access Token из шага 3. Рядом значок
?с подсказкой, как его получить. - Имя автомобиля — точно такое же, как в интеграции (шаг 2). При первом запуске подставляется VVIN автомобиля — замените на своё имя, совпадающее с интеграцией.
- Нажмите Проверить соединение — должно появиться подтверждение.
Подробнее: Настройки.
Шаг 6. Включите передачу данных¶
- На главном экране приложения включите переключатель Отправлять в HA.
- Откройте таблицу телеметрии и отметьте нужные сигналы (галочка в шапке — выбрать/снять все). Неподдерживаемые автомобилем сигналы показываются без галочек — они опрашиваются, но в HA не передаются.
- Через несколько секунд в HA появятся сущности
sensor.<имя_авто>_*.
Шаг 7. Настройте автозапуск и фоновую работу¶
Чтобы приложение работало постоянно:
- В меню приложения выберите пункт автозапуска — откроется системное окно BYD AppStartManagement; разрешите автозапуск DiPlus-to-hass.
- В системных настройках батареи/энергосбережения исключите приложение из оптимизации.
- Для работы при выключенном авто (ACC off) см. Фоновый режим.
Шаг 8. Управление автомобилем (опционально)¶
По умолчанию выключено в целях безопасности. Чтобы разрешить команды из HA:
- Настройки → Управление авто из HA — включите.
- В HA появятся переключатели, числовые поля, списки и кнопки для команд (климат, окна, замки и т.д.).
- Подробнее: Управление и Команды.