相信很多朋友都會(huì)忽視errDump錯(cuò)誤日志上報(bào)，但不得不說(shuō)的是技術(shù)高手都知道它真的是比較重要的一環(huán)。

讓我們以概述，準(zhǔn)備環(huán)境等來(lái)一一說(shuō)明：

1、errDump功能概述

LuatOS-Air錯(cuò)誤日志上報(bào)功能模塊名叫：errDump，errDump對(duì)“量產(chǎn)投放市場(chǎng)的設(shè)備，遠(yuǎn)程調(diào)試初步定位問題”至關(guān)重要，強(qiáng)烈建議客戶一定要使用此功能。

errDump就是將模塊運(yùn)行過程中產(chǎn)生的錯(cuò)誤信息或者應(yīng)用日志通過TCP/UDP上報(bào)到互聯(lián)網(wǎng)上的指定服務(wù)器，技術(shù)人員可以在服務(wù)器上查閱日志，協(xié)助遠(yuǎn)程了解設(shè)備運(yùn)行情況，或者故障診斷。

使用合宙云服務(wù)器時(shí)，迫于服務(wù)器壓力，只有手動(dòng)打開debug開關(guān)（見后面第六節(jié)代碼示例介紹），才有日志上報(bào)（當(dāng)使用合宙調(diào)試服務(wù)器時(shí)，開機(jī)前先檢查一下log開關(guān)，每2小時(shí)查詢一次log開關(guān)，如果開關(guān)未開啟，則不允許上傳調(diào)試日志），打開方式見《三、實(shí)例介紹》。

2、演示功能概述

本示例將演示上報(bào)錯(cuò)誤日志的功能。

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

3.1 780E開發(fā)板一套

此核心板的詳細(xì)使用說(shuō)明參考：Air780E產(chǎn)品手冊(cè)中的<<開發(fā)板Core_Air780E使用說(shuō)明V1.0.5.pdf>>。

3.2 SIM卡

請(qǐng)準(zhǔn)備一張可正常上網(wǎng)的SIM卡，該卡可以是物聯(lián)網(wǎng)卡或您的個(gè)人手機(jī)卡。

特別提醒：請(qǐng)確保SIM卡未欠費(fèi)且網(wǎng)絡(luò)功能正常，以便順利進(jìn)行后續(xù)操作。

3.3 數(shù)據(jù)通信線

typec接口USB數(shù)據(jù)線即可。

3.4 PC電腦

WINDOWS系統(tǒng)。

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

4.1基本的下載調(diào)試工具

使用說(shuō)明參考：Luatools下載和詳細(xì)使用；

5、errDump軟硬件資料

本文通過demo演示來(lái)說(shuō)明本章節(jié)內(nèi)容的基本用法。

5.1源碼和工具

Air780E模塊使用固件：SDK&Demo-合宙文檔中心，本demo使用的固件版本是：LuatOS-SoC_V1112_EC618_FULL.soc

本教程使用的demo：
https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/errDump

將固件和腳本燒錄到模塊中，使用說(shuō)明參考：
Luatools下載和詳細(xì)使用
https://docs.openluat.com/Luatools/

合宙云平臺(tái)：
https://iot.openluat.com

5.2本demo使用api介紹

errDump.config(enable,period,user_flag,custom_id,host,port)

作用：配置關(guān)鍵日志上傳IOT平臺(tái)，這里的日志包括引起luavm異常退出的日志和用戶通過record寫入的日志，類似于air的errDump。

參數(shù)

返回值

errDump.dump(zbuff,type,isDelete)

作用：手動(dòng)讀取異常日志，主要用于用戶將日志發(fā)送給自己的服務(wù)器而不是IOT平臺(tái)，如果在errDump.config配置了周期上傳，則不能使用本函數(shù)

參數(shù)

返回值

errDump.record(string)

作用：寫入用戶的異常日志，注意最大只有4KB，超過部分新的覆蓋舊的，開啟自動(dòng)上傳后會(huì)上傳到合宙IOT平臺(tái)

參數(shù)

返回值

6、代碼示例介紹

6.1 上傳錯(cuò)誤日志到云平臺(tái)

6.1.1 云平臺(tái)配置

云平臺(tái)：https://iot.openluat.com

（1）打開IOT平臺(tái)

1errDump功能概述

LuatOS-Air錯(cuò)誤日志上報(bào)功能模塊名叫：errDump，errDump對(duì)“量產(chǎn)投放市場(chǎng)的設(shè)備，遠(yuǎn)程調(diào)試初步定位問題”至關(guān)重要，強(qiáng)烈建議客戶一定要使用此功能。

