DiPlus-to-hass: интегрируем BYD в Home Assistant

Итак, я всё-таки получил то, чего мне так долго хотелось, — а именно интеграцию своего BYD Song PRO в Home Assistant. Теперь можно настраивать автоматизации: как в доме (по событиям и состоянию авто), так и в самом авто менять настройки и автоматизировать то, о чём раньше только мечтал — пока через HA, но в будущем допилю Tasker прямо в программе-компаньоне на вашем авто. Об этом — чуть позже.

Главный экран Home Assistant с устройством BYD Song PRO и списком сенсоров

Скриншот 1: устройство BYD в Home Assistant

Что мы имеем?

Неудержимое желание получить телеметрию вашего авто в умном доме.
Автомобиль BYD с корректно установленным DiPlus (желательно версии 1.3.8-beta18 или новее) и активированным ADB.
Умный дом на базе Home Assistant и доступ к папке custom_components.
Флешку и возможность установить программу на головное устройство (ГУ) авто. Соответственно, DiPlus уже должен быть установлен.

DiPlus (com.van.diplus) — это приложение на ГУ BYD, которое предоставляет локальный HTTP API на адресе 127.0.0.1:8988. Без него DiPlus-to-hass работать не будет.

Что умеет интеграция?

Передаёт более 130 сигналов авто: скорость, SOC, пробег, давление в шинах, температуры батареи и салона, двери, замки, свет, ADAS и другие.
Отправляет GPS-координаты автомобиля в HA как device_tracker.
Позволяет управлять авто из HA: включать климат, менять температуру, закрывать окна, открывать багажник и многое другое (включается отдельно в настройках).
Работает в фоне и автозапускается при старте ГУ, кратковременно показываясь и сворачиваясь.
Поддерживает русский и английский языки.
Позволяет выбрать, какие сигналы отправлять в HA, прямо на главном экране — с сортировкой и выбором всех.
Ведёт подробный лог команд и ответов DiPlus с ротацией и экспортом.

Пример панели Home Assistant с сенсорами BYD: SOC, скорость, пробег, давление в шинах

Скриншот 2: пример сенсоров в HA

Порядок установки

1. Установите интеграцию Home Assistant

Скачайте архив diplus2hass.zip с сайта teplitzky.ru/diplus2hass.
Распакуйте его. Внутри будет папка custom_components/diplus2hass.
Скопируйте её в конфигурацию HA:
cp -r custom_components/diplus2hass /config/custom_components/
Перезапустите Home Assistant.
Перейдите в Настройки → Устройства и службы → Добавить интеграцию и выберите DiPlus-to-hass — BYD Vehicle Telemetry.
Введите имя автомобиля, например BYDSongPRO. Это же имя позже укажете в приложении.

Окно добавления интеграции DiPlus-to-hass в Home Assistant

Скриншот 3: добавление интеграции в HA

Важно: имя автомобиля в интеграции HA и в Android-приложении должны совпадать. Иначе сенсоры не появятся.

2. Установите DiPlus-to-hass на ГУ с флешки

Скачайте DiPlus-to-hass.apk с сайта teplitzky.ru/diplus2hass на компьютер.
Скопируйте файл DiPlus-to-hass.apk в корень USB-флешки.
Вставьте флешку в USB-порт головного устройства BYD.
На ГУ откройте файловый менеджер (или приложение "Проводник" / "File Manager").
Найдите флешку, откройте папку с APK и нажмите на файл DiPlus-to-hass.apk.
Система предложит установить приложение. Нажмите Установить. Если появится предупреждение об установке из неизвестных источников, разрешите установку для файлового менеджера.
После установки откройте приложение и разрешите все запрошенные разрешения (местоположение, уведомления, автозапуск).

Главный экран приложения DiPlus-to-hass с телеметрией авто

Скриншот 4: главный экран приложения

3. Настройте подключение к Home Assistant

В приложении нажмите ⚙ → Настройки.
Укажите:
- Адрес сервера — домен или IP Home Assistant.
- Порт — обычно 443 для HTTPS или 8123 для HTTP.
- Long-Lived Access Token — токен из профиля пользователя HA.
- Имя автомобиля — точно такое же, как в интеграции HA.
Включите HTTPS, если HA работает по HTTPS.
Вернитесь на главный экран и включите переключатель Отправлять в HA.
При необходимости включите Управление авто из HA — тогда интеграция сможет отправлять команды в DiPlus.

Экран настроек DiPlus-to-hass с полями сервера, порта, токена и имени авто

Скриншот 5: настройки подключения к HA

Получение токена: в HA откройте профиль пользователя (левый нижний угол) → раздел Long-Lived Access Tokens → Создать токен. Скопируйте его сразу — повторно HA не покажет.

4. Настройте автозапуск и фоновую работу

В меню приложения откройте Настройки → Автозапуск (BYD).
В системном окне (список запрета автозапуска приложений) уберите галочку напротив DiPlus-to-hass, чтобы разрешить ему автозапускаться.
Откройте Фоновая работа и добавьте приложение в белый список.

После перезагрузки ГУ приложение кратковременно появится на экране и свернётся — так оно надёжнее удерживается в фоне.

5. Выберите сигналы для передачи

На главном экране в таблице телеметрии отметьте галочками те сигналы, которые нужны в HA. Чекбокс в шапке выбирает или снимает все сразу, а клик по заголовкам столбцов сортирует таблицу. Фильтр сохраняется автоматически.

6. Включите управление авто из HA (опционально)

Если хотите управлять климатом, окнами и другими функциями прямо из Home Assistant, откройте ⚙ → Настройки и включите Управление авто из HA. По умолчанию эта опция выключена для безопасности.

Вкладка Команды в приложении DiPlus-to-hass: список категорий команд и журнал отправки

Скриншот 8: вкладка команд в приложении

7. Логирование и диагностика

Для отладки включите Писать подробный лог в настройках. Лог хранится в памяти, автоматически ротируется при превышении 5 МБ и может быть экспортирован в Downloads с именем, содержащим дату и время.

Системное окно автозапуска приложений BYD с разрешением для DiPlus-to-hass

Скриншот 6: настройка автозапуска

Как это выглядит в Home Assistant?

После первой отправки данных в HA появится устройство с сенсорами, бинарными сенсорами и трекером. Можно строить автоматизации:

Если SOC < 20% — отправить уведомление "пора заряжаться".
Если дверь открыта — включить свет в гараже.
Если температура за бортом > 25 °C — включить вентиляцию сидений.

Карта Home Assistant с местоположением автомобиля и сенсорами рядом

Скриншот 7: карта с трекером авто

Сущности управления автомобилем в Home Assistant: переключатели климат-контроля, селекты режимов сидений и кнопки

Скриншот 9: сущности управления авто в HA

Что делать, если что-то не работает?

"diplus not responding" — убедитесь, что DiPlus запущен на ГУ.
Нет сенсоров в HA — проверьте, что имя авто в приложении совпадает с именем в интеграции, и что включён переключатель Отправлять в HA.
Нет координат на карте — проверьте разрешение на местоположение и наличие GPS/сетевой геолокации.
Данные не обновляются в фоне — проверьте автозапуск, разрешение на фоновую работу и оптимизацию батареи.
Команды из HA не работают — проверьте, что в настройках включено Управление авто из HA.
Нужна диагностика — включите Писать подробный лог в настройках и экспортируйте лог через кнопку Экспорт лога.

Планы развития

В ближайших версиях планируется добавить автоматические действия по правилам прямо в приложении. Например: если температура за бортом выше 25 °C, автоматически включать обдув сидений на 100% на местах, где сидят пассажиры.

Скачать

diplus2hass.zip — интеграция Home Assistant v1.7.0
DiPlus-to-hass.apk — Android-приложение v1.7.0

Поддержка и обсуждения — в Telegram: @BYDiPlus2HASS.

Отказ от ответственности. Все действия с программным обеспечением, настройками автомобиля и системой Home Assistant вы выполняете исключительно на свой страх и риск. Авторы не несут ответственности за возможные повреждения оборудования, изменение настроек автомобиля или потерю данных.