通博TBET

WH-GM5（展锐）系列抓取模块日志示例

注1：驱动程序和log软件工具找在线技术支持索要

一、资料下载

WH-GM5资料包官网下载链接：http://www.ybljg.com/Download/1283.html

（包含硬件设计手册、说明书、AT指令集、设置软件）

二、硬件连接

1、所需物品

WH-GM5产品1台

5V/12V电源适配器1个

天线1根

USB线1条

笔记本电脑1台

2、硬件连接

WH-GM5TF-CT-4-N40底板上的USB串口接USB串口线到电脑USB口，然后产品接5V/12V电源适配器上电。

EVK硬件连接框图：

若自己设计底板未引出USB口，则需要把USB线（只能传输数据的USB线）剪开，进行飞线。

飞线硬件连接框图：

三、产品参数设置

1、驱动安装

打开文件夹WH-Cat.1_Series_，根据电脑系统双击安装驱动，例如，若电脑是win10/win11 64位操作系统，则运行\WH-Cat.1_Series_\DriversForWin10\DPInst64.exe，按照默认选项安装驱动，执行完毕后点击“完成”。

注意：安装驱动之前，关闭电脑防火墙、杀毒软件

2、microUSB数据线连接电脑和网关，打开电脑设备管理器，看到识别到如下8个port的显示，即驱动安装成功。

四、功能调试

1、软件介绍

Coolwatcher是绿色软件，无需安装，将压缩包解压到某个子目录下即可使用。

2、调整网关log输出口

使用串口调试助手打开port0，然后发送AT指令AT^USRFCTRACE=0,1,2 返回OK之后发送指令AT+TRB重启网关。注意指令末尾加回车换行。

3、启动软件

双击打开coolwatcher_usb.exe，配置页面如下图所示，左侧选择8910，右侧信息修改lastcomport选项内容为实际对应的port4的com编号，例如，设备管理器中显示port4对应的是com158，则这里就填158，其他保持默认即可，点击OK。

4、抓取log

①启动tracer

点击OK后，进入coolwatcher 主界面，主界面包括：菜单栏、工具栏、log 打印区、HW Library 显示树、SW Library 显示树，寄存器查看区，Buffer 读取区等功能区域。我们抓log常用的就是tracer。点击菜单 Plugins->Activate Tracer，如下图显示界面。

工具栏各按钮分别对应：开始 Trace、停止、清空、设置 TraceLevels、Reapply trace levels、保存、启动/关闭 Received 列、启动/关闭 comment。

各列分别对应：Trace 序列号、PC 接收 Trace 时间、Tick、Level、描述等。

②Tracer菜单

一般保持默认就够用了

Start Tracer：开始；

Stop Tracer：停止；

Clean Trace：清空 Trace 表格；

Clean Search：清空 Search 记录；

Show/Hide …：显示或隐藏 tracer 主操作界面相关功能列；

Set Trace Levels：设置 Trace Levels；

Reapply Trace Levels：重新应用 Trace Levels； Reload DB：重新加载 DB 文件；

LoadSettings：加载 Levels 配置；

SaveSettings：保存 Levels 配置；

Load TFG：加载 tfg 文件；

Save TFG：选择保存 T 卡 Trace 文件；

Load bin: 加载二进制 Trace；

Save Trace（bin/trc）：保存 trace。目前保存的 trc 格式有些变化，加了是否采用的 TRACE ID，可以帮助检查没有使用 TRACE ID 的情况。

③Tracer应用

点击设置按钮，勾选save pcap后点击OK，然后点击开始按钮，软件就会自动抓取网关的网络包。

5、保存log

Log自动保存在与coolwatcher_usb.exe同路径下的logs文件夹中，logs文件夹下的cap则是保存的抓取的网络包，log抓取过程中要覆盖到问题复现的全部过程，抓取完毕后，将对应时间段的所有log文件打包提供给研发分析即可。

五、抓cplog

1、调整log口

使用串口调试助手打开port0，发送指令AT^USRFCTRACE=1,1,5，返回OK之后发送指令AT+TRB重启网关。注意指令末尾加回车换行。

2、抓取log

①运行软件

双击运行路径ArmTracer_V6.2.4_User\V6.2.4_User下的ArmTracer.exe文件

②选择正确的com

如下图所示点击按钮，然后选择设备管理器中port3对应的com口，例如设备管理器中检测到的port3对应的是com157，这里就选择com157，然后点击OK。

③选择log保存的位置

点击按钮，然后选择log文件保存的位置，选择好之后点击OK。

3、保存log

如上步，点击之后LOG信息开始打印，此时可一直运行模块，（log文件会自动保存）直至问题复现，提交log文件至研发排查。

注：长时间抓取CP侧LOG，会占用大量的计算机内存，抓取时长一天大约消耗20G左右硬盘空间，因此建议电脑上存储CPlog的空间足够大，并且在问题未复现之前，定期清除log文件。

编写人：王玉雪 编写日期：2024-09-19

审核人：金志方 审核日期：2024-10-14

订正版本：V1.0 订正内容：初稿