errDump就是將模塊運(yùn)行過程中產(chǎn)生的錯(cuò)誤信息或者應(yīng)用日志通過TCP/UDP上報(bào)到互聯(lián)網(wǎng)上的指定服務(wù)器，技術(shù)人員可以在服務(wù)器上查閱日志，協(xié)助遠(yuǎn)程了解設(shè)備運(yùn)行情況，或者故障診斷。

使用云服務(wù)器時(shí)，迫于服務(wù)器壓力，只有手動(dòng)打開debug開關(guān)（見后面第六節(jié)代碼示例介紹），才有日志上報(bào)（當(dāng)使用調(diào)試服務(wù)器時(shí)，開機(jī)前先檢查一下log開關(guān)，每2小時(shí)查詢一次log開關(guān)，如果開關(guān)未開啟，則不允許上傳調(diào)試日志），打開方式見《三、實(shí)例介紹》。

2演示功能概述

本示例將演示上報(bào)錯(cuò)誤日志的功能。

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

3.1 780E開發(fā)板一套

此核心板的詳細(xì)使用說(shuō)明參考：Air780E產(chǎn)品手冊(cè)中的<<開發(fā)板Core_Air780E使用說(shuō)明V1.0.5.pdf>>。

3.2 SIM卡

請(qǐng)準(zhǔn)備一張可正常上網(wǎng)的SIM卡，該卡可以是物聯(lián)網(wǎng)卡或您的個(gè)人手機(jī)卡。

特別提醒：請(qǐng)確保SIM卡未欠費(fèi)且網(wǎng)絡(luò)功能正常，以便順利進(jìn)行后續(xù)操作。

3.3 數(shù)據(jù)通信線

typec接口USB數(shù)據(jù)線即可。

3.4 PC電腦

WINDOWS系統(tǒng)。

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

4.1基本的下載調(diào)試工具

使用說(shuō)明參考：Luatools下載和詳細(xì)使用；

5errDump軟硬件資料

本文通過demo演示來(lái)說(shuō)明本章節(jié)內(nèi)容的基本用法。

5.1源碼和工具

Air780E模塊使用固件：SDK&Demo-合宙文檔中心，本demo使用的固件版本是：LuatOS-SoC_V1112_EC618_FULL.soc

本教程使用的demo：
https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/errDump

將固件和腳本燒錄到模塊中，使用說(shuō)明參考：
Luatools下載和詳細(xì)使用
https://docs.openluat.com/Luatools/

合宙云平臺(tái)：
https://iot.openluat.com

5.2本demo使用api介紹

errDump.config(enable,period,user_flag,custom_id,host,port)

作用：配置關(guān)鍵日志上傳IOT平臺(tái)，這里的日志包括引起luavm異常退出的日志和用戶通過record寫入的日志，類似于air的errDump。

參數(shù)

返回值

errDump.dump(zbuff,type,isDelete)

作用：手動(dòng)讀取異常日志，主要用于用戶將日志發(fā)送給自己的服務(wù)器而不是IOT平臺(tái)，如果在errDump.config配置了周期上傳，則不能使用本函數(shù)

參數(shù)

返回值

errDump.record(string)

作用：寫入用戶的異常日志，注意最大只有4KB，超過部分新的覆蓋舊的，開啟自動(dòng)上傳后會(huì)上傳到合宙IOT平臺(tái)

參數(shù)

返回值

6代碼示例介紹

6.1 上傳錯(cuò)誤日志到合宙云平臺(tái)

6.1.1 云平臺(tái)配置

合宙云平臺(tái)：https://iot.openluat.com

（1）打開IOT平臺(tái)

（2）新建一個(gè)項(xiàng)目

（3）將你自己建的項(xiàng)目KEY復(fù)制到DEMO中

（4）打開設(shè)備DEBUG開關(guān)

6.1.2 demo介紹

這里測(cè)試用的是合宙云平臺(tái)上報(bào)。

demo程序中打開自動(dòng)上報(bào)合宙云平臺(tái)部分，注釋掉手動(dòng)獲取信息部分。

使用合宙云平臺(tái)查看上報(bào)錯(cuò)誤信息的話，代碼更改如下：

7、功能驗(yàn)證

7.1 Luatools日志打印

7.2 云平臺(tái)查看錯(cuò)誤上報(bào)

本示例介紹了將錯(cuò)誤日志上報(bào)到云平臺(tái)的功能，分享完畢。