# 一、errDump功能

LuatOS-Air错误日志上报功能模块名叫：errDump，errDump对“量产投放市场的设备，远程调试初步定位问题”至关重要，强烈建议客户一定要使用此功能。errDump就是将模块运行过程中产生的错误信息或者应用日志通过TCP/UDP上报到互联网上的指定服务器，技术人员可以在服务器上查阅日志，协助远程了解设备运行情况，或者故障诊断。

使用合宙云服务器时，迫于服务器压力，只有手动打开debug开关（见后面第六节代码示例介绍），才有日志上报（当使用合宙调试服务器时，开机前先检查一下log开关，每2小时查询一次log开关，如果开关未开启，则不允许上传调试日志），打开方式见《三、实例介绍》。

二、演示功能概述

本示例将演示上报错误日志的功能。

三、准备硬件环境

3.1 780E开发板一套

此核心板的详细使用说明参考：Air780E产品手册中的<<开发板Core_Air780E使用说明V1.0.5.pdf>>。

3.2 PC电脑

WINDOWS系统。

3.3 SIM卡

请准备一张可正常上网的SIM卡，该卡可以是物联网卡或您的个人手机卡。

特别提醒：请确保SIM卡未欠费且网络功能正常，以便顺利进行后续操作。

3.4 数据通信线

typec接口 USB数据线即可。

四、准备软件环境

4.1基本的下载调试工具

使用说明参考：Luatools下载和详细使用；

五、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	服务器端口,默认