眾所周知，通過日志可以對研發過程中，以及模組運行過程中的各種故障進行分析，快速定位和解決問題。

但新手朋友往往念叨著“抓日志”，卻又無從下手……此時就不得不提到工程師朋友的寶藏工具——[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/

審核編輯 黃宇