蓝牙 - TI工具 Bluetooth Logger

本文介绍了TI蓝牙调试工具，用来抓取和分析蓝牙固件的日志信息，还有CC256x双模蓝牙设备的协议事务(protocol  transactions)，并同时支持WL18xx WiLink™8通信设备。使用BT Logger和Link Quality Monitor（LQM）工具，就可以对BT Controller的内部数据和状态进行观察，以及与对端设备的协议事务信息。

需求

硬件需求：

- 引出WL18xx设备的BT_UART_DBG pin或CC256x设备的TX_DBG pin.

- UART-to-USB的串口转USB工具，将UART Debug pin连接到PC。

BT_UART_DBG/TX_DBG引脚是一个1.8V的UART TX引脚，使用921600的波特率。

所以它应该连接到1.8V的UART-to-USB转换器的RX引脚，并且UART-to-USB转换器应该与BT控制器共地。

可以使用的转换器：FTDI Chip™ TTL-232RG-VREG1V8-WE，官网：USB TTL Serial Cable Series - FTDI 

软件需求：

- BT Logger和LQM应用软件，这两个应用是WiLink Wireless Tools package的一部分。

下载路径： WILINK-BT_WIFI-WIRELESS_TOOLS Application software & framework | TI.com

安装路径：C:\Program Files (x86)\Texas Instruments\Wireless Tools

- ILI和XML的配置文件。CC2564C的最新的配置文件： CC256XC-BT-SP Driver or library | TI.com

安装

BT logger程序：

LQM程序：

TI Logger

此logger程序有两个端口：

- BT Logger 1：所有的固件操作记录都在这个端口下捕获。

- HCI/LMP viewer 1：所有的协议事务信息（protocol transaction message）都在这个端口下捕获。

注意：为了捕捉完整的日志，这两个端口的信息都要捕获并保存。

设置方法：

1,打开程序，主工作窗口如下：

2,在菜单栏里点开设置选项。

显示设置对话框：

3,选择BT Logger 1，进行设置。

4,在设置对话框里，选择TI BT controller的BT_UART_DBG/TX_DBG引脚所连接的COM端口

注意：请确保COM端口号小于50，否则需要在PC的控制面板里修改端口号数值。

5,按下图对COM port进行设置，然后点击OK。

6,在设置对话框的Mapping Files部分，点击Add File，选择与BT controller相对应的*.ili文件。

这个文件在上面的软件需求里提到过。

注意：应保证只有一个*.ili文件处于选中状态。

7,点击OK应用所用对BT Logger 1的设置的改动。

下一步，对HCI/LMP viewer port进行设置。

8,类似的，选择HCI/LMP viewer 1，然后点击设置。

9,设置串口选项。

10,选择添加文件，即上面的软件需求中提到的*.xml文件。

注意：处于选中状态的*.xml文件只能有一个。

11,点击OK应用对HCI/LMP view port所进行的所有改动。

12,检查设置，如下图：

注意：如果COM port number没有显示，重新勾选两个端口，来加载COM port的设置。

13, 点击OK应用所有设置的改动，关闭Logger的设置对话框。

抓Log / Capturing the Logs

1,设置完成后，在菜单中选择Show All Items关闭所有已经设置的过滤器。

2,蓝牙设备上电，并开启BT controller。一个初始化序列信息就能在Logger中查看到。

3,可以将log保存称*.lgr文件。

如果抓取了很长时间的log，比如几小时，那较好的实践方法时，打开自动保存和清除功能。这样防止单个的log文件过大，不利于分析log。

设置方法如下：

在选项里找到并打开自动保存功能。

设置好相关参数后点击OK。

注意：当log抓取停止时，最后剩下的log需要手动保存，使用菜单中的File->Save As。

分析log

保存下来的log文件，可以用Logger程序在新窗口中再打开，使用File->Open。

Logger中有一些功能可以帮助我们更好的分析log。

第一个：视图过滤器 / View Filter

在log中，可以根据条件来筛选感兴趣的log内容。

打开View->Settings窗口，在下面的“Criteria”栏，选择View Filter。

在Text栏里面输入字符串就会显示只包含这个字符串的log，还可以根据右边的提示，输入多个条件。

Port里也可以输入条件，可以输入字符串来选择BT Logger 1或HCI/LMP viewer 1。

在Text栏里输入“--”, 这是个宏，可以只显示HCI/LMP viewer的记录。

然后点击Apply应用改动。

第二个，高亮。

可以将满足条件的记录高亮显示。

在设置对话框里的"Criteria"里，选中一个Hightlight Color，然后再输入条件，点击Apply，就能按照此栏的设置按颜色显示符合条件的log记录。

在右侧的Color部分，还能调整高亮显示的颜色，包括前景色和背景色，以及字体。

切换log等级 / Toggling Log Levels

每个日志追踪都有一个特定的日志级别。切换日志级别可以用来快速的应用在视图过滤器中。

在设置对话框的条件栏，里面的Level栏，输入1-10的某个数字，或者一个范围（比如2-3），就可以过滤相应log level的日志。

类似的，前面的Log #栏，可以用来过滤具体的日志记录的编号。

标签和注释

可以给某条日志中添加标签，用来快速浏览和切换关注的日志条目。

也可以给日志条目添加注释，添加了注释的条目也作为标签看待。

在Bookmarks/Comments菜单栏里可以操作，有Toggle Bookmark和Edit Comment命令。

注意：使用F2和Shift+F2快捷键，可以快速的跳到前一个或后一个标签点。

查找功能

使用Edit->Find（Ctrl+F）功能，可以在日志中查找内容。

时间锚定 / Time Anchor

可以锚定某一条日志记录，然后更新每条记录的时间为相对时间。

先要确保View->Show Relative Time选项是打开的。

操作方法是，右键点击某条记录，选择Edit->Set Time Anchor.

参考：

User's Guide SWAU058D–December 2008–Revised May 2018 (swau058d.pdf)