眾所周知，通過(guò)日志可以對(duì)研發(fā)過(guò)程中，以及模組運(yùn)行過(guò)程中的各種故障進(jìn)行分析，快速定位和解決問(wèn)題。

但新手朋友往往念叨著“抓日志”，卻又無(wú)從下手……此時(shí)就不得不提到工程師朋友的寶藏工具——[LuaTools]多功能下載調(diào)試工具，簡(jiǎn)單又高效。

LuaTools新版下載/使用教程：

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

本文特別分享LuaTools日志相關(guān)內(nèi)容。

一、LuaTools日志分類(lèi)

LuaTools包括4種日志：工具本身的日志、用戶(hù)日志、底層日志、死機(jī)日志。

1. 工具本身的日志

在工具目錄/log/，main_當(dāng)天日期.txt形式存在，記錄工具本身工作中輸出的日志，主要用于工具報(bào)錯(cuò)時(shí)查找錯(cuò)誤原因。當(dāng)天工具第一次打開(kāi)，才會(huì)新建文件。

2. 用戶(hù)日志

在工具目錄/log/，trace_當(dāng)天日期_首次記錄時(shí)間.txt形式存在，記錄了LuatOS里調(diào)用print、log等API輸出的日志，LuatOS組件輸出的部分日志，CSDK里調(diào)用luat_debug_print輸出的日志，一般查看模組工作狀態(tài)。在工具重新打開(kāi)后，會(huì)新建文件。

3. 底層日志

在工具目錄/log/4gdiag/，根據(jù)模塊內(nèi)SoC平臺(tái)不同，會(huì)有不同的類(lèi)型。

1）AP log

Air724系列模組（展銳平臺(tái)），Air780/Air700系列模組及Air8000工業(yè)引擎模組（移芯平臺(tái)）支持。當(dāng)天日志_首次記錄時(shí)間_固件類(lèi)型_固件版本_SOC名稱(chēng)_IMEI_接收COM口號(hào).bin形式存在，記錄了SoC AP處理器（移芯包括了CP處理器）輸出的所有l(wèi)og，當(dāng)LuatOS日志無(wú)法定位問(wèn)題時(shí)，需要用到，有時(shí)也會(huì)用于死機(jī)問(wèn)題分析。

2）CP log

Air724系列模組（展銳平臺(tái)）支持。xxx.tra形式存在，記錄了soc CP處理器輸出的所有l(wèi)og，當(dāng)AP log都無(wú)法定位問(wèn)題時(shí)，需要用到。

4. 死機(jī)日志

Air780/Air700系列模組及Air8000工業(yè)引擎模組（移芯平臺(tái)）支持，目前有2類(lèi)：

1）Ramdump

在工具目錄/log/ramdump/，當(dāng)天日志_首次記錄時(shí)間_固件類(lèi)型_固件版本_SOC名稱(chēng)_IMEI_接收COM口號(hào)_ramdump.bin形式存在，用于死機(jī)問(wèn)題分析，必須開(kāi)啟AP log抓取，才能在死機(jī)時(shí)抓取ramdump。

2）Flashdump

在工具目錄/log/flashdump/，這是移芯EC7XX獨(dú)有功能。

二、LuaTools如何與EPAT共存

EPAT是底層日志工具，適用于Air780系列/Air700系列模組及Air8000工業(yè)引擎模組。

默認(rèn)狀態(tài)下，LuaTools會(huì)開(kāi)啟AP log和CP log抓取，由于移芯平臺(tái)沒(méi)有CP log，所以CP log項(xiàng)目沒(méi)有影響。

但是EPAT抓底層log會(huì)和LuaTools抓AP log沖突，兩者是同一個(gè)東西。因此，如果想用LuaTools查看用戶(hù)日志，用EPAT查看底層log，需要將LuaTools抓取AP log的功能關(guān)閉。

新版本： LuaTools ->賬戶(hù) ->工具配置； 老版本： LuaTools ->工具 ->配置。

如下圖所示，將打開(kāi)AP LOG去掉勾選即可：

三、如何抓死機(jī)信息

Air780系列/Air700系列模組及Air8000工業(yè)引擎模組，LuaTools抓死機(jī)信息是自動(dòng)進(jìn)行的，只要保證AP log是正常抓取，也就是說(shuō)EPAT不能開(kāi)啟，正常抓取完成后LuaTools有非常明顯的提示文件存放位置。

如果LuaTools和EPAT并存，或者只開(kāi)EPAT，那么需要用EPAT來(lái)保存log。

但是光靠死機(jī)信息不一定能找到問(wèn)題點(diǎn)，因此需要提供全套文件包括：

死機(jī)前AP log，或者EPAT的log，注意要在死機(jī)發(fā)生前的。

Ramdump文件（或者flashdump文件，但是flashdump內(nèi)容少，不一定有用），如果是EPAT抓的ramdump，則在保存成zip壓縮包中時(shí)已經(jīng)保存了。

SoC文件，如果是618的CSDK，則需要編譯輸出目錄的xxx.elf，xxx.map，comdb.txt文件。

今天的分享就到這里了~

更多模組日志相關(guān)內(nèi)容詳見(jiàn)：

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

審核編輯 黃宇