相信很多朋友都會忽視errDump錯誤日志上報，但不得不說的是技術高手都知道它真的是比較重要的一環。

讓我們以概述，準備環境等來一一說明：

1、errDump功能概述

LuatOS-Air錯誤日志上報功能模塊名叫：errDump，errDump對“量產投放市場的設備，遠程調試初步定位問題”至關重要，強烈建議客戶一定要使用此功能。

errDump就是將模塊運行過程中產生的錯誤信息或者應用日志通過TCP/UDP上報到互聯網上的指定服務器，技術人員可以在服務器上查閱日志，協助遠程了解設備運行情況，或者故障診斷。

使用合宙云服務器時，迫于服務器壓力，只有手動打開debug開關（見后面第六節代碼示例介紹），才有日志上報（當使用合宙調試服務器時，開機前先檢查一下log開關，每2小時查詢一次log開關，如果開關未開啟，則不允許上傳調試日志），打開方式見《三、實例介紹》。

2、演示功能概述

本示例將演示上報錯誤日志的功能。

3、準備硬件環境

3.1 780E開發板一套

此核心板的詳細使用說明參考：Air780E產品手冊中的<<開發板Core_Air780E使用說明V1.0.5.pdf>>。

3.2 SIM卡

請準備一張可正常上網的SIM卡，該卡可以是物聯網卡或您的個人手機卡。

特別提醒：請確保SIM卡未欠費且網絡功能正常，以便順利進行后續操作。

3.3 數據通信線

typec接口USB數據線即可。

3.4 PC電腦

WINDOWS系統。

4、準備軟件環境

4.1基本的下載調試工具

使用說明參考：Luatools下載和詳細使用；

5、errDump軟硬件資料

本文通過demo演示來說明本章節內容的基本用法。

5.1源碼和工具

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

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

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

合宙云平臺：
https://iot.openluat.com

5.2本demo使用api介紹

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

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

參數

傳入值類型	解釋
boolean	是否啟用記錄功能， false的話將不會記錄任何日志
int	定時上傳周期，單位秒，默認600秒， 這個是自動上傳時候后的重試時間時間， 在開機后或者有record操作后， 會很快嘗試上傳到合宙IOT平臺一次， 如果為0，則不會上傳， 由用戶dump后自己上傳自己的平臺
string	用戶的特殊標識，可以為空
string	設備識別號,4G設備默認是imei, 其他設備默認是mcu.unique_id
string	服務器域名, 默認dev_msg1.openluat.com
int	服務器端口,默認

返回值

返回值類型	解釋
nil	無返回值

errDump.dump(zbuff,type,isDelete)

作用：手動讀取異常日志，主要用于用戶將日志發送給自己的服務器而不是IOT平臺，如果在errDump.config配置了周期上傳，則不能使用本函數

參數

傳入值類型	解釋
zbuff	日志信息緩存， 如果為nil就不會讀出
int	日志類型，目前只有： errDump.TYPE_SYS errDump.TYPE_USR
boolean	是否刪除日志

返回值

返回值類型	解釋
boolean	true表示本次讀取前并沒有寫入數據， false反之， 在刪除日志前， 最好再讀一下確保沒有新的數據寫入了

errDump.record(string)

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

參數

傳入值類型	解釋
string	日志

返回值

返回值類型	解釋
nil	無返回值

6、代碼示例介紹

6.1 上傳錯誤日志到云平臺

6.1.1 云平臺配置

云平臺：https://iot.openluat.com

（1）打開IOT平臺

1errDump功能概述

LuatOS-Air錯誤日志上報功能模塊名叫：errDump，errDump對“量產投放市場的設備，遠程調試初步定位問題”至關重要，強烈建議客戶一定要使用此功能。

errDump就是將模塊運行過程中產生的錯誤信息或者應用日志通過TCP/UDP上報到互聯網上的指定服務器，技術人員可以在服務器上查閱日志，協助遠程了解設備運行情況，或者故障診斷。

使用云服務器時，迫于服務器壓力，只有手動打開debug開關（見后面第六節代碼示例介紹），才有日志上報（當使用調試服務器時，開機前先檢查一下log開關，每2小時查詢一次log開關，如果開關未開啟，則不允許上傳調試日志），打開方式見《三、實例介紹》。

2演示功能概述

本示例將演示上報錯誤日志的功能。

3準備硬件環境

3.1 780E開發板一套

此核心板的詳細使用說明參考：Air780E產品手冊中的<<開發板Core_Air780E使用說明V1.0.5.pdf>>。

3.2 SIM卡

請準備一張可正常上網的SIM卡，該卡可以是物聯網卡或您的個人手機卡。

特別提醒：請確保SIM卡未欠費且網絡功能正常，以便順利進行后續操作。

3.3 數據通信線

typec接口USB數據線即可。

3.4 PC電腦

WINDOWS系統。

4準備軟件環境

4.1基本的下載調試工具

使用說明參考：Luatools下載和詳細使用；

5errDump軟硬件資料

本文通過demo演示來說明本章節內容的基本用法。

5.1源碼和工具

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

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

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

合宙云平臺：
https://iot.openluat.com

5.2本demo使用api介紹

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

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

參數

傳入值類型	解釋
boolean	是否啟用記錄功能， false的話將不會記錄任何日志
int	定時上傳周期，單位秒，默認600秒， 這個是自動上傳時候后的重試時間時間， 在開機后或者有record操作后， 會很快嘗試上傳到合宙IOT平臺一次， 如果為0，則不會上傳， 由用戶dump后自己上傳自己的平臺
string	用戶的特殊標識，可以為空
string	設備識別號,4G設備默認是imei, 其他設備默認是mcu.unique_id
string	服務器域名, 默認dev_msg1.openluat.com
int	服務器端口,默認

返回值

返回值類型	解釋
nil	無返回值

errDump.dump(zbuff,type,isDelete)

作用：手動讀取異常日志，主要用于用戶將日志發送給自己的服務器而不是IOT平臺，如果在errDump.config配置了周期上傳，則不能使用本函數

參數

傳入值類型	解釋
zbuff	日志信息緩存， 如果為nil就不會讀出
int	日志類型，目前只有： errDump.TYPE_SYS errDump.TYPE_USR
boolean	是否刪除日志

返回值

返回值類型	解釋
boolean	true表示本次讀取前并沒有寫入數據， false反之， 在刪除日志前， 最好再讀一下確保沒有新的數據寫入了

errDump.record(string)

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

參數

傳入值類型	解釋
string	日志

返回值

返回值類型	解釋
nil	無返回值

6代碼示例介紹

6.1 上傳錯誤日志到合宙云平臺

6.1.1 云平臺配置

合宙云平臺：https://iot.openluat.com

（1）打開IOT平臺

（2）新建一個項目

（3）將你自己建的項目KEY復制到DEMO中

（4）打開設備DEBUG開關

6.1.2 demo介紹

這里測試用的是合宙云平臺上報。

demo程序中打開自動上報合宙云平臺部分，注釋掉手動獲取信息部分。

使用合宙云平臺查看上報錯誤信息的話，代碼更改如下：

7、功能驗證

7.1 Luatools日志打印

7.2 云平臺查看錯誤上報

本示例介紹了將錯誤日志上報到云平臺的功能，分享完畢。