mirror of https://github.com/espressif/esp-idf.git synced 2026-09-22 13:01:16 +03:00

Files

Zhou Xiao d51892380b change(bt/ble_log): remove BLE Log UHCI Out module

Delete ble_log_uhci_out.c and its header. Remove the UHCI Out source
from CMakeLists.txt and all BT_BLE_LOG_UHCI_OUT_* Kconfig options.
Remove per-chip BT_LE_CONTROLLER_LOG_UHCI_OUT_ENABLED Kconfig and
all UHCI Out caller references in esp32c5/c6/h2 controller bt.c.
Update ble_log_console README to reference the new BLE Log Module
UART DMA config. The functionality is superseded by the BLE Log
Module's UART DMA peripheral transport.

2026-03-20 16:01:35 +08:00

ble_log_console.py

feat(ble): added ble log console for ble log uhci out

2025-08-08 12:01:43 +08:00

README.md

change(bt/ble_log): remove BLE Log UHCI Out module

2026-03-20 16:01:35 +08:00

README.md

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_BLE_LOG_PRPH_UART_DMA is enabled for the purpose of capturing BLE logs.

Usage

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 when CONFIG_BLE_LOG_PRPH_UART_DMA 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)