# EPAT工具使用教程

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

---

# 概述

本文档以EG800Z系列模块为例，介绍如何使用EPAT日志工具抓取日志，以及如何导出Dump和Pcap文件。

## 下载地址

[EPAT日志工具 | 移远通信-全球物联网整体解决方案供应商](<https://www.quectel.com.cn/download/epat%e6%97%a5%e5%bf%97%e5%b7%a5%e5%85%b7> )

## 运行环境

- 操作系统：Windows 10/11

- 计算机内存：2 GB以上

- 处理器：酷睿i3以上

## 软件安装

EPAT为绿色免安装软件，解压后即可使用。解压后在 *EPAT\bin* 目录下运行 *EPAT.exe*。

```{note}
1. 解压路径中不可包含中文字符，否则可能导致工具无法正常运行。
2. EPAT需要Visual C++运行库（MFC组件），如果第一次运行EPAT失败，请安装执行 *EPAT\bin* 目录下的 *vc_redist.x86.exe* 文件。
```

## 准备工作

使用EPAT抓取日志前，用户应做如下准备：

- 确认已安装模块USB驱动程序

- 使用USB数据线将模块连接至计算机

- 模块上电运行

- 进入计算机的设备管理器界面，若USB驱动程序加载正常，则显示下图所示端口：

```{image} images/image_RKXubiMiLo5V2oxHZiOc4bx6nAg.webp
:width: 563px
:height: 103px
```

```{note}
1. Quectel USB AT Port：主要用于AT命令收发，是上位机与模块进行AT命令交互的核心通道。
2. Quectel USB DIAG Port：主要用于抓取AP/CP日志、导出Dump文件 ，是模块调试和日志分析的专用通道。
```

确认设备与计算机硬件连接正常，且所有USB端口枚举成功后，即可进行EPAT工具的配置与使用。

# 抓取AP和CP日志

## **启动EPAT工具**

进入 *EPAT\bin* 目录，双击 *EPAT.exe* 启动工具。

```{image} images/image_VK3GbOHHtocCOmxNxc9cuSU8nRh.webp
:width: 982px
:height: 535px
```

启动后会弹出数据源选择窗口：

- Serial Device：在线模式，直接从串口设备实时抓取日志。

- Select From Local Files：离线模式，从本地加载已有的日志文件。

此处选择“**Serial Device**”，点击“**OK**”。

```{image} images/image_LhDnbgsH7oORICxQmBdcf1I2n2g.webp
:width: 1603px
:height: 858px
```

## **配置端口参数**

在工具栏中点击下图①指示的图标，弹出“Device Selection”窗口，在弹出的窗口中点击“**Settings**”进入“Communications Settings”界面。在下拉菜单中选择“**Quectel USB DIAG Port**”端口，依次点击“**OK**”确认。

```{image} images/image_DUzKbpnF1ofO4lxVjFhcUEqinQR.webp
:width: 1109px
:height: 454px
```

## **匹配数据库**

端口配置完成后，工具会自动连接USB端口并开始输出日志，如下图所示：

```{image} images/image_PdKNbFJszoH8FkxVEAYcIKkRnec.webp
:width: 1236px
:height: 576px
```

由于未匹配数据库文件，此时输出的日志多为未解码的十六进制数据。如需查看明文日志，需进行数据库匹配：

**步骤一**：在工具栏中点击下图①指示的图标，弹出“State”窗口；

**步骤二**：点击“**Update**” 弹出版本匹配窗口“CheckVersion”；

**步骤三**：点击浏览按钮“**...**”，选择与模块当前固件版本对应的DB文件并打开；

**步骤四**：点击“**Update**”进行匹配，匹配成功后窗口指示灯变为绿色；

**步骤五**：关闭弹窗，日志自动解码为明文信息。

```{image} images/image_Pv6kbgwNIodCMdxTLaAcvcDznae.webp
:width: 1593px
:height: 491px
:align: center
```

## **重启设备并开始日志抓取**

数据库文件匹配完成后，重启模块，EPAT工具会自动识别端口并开始抓取日志。

## **保存日志文件**

日志抓取完成后，点击工具栏的保存按钮，自定义存放路径并确认。导出的日志文件默认为ZIP压缩包。

```{image} images/image_Hyz6bayPoodNw6xDO5DccJ6qnSg.webp
:width: 552px
:height: 155px
```

```{image} images/image_CfbRbtFnMoVxC4xmkIYcUkXXn5g.webp
:width: 579px
:height: 144px
```

文件保存完成后，将该压缩包提交至移远通信技术支持进行问题分析。

# 导出Dump文件

模块默认在发生Dump时会直接重启，导致无法导出文件。因此模块正常运行时，用户需提前通过AT命令配置模块在Dump模式下禁止自动重启，并Dump完整的日志到EPAT和Flash。

## **配置Dump模式**

打开QCOM工具，“COM Port”选择“**Quectel USB AT Port**”端口，点击“**Open Port**”，下发如下命令：

```c
AT+ECPCFG="faultAction",0
```

```{image} images/image_ZUehbfXp0ogLgpxPOFuczKlhnxd.webp
:width: 1001px
:height: 766px
:align: center
```

```{note}
1. **AT+ECPCFG="faultAction"** 发送后立即生效，参数配置自动保存至NVRAM；深休眠唤醒后仍有效。
2. 有关QCOM使用详情，请参考 [QCOM使用教程](../QCOM%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B/QCOM%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B.md)。
```

## **复现Dump问题**

触发导致模块死机、异常重启的问题场景，等待Dump触发。

## **保存Dump文件**

EPAT检测到Dump触发后自动开始导出，导出完成弹出“RamDump”提示窗口，窗口可直接关闭。

Dump文件默认保存在 *Bin\RamDump* 目录中，将Dump文件压缩打包，提交至移远通信技术支持进行问题分析。

```{image} images/image_ENmCbXZywoezs9xIFJ7c88y1nLe.webp
:width: 1601px
:height: 852px
```

```{image} images/image_R9cJbtjbSo779BxWifNcsHeSnPf.webp
:width: 705px
:height: 129px
```

# 导出Pcap文件

当需要分析MQTT/HTTP/HTTPS等网络协议问题时，可按以下步骤导出Pcap文件：

**步骤一**：点击“**SigLogger**”标签；

**步骤二**：点击图中②所示的“**暂停**”按钮；

**步骤三**：在菜单栏选择“**SigLog**” → “**Export As pcap file**”；

**步骤四**：在弹出的对话框中选择保存目录并设置文件名，确认后即可完成导出。

```{image} images/image_H1kcbSypgoRRBJxbRcfcx7fZntg.webp
:width: 607px
:height: 215px
```

```{image} images/image_IIrsbPTdLoZWZnx3J6tcERbznqh.webp
:width: 608px
:height: 295px
```

# 常见问题

**问题：** 使用EPAT工具连接模块后，为什么日志输出窗口中看到的几乎都是一些十六进制的数据？

**答案**：因为工具尚未匹配正确的数据库文件，导致日志处于未解码状态。请参考本文 [匹配数据库](#匹配数据库) 章节进行操作，匹配成功即可正常查看明文日志。

```{image} images/image_Hj6pb1DWUoxPzcxYjracjrJQnxh.webp
:width: 1236px
:height: 576px
```