本文以Air780E低功耗模組為例，要講的是4G模組LuatOS開(kāi)發(fā)的日志輸出的全程演示。

一、LuatOS日志輸出介紹

LuatOS使用log庫(kù)是進(jìn)行日志輸出，通過(guò)log庫(kù)可以輸出不同等級(jí)的用戶日志。

1.1 日志的等級(jí)

debug：調(diào)試內(nèi)容輸出，為日志輸出優(yōu)先級(jí)第 4 等級(jí)，優(yōu)先級(jí)最低；

info：信息輸出，為日志輸出優(yōu)先級(jí)第 3 等級(jí)，僅比 debug 級(jí)別高；

warn：為警告輸出，為日志輸出優(yōu)先級(jí)第 2 等級(jí)；

error：為錯(cuò)誤輸出，為日志輸出優(yōu)先級(jí)第 1 等級(jí)，級(jí)別最高；

注：LuatOS 默認(rèn)日志等級(jí)是 debug，可以輸出 debug 及以上等級(jí)的日志；

如：log.debug(PROJECT, "debug message")，debug 為 log 模塊的函數(shù)，使用小寫英文字母；

1.2 日志輸出等級(jí)

SILENT：靜默所有日志，即禁止日志有任何內(nèi)容輸出；

DEBUG：輸出 debug 級(jí)及以上級(jí)別的日志

INFO：輸出 info 級(jí)及以上級(jí)別的日志

WARN：輸出 warn 級(jí)及以上級(jí)別的日志

ERROR：輸出 error 級(jí)的日志

如：log.setLevel("INFO")，INFO 作為 setLevel 函數(shù)的參數(shù)存在，使用大寫英文字母；

注：debug 小寫與 DEBUG 大寫（其他以此類比）具有不同作用，使用過(guò)程要注意！

綜上所述，LuatOS 的 log 庫(kù)具有基本的日志輸出功能，通過(guò)靈活運(yùn)用日志功能，開(kāi)發(fā)者可以隨時(shí)查看變量的數(shù)值或跟蹤程序運(yùn)行的邏輯順序，非常適合嵌入式開(kāi)發(fā)過(guò)程中用于調(diào)試，同時(shí)也方便長(zhǎng)時(shí)間跟蹤運(yùn)行，排查問(wèn)題。

二、演示功能概述

本文使用Air780E核心板，輸出不同等級(jí)，以便開(kāi)發(fā)者能快速了解日志功能的使用。

三、準(zhǔn)備硬件環(huán)境

3.1 Air780E 開(kāi)發(fā)板

（注意：需要配套采購(gòu) 4G 物聯(lián)網(wǎng)卡?。?/p>

3.2 TYPE-C 數(shù)據(jù)線

（注意：必須是具備USB通信的數(shù)據(jù)線！）

四、準(zhǔn)備軟件環(huán)境

4.1 Luatools

Luatools日志打印與程序燒錄軟件下載：
https://docs.openluat.com/Luatools/

4.2 core 固件和源碼腳本

注：core 固件，是基礎(chǔ)環(huán)境，該固件由官方提供，用戶不可修改；源碼腳本，為應(yīng)用程序，可由客戶自行修改；

五、軟硬件資料

1、Air780E 開(kāi)發(fā)板原理圖，打開(kāi) Air780E 產(chǎn)品手冊(cè)，訪問(wèn)頁(yè)面中的 《EVB_Air780X_V1.6.zip》：
https://docs.openluat.com/air780e/product/

2、API 使用介紹說(shuō)明：
https://wiki.luatos.com/boardGuide/common/log.html?highlight=log

3、Air780E 開(kāi)發(fā)板使用說(shuō)明：
打開(kāi)Air780E 產(chǎn)品手冊(cè)，訪問(wèn)頁(yè)面中的 《Core_Air780E 使用說(shuō)明 V1.0.5.pdf》

5.1 開(kāi)發(fā)板按鈕與指示燈圖示與說(shuō)明

5.2 硬件安裝與連接

5.2.1 SIM 卡安裝

5.2.2 實(shí)物連接圖

注：開(kāi)發(fā)板與電腦通過(guò) TYPE-C 線連接，用于通信與供電，所以必須使用支持 USB 通信的 TYPE-C 線才可以；

六、代碼示例介紹

6.1 完整程序清單

注：完整復(fù)制后保存為 main.lua，可直接使用

七、功能驗(yàn)證

7.1 開(kāi)機(jī)

按下圖所示通過(guò) TYPE-C 線將開(kāi)發(fā)板與電腦連接無(wú)誤后，開(kāi)發(fā)板電源指示紅燈常亮，網(wǎng)絡(luò)指示燈滅：

此時(shí)按下開(kāi)機(jī)鍵，約 2 秒后釋放，等待幾秒網(wǎng)絡(luò)指示綠燈常亮，即開(kāi)機(jī)成功，如下圖：

此時(shí)電腦設(shè)備管理器中會(huì)發(fā)現(xiàn)下圖所示幾個(gè)設(shè)備，即代表開(kāi)機(jī)成功！

7.2 打開(kāi) Luatool 軟件工具并進(jìn)入項(xiàng)目管理測(cè)試頁(yè)面

7.3 按序號(hào)步驟創(chuàng)建項(xiàng)目

7.4 按如下步驟進(jìn)行程序燒錄

7.5 觀察下載過(guò)程后確認(rèn)燒錄結(jié)果

7.6 關(guān)閉項(xiàng)目管理界面，回到調(diào)試頁(yè)面，觀察輸出

注：詳細(xì)日志輸出內(nèi)容，在程序中有增強(qiáng)注釋說(shuō)明，請(qǐng)?jiān)敿?xì)查看。

八、總結(jié)

至此，我們已使用 Air780E 開(kāi)發(fā)板驗(yàn)證了 LuatOS 所有日志功能。

分享完畢。


審核編輯 黃宇