# 日志调试

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

日志调试旨在通过记录和分析程序运行时的状态信息，帮助开发者快速定位代码缺陷并排查运行异常。本文档以EG800Z模块为例，使用EPAT工具验证Hello World程序的运行状态。

```{note}
1. 其他型号模块请使用对应平台的日志工具。
2. 请分别点击链接获取所需资源：[驱动](<https://www.quectel.com.cn/download/quectel_windows_usb_drivery_v1-0_cn>) 及 [EPAT](<https://www.quectel.com.cn/download/epat%e6%97%a5%e5%bf%97%e5%b7%a5%e5%85%b7>) 软件。
3. 有关EPAT工具的内容，详情请参阅 [EPAT工具使用教程](<../../开发工具/EPAT工具使用教程/EPAT工具使用教程.md>) 章节。
```

# 打开EPAT

打开EPAT日志工具，选择“**Serial Device**”，并点击“**OK**”。

```{image} images/image_VVNHbnhNeo7aWHxjLmHcHFPgnwb.webp
:width: 671px
:height: 346px
:align: center
```

# 连接日志端口

点击“**Device Communication**”图标打开设备配置页面。

```{image} images/image_KrDObp28AogspGxIiNNcBmY9nMc.webp
:width: 630px
:height: 245px
:align: center
```

按照以下步骤配置设备的日志端口：

1. 打开电脑的“**设备管理器**”界面，展开“**端口（COM和LPT）**”，并记录“**Quectel USB DIAG Port**”的端口号。

2. 在EPAT的“**Device Selection**”界面中，点击“**Device 0**”右侧的“**Settings**”选项。

3. 在弹出的“**Communications Settings**”窗口中，选择 **第1步** 中记录的端口号。

4. 勾选已配置好的“**Device 0**”。此时UniLogViewer界面将开始实时滚动输出日志。

```{image} images/image_Q4YpbqivZoglg2xyYVfcrPP1njh.webp
:width: 834px
:height: 618px
:align: center
```

# 日志数据库匹配

点击“**Database state**”图标打开数据库配置窗口：

```{image} images/image_GBRvbOH6zocvCXx4Pk2cLPTDnbf.webp
:width: 508px
:height: 229px
:align: center
```

按照以下步骤配置日志数据库：

1. 在弹出的“**State**”窗口中，点击“**Update**”选项。

2. 在新弹出的“**CheckVersion**”窗口中，点击“**...**”选项，打开文件选择窗口。

3. 选择与固件版本对应的“**comdb.txt**”。该文件通常位于项目目录的 *qos_build\release\版本号\DBG* 路径下。

4. 点击“**CheckVersion**”界面的“**Update**”选项以更新数据库文件。

```{image} images/image_DcSNb7WfYoV5tQxw45vcjZwDnLM.webp
:width: 1319px
:height: 696px
:align: center
```

# 暂停/终止日志输出

在“**UniLogViewer**”选项卡中，点击“**Pause**”（2）图标暂停或“**Stop**”（3）图标终止日志记录：

```{image} images/image_B9JMbC6kMoIfBhxfrxScweptnGe.webp
:width: 834px
:height: 469px
:align: center
```

# App日志搜索

1. 暂停或终止日志输出后，按下快捷键“**Ctrl+F**”打开日志搜索框。在“**Find what**”输入框中输入“**hello world**”。

2. 配置搜索规则：  
    - 勾选 Match Case（区分大小写）。  
    - 勾选 List All Found Items（列出所有匹配的内容）

3. 点击“**Find Previous**”，从当前日志向上搜索匹配的日志。

4. 在弹出的搜索结果框中，查看匹配的日志内容。

```{image} images/image_AFgfbfS9Uoc7rQxhgxUcoMUnns1.webp
:width: 1600px
:height: 820px
:align: center
```

# 下一步与更多资源

- 如需进一步学习，推荐 [GPIO](<../../外设与驱动/GPIO/GPIO.md#gpio>)、[UART](<../../外设与驱动/UART/UART.md#uart>)、[IIC](<../../外设与驱动/IIC/IIC.md#iic>) 等通用外设章节。

- 更多开发资源：可参考 [GitHub开源仓库](<https://github.com/UniRTOS>) 和 [示例项目库](<https://github.com/UniRTOS/UniRTOS-Doc-Examples>)。

- 社区与支持：[移远开发者社区论坛](<https://forumschinese.quectel.com/c/66-category/66>) 或微信公众号关注“移远开发者社区”获取最新资讯。