原创探秘日志篇：模组日志总体介绍！

 2025-1-8 14:08  20 0 分类: 通信

今天我们学习模组日志总体介绍，以下进入正文。

一、本文讨论的边界

本文是对4G 模组，以及 4G+GNSS 模组的日志功能的总体介绍。通过日志，可以对研发过程中，以及模组运行过程中的各种故障进行分析。

二、4G模组日志的几种类型界

4G 模组的日志有两种类型：业务日志和底层日志。业务日志是指在用模组的用户代码输出的日志，包括 AT指令交互的日志和二次开发的业务代码输出的日志。

2.1 AT 交互的业务日志

把模组作为 AT 指令的方式做开发的时候，可以通过串口工具，抓取 AT 指令的日志。也可以由设备的主控 CPU，输出和模组的 AT 指令的交互日志。AT 交互的日志，用普通的串口工具，比如 sscom，LLcom，都可以使用。

2.2 二次开发的业务日志

在用 LuatOS 二次开发的代码里面，用 print()函数，就可以输出任何的信息到 Luatools。通过 Luatools 的日志查看界面，就可以非常方便的查看，保存，分析业务日志。使用 Luatools 查看日志的详细资料，可以查看：

Luatools下载和使用教程

2.3 底层日志

当遇到疑难问题，用业务日志无法定位问题原因的时候，就需要抓取底层日志，交给技术同事分析问题。

无论是 AT 指令方式的开发，还是在模组内部做二次开发，都可以抓取底层日志。

三、怎么抓底层日志

本章的内容，适合 780 系列模组，700系列模组，不适合 724和795系列模组。底层日志工具，叫做 EPAT 工具。

3.1 下载底层日志工具

点击如下链接，直接下载底层日志工具EPAT：模组底层日志抓取和分析工具。

3.2 日志输出端口

如彻底讲清楚USB驱动问题这篇教程所说，USB的虚拟端口中，有一个底层日志的输出端口。可以从设备管理器的端口属性中根据“设备实例路径”中的值是否是0004，来判断底层日志的输出端口。

正常情况下，要用USB物理接口抓取日志，因为USB虚拟出来的端口的输出速率很高，基本不会出现丢日志的现象。

而串口抓底层日志，很容易丢失日志，导致抓不全日志，给问题分析带来很大的障碍。

3.3 EPAT工具中图标功能

3.4 EPAT底层日志抓取方法

① 打开EPAT工具，抓日志选择第一项“Serial Device”

② 选择日志端口，准备抓取log

- （1）打开设备端口配置界面

- （2）关闭或打开端口，如果端口被占用，工具也不会提示"端口已被占用"，所以如果发现端口选择正确，并且日志还是没有出来的话，可以确认下日志端口是否有被占用，而导致EPAT没有打开日志端口。

- （3）日志端口可以同时打开两个，一个用模块的DBG_UART端口打开，另一个使用USB的日志输出端口，AT固件需要设置AT+ECPCFG=logPortSel,2（重启生效）才能设置日志端口可以从USB和DBG_UART两个端口输出。好处是在进入休眠的时候，待USB断开，就会用DBG串口输出日志，等模块唤醒时就会重新虚拟出来USB端口，就会从USB的日志口抓取日志。这样抓取休眠中的程序日志也基本上不会出现日志丢失的情况。

- （4）打开日志输出端口和修改波特率的界面

- （5）选择日志输出端口

- （6）USB的虚拟日志端口不用特意修改波特率；

DBG_UART端口默认为3M波特率输出，请不要随意更改，如果技术/研发同事发现日志丢失严重，可手动写入修改为6000000（6M）波特率；

③ 抓取底层日志