BLE Log Console

Introduction

BLE Log Console is a Python utility for capturing and displaying BLE logs from UART DMA output, which is able to

Output normal ASCII logs to console in runtime
Capture binary BLE logs from UART DMA output in background
Live status panel showing data transfer statistics
Automatic detection of frame loss

It would provide users and developers with convenience using this tool when CONFIG_BT_BLE_LOG_UHCI_OUT_ENABLED is enabled for the purpose of capturing BLE logs.

Usage

bash

cd <esp-idf-path>
. ./export.sh
cd tools/bt/ble_log_console
python ble_log_console.py --port <UART_PORT> [--output <OUTPUT_FILE>] [--baudrate <BAUD_RATE>]

Notes

Please check the baud rate of the UART port in menuconfig CONFIG_BT_BLE_LOG_UHCI_OUT_ENABLED is enabled. It's recommended to set the baud rate to 921600 or higher to avoid BLE log frame loss.

Arguments

--port (mandatory): The UART port to connect to (e.g., /dev/ttyUSB0 on Linux or COM3 on Windows)
--output (optional): Output filename for binary capture (default: uart_data.bin)
--baudrate (optional): Baud rate for UART communication (default: 115200)