Чекліст онбордингу

Використовуйте цей чекліст, щоб не змішувати Car App, Companion App і опційний T-Box.

1. Підтвердьте шлях встановлення Car App

1. Підтвердьте затверджене продуктом джерело APK і шлях sideloading для DiLink.
2. Встановлюйте тільки з цього підтвердженого джерела.
3. Відкрийте BYD EV Pro на головному пристрої DiLink.
4. Тримайте головний пристрій активним, доки з’являться живі дані авто.
5. Переконайтеся, що застосунок може дістатися реле, перш ніж використовувати ліцензії, сполучення, Telegram або віддалені функції.

TODO: Product clarification needed — What exact public Car App installation instructions should be documented for end users?

2. Запустіть або відновіть ліцензію

Поточний код реле і Car App підтримує явний 14-денний пробний період рівня app. Ліцензія перевіряється через Cloud, кешується з HMAC-підписом, а перевірки функцій fail closed, якщо остання успішна перевірка реле була понад 72 години тому.

1. Відкрийте ліцензійний розділ Car App.
2. Використовуйте дію запуску пробного періоду тільки для нового авто/інсталяції, які мають право на пробний період.
3. Використовуйте відновлення/перевірку для наявної ліцензії.
4. Переконайтеся, що статус ліцензії trial або active, перш ніж налаштовувати ліцензовані функції.

Обережно

Старі чернетки документів згадували 31-денний пробний період і 24-годинний пільговий період. Поточний код показує 14 днів пробного періоду і 72-годинне пільгове вікно у Car App.

3. Вирішіть, чи потрібен T-Box

Пропустіть T-Box, якщо потрібні тільки функції Car App під час роботи головного пристрою, сполучення Companion App у режимі без T-Box і push-оновлення Home Assistant від запущеного Car App.

Додайте T-Box, якщо потрібні автоматичне блокування/розблокування за наближенням, T-Box GPS, стан T-Box, OTA-оновлення прошивки або Cloud-команди, які виконує T-Box.

4. Сполучіть T-Box, якщо він є

Перед сполученням публічній документації ще потрібні затверджені продуктом вимоги до фізичного монтажу. Мінімально для сполучення потрібні T-Box з живленням, BLE-з’єднання між Car App/головним пристроєм і T-Box та з’єднання з реле, щоб створити Cloud-облікові дані для конкретного пристрою.

1. Переконайтеся, що T-Box має живлення і перебуває достатньо близько для BLE-сполучення.
2. У Car App відкрийте майстер сполучення T-Box, якщо він доступний.
3. Дочекайтеся Bluetooth-пристрою з назвою на кшталт EVP-tbox-XXXXXX.
4. Виберіть відповідний пристрій і підключіться.
5. Дочекайтеся, поки Car App створить Cloud-облікові дані для пристрою і передасть спільний секрет через Bluetooth.
6. Дочекайтеся перезавантаження T-Box і повторної ідентифікації.

TODO: Product clarification needed — What physical T-Box power, wiring, placement, and safety checks must be completed before users start BLE pairing?

Після цього майстер пропонує опційний QR-крок для Companion App. Поточна реалізація закриває майстер з цього екрана; вона не переходить сама в повний сценарій сполучення Companion App.

5. Сполучіть Companion App

1. Відкрийте Companion App.
2. Натисніть сценарій сканування QR.
3. У Car App відкрийте QR сполучення/поширення для Companion App.
4. Проскануйте QR у Companion App.
5. Надайте дозволи, які Companion App запитає для вибраного режиму сполучення.
6. Дочекайтеся стану сполучення/головного екрана.

QR-сполучення в режимі без T-Box використовує Cloud. Режими сполучення T-Box також можуть передавати або отримувати секрет наближення для функцій наближення.

6. Налаштуйте Home Assistant, опційно

Home Assistant отримує webhook push-оновлення від Car App. Спочатку встановіть кастомну інтеграцію, скопіюйте її webhook URL, потім вставте URL у налаштування Home Assistant в Car App, якщо цей екран доступний у встановленій версії Car App.

7. Перевірте фінальний стан

• Панель Car App показує живі дані авто.
• Статус ліцензії trial або active для ліцензованих функцій.
• Companion App сполучений і показує стан авто.
• Статус T-Box видно тільки якщо T-Box встановлений і сполучений.
• Сутності Home Assistant оновлюються після webhook від Car App.

TODO: Product clarification needed — Which Telegram setup steps are ready for public user documentation, and which license tier should be described for Telegram access?