Xử lý lỗi kết nối

Checklist quyền, pairing, transport, UUID và trạng thái retry khi HUD không kết nối.

Cấp quyền Thiết bị ở gần, bật Bluetooth, pair module Classic trong phần cài đặt Android và chọn đúng địa chỉ thiết bị trong picker.
Xác nhận transport đã chọn khớp với firmware. ESP32 chỉ hỗ trợ Classic không thể kết nối bằng BLE; ESP32 BLE-only cũng không thể kết nối bằng SPP.
Kiểm tra foreground notification cùng các preference hud_link_status và hud_link_error.
Với BLE, xác nhận service UUID và hai characteristic UUID TX/RX khớp tuyệt đối với ANDROID_HUD_LINK.md.
Chỉ bật log payload tạm thời khi debug vì log chứa dữ liệu điều hướng.
Việc retry lặp lại với PERMISSION_REQUIRED, BLUETOOTH_OFF hoặc No device selected là có chủ đích. Các trạng thái này chờ người dùng/hệ thống xử lý thay vì retry liên tục gây hao pin.

ESP32HLP/1TROUBLESHOOTING.md

Checklist quyền, pairing, transport, UUID và trạng thái retry khi HUD không kết nối.

Cấp quyền Thiết bị ở gần, bật Bluetooth, pair module Classic trong phần cài đặt Android và chọn đúng địa chỉ thiết bị trong picker.
Xác nhận transport đã chọn khớp với firmware. ESP32 chỉ hỗ trợ Classic không thể kết nối bằng BLE; ESP32 BLE-only cũng không thể kết nối bằng SPP.
Kiểm tra foreground notification cùng các preference hud_link_status và hud_link_error.
Với BLE, xác nhận service UUID và hai characteristic UUID TX/RX khớp tuyệt đối với ANDROID_HUD_LINK.md.
Chỉ bật log payload tạm thời khi debug vì log chứa dữ liệu điều hướng.
Việc retry lặp lại với PERMISSION_REQUIRED, BLUETOOTH_OFF hoặc No device selected là có chủ đích. Các trạng thái này chờ người dùng/hệ thống xử lý thay vì retry liên tục gây hao pin.