Windows Log 抓取指南_Rev1.0

English

修订记录

版本	日期	作者	修订内容
Rev1.0	2026-04-25	ljz	创建文档

1 引言

本文档介绍系列模组 windows 环境下如何使用上位机工具抓取 LTE-EC71X 系列模组的运行日志，用于协助用户及工程师分析模组运行状态、现网表现及排查异常问题。

2 EPAT 简介

• EPAT： EigenComm Platform Analysis Tools。用于抓取和分析EigenComm UE Log，对 UE 进行调试和分析。

• EPAT offline mode： 用于打开 UE log 并显示 log，在 offline mode 下可以启动多个 EPAT 进程，同时打开多 UE log，便于log 之间比较。

• EPAT online mode： 用于捕获 UE log 及 UE 在线状态，在 Online mode 下仅能启动一个 EPAT。

2.1 日志抓取方式选择

根据不同的调试场景，可选择合适的日志抓取方式：

抓取方式	适用场景	说明
串口工具（第4章）	快速查看 APP 层日志、调试应用逻辑	仅能看 APP log，无底包信息
EPAT online（第5章）	排查网络注册、信令交互、底包问题	完整的底包+APP log，实时抓取，需配置数据库文件
EPAT offline	离线分析已保存的 zip log 文件	可同时打开多个 log 对比分析，需提前保存好 log 文件
Wireshark pcap（5.7.5）	深度分析网络协议栈、数据包交互	专业网络分析工具，需从 EPAT 导出

建议：

• 新手入门或简单 APP 调试：使用串口工具（第4章）

• 网络问题、现网测试、需要底包信息：使用 EPAT online（第5章）

• 需要分析网络协议细节：先用 EPAT 抓取，再导出为 pcap 用 Wireshark 分析（5.7.5）

3 环境搭建

3.1 确认日志输出端口

APP 中的log在 LSDK/config/default.ini 确认或修改当前模组输出端口的配置，修改后需要全清编译生效：

功能	指令	说明
输出至 USB AT	appLogPort=0	无
输出至UART2口	appLogPort=1	uart2At需要设置为1
输出至EPAT工具中	appLogPort=3	使用 EPAT.exe

底包中的 log 输出端口通过 logPortSel 参数配置，该参数同样位于 LSDK/config/default.ini 中，修改后需要全清编译生效：

功能	指令	说明
输出至 USB	logPortSel=0	默认配置
输出至 UART	logPortSel=1	无
输出至 MIX	logPortSel=2	预留，UART/USB 动态选择

3.2 准备工作

请准备以下工具和条件：

1. 目标模组（需抓取 log 的设备）；

2. 模组APP中支持三种日志输出方式：

   • USB AT 日志输出（默认）：连接模组 USB 接口，使用串口工具查看，设备管理器中映射的名称为：Lierda At Port；

   • USB Log 日志输出（默认）：连接模组 USB 接口，使用EPAT工具查看，设备管理器中映射的名称为：Lierda Log Port；

   • UART 2 串口输出：默认需连接 AUX_TXD、AUX_RXD、GND 引脚，使用串口工具查看；

3. 上位机日志抓取工具：串口工具或EPAT.exe；

4. 若使用EPAT查看，还需准备对应固件版本的数据库文件（如 LSDK/gccout/[PROJECT]/comdb.txt），若comdb.txt不匹配，可能出现log对应错误的问题，导致定位问题失败。

5. USB驱动安装请参考《USB_Driver_Installation_Guide.md》。

注意：

• 若无 EPAT.exe 工具，请联系技术支持获取；

• 数据库文件需与固件版本匹配。

4 串口LOG抓取

串口工具没有指定要求，打开任意串口工具，根据工具实际使用方式，波特率选择115200，选择 3.2 中配置输出方式对应的端口并打开，即可查看APP的log。

5 EPAT LOG抓取

5.1 启动 EPAT 工具

双击运行 EPAT.exe，工具版本可能不同，如有需要请联系 FAE 获取最新版。

