Налаштування Home Assistant

Інтеграція BYD EV Pro для Home Assistant — кастомна інтеграція в ev-pro-ha-integration. Вона реєструє webhook, створює сенсорні сутності і device tracker та приймає телеметрію, яку надсилає Car App.

Що створює інтеграція

Інтеграція визначає сенсори для батареї, температури, руху, заряджання, клімату, доступу, вікон/даху, TPMS, підігріву керма, підігріву сидінь і швидкості моторів. Також вона створює GPS device_tracker з даних розташування webhook.

Конкретні сутності отримують значення тільки якщо Car App надсилає відповідні дані для вашого авто.

Передумови

• Home Assistant із встановленим HACS.
• BYD EV Pro Car App встановлений через затверджений продуктом шлях APK і отримує живі дані авто.
• Home Assistant webhook URL доступний з мережі, яку використовує Car App.
• Статус ліцензії дозволяє функцію Home Assistant у Car App.
• Home Assistant може приймати вхідні webhook-запити з мережі авто/головного пристрою. Якщо Home Assistant недоступний з цієї мережі, сутності не оновлюватимуться.

TODO: Product clarification needed — Which license tier names should public docs use for Home Assistant access?

Встановлення інтеграції

README інтеграції документує встановлення через кастомний репозиторій HACS.

1. Відкрийте HACS у Home Assistant.
2. Додайте https://github.com/ant0nkr/ev-pro-ha-integration як кастомний репозиторій типу Integration.
3. Встановіть BYD EV Pro з HACS.
4. Перезапустіть Home Assistant.
5. Перейдіть у Налаштування → Пристрої та служби → Додати інтеграцію.
6. Знайдіть BYD EV Pro.
7. Введіть назву авто.
8. Скопіюйте webhook URL, який показує Home Assistant.
9. Натисніть Надіслати ще раз, щоб завершити налаштування.

Підключення Car App

1. У Car App відкрийте Налаштування → Home Assistant, якщо цей екран доступний у встановленій версії.
2. Вставте webhook URL, згенерований Home Assistant.
3. Опційно: введіть однаковий секрет webhook у параметрах інтеграції Home Assistant і в Car App.
4. Увімкніть sync.
5. Використайте дію перевірки з’єднання у Car App, якщо вона доступна.

Коли секрет webhook налаштований, Home Assistant перевіряє HMAC-SHA256-заголовок X-Webhook-Signature і відхиляє недійсні запити.

Голосові дії

Параметри інтеграції можуть зберігати довготривалий токен і список дій сценаріїв з українськими та англійськими голосовими фразами. Webhook-відповідь може повернути цю конфігурацію дій у Car App, але точний користувацький сценарій налаштування в Car App ще не задокументований тут.

TODO: Product clarification needed — What exact Car App voice-action setup flow should be documented after actions are configured in Home Assistant?

Усунення проблем

Сутності не оновлюються

• Переконайтеся, що Car App запущений і Home Assistant sync увімкнений.
• Переконайтеся, що webhook URL доступний з мережі авто/head unit.
• Якщо використовується секрет webhook, переконайтеся, що обидві сторони мають однаковий секрет.
• Перевірте журнал Home Assistant на invalid_signature, invalid_json або невідомі помилки webhook.

Device tracker порожній

Device tracker оновлюється тільки коли payload webhook містить дані розташування.