BLE 日志调试工具 (BLE Log Console)

[English]

BLE Log Console 是乐鑫提供的电脑端工具，可通过 UART（仅限支持 UHCI 的芯片）或 SPI Bridge 实时接收、显示设备内部的 BLE 日志，并将原始数据保存为 .bin 文件。BLE 功能异常、常规控制台日志不足以定位问题，或乐鑫技术支持要求提供调试日志时，可使用该工具采集日志。

采集前，先在目标设备固件中启用 BLE Log，并按下文选择传输方式。完成固件编译、烧录和硬件接线后，再启动 BLE Log Console 接收日志。

工具下载

请从 BLE Log Console 发布页面 下载最新稳定版本。

使用 SPI Bridge 采集日志

重要

SPI Bridge 模式需要额外准备一台独立的 Bridge 设备。目前将运行特定固件的 ESP32-P4 开发板作为 Bridge。Bridge 设备不能与产生 BLE Log 的目标设备为同一设备。

SPI Bridge 将目标设备输出的 SPI 日志转发至电脑，适合日志流量较大的场景。

连接关系如下：

目标 ESP 设备 -> SPI Bridge -> 电脑

固件配置

在产生 BLE Log 的目标设备中启用 BLE Log，并选择 SPI Master DMA 传输方式：

CONFIG_BLE_LOG_ENABLED=y
CONFIG_BLE_LOG_PRPH_SPI_MASTER_DMA=y
CONFIG_BLE_LOG_PRPH_SPI_MASTER_DMA_MOSI_IO_NUM=<GPIO>
CONFIG_BLE_LOG_PRPH_SPI_MASTER_DMA_SCLK_IO_NUM=<GPIO>
CONFIG_BLE_LOG_PRPH_SPI_MASTER_DMA_CS_IO_NUM=<GPIO>

按照实际 GPIO 配置，将目标设备的 MOSI、SCLK 和 CS 分别连接至 SPI Bridge 对应引脚，并确保两个设备共地。有关 SPI Bridge 固件获取、烧录方法和具体引脚连接，请参阅 BLE Log Console 中文用户指南。

启动日志采集

完成固件配置、烧录和硬件连接后：

  1. 启动 BLE Log Console。

  2. 选择上文介绍的传输模式及相应端口。

  3. 设置日志保存目录，然后连接设备。

连接成功后，工具会实时显示解析出的 BLE Log，并将原始日志保存为 .bin 文件。如果界面中的接收数据量和帧数持续增加，且传输速度不为零，通常表示日志采集正常。结束录制时，点击 Stop & Review 或按 q / Ctrl+C。工具写完缓存数据后会显示录制质量报告。

BLE Log Console 录制界面，显示 Stop & Review 按钮

BLE Log Console 录制界面

更多帮助

有关支持的操作系统、界面与命令行操作、录制文件和问题排查，请参阅 BLE Log Console 中文用户指南。

如果本页配置示例不适用于现有工程，或无法确定传输方式及接线，请参阅 BLE Log 配置指南。如仍需协助，请联系乐鑫技术支持，并提供目标芯片、ESP-IDF 版本和相关配置。

此文档对您有帮助吗？