2024-10-14
108
WH-GM5（展锐）系列抓取模块日志示例
注1：驱动程序和log软件工具找在线技术支持索要
一、资料下载
WH-GM5资料包官网下载链接：http://www.a3photo.net/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 订正内容：初稿
