1个工具4类日志，帮你解决99%的问题

众所周知，通过日志可以对研发过程中，以及模组运行过程中的各种故障进行分析，快速定位和解决问题。

但新手朋友往往念叨着“抓日志”，却又无从下手……此时就不得不提到工程师朋友的宝藏工具——[LuaTools]多功能下载调试工具，简单又高效。

LuaTools新版下载/使用教程：

https://docs.openluat.com/Luatools/

本文特别分享LuaTools日志相关内容。

一、LuaTools日志分类

LuaTools包括4种日志：工具本身的日志、用户日志、底层日志、死机日志。

1. 工具本身的日志

在工具目录/log/，main_当天日期.txt形式存在，记录工具本身工作中输出的日志，主要用于工具报错时查找错误原因。当天工具第一次打开，才会新建文件。

2. 用户日志

在工具目录/log/，trace_当天日期_首次记录时间.txt形式存在，记录了LuatOS里调用print、log等API输出的日志，LuatOS组件输出的部分日志，CSDK里调用luat_debug_print输出的日志，一般查看模组工作状态。在工具重新打开后，会新建文件。

3. 底层日志

在工具目录/log/4gdiag/，根据模块内SoC平台不同，会有不同的类型。

1）AP log

Air724系列模组（展锐平台），Air780/Air700系列模组及Air8000工业引擎模组（移芯平台）支持。当天日志_首次记录时间_固件类型_固件版本_SOC名称_IMEI_接收COM口号.bin形式存在，记录了SoC AP处理器（移芯包括了CP处理器）输出的所有log，当LuatOS日志无法定位问题时，需要用到，有时也会用于死机问题分析。

2）CP log

Air724系列模组（展锐平台）支持。xxx.tra形式存在，记录了soc CP处理器输出的所有log，当AP log都无法定位问题时，需要用到。

4. 死机日志

Air780/Air700系列模组及Air8000工业引擎模组（移芯平台）支持，目前有2类：

1）Ramdump

在工具目录/log/ramdump/，当天日志_首次记录时间_固件类型_固件版本_SOC名称_IMEI_接收COM口号_ramdump.bin形式存在，用于死机问题分析，必须开启AP log抓取，才能在死机时抓取ramdump。

2）Flashdump

在工具目录/log/flashdump/，这是移芯EC7XX独有功能。

二、LuaTools如何与EPAT共存

EPAT是底层日志工具，适用于Air780系列/Air700系列模组及Air8000工业引擎模组。

默认状态下，LuaTools会开启AP log和CP log抓取，由于移芯平台没有CP log，所以CP log项目没有影响。

但是EPAT抓底层log会和LuaTools抓AP log冲突，两者是同一个东西。因此，如果想用LuaTools查看用户日志，用EPAT查看底层log，需要将LuaTools抓取AP log的功能关闭。

新版本： LuaTools ->账户 ->工具配置； 老版本： LuaTools ->工具 ->配置。

如下图所示，将打开AP LOG去掉勾选即可：

三、如何抓死机信息

Air780系列/Air700系列模组及Air8000工业引擎模组，LuaTools抓死机信息是自动进行的，只要保证AP log是正常抓取，也就是说EPAT不能开启，正常抓取完成后LuaTools有非常明显的提示文件存放位置。

如果LuaTools和EPAT并存，或者只开EPAT，那么需要用EPAT来保存log。

但是光靠死机信息不一定能找到问题点，因此需要提供全套文件包括：

死机前AP log，或者EPAT的log，注意要在死机发生前的。

Ramdump文件（或者flashdump文件，但是flashdump内容少，不一定有用），如果是EPAT抓的ramdump，则在保存成zip压缩包中时已经保存了。

SoC文件，如果是618的CSDK，则需要编译输出目录的xxx.elf，xxx.map，comdb.txt文件。

今天的分享就到这里了~

更多模组日志相关内容详见：

https://docs.openluat.com/howtouselog/

审核编辑 黄宇