首次打开 EPAT 工具，将弹出选择数据源窗口：

• 选择：Serial Device（串口设备）

• 点击 OK 进入主界面

5.2 连接 UE

5.2.1 设备对话框

点击"串口设置"图标，在弹出的"Device Communication"中点击"Setting"

5.2.2 设置连接参数

选择正确的日志端口（Lierda Log Port），配置波特率（EPAT 默认 3000000）

配置完成后点击 OK 返回主界面

注意：

• 若 USB 端口未枚举，请参考《USB_Driver_Installation_Guide.md》进行驱动安装。

• DBG串口波特率默认3M，可设置为其他波特率，设置后重启生效。

设备管理器中的USB设备

5.2.3 查看连接状态

在 EPAT 状态栏可以查看连接状态。

状态	显示效果
连接成功
未连接
连接失败

5.3 Update DB

5.3.1 查看状态

工具栏的 Database State 按钮有三种状态来表示数据库的匹配状态。

状态	显示效果
UE DB 读取失败
UE DB 不匹配
UE DB 匹配

点击工具栏中的"数据库更新"图标

在弹出窗口中点击 Update，然后选择匹配的comdb.txt文件

5.3.2 更新数据库

在更新数据库界面，手动更新对应的数据库文件

数据库版本更新完成后弹出提示：Databases updated!

更新后，Check DB Version Result 区域显示结果：

• 绿色： 成功且匹配

• 红色： 不匹配

• 灰色： 读取 UE DB 失败

点击 Close 返回主界面

注意：

• 数据库图标中的问号会在成功抓取日志时自动消失。

5.4 Start/Pause/Stop/Clear 功能

5.4.1 Start

表示 Viewer 开始抓取log。

5.4.2 Pause

表示 Viewer 不刷新 log 显示，但继续保存 Log。用于不确定当前的 log 是否已经发现 UE 的故障，仅临时查看一下，log继续写情况下。

5.4.3 Stop

表示 Viewer 不刷新 log 显示，并停止保存 log。用于确认当前的 log 已经想要保存、后面接收的 log 不需要保存的情况下。

5.4.4 Clear

清空 Viewer，并新开 log 文件继续写 log。

5.5 日志抓取

5.5.1 启动日志抓取

点击 5.4.1 中的 Start 按键，开始日志抓取。

日志输出成功后，数据库图标变为绿色表示数据库与模组固件匹配。

5.6 筛选 APP 中的LOG

点击筛选日志图标

先点击All前面的对勾，取消勾选所有log

勾选 CUSTOMER -> LIOT_CUST -> USRTAPP_LOG，点击 Apply 和 OK。

此时log查看界面显示的就是 APP 部分的log。

5.7 日志保存

5.7.1 手动保存日志文件

日志抓取完成后，点击"停止"按钮后，点击"保存"图标，将当前抓取日志保存为 .zip 格式压缩包。

5.7.2 自动保存与分包保存日志文件

为便于长时间测试及问题复现，建议启用日志"分包保存"功能：

• 菜单路径：Log -> Options

• 启用定时或大小分包保存选项

• 若无此功能，请联系支持人员获取最新版工具

在选中 AutoSave Log File 后，Set max file size 中设置文件大小，当 log 文件达到此大小时自动保存到磁盘。在 Save Folder 输入框中指定保存文件的位置。

如果选项 Automatically delete old zip log files 被选中，自动保存的 zip log 文件数量如果超过预设数量的上限，旧的文件会被自动删除。此数量的值默认是 50。

注意：

• 长时间挂测时需设置该参数，若不进行设置日志文件会被保存为一份，时间越长日志文件越大，不利于日志的传输与分析。

5.7.3 保存文本 log

这里有两个选项分别来控制当保存 zip log 文件时，unilog 或者 siglog 是否保存为同名的 csv 或者 text 文件。

如果选中 Saving unilog as csv file when saving zip log，在保存 zip log 文件的同时，当前的 unilog 数据保存为 zip log 文件的相同目录和名字的 csv 文件。

