Быстрый старт¶

Полная установка занимает 15–20 минут.

Car2Hass универсален: приложение стартует само и само определяет, какие источники данных доступны на устройстве (ADB, DiPlus, OBD, системные датчики). DiPlus нужен только если вы хотите канал BYD/DiLink — на BYD без него не будет основного потока CAN-данных.

Шаг 1. (Для BYD DiLink) Установите DiPlus на головное устройство¶

Приложение DiPlus — один из поддерживаемых источников данных (канал BYD CAN). Для других автомобилей/источников этот шаг пропустите.

Скачайте 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 Car2Hass — BYD Vehicle Telemetry и нажмите Download.
Перезапустите Home Assistant.

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

Способ B. Вручную (без HACS)¶

Скачайте cartelemetry-v3.3.11.zip и распакуйте.
Скопируйте папку custom_components/cartelemetry в /config/custom_components/.
```
cp -r custom_components/cartelemetry /config/custom_components/
```
Обновление с предыдущей версии

Сначала полностью удалите старую папку /config/custom_components/cartelemetry/, затем копируйте новую. Перезапись поверх оставляет смешанный набор файлов и приводит к ошибкам импорта при запуске.
Перезапустите Home Assistant.

Добавление интеграции¶

Настройки → Устройства и службы → Добавить интеграцию → найдите Car2Hass — BYD Vehicle Telemetry.
Введите имя автомобиля (латиницей, без пробелов — например, BYDSongPRO). Оно станет префиксом всех сущностей.

Анонимная связь с сайтом

Интеграция один раз в сутки отправляет на mytechnic.ru анонимный запрос (без личных данных) для подсчёта числа установок. Если ваш HA не имеет доступа к сайту — запрос молча пропускается.

Шаг 3. Создайте Long-Lived Access Token¶

В HA откройте профиль пользователя (внизу слева) → раздел Long-Lived Access Tokens.
Создайте токен с понятным именем (например, diplus-car) и скопируйте его — он показывается один раз.

Шаг 4. Установите приложение Car2Hass¶

Скачайте car2hass-v3.3.11.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; разрешите автозапуск Car2Hass.
В системных настройках батареи/энергосбережения исключите приложение из оптимизации.
Для работы при выключенном авто (ACC off) см. Фоновый режим.

Шаг 8. Управление автомобилем (опционально)¶

По умолчанию выключено в целях безопасности. Чтобы разрешить команды из HA:

Настройки → Управление авто из HA — включите.
В HA появятся переключатели, числовые поля, списки и кнопки для команд (климат, окна, замки и т.д.).
Подробнее: Управление и Команды.

Что дальше¶

Дашборд — соберите главный экран из плиток.
Правила — автоматизации без HA (например, «обдув сиденья при +25 °C»).
Геозоны — автоматизации по местоположению.