LuatOS/module/Air780EHM_Air780EHV_Air780EGH/demo/fota2/self_server

功能模块介绍

自建服务器fota功能演示

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

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

3、update.lua：使用自建服务器进行远程升级功能模块，简单升级演示；

4、tcp_self_server文件夹：通过tcp服务器下发升级指令（指令格式使用json字符串，包含是否升级参数），控制设备启动customer_srv_fota功能模块，使用自建服务器进行升级；

5、customer_srv_fota.lua：自建服务器升级功能模块；

6、psm_power_fota.lua：低功耗fota功能模块，此场景是针对psm状态下升级没完成就进入休眠导致升级失败的情况写的一个例子。需要注意的是此场景与上面两种场景不能同时使用；

系统消息介绍

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

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

用户消息介绍

1、"RECV_DATA_FROM_SERVER"：socket client收到服务器下发的数据后，通过此消息发布出去，给其他应用模块处理；

2、"SEND_DATA_REQ"：其他应用模块发布此消息，通知socket client发送数据给服务器；

演示功能概述

1、combination文件夹下的demo会有三个演示场景，在main.lua中选择要使用的场景：

(1) 使用自建服务器升级，演示最简单的升级逻辑。

(2) 使用自建服务器升级，通过tcp下发升级指令控制设备升级，指令格式使用json字符串，包含版本、url、是否升级参数，演示如何通过服务器控制下发指令去升级。

(3) 休眠状态下升级，此场景是针对psm状态下升级没完成就进入休眠导致升级失败的情况写的一个例子。

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

(1) netdrv_4g：4G网卡

(2) netdrv_wifi：WIFI STA网卡

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

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

演示硬件环境

1、Air780EXX核心板一块

2、TYPE-C USB数据线一根

3、USB转串口数据线一根

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

• Air780EXX核心板通过TYPE-C USB口供电；

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

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

• USB转串口数据线，一般来说，白线连接核心板的18/U1TXD，绿线连接核心板的17/U1RXD，黑线连接核心板的gnd，另外一端连接电脑USB口；

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

Air780EXX核心板	AirETH_1000配件板
3V3	3.3v
gnd	gnd
86/SPI0CLK	SCK
83/SPI0CS	CSS
84/SPI0MISO	SDO
85/SPI0MOSI	SDI
107/GPIO21	INT

演示软件环境

1、Luatools下载调试工具

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

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

演示核心步骤

1、搭建好硬件环境

2、PC端浏览器访问合宙TCP/UDP web测试工具，点击 打开TCP 按钮，会创建一个TCP server，将server的地址和端口赋值给tcp_client_self_main.lua中的SERVER_ADDR和SERVER_PORT两个变量

3、demo脚本代码netdrv_device.lua中，按照自己的网卡需求启用对应的Lua文件

• 如果需要单4G网卡，打开require "netdrv_4g"，其余注释掉

• 如果需要单WIFI STA网卡，打开require "netdrv_wifi"，其余注释掉；同时netdrv_wifi.lua中的wlan.connect("茶室-降功耗,找合宙!", "Air123456", 1)，前两个参数，修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi

• 如果需要以太网卡，打开require "netdrv_eth_spi"，其余注释掉

• 如果需要多网卡，打开require "netdrv_multiple"，其余注释掉；同时netdrv_multiple.lua中的ssid = "茶室-降功耗,找合宙!", password = "Air123456", 修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi

4、Luatools烧录内核固件和修改后的demo脚本代码

5、使用Luatools制作升级包，先把新旧版本分别生成量产文件，然后再制作升级包，工具上栏 luatOS->固件工具->差分包/整包升级包制作，将制作好的升级包配置到合宙iot服务器自己项目下，或上传到自建服务器上面；

6、烧录成功后，自动开机运行

7、合宙TCP/UDP web测试工具上创建的两个TCP server可以看到有设备连接上来，然后可以下发下面字符串触发升级：

--自建服务器下发这个指令，下发之前需要在服务器上面配置好升级包，然后吧url给到字符串
--定义一个json格式如下，具体可以根据实际情况定义：
-- {"fota": "true","url": "http://airtest.openluat.com:2900/download/FOTA2_DEMO_2012.001.001_LuatOS-SoC_Air780EHM.bin"}

8、可以看到升级过程如下，不管是什么场景下升级，基本都是如下情况：

--没有升级之前可以看到如下打印
I/user.fota 脚本版本号 001.000.000 core版本号 V2010

I/user.fota_task_func recv IP_READY 1
I/user.开始检查升级

I/user.升级包下载成功,重启模块


--升级之后可以看到如下打印
I/user.fota 脚本版本号 001.000.001 core版本号 V2012
--升级重启之后还是会检查升级，所以会有如下打印属于正常情况，其中"code": 27 是合宙iot服务器返回的状态码，意思是已经是最新版本了。自建服务器如果没做设置会再下载一遍升级包。

I/user.fota -9 {"code": 27, "msg": "\u5df2\u662f\u6700\u65b0\u7248\u672c"}
I/user.使用合宙服务器,接下来解析body里的code
I/user.已是最新版本 1.设备的固件/脚本版本高于或等于云平台上的版本号 2.用户项目升级配置中未添加该设备 3.云平台升级配置中，是否升级配置为否
I/user.fota 4

9、对于psm休眠状态下的升级的场景，打印的版本来判断是否是最新版本。模组升级成功后会自动进入psm休眠状态。可以通过电流查看休眠情况。