如果选中 Saving siglog as text file when saving zip log，则在保存 zip log 文件的同时，当前的 siglog 数据保存为 zip log 文件的相同目录和名字的文本文件。

5.7.4 删除

选择 Log file 分类下的 Delete 选项，则显示配置页如下图：

选中 Automatically delete old log files 后，本地记录的 log 文件如果超过指定的数量会自动删除旧的文件。此数量由 Number of local files 确定。

5.7.5 转换为 Wireshark 数据包

EPAT 支持将日志转换为 .pcap 格式，供 Wireshark 分析使用：

1. 切换日志窗口到 SigLogger

2. 菜单中选择导出选项

3. 设置保存路径与文件名

4. 使用 Wireshark 打开 .pcap 文件进行数据包分析

5. 通过wireshark工具进行网络数据包分析。这里只举例简单TCP数据业务的收发流程。

5.8 提交日志给 FAE

当需要将日志提交给 FAE 协助分析时，请准备以下材料：

材料	说明
zip log 文件	EPAT 保存的 .zip 日志文件
comdb.txt	与固件版本匹配的数据库文件
复现时间点	问题发生的准确时间（精确到秒），便于 FAE 在 log 中快速定位
问题现象描述	简要说明问题表现、复现步骤、是否必现

注意： 请确保 comdb.txt 与固件版本一致，否则 FAE 侧也会出现日志解析错误。

6 注意事项

1. 使用最新版 EPAT.exe 工具，可联系支持人员确认版本；

2. 数据库文件需与固件匹配，版本不一致会导致日志解析失败；

3. 若 EPAT 异常闪退或无法打开，请结束所有进程，重解压后重新启动；

7 常见问题

7.1 找不到mfc140u.dll

请至钉钉文档查看附件《找不到mfc140u.dll.mp4》

将以下3个文件拷贝到EPAT根目录下：

• 请至钉钉文档查看附件《mfc140u.dll》

• 请至钉钉文档查看附件《vcruntime140.dll》

• 请至钉钉文档查看附件《msvcp140.dll》

7.2 设备管理器中找不到端口

现象： 模组连接 USB 后，设备管理器中看不到 Lierda At Port 或 Lierda Log Port。

排查步骤：

1. 确认 USB 线连接正常；

2. 确认模组已成功上电开机；

3. 确认没有关闭USB功能：LSDK/config/default.ini 中的usbCtrl不为2；

4. 打开设备管理器，查看是否有未识别设备（黄色感叹号）；

5. 若有未识别设备，说明 USB 驱动未安装，请参考《USB_Driver_Installation_Guide.md》安装驱动；

6. 安装驱动后若仍无端口，尝试更换 USB 端口或重启电脑。

7.3 EPAT 中看不到 APP log

现象： EPAT 连接正常且底包 log 可以输出，但看不到 APP 层的日志。

排查步骤：

1. 确认 LSDK/config/default.ini 中 appLogPort=3，只有设置为 3 时 APP log 才会输出到 EPAT；

2. 确认修改后进行了全清编译并烧录了新固件；

3. 确认 EPAT 筛选器中勾选了 CUSTOMER -> LIOT_CUST -> USRTAPP_LOG（参考 5.6 节）；

4. 若筛选器中没有 USRTAPP_LOG 选项，说明 comdb.txt 与固件不匹配，请更新数据库文件。

7.4 EPAT 连接后完全无 log 输出

现象： EPAT 点击 Start 后，底包和 APP log 均无任何输出。

排查步骤：

1. 确认选择的端口是否正确：应选择设备管理器中 Lierda Log Port 对应的 COM 口；

2. 确认波特率是否匹配：EPAT 默认 3000000，若模组侧修改过波特率需保持一致；

3. 确认 LSDK/config/default.ini 中 logPortSel=0（USB 输出），若设置为 1（UART）则 log 不会从 USB 输出；

4. 确认 EPAT 状态栏显示为"连接成功"状态（参考 5.2.3 节）；

5. 尝试重启模组，等待 USB 重新枚举后再点击 Start。