docs(ble): update bridge docs and troubleshooting

This commit is contained in:
Zhou Xiao
2026-05-09 16:13:08 +08:00
parent 38fad3e7cb
commit 19b09de9fe
4 changed files with 32 additions and 11 deletions
@@ -136,7 +136,7 @@ This affects BLE GATT write behavior only. It does not create an application-lev
Use the [BLE UART Service example](../../../../examples/bluetooth/ble_uart_service) when you want a ready-made ESP-IDF Echo Server for testing BLE UART Bridge Console. After building, flashing, and pairing with the example, open Console and type any text; the example should echo the same data back as `[RX]` output.
```bash
# List nearby BLE UART devices and use the printed device ID as DEVICE_ID
# List nearby BLE devices and use the printed device ID as DEVICE_ID
python main.py list-devices
python main.py console AA:BB:CC:DD:EE:FF
```
@@ -190,6 +190,14 @@ aa 55 01 00
- Make sure no other host is already connected to the BLE device.
- Restart advertising on the device.
- Run `connection-check` before opening the console.
- On Linux, reset the system Bluetooth service if connections keep failing,
pairing gets stuck, or service discovery cannot find the BLE UART service or
characteristics:
```bash
sudo systemctl stop bluetooth
sudo systemctl start bluetooth
```
### Text looks broken