模組日志功能技術(shù)方案以低侵入、高可用為原則，提供統(tǒng)一的日志API、多級日志分類與條件輸出機制。通過集成該技術(shù)，開發(fā)者可在不干擾業(yè)務(wù)邏輯的前提下，全面掌握模組的執(zhí)行狀態(tài)與異常行為。

一、本文討論的邊界

本文是對 4G 模組， 以及 4G+GNSS 模組的日志功能的總體介紹。

通過日志，可以對研發(fā)過程中，以及模組運行過程中的各種故障進行分析。

二、4G 模組日志的幾種類型

4G 模組的日志有兩種類型： 業(yè)務(wù)日志和底層日志。

業(yè)務(wù)日志是指在用模組的用戶代碼輸出的日志，包括 AT指令交互的日志和二次開發(fā)的業(yè)務(wù)代碼輸出的日志。

（一）AT 交互的業(yè)務(wù)日志

把模組作為 AT 指令的方式做開發(fā)的時候， 可以通過串口工具，抓取 AT 指令的日志。

也可以由設(shè)備的主控 CPU，輸出和模組的 AT 指令的交互日志。

AT 交互的日志，用普通的串口工具，比如 sscom，LLcom，都可以使用。

（二）二次開發(fā)的業(yè)務(wù)日志

在用 LuatOS 二次開發(fā)的代碼里面， 用 print()函數(shù)， 就可以輸出任何的信息到 Luatools。

通過 Luatools 的日志查看界面， 就可以非常方便的查看， 保存，分析業(yè)務(wù)日志。

使用 Luatools 查看日志的詳細資料，可以查看：https://docs.openluat.com/air780epm/common/Luatools/

（三）底層日志

當遇到疑難問題， 用業(yè)務(wù)日志無法定位問題原因的時候， 就需要抓取底層日志，

交給我們的技術(shù)同事分析問題。

無論是 AT 指令方式的開發(fā)，還是在模組內(nèi)部做二次開發(fā)，都可以抓取底層日志。

三、怎么抓底層日志

本章的內(nèi)容，適合 780 系列模組，700系列模組，不適合 724和795系列模組。

底層日志工具，叫做 EPAT 工具。

（一）下載底層日志工具

下載底層日志工具： EPAT

（二）日志輸出端口

USB的虛擬端口中，有一個底層日志的輸出端口。 可以從設(shè)備管理器的端口屬性中根據(jù)“設(shè)備實例路徑”中的值是否是0004，來判斷底層日志的輸出端口。

正常情況下，要用USB物理接口抓取日志，因為USB虛擬出來的端口的輸出速率很高， 基本不會出現(xiàn)丟日志的現(xiàn)象。

而串口抓底層日志，很容易丟失日志，導(dǎo)致抓不全日志，給問題分析帶來很大的障礙。

（三）EPAT工具中圖標功能

打開日志文件，需要在打開EPAT工具時跳出的"Select Data Source"選擇框中選擇"Select From Local Files"，才能點擊使用功能，可以打開ZIP壓縮包和Bin格式的日志文件。

保存日志，會將已抓取到的日志導(dǎo)出，以ZIP壓縮包的方式保存，方便提供給技術(shù)同事或研發(fā)同事分析。

更新解析日志的數(shù)據(jù)庫文件，在抓日志的時候，可以不匹配，等在使用EPAT打開日志文件的時候再做匹配解析。

篩選查看日志，如果不了解，用不到這個功能。

啟動開始抓日志，如果沒有日志出來，請檢查日志端口有沒有選擇正確，有沒有勾選打開；確認端口正確，也已勾選，還是沒有日志出來，請嘗試：

1）重啟模塊

2）勾選選擇的端口從其他串口調(diào)試工具嘗試打開是否可以正常輸出數(shù)據(jù)（亂碼）

3）如果使用AT固件，默認DBG_UART端口輸出是3M波特率，可以通過AT+ECPCFG=logBaudrate,6000000 指令修改，波特率設(shè)置請不要低于3M，不然很容易出現(xiàn)丟日志、抓的不全。

暫停日志

停止抓日志，點擊完停止后，就可以選擇保存日志 發(fā)給技術(shù)/研發(fā)同事分析了。

清除日志，建議每次正式準備抓日志前清理一下日志，這樣保存出來的日志給技術(shù)同事分析會方便很多。

搜索日志內(nèi)容

設(shè)備端口配置界面

（四）EPAT底層日志抓取方法

1，打開EPAT工具，抓日志選擇第一項“Serial Device”

2，選擇日志端口，準備抓取log

（1）打開設(shè)備端口配置界面

（2）關(guān)閉或打開端口，如果端口被占用，工具也不會提示"端口已被占用"，所以如果發(fā)現(xiàn)端口選擇正確，并且日志還是沒有出來的話，可以確認下日志端口是否有被占用，而導(dǎo)致EPAT沒有打開日志端口。

（3）日志端口可以同時打開兩個，一個用模塊的DBG_UART端口打開，另一個使用USB的日志輸出端口，AT固件需要設(shè)置AT+ECPCFG=logPortSel,2（重啟生效）才能設(shè)置日志端口可以從USB和DBG_UART兩個端口輸出。

好處是在進入休眠的時候，待USB斷開，就會用DBG串口輸出日志，等模塊喚醒時就會重新虛擬出來USB端口，就會從USB的日志口抓取日志。這樣抓取休眠中的程序日志 也基本上不會出現(xiàn)日志丟失的情況。

（4）打開日志輸出端口和修改波特率的界面

（5）選擇日志輸出端口

（6）USB的虛擬日志端口不用特意修改波特率；

（7）在lua版本中，模塊優(yōu)先從USB口輸出底層日志，USB口輸出底層日志的時候，DEBUG口沒有辦法輸出底層日志，如果需要DEBUG口輸出底層日志的話，需要關(guān)閉USB功能pm.power(pm.USB,false)，如果需要DEBUG口看日志該操作每次開機都要執(zhí)行。

DBG_UART端口默認為3M波特率輸出，請不要隨意更改，如果技術(shù)/研發(fā)同事發(fā)現(xiàn)日志丟失嚴重，可手動寫入修改為6000000（6M）波特率；

3，抓取底層日志

如果輸出的日志有亂碼，先確認波特率是否有改動，是不是默認3M波特率抓取的，或確認串口線是否支持3M波特率輸出。然后再點擊上圖紅框中的圖標匹配數(shù)據(jù)庫comdb解析文件。

4，獲取數(shù)據(jù)庫db文件

抓日志時，可以不做數(shù)據(jù)庫匹配，只需要把文件發(fā)給技術(shù)同事就可以了； 但如果技術(shù)同事建議本地先匹配數(shù)據(jù)庫文件后再抓取，那優(yōu)先保證日志可以正常輸出出來，然后再匹配數(shù)據(jù)庫文件。

在底層core .soc后綴的固件中，通過解壓縮工具打開該文件，可以看到里面會有一個comdb.txt文件，在EPAT選擇更新數(shù)據(jù)庫文件的時候 選擇該文件，隨后點擊"UPDATE"，如果變?yōu)榫G燈 代表匹配成功；如果是還是紅燈表示 選擇的db文件和現(xiàn)在模塊中燒錄的固件不匹配；

AT開發(fā)方式只能從技術(shù)同事中獲取，一般AT的底層問題，不需要用戶去看，所以一般不需要匹配數(shù)據(jù)庫文件，抓取成功日志將zip日志壓縮包和模塊使用的AT固件完整版本號（發(fā)ATI 指令查看版本號）發(fā)給技術(shù)同事，分析時自行匹配。

數(shù)據(jù)庫文件更新成功后， 燈會變成綠色

5，保存日志

導(dǎo)出日志前，先停止打印

點擊保存日志的圖標

保存的日志文件不要以相同名稱文件覆蓋的形式保存，否則日志會保存失敗，實際內(nèi)容不會覆蓋。

6，將保存出來的ZIP日志壓縮包發(fā)給技術(shù)分析

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