日志调试¶
Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.
日志调试旨在通过记录和分析程序运行时的状态信息，帮助开发者快速定位代码缺陷并排查运行异常。本文档以EG800Z模块为例，使用EPAT工具验证Hello World程序的运行状态。
备注
其他型号模块请使用对应平台的日志工具。
有关EPAT工具的内容，详情请参阅 EPAT工具使用教程 章节。
打开EPAT¶
打开EPAT日志工具，选择“Serial Device”，并点击“OK”。
连接日志端口¶
点击“Device Communication”图标打开设备配置页面。
按照以下步骤配置设备的日志端口：
打开电脑的“设备管理器”界面，展开“端口（COM和LPT）”，并记录“Quectel USB DIAG Port”的端口号。
在EPAT的“Device Selection”界面中，点击“Device 0”右侧的“Settings”选项。
在弹出的“Communications Settings”窗口中，选择 第1步 中记录的端口号。
勾选已配置好的“Device 0”。此时UniLogViewer界面将开始实时滚动输出日志。
日志数据库匹配¶
点击“Database state”图标打开数据库配置窗口：
按照以下步骤配置日志数据库：
在弹出的“State”窗口中，点击“Update”选项。
在新弹出的“CheckVersion”窗口中，点击“...”选项，打开文件选择窗口。
选择与固件版本对应的“comdb.txt”。该文件通常位于项目目录的 qos_build\release\版本号\DBG 路径下。
点击“CheckVersion”界面的“Update”选项以更新数据库文件。
暂停/终止日志输出¶
在“UniLogViewer”选项卡中，点击“Pause”（2）图标暂停或“Stop”（3）图标终止日志记录：
App日志搜索¶
暂停或终止日志输出后，按下快捷键“Ctrl+F”打开日志搜索框。在“Find what”输入框中输入“hello world”。
配置搜索规则：
勾选 Match Case（区分大小写）。
勾选 List All Found Items（列出所有匹配的内容）
点击“Find Previous”，从当前日志向上搜索匹配的日志。
在弹出的搜索结果框中，查看匹配的日志内容。
