本文以低功耗4G模組Air780E為例，學會低功耗模組LuatOS開發的日志輸出，積累技術。

一、LuatOS日志輸出介紹

LuatOS使用log庫是進行日志輸出，通過log庫可以輸出不同等級的用戶日志。

1.1 日志的等級

debug：調試內容輸出，為日志輸出優先級第 4 等級，優先級最低；

info：信息輸出，為日志輸出優先級第 3 等級，僅比 debug 級別高；

warn：為警告輸出，為日志輸出優先級第 2 等級；

error：為錯誤輸出，為日志輸出優先級第 1 等級，級別最高；

注：LuatOS 默認日志等級是 debug，可以輸出 debug 及以上等級的日志；

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

1.2 日志輸出等級

SILENT：靜默所有日志，即禁止日志有任何內容輸出；

DEBUG：輸出 debug 級及以上級別的日志

INFO：輸出 info 級及以上級別的日志

WARN：輸出 warn 級及以上級別的日志

ERROR：輸出 error 級的日志

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

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

綜上所述，LuatOS 的 log 庫具有基本的日志輸出功能，通過靈活運用日志功能，開發者可以隨時查看變量的數值或跟蹤程序運行的邏輯順序，非常適合嵌入式開發過程中用于調試，同時也方便長時間跟蹤運行，排查問題。

二、演示功能概述

本文使用Air780E核心板，輸出不同等級，以便開發者能快速了解日志功能的使用。

三、準備硬件環境

3.1 Air780E 開發板

（注意：需要配套采購 4G 物聯網卡！）

3.2 TYPE-C 數據線

（注意：必須是具備USB通信的數據線！）

四、準備軟件環境

4.1 Luatools

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

4.2 core 固件和源碼腳本

注：core 固件，是基礎環境，該固件由官方提供，用戶不可修改；源碼腳本，為應用程序，可由客戶自行修改；

五、軟硬件資料

1、Air780E 開發板原理圖，打開 Air780E 產品手冊，訪問頁面中的 《EVB_Air780X_V1.6.zip》：
https://docs.openluat.com/air780e/product/

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

3、Air780E 開發板使用說明：
打開Air780E 產品手冊，訪問頁面中的 《Core_Air780E 使用說明 V1.0.5.pdf》

5.1 開發板按鈕與指示燈圖示與說明

5.2 硬件安裝與連接

5.2.1 SIM 卡安裝

5.2.2 實物連接圖

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

六、代碼示例介紹

6.1 完整程序清單

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

七、功能驗證

7.1 開機

按下圖所示通過 TYPE-C 線將開發板與電腦連接無誤后，開發板電源指示紅燈常亮，網絡指示燈滅：

此時按下開機鍵，約 2 秒后釋放，等待幾秒網絡指示綠燈常亮，即開機成功，如下圖：

此時電腦設備管理器中會發現下圖所示幾個設備，即代表開機成功！

7.2 打開 Luatool 軟件工具并進入項目管理測試頁面

7.3 按序號步驟創建項目

7.4 按如下步驟進行程序燒錄

7.5 觀察下載過程后確認燒錄結果

7.6 關閉項目管理界面，回到調試頁面，觀察輸出

注：詳細日志輸出內容，在程序中有增強注釋說明，請詳細查看。

八、總結

至此，我們已使用 Air780E 開發板驗證了 LuatOS 所有日志功能。

審核編輯 黃宇