Огляд T-Box
T-Box — опційний апаратно-програмний компонент BYD EV Pro. Репозиторій прошивки ev-pro-tbox містить BLE, Cloud, modem, GPS, proximity, OTA, diagnostics і модулі command-dispatcher. Ця документація описує перевірену поведінку програмного забезпечення; затверджене продуктом пакування обладнання та інструкції встановлення ще відкриті.
Що додає T-Box
Section titled “Що додає T-Box”Підтверджено кодом:
- BLE-сполучення/provisioning з Car App.
- Cloud-з’єднання і командні topics для конкретного пристрою.
- Публікація стану, даних, логів та інформації T-Box.
- GPS через modem GPS module.
- BLE-сканування наближення, фільтрація RSSI, перевірка HMAC-токенів, challenge/response і логіка дій блокування/розблокування.
- Підтримка OTA-оновлення прошивки, зокрема BLE OTA з Car App і Cloud OTA modules.
- Діагностичне логування і публікація логів через Cloud.
Що працює без T-Box
Section titled “Що працює без T-Box”- Панель Car App і локальні елементи керування, поки головний пристрій працює.
- QR-сполучення Companion App у режимі без T-Box.
- Webhook push-оновлення Home Assistant від Car App.
Що потребує T-Box
Section titled “Що потребує T-Box”- Автоматичне блокування/розблокування за наближенням.
- GPS breadcrumbs/state T-Box.
- Маршрутизація команд T-Box через
tbox/cmd/.... - Доставка оновлень прошивки для T-Box.
- Діагностика та логи T-Box.
Вимоги перед setup
Section titled “Вимоги перед setup”- Затверджені продуктом інструкції з фізичного встановлення, живлення, проводки, запобіжника і розміщення.
- T-Box з живленням, який рекламується через BLE з назвою на кшталт
EVP-tbox-XXXXXX. - Доступ Car App до реле, щоб створити Cloud-облікові дані для конкретного пристрою.
- BLE-доступ між Car App/головним пристроєм і T-Box під час provisioning та BLE OTA-оновлень.
- Підтверджений cellular/SIM/eSIM або інший мережевий шлях для Cloud/GPS через modem.
TODO: Product clarification needed — Which T-Box hardware revision, connector, power input, fuse rating, placement, and safety limits should public docs require before setup?
Сполучення і provisioning
Section titled “Сполучення і provisioning”Майстер сполучення Car App сканує Bluetooth-пристрої з назвами на кшталт EVP-tbox-XXXXXX. Він виводить ідентифікатор tbox-XXXXXX, створює Cloud-облікові дані для конкретного пристрою через реле, надсилає спільний секрет і облікові дані у T-Box через BLE, потім чекає перезавантаження T-Box і повторної ідентифікації.
Якщо Cloud-облікові дані не можна створити, майстер завершується помилкою замість fallback на старі compiled credentials.
З’єднання
Section titled “З’єднання”У прошивці є модулі modem PPP, Cloud, WebSocket і GPS. Публічна документація не має обіцяти SIM-карту в комплекті, конкретного мобільного оператора або політику тарифного плану користувача без підтвердження комплектації.
TODO: Product clarification needed — Does the shipped T-Box include a SIM/eSIM and data service, and what should users do if cellular service is unavailable?
Індикатори стану
Section titled “Індикатори стану”Поточний led_status.c каже, що T-Box v2 не має status LED on board, а LED API залишений no-op. Старі чернеткові таблиці блимання LED не валідні для обладнання v2.
TODO: Product clarification needed — Are there any user-visible indicators on shipping T-Box hardware besides app-reported status?
Оновлення прошивки
Section titled “Оновлення прошивки”Car App має сценарій T-Box OTA: перевіряє оновлення, завантажує прошивку, перевіряє SHA-256, передає фрагменти через BLE, чекає підтвердження встановлення і обробляє стан перезавантаження/повторного підключення.
Встановлення
Section titled “Встановлення”TODO: Product clarification needed — What physical installation, wiring, fuse, and placement instructions are approved for public documentation?
Поки це не уточнено, ця сторінка описує тільки поведінку програмного забезпечення, підтверджену репозиторієм.