Сполучення Companion App

Companion App — це ev_pro_companion, Flutter-застосунок для телефону для віддаленого моніторингу й керування авто. Він сполучається через QR-код, який показує Car App.

Передумови

Car App встановлений, підключений до авто, отримує дані авто і може дістатися реле.
Встановлена ліцензія дозволяє доступ Companion App.
Телефон може надати дозвіл камери для сканування QR.
Дозвіл Bluetooth потрібен для шляхів сполучення T-Box і поведінки за наближенням.
Обладнання T-Box потрібне для автоматичного блокування/розблокування за наближенням і доступу через T-Box, коли шлях через головний пристрій недоступний.

TODO: Product clarification needed — What public download channels and minimum Android/iOS versions should be documented for the Companion App?

Що дає сполучення

Підтверджено кодом Companion App:

Стан авто на головному екрані, зокрема батарея/запас ходу/замки, якщо ці дані публікує Car App або T-Box.
Інтерфейс віддалених команд для блокування, розблокування, багажника, віддаленого запуску та сигналізації.
Екрани камер на основі сигналізації WebRTC.
Сповіщення про охорону/безпеку, заряджання, ціль заряду та поїздки.
Віджети головного екрана та швидкі дії іконки застосунку.
Опційна біометрія/код пристрою перед чутливими командами.
Налаштування наближення та BLE advertising, якщо доступний секрет наближення T-Box.

Без T-Box

Companion App може сполучатися в режимі без T-Box через QR з ідентифікатором Car App і токеном сполучення. Цей шлях використовує початкове Cloud-сполучення і не дає автоматичного розблокування за наближенням.

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

З T-Box

Режими сполучення T-Box містять T-Box ID і можуть надати Companion App секрет наближення. Зі сполученим T-Box Companion App може передавати токени наближення через BLE advertising, а T-Box може вирішувати блокування/розблокування за RSSI і логікою challenge/response.

Використовуйте цей режим для автоматичного блокування/розблокування за наближенням і доступу через T-Box. Він все одно залежить від того, чи T-Box встановлений, має живлення, provisioned і підключений згідно із затвердженими продуктом вимогами до обладнання.

Кроки сполучення

Відкрийте Companion App і виберіть сценарій сканування QR.
Відкрийте екран QR для сполучення/поширення в Car App, якщо цей екран доступний у встановленій версії.
Проскануйте QR-код у Companion App.
Надайте дозвіл камери для сканування QR.
Надайте дозволи Bluetooth, якщо цього вимагає режим сполучення або функція наближення.
Дочекайтеся завершення сполучення через реле і переходу Companion App у стан сполучення/головного екрана.

Поведінка наближення

Автоматичне розблокування/блокування за наближенням потребує T-Box. Companion App передає підписаний BLE-токен; T-Box сканує BLE advertisements, відстежує стабільність RSSI, виконує перевірки challenge/response і запускає GPIO-дії блокування/розблокування через proximity engine.

TODO: Product clarification needed — What default proximity distance/sensitivity values should be documented for end users?

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

QR не сканується

Переконайтеся, що Companion App має дозвіл камери.
Згенеруйте новий QR у Car App.
Тримайте екран QR у Car App відкритим, поки сполучення завершується.

Сполучення відхилено

Companion App перетворює помилки реле pair_rejected на текст для користувача. Типові причини: помилки ліцензії/прав доступу, застарілі токени сполучення або забагато сполучених Companion App.

TODO: Product clarification needed — What exact public messages should be documented for each relay pairing rejection reason?

Наближення не працює

Переконайтеся, що T-Box сполучений і видимий у Companion App.
Переконайтеся, що QR сполучення містив дані T-Box, або повторіть сполучення після додавання T-Box.
Переконайтеся, що дозволи Bluetooth на телефоні залишаються увімкненими.
Переконайтеся, що T-Box встановлений, має живлення і перебуває в межах затвердженої продуктом дальності наближення.