LuatOS/module/Air8101/demo/errdump

功能模块介绍

1、main.lua：主程序入口；

2、netdrv_device.lua：网卡驱动设备，可以配置使用netdrv文件夹内的四种网卡(单4g网卡，单wifi网卡，单spi以太网卡，多网卡)中的任何一种网卡；

3、errdump_read.lua：手动读取errdump异常日志功能模块；

4、errdump_tcp文件夹：将手动读取到的日志发到tcp服务器中。

5、uart_app.lua：uart应用层，用于将手动读取的异常日志通过串口发出去；

6、auto_dump_air_srv.lua：自动上报异常日志到合宙服务器中；

7、auto_dump_udp_srv.lua：自动上报异常日志到自建udp服务器中；注：1、必须udp服务器；2、收到模组上报的异常日志后要回复一个大写的OK。

系统消息介绍

1、"IP_READY"：某种网卡已经获取到ip信息，仅仅获取到了ip信息，能否和外网连通还不确认；

2、"IP_LOSE"：某种网卡已经掉网；

用户消息介绍

1、"ERRDUMP_DATA_SEND_UART"：手动读取到的异常日志通过此消息发送到uart应用层；

2、"SEND_DATA_REQ"：手动读取到异常日志后发布此消息，通知socket client发送数据给服务器；

演示功能概述

1、主要是使用Air8000开发板演示四种errdump异常日志上报功能，使用的时候根据自己需求在main.lua文件中选择要使用的功能，注意不能同时使用自动上报和手动读取功能。

（1）自动上报异常日志到iot平台

（2）自动上报异常日志到自建udp服务器

（3）手动读取异常日志并通过串口传输

（4）手动读取异常日志并通过tcp传输

2、netdrv_device：配置连接外网使用的网卡，目前支持以下四种选择（四选一）

(1) netdrv_wifi：WIFI STA网卡

(2) netdrv_eth_rmii：通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡

(3) netdrv_eth_spi：通过SPI外挂CH390H芯片的以太网卡

(4) netdrv_multiple：支持以上三种网卡，可以配置三种网卡的优先级

演示硬件环境

1、Air8101核心板一块

2、TYPE-C USB数据线一根

3、USB转串口数据线一根

4、Air8101核心板和数据线的硬件接线方式为

• Air8101核心板通过TYPE-C USB口供电；（核心板背面的功耗测试开关拨到OFF一端）

• 如果测试发现软件频繁重启，重启原因值为：poweron reason 0，可能是供电不足，此时再通过直流稳压电源对核心板的vbat管脚进行4V供电，或者VIN管脚进行5V供电；

• TYPE-C USB数据线直接插到核心板的TYPE-C USB座子，另外一端连接电脑USB口；

• USB转串口数据线，一般来说，白线连接核心板的12/U1TX，绿线连接核心板的11/U1RX，黑线连接核心板的gnd，另外一端连接电脑USB口；

5、可选AirPHY_1000配件板一块，Air8101核心板和AirPHY_1000配件板的硬件接线方式为:

Air8101核心板	AirPHY_1000配件板
59/3V3	3.3v
gnd	gnd
5/D2	RX1
72/D1	RX0
71/D3	CRS
4/D0	MDIO
6/D4	TX0
74/PCK	MDC
70/D5	TX1
7/D6	TXEN
不接	NC
69/D7	CLK

6、可选AirETH_1000配件板一块，Air8101核心板和AirETH_1000配件板的硬件接线方式为:

Air8101核心板	AirETH_1000配件板
59/3V3	3.3v
gnd	gnd
28/DCLK	SCK
54/DISP	CSS
55/HSYN	SDO
57/DE	SDI
14/GPIO8	INT

7、可选Air780EHM/Air780EHV/Air780EGH/Air780EPM核心板或者开发板一块，Air8101核心板和Air780EHM/Air780EHV/Air780EGH/Air780EPM核心板或者开发板的硬件接线方式为:

Air8101核心板	Air780EHM/Air780EHV/Air780EGH/Air780EPM核心板
gnd	GND
54/DISP	83/SPI0CS
55/HSYN	84/SPI0MISO
57/DE	85/SPI0MOSI
28/DCLK	86/SPI0CLK
43/R2	19/GPIO22
75/GPIO28	22/GPIO1

Air8101核心板	Air780EHM/Air780EHV/Air780EGH/Air780EPM开发板
gnd	GND
54/DISP	SPI_CS
55/HSYN	SPI_MISO
57/DE	SPI_MOSI
28/DCLK	SPI_CLK
43/R2	GPIO22
75/GPIO28	GPIO1

演示软件环境

1、Luatools下载调试工具

2、Air8101 V1005版本固件（理论上，2025年7月26日之后发布的固件都可以）

3、PC端的串口工具，例如SSCOM、LLCOM等都可以；

4、PC端浏览器访问合宙TCP/UDP web测试工具；

演示开发步骤

1、搭建好硬件环境

2、在main.lua文件中选择好要使用的功能，通过Luatools将demo与固件烧录到开发板中

3、烧录好后，板子开机同时在luatools上查看日志：

可以看到设备打印的死机日志以及errdump ok!字样

[2025-07-15 16:17:59.681][000000034.674] D/errDump errdump ok!
[2025-07-15 16:18:14.479][000000049.480] dns_run 674:dev_msg1.openluat.com state 0 id 4 ipv6 0 use dns server2, try 0
[2025-07-15 16:18:14.634][000000049.625] dns_run 691:dns all done ,now stop
[2025-07-15 16:18:14.728][000000049.721] D/errDump errdump ok!
[2025-07-15 16:18:25.443][000000060.434] E/user.coroutine.resume	auto_dump_air_srv.lua:42: attempt to index a nil value (global 'lllllllllog')
stack traceback:
	auto_dump_air_srv.lua:42: in function <errdump_test.lua:30>
[2025-07-15 16:18:25.944][000000060.934] E/main Luat:
[2025-07-15 16:18:25.961][000000060.935] E/main auto_dump_air_srv.lua:42: attempt to index a nil value (global 'lllllllllog')
stack traceback:
	auto_dump_air_srv.lua:42: in function <errdump_test.lua:30>

烧录不同的功能代码，可以在对应的平台看到如下信息：

errdump_demo_LuatOS-SoC_V2009_Air8000,001.000.000,866597072472820,866597072472820, 测试一下用户的记录功能
errdump_demo_LuatOS-SoC_V2009_Air8000,001.000.000,866597072472820,866597072472820, poweron reason:3 auto_dump_air_srv.lua:42: attempt to index a nil value (global 'lllllllllog') stack traceback: auto_dump_air_srv.lua:42: in function <errdump_test.lua:30>