wangfq/mobile_comm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init: Air780EPM 官方 LuatOS 项目代码基线

Browse Source 
- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码
- 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等)
- 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
This commit is contained in:
wangfq
2026-08-31 08:53:49 +08:00
commit 173dd6874f
813 changed files with 125484 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/fota3_auto.lua
+104
View File
@@ -0,0 +1,104 @@
--[[
@module fota3_auto
@summary libfota3 无UI自动升级功能模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@注意 仅合宙内部使用
@usage
使用libfota3扩展库实现无UI设备的自动FOTA升级功能。
特点：
1、不使用 on_confirm 回调，检测到新版本自动下载并重启；
2、使用 on_status 回调记录升级状态日志；
3、支持自动定时检测，默认24小时检测一次；
适用场景：
- DTU、传感器、网关等无屏幕设备
- 无人值守场景
]]
-- 项目密钥：在 iot.openluat.com 平台主页面上方导航栏 Turnkey 页面中获取，仅支持合宙内部使用
local PRODUCT_KEY = "your_project_key_here"
-- 加载libfota3扩展库
local libfota3 = require "libfota3"
-- 循环打印版本号, 方便看版本号变化, 非必须
local function print_version()
log.info("fota3", "脚本版本号", VERSION, "core版本号", rtos.version())
end
sys.timerLoopStart(print_version, 3000)
-- 启动FOTA自动升级任务
local function fota3_auto_task()
-- 如果当前时间点设置的默认网卡还没有连接成功，一直在这里循环等待
while not socket.adapter(socket.dft()) do
log.warn("fota3_auto", "wait IP_READY", socket.dft())
-- 在此处阻塞等待默认网卡连接成功的消息"IP_READY"
-- 或者等待1秒超时退出阻塞等待状态;
-- 注意：此处的1000毫秒超时不要修改的更长；
-- 因为当使用exnetif.set_priority_order配置多个网卡连接外网的优先级时，会隐式的修改默认使用的网卡
-- 当exnetif.set_priority_order的调用时序和此处的socket.adapter(socket.dft())判断时序有可能不匹配
-- 此处的1秒，能够保证，即使时序不匹配，也能1秒钟退出阻塞状态，再去判断socket.adapter(socket.dft())
sys.waitUntil("IP_READY", 1000)
end
-- 检测到了IP_READY消息
log.info("fota3_auto", "recv IP_READY", socket.dft())
-- 这个判断是提醒要设置PRODUCT_KEY的,实际生产请删除
if "your_project_key_here" == _G.PRODUCT_KEY then
while true do
sys.wait(1000)
log.info("fota3", "请修改正确的PRODUCT_KEY")
end
end
-- 启动 FOTA 自动升级
libfota3.request({
-- 项目密钥：在 iot.openluat.com 平台主页面上方导航栏 Turnkey 页面中获取，仅支持合宙内部使用
project_key = PRODUCT_KEY,
-- 脚本名称：与项目名保持一致即可
script_name = PROJECT,
-- 脚本版本：与 VERSION 保持一致
script_version = VERSION,
-- 启用自动定时检测
auto = true,
-- 自动检测间隔：24小时（86400秒）
-- 可根据需求调整，建议不要太频繁
interval = 86400,
-- 状态回调：记录升级状态日志
on_status = function(status, msg, percent)
if status == "downloading" then
-- 下载进度：percent 为 0-100
log.info("fota3", string.format("[%s] %s %d%%", status, msg, percent or 0))
else
-- 其他状态
log.info("fota3", string.format("[%s] %s", status, msg))
end
end,
-- 注意：无UI设备不需要 on_confirm 回调
-- libfota3 检测到新版本后会自动下载并重启
})
end
-- 初始化FOTA任务
sys.taskInit(fota3_auto_task)
-- 演示手动触发升级检测，可以根据需求打开
-- sys.timerLoopStart(function()
-- libfota3.check_update()
-- end, 4 * 3600000) -- 每4小时手动检测一次
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/main.lua
+69
View File
@@ -0,0 +1,69 @@
--[[
@module main
@summary LuatOS用户应用脚本文件入口，总体调度应用逻辑
@version 1.0
@date 2026.08.24
@author 马梦阳
@注意 仅合宙内部使用
@usage
本demo演示的核心功能为：
使用libfota3扩展库进行FOTA远程升级，适用于无屏幕设备（DTU、传感器、网关等）的自动升级场景。
特点：
1、不使用 on_confirm 回调，检测到新版本自动下载并重启；
2、支持网络驱动模块，兼容4G/以太网/多网卡场景；
更多说明参考本目录下的readme.md文件
]]
--[[
必须定义PROJECT和VERSION变量，Luatools工具会用到这两个变量，远程升级功能也会用到这两个变量
PROJECT：项目名，ascii string类型
可以随便定义，只要不使用,就行
VERSION：项目版本号，ascii string类型
如果使用合宙iot.openluat.com进行远程升级，必须按照"XXX.YYY.ZZZ"三段格式定义：
X、Y、Z各表示1位数字，三个X表示的数字可以相同，也可以不同，同理三个Y和三个Z表示的数字也是可以相同，可以不同
因为历史原因，YYY这三位数字必须存在，但是没有任何用处，可以一直写为999
如果不使用合宙iot.openluat.com进行远程升级，根据自己项目的需求，自定义格式即可
]]
PROJECT = "FOTA3_NO_UI"
VERSION = "001.999.000"
-- 在日志中打印项目名和项目版本号
log.info("main", PROJECT, VERSION)
-- 如果内核固件支持errDump功能，此处进行配置，【强烈建议打开此处的注释】
-- 因为此功能模块可以记录并且上传脚本在运行过程中出现的语法错误或者其他自定义的错误信息，可以初步分析一些设备运行异常的问题
-- 以下代码是最基本的用法，更复杂的用法可以详细阅读API说明文档
-- 启动errDump日志存储并且上传功能，600秒上传一次
-- if errDump then
-- errDump.config(true, 600)
-- end
-- 启动一个循环定时器
-- 每隔3秒钟打印一次总内存，实时的已使用内存，历史最高的已使用内存情况
-- 方便分析内存使用是否有异常
-- sys.timerLoopStart(function()
-- log.info("mem.lua", rtos.meminfo())
-- log.info("mem.sys", rtos.meminfo("sys"))
-- end, 3000)
-- 加载网络驱动设备功能模块
require "netdrv_device"
-- 加载无UI自动升级功能模块
require "fota3_auto"
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/netdrv/netdrv_4g.lua
+43
View File
@@ -0,0 +1,43 @@
--[[
@module netdrv_4g
@summary "4G网卡"驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为4G网卡驱动模块，核心业务逻辑为：
1、监听"IP_READY"和"IP_LOSE"，在日志中进行打印；
本文件没有对外接口，直接在其他功能模块中require "netdrv_4g"就可以加载运行；
]]
local function ip_ready_func(ip, adapter)
if adapter == socket.LWIP_GP then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_4g.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_GP))
end
end
local function ip_lose_func(adapter)
if adapter == socket.LWIP_GP then
log.warn("netdrv_4g.ip_lose_func", "IP_LOSE")
end
end
-- 此处订阅"IP_READY"和"IP_LOSE"两种消息
-- 在消息的处理函数中，仅仅打印了一些信息，便于实时观察4G网络的连接状态
-- 也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
-- 在Air780EPM上，内核固件运行起来之后，默认网卡就是socket.LWIP_GP
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/netdrv/netdrv_eth_spi.lua
+78
View File
@@ -0,0 +1,78 @@
--[[
@module netdrv_eth_spi
@summary "通过SPI外挂CH390H芯片的以太网卡"驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为"通过SPI外挂CH390H芯片的以太网卡"驱动模块，核心业务逻辑为：
1、打开CH390H芯片供电开关；
2、初始化spi0，初始化以太网卡，并且在以太网卡上开启DHCP(动态主机配置协议)；
3、以太网卡的连接状态发生变化时，在日志中进行打印；
直接使用Air780EPM V1.3版本开发板硬件测试即可；
本文件没有对外接口，直接在其他功能模块中require "netdrv_eth_spi"就可以加载运行；
]]
local exnetif = require "exnetif"
local function ip_ready_func(ip, adapter)
if adapter == socket.LWIP_ETH then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_eth_spi.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_ETH))
end
end
local function ip_lose_func(adapter)
if adapter == socket.LWIP_ETH then
log.warn("netdrv_eth_spi.ip_lose_func", "IP_LOSE")
end
end
-- 以太网联网成功（成功连接路由器，并且获取到了IP地址）后，内核固件会产生一个"IP_READY"消息
-- 各个功能模块可以订阅"IP_READY"消息实时处理以太网联网成功的事件
-- 也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
-- 以太网断网后，内核固件会产生一个"IP_LOSE"消息
-- 各个功能模块可以订阅"IP_LOSE"消息实时处理以太网断网的事件
-- 也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
--此处订阅"IP_READY"和"IP_LOSE"两种消息
--在消息的处理函数中，仅仅打印了一些信息，便于实时观察"通过SPI外挂CH390H芯片的以太网卡"的连接状态
--也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
local function netdrv_eth_spi_task_func()
-- 配置SPI外接以太网芯片CH390H的单网卡，exnetif.set_priority_order使用的网卡编号为socket.LWIP_ETH
-- 本demo使用Air780EPM V1.3版本开发板测试，开发板上的硬件配置为：
-- GPIO20为CH390H以太网芯片的供电使能控制引脚
-- 使用spi0，片选引脚使用GPIO8，中断引脚使用GPIO22
-- 如果使用的硬件和以上描述的环境不同，根据自己的硬件配置修改以下参数
exnetif.set_priority_order({
{
ETHERNET = {
pwrpin = 20,
tp = netdrv.CH390,
opts = {spi = 0, cs = 8, irq = 22}
}
}
})
end
-- 启动一个task，task的处理函数为netdrv_eth_spi_task_func
-- 在处理函数中调用exnetif.set_priority_order设置网卡优先级
-- 因为exnetif.set_priority_order要求必须在task中被调用，所以此处启动一个task
sys.taskInit(netdrv_eth_spi_task_func)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/netdrv/netdrv_multiple.lua
+89
View File
@@ -0,0 +1,89 @@
--[[
@module netdrv_multiple
@summary 多网卡（4G网卡、通过SPI外挂CH390H芯片的以太网卡）驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为多网卡驱动模块，核心业务逻辑为：
1、调用exnetif.set_priority_order配置多网卡的控制参数以及优先级；
直接使用Air780EPM V1.3版本开发板硬件测试即可；
本文件没有对外接口，直接在其他功能模块中require "netdrv_multiple"就可以加载运行；
]]
local exnetif = require "exnetif"
-- 网卡状态变化通知回调函数
-- 当exnetif中检测到网卡切换或者所有网卡都断网时，会触发调用此回调函数
-- 当网卡切换切换时：
-- net_type：string类型，表示当前使用的网卡字符串
-- adapter：number类型，表示当前使用的网卡id
-- 当所有网卡断网时：
-- net_type：为nil
-- adapter：number类型，为-1
local function netdrv_multiple_notify_cbfunc(net_type,adapter)
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
if type(net_type)=="string" then
log.info("netdrv_multiple_notify_cbfunc", "use new adapter", net_type, adapter)
elseif type(net_type)=="nil" then
log.warn("netdrv_multiple_notify_cbfunc", "no available adapter", net_type, adapter)
else
log.warn("netdrv_multiple_notify_cbfunc", "unknown status", net_type, adapter)
end
end
local function netdrv_multiple_task_func()
--设置网卡优先级
exnetif.set_priority_order(
{
-- "通过SPI外挂CH390H芯片"的以太网卡，使用Air780EPM V1.3版本开发板验证
{
ETHERNET = {
-- 供电使能GPIO
pwrpin = 20,
-- 设置的多个"已经IP READY，但是还没有ping通"网卡，循环执行ping动作的间隔（单位毫秒，可选）
-- 如果没有传入此参数，exnetif会使用默认值10秒
ping_time = 3000,
-- 连通性检测ip(选填参数)；
-- 如果没有传入ip地址，exnetif中会默认使用httpdns能否成功获取baidu.com的ip作为是否连通的判断条件；
-- 如果传入，一定要传入可靠的并且可以ping通的ip地址；
-- ping_ip = "填入可靠的并且可以ping通的ip地址",
-- 网卡芯片型号(选填参数)，仅spi方式外挂以太网时需要填写。
tp = netdrv.CH390,
opts = {spi=0, cs=8, irq=22}
}
},
-- 4G网卡
{
LWIP_GP = true
}
}
)
end
-- 设置网卡状态变化通知回调函数netdrv_multiple_notify_cbfunc
exnetif.notify_status(netdrv_multiple_notify_cbfunc)
-- 如果存在udp网络应用，并且udp网络应用中，根据应用层的心跳能够判断出来udp数据通信出现了异常；
-- 可以在判断出现异常的位置，调用一次exnetif.check_network_status()接口，强制对当前正式使用的网卡进行一次连通性检测；
-- 如果存在tcp网络应用，不需要用户调用exnetif.check_network_status()接口去控制，exnetif会在tcp网络应用通信异常时自动对当前使用的网卡进行连通性检测。
-- 启动一个task，task的处理函数为netdrv_multiple_task_func
-- 在处理函数中调用exnetif.set_priority_order设置网卡优先级
-- 因为exnetif.set_priority_order要求必须在task中被调用，所以此处启动一个task
sys.taskInit(netdrv_multiple_task_func)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/netdrv/netdrv_pc.lua
+45
View File
@@ -0,0 +1,45 @@
--[[
@module netdrv_pc
@summary "pc模拟器网卡"驱动模块
@version 1.0
@date 2025.07.01
@author 朱天华
@usage
本文件为pc模拟器网卡驱动模块，核心业务逻辑为：
1、监听"IP_READY"和"IP_LOSE"，在日志中进行打印；
本文件没有对外接口，直接在其他功能模块中require "netdrv_pc"就可以加载运行；
]]
local function ip_ready_func(ip, adapter)
if adapter == socket.ETH0 then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_pc.ip_ready_func", "IP_READY", socket.localIP(socket.ETH0))
end
end
local function ip_lose_func(adapter)
if adapter == socket.ETH0 then
log.warn("netdrv_pc.ip_lose_func", "IP_LOSE")
end
end
--此处订阅"IP_READY"和"IP_LOSE"两种消息
--在消息的处理函数中，仅仅打印了一些信息，便于实时观察pc模拟器网络的连接状态
--也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
-- 设置默认网卡为socket.ETH0
-- pc模拟器上的默认网卡仍然需要使用接口(socket.ETH0)来设置，因为exnetif扩展库当前还不支持模拟器
socket.dft(socket.ETH0)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/no_support_ui/netdrv_device.lua
+34
View File
@@ -0,0 +1,34 @@
--[[
@module netdrv_device
@summary 网络驱动设备功能模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为网络驱动设备功能模块，核心业务逻辑为：根据项目需求，选择并且配置合适的网卡(网络适配器)
1、netdrv_4g：socket.LWIP_GP，4G网卡；
2、netdrv_eth_spi：socket.LWIP_USER1，通过SPI外挂CH390H芯片的以太网卡；
3、netdrv_multiple：可以配置多种网卡的优先级，按照优先级配置，使用其中一种网卡连接外网；
4、netdrv_pc：socket.ETH0，PC模拟器网卡；
根据自己的项目需求，只需要require以上四种中的一种即可；
本文件没有对外接口，直接在main.lua中require "netdrv_device"就可以加载运行；
]]
-- 根据自己的项目需求，只需要require以下四种中的一种即可；
-- 加载"4G网卡"驱动模块
require "netdrv_4g"
-- 加载"通过SPI外挂CH390H芯片的以太网卡"驱动模块
-- require "netdrv_eth_spi"
-- 加载"可以配置优先级的多种网卡"驱动模块
-- require "netdrv_multiple"
-- 加载"PC模拟器网卡"驱动模块
-- require "netdrv_pc"
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/fota3_ui.lua
+211
View File
@@ -0,0 +1,211 @@
--[[
@module fota3_ui
@summary libfota3 有UI确认升级功能模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@注意 仅合宙内部使用
@usage
使用libfota3扩展库实现有UI设备的FOTA升级功能。
特点：
1、使用 on_confirm 回调实现用户确认交互；
2、检测到新版本后弹窗让用户确认是否下载；
3、下载完成后弹窗让用户确认是否重启；
4、支持显示下载进度；
适用场景：
- 手持终端、智能家居面板等有屏幕设备
- 需要用户确认的升级场景
]]
-- 项目密钥：在 iot.openluat.com 平台主页面上方导航栏 Turnkey 页面中获取，仅支持合宙内部使用
local PRODUCT_KEY = "your_project_key_here"
-- 加载libfota3扩展库
local libfota3 = require "libfota3"
-- 循环打印版本号, 方便看版本号变化, 非必须
local function print_version()
log.info("fota3", "脚本版本号", VERSION, "core版本号", rtos.version())
end
sys.timerLoopStart(print_version, 3000)
-- ============================================================
-- UI 相关函数（需要根据实际硬件平台实现）
-- ============================================================
-- 存储用户确认结果
local user_confirm_result = nil
--[[
@function show_confirm_dialog
@summary 显示确认对话框（需要根据实际UI框架实现）
@param title string 对话框标题
@param message string 提示信息
@param on_confirm function 确认回调，传入 true/false
@return 无
@description
此函数需要根据实际硬件平台的UI框架实现。
示例中使用日志模拟，实际项目中应调用：
- AirUI 的弹窗组件
- 或其他GUI框架的对话框API
实现要点：
1. 显示对话框，包含"确认"和"取消"按钮
2. 用户点击按钮后调用 on_confirm(true) 或 on_confirm(false)
]]
local function show_confirm_dialog(title, message, on_confirm)
-- ========================================
-- 以下是模拟实现，实际项目请替换为真实UI代码
-- ========================================
log.info("ui", "========================================")
log.info("ui", title)
log.info("ui", message)
log.info("ui", "========================================")
-- 模拟用户确认（3秒后自动确认）
-- 实际项目中应等待用户点击按钮
sys.taskInit(function()
log.info("ui", "模拟用户确认：3秒后自动确认...")
sys.wait(3000)
-- 模拟用户点击"确认"按钮
on_confirm(true)
end)
end
--[[
@function show_progress
@summary 显示下载进度（需要根据实际UI框架实现）
@param percent number 进度百分比 0-100
@param message string 进度信息
@return 无
@description
此函数需要根据实际硬件平台的UI框架实现。
示例中使用日志打印，实际项目中应更新进度条UI
]]
local function show_progress(percent, message)
-- ========================================
-- 以下是模拟实现，实际项目请替换为真实UI代码
-- ========================================
log.info("ui", string.format("进度: %d%% - %s", percent, message))
end
-- 启动FOTA带UI确认升级任务
local function fota3_ui_task()
-- 如果当前时间点设置的默认网卡还没有连接成功，一直在这里循环等待
while not socket.adapter(socket.dft()) do
log.warn("fota3_ui", "wait IP_READY", socket.dft())
-- 在此处阻塞等待默认网卡连接成功的消息"IP_READY"
-- 或者等待1秒超时退出阻塞等待状态;
-- 注意：此处的1000毫秒超时不要修改的更长；
-- 因为当使用exnetif.set_priority_order配置多个网卡连接外网的优先级时，会隐式的修改默认使用的网卡
-- 当exnetif.set_priority_order的调用时序和此处的socket.adapter(socket.dft())判断时序有可能不匹配
-- 此处的1秒，能够保证，即使时序不匹配，也能1秒钟退出阻塞状态，再去判断socket.adapter(socket.dft())
sys.waitUntil("IP_READY", 1000)
end
-- 检测到了IP_READY消息
log.info("fota3_ui", "recv IP_READY", socket.dft())
-- 这个判断是提醒要设置PRODUCT_KEY的,实际生产请删除
if "your_project_key_here" == _G.PRODUCT_KEY then
while true do
sys.wait(1000)
log.info("fota3", "请修改正确的PRODUCT_KEY")
end
end
-- 启动 FOTA 升级（带UI确认）
libfota3.request({
-- 项目密钥：在 iot.openluat.com 平台主页面上方导航栏 Turnkey 页面中获取，仅支持合宙内部使用
project_key = PRODUCT_KEY,
-- 脚本名称：与项目名保持一致即可
script_name = PROJECT,
-- 脚本版本：与 VERSION 保持一致
script_version = VERSION,
-- 启用自动定时检测
auto = true,
-- 自动检测间隔：24小时（86400秒）
interval = 86400,
-- 状态回调：更新UI显示
on_status = function(status, msg, percent)
if status == "checking" then
-- 正在检测更新
show_progress(0, "正在检测更新...")
elseif status == "new_version" then
-- 发现新版本：msg 包含版本信息
log.info("fota3", "发现新版本:", msg)
elseif status == "downloading" then
-- 下载进度：percent 为 0-100
show_progress(percent or 0, msg)
elseif status == "download_done" then
-- 下载完成
show_progress(100, "下载完成")
elseif status == "download_fail" then
-- 下载失败
log.error("fota3", "下载失败:", msg)
elseif status == "rebooting" then
-- 正在重启
show_progress(100, "正在重启升级...")
else
-- 其他状态
log.info("fota3", string.format("[%s] %s", status, msg))
end
end,
-- 确认回调：显示UI让用户确认
on_confirm = function(action, info, callback)
if action == "download" then
-- 确认下载：info 包含 version, size, fota_sn
local version = info and info.version or "未知"
local size = info and info.size or 0
local size_kb = math.floor(size / 1024)
local message = string.format(
"发现新版本: %s\n大小: %d KB\n\n是否下载？",
version, size_kb
)
-- 显示确认对话框
show_confirm_dialog("固件更新", message, function(ok)
log.info("fota3", "用户" .. (ok and "确认" or "取消") .. "下载")
callback(ok)
end)
elseif action == "reboot" then
-- 确认重启
show_confirm_dialog("升级确认", "下载完成，是否立即重启升级？", function(ok)
log.info("fota3", "用户" .. (ok and "确认" or "取消") .. "重启")
callback(ok)
end)
end
end,
})
end
-- 初始化FOTA任务
sys.taskInit(fota3_ui_task)
-- 演示手动触发升级检测，可以根据需求打开
-- sys.timerLoopStart(function()
-- libfota3.check_update()
-- end, 4 * 3600000) -- 每4小时手动检测一次
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/main.lua
+72
View File
@@ -0,0 +1,72 @@
--[[
@module main
@summary LuatOS用户应用脚本文件入口，总体调度应用逻辑
@version 1.0
@date 2026.08.24
@author 马梦阳
@注意 仅合宙内部使用
@usage
本demo演示的核心功能为：
使用libfota3扩展库进行FOTA远程升级，适用于有屏幕设备（手持终端、智能家居面板等）的带UI确认升级场景。
特点：
1、使用 on_confirm 回调实现用户确认交互；
2、检测到新版本后弹窗让用户确认是否下载；
3、下载完成后弹窗让用户确认是否重启；
4、支持显示下载进度；
5、支持网络驱动模块，兼容4G/以太网/多网卡场景；
更多说明参考本目录下的readme.md文件
]]
--[[
必须定义PROJECT和VERSION变量，Luatools工具会用到这两个变量，远程升级功能也会用到这两个变量
PROJECT：项目名，ascii string类型
可以随便定义，只要不使用,就行
VERSION：项目版本号，ascii string类型
如果使用合宙iot.openluat.com进行远程升级，必须按照"XXX.YYY.ZZZ"三段格式定义：
X、Y、Z各表示1位数字，三个X表示的数字可以相同，也可以不同，同理三个Y和三个Z表示的数字也是可以相同，可以不同
因为历史原因，YYY这三位数字必须存在，但是没有任何用处，可以一直写为999
如果不使用合宙iot.openluat.com进行远程升级，根据自己项目的需求，自定义格式即可
]]
PROJECT = "FOTA3_WITH_UI"
VERSION = "001.999.000"
-- 在日志中打印项目名和项目版本号
log.info("main", PROJECT, VERSION)
-- 如果内核固件支持errDump功能，此处进行配置，【强烈建议打开此处的注释】
-- 因为此功能模块可以记录并且上传脚本在运行过程中出现的语法错误或者其他自定义的错误信息，可以初步分析一些设备运行异常的问题
-- 以下代码是最基本的用法，更复杂的用法可以详细阅读API说明文档
-- 启动errDump日志存储并且上传功能，600秒上传一次
-- if errDump then
-- errDump.config(true, 600)
-- end
-- 启动一个循环定时器
-- 每隔3秒钟打印一次总内存，实时的已使用内存，历史最高的已使用内存情况
-- 方便分析内存使用是否有异常
-- sys.timerLoopStart(function()
-- log.info("mem.lua", rtos.meminfo())
-- log.info("mem.sys", rtos.meminfo("sys"))
-- end, 3000)
-- 加载网络驱动设备功能模块
require "netdrv_device"
-- 加载有UI确认升级功能模块
require "fota3_ui"
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/netdrv/netdrv_4g.lua
+43
View File
@@ -0,0 +1,43 @@
--[[
@module netdrv_4g
@summary "4G网卡"驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为4G网卡驱动模块，核心业务逻辑为：
1、监听"IP_READY"和"IP_LOSE"，在日志中进行打印；
本文件没有对外接口，直接在其他功能模块中require "netdrv_4g"就可以加载运行；
]]
local function ip_ready_func(ip, adapter)
if adapter == socket.LWIP_GP then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_4g.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_GP))
end
end
local function ip_lose_func(adapter)
if adapter == socket.LWIP_GP then
log.warn("netdrv_4g.ip_lose_func", "IP_LOSE")
end
end
-- 此处订阅"IP_READY"和"IP_LOSE"两种消息
-- 在消息的处理函数中，仅仅打印了一些信息，便于实时观察4G网络的连接状态
-- 也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
-- 在Air780EPM上，内核固件运行起来之后，默认网卡就是socket.LWIP_GP
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/netdrv/netdrv_eth_spi.lua
+78
View File
@@ -0,0 +1,78 @@
--[[
@module netdrv_eth_spi
@summary "通过SPI外挂CH390H芯片的以太网卡"驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为"通过SPI外挂CH390H芯片的以太网卡"驱动模块，核心业务逻辑为：
1、打开CH390H芯片供电开关；
2、初始化spi0，初始化以太网卡，并且在以太网卡上开启DHCP(动态主机配置协议)；
3、以太网卡的连接状态发生变化时，在日志中进行打印；
直接使用Air780EPM V1.3版本开发板硬件测试即可；
本文件没有对外接口，直接在其他功能模块中require "netdrv_eth_spi"就可以加载运行；
]]
local exnetif = require "exnetif"
local function ip_ready_func(ip, adapter)
if adapter == socket.LWIP_ETH then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_eth_spi.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_ETH))
end
end
local function ip_lose_func(adapter)
if adapter == socket.LWIP_ETH then
log.warn("netdrv_eth_spi.ip_lose_func", "IP_LOSE")
end
end
-- 以太网联网成功（成功连接路由器，并且获取到了IP地址）后，内核固件会产生一个"IP_READY"消息
-- 各个功能模块可以订阅"IP_READY"消息实时处理以太网联网成功的事件
-- 也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
-- 以太网断网后，内核固件会产生一个"IP_LOSE"消息
-- 各个功能模块可以订阅"IP_LOSE"消息实时处理以太网断网的事件
-- 也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
--此处订阅"IP_READY"和"IP_LOSE"两种消息
--在消息的处理函数中，仅仅打印了一些信息，便于实时观察"通过SPI外挂CH390H芯片的以太网卡"的连接状态
--也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
local function netdrv_eth_spi_task_func()
-- 配置SPI外接以太网芯片CH390H的单网卡，exnetif.set_priority_order使用的网卡编号为socket.LWIP_ETH
-- 本demo使用Air780EPM V1.3版本开发板测试，开发板上的硬件配置为：
-- GPIO20为CH390H以太网芯片的供电使能控制引脚
-- 使用spi0，片选引脚使用GPIO8，中断引脚使用GPIO22
-- 如果使用的硬件和以上描述的环境不同，根据自己的硬件配置修改以下参数
exnetif.set_priority_order({
{
ETHERNET = {
pwrpin = 20,
tp = netdrv.CH390,
opts = {spi = 0, cs = 8, irq = 22}
}
}
})
end
-- 启动一个task，task的处理函数为netdrv_eth_spi_task_func
-- 在处理函数中调用exnetif.set_priority_order设置网卡优先级
-- 因为exnetif.set_priority_order要求必须在task中被调用，所以此处启动一个task
sys.taskInit(netdrv_eth_spi_task_func)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/netdrv/netdrv_multiple.lua
+89
View File
@@ -0,0 +1,89 @@
--[[
@module netdrv_multiple
@summary 多网卡（4G网卡、通过SPI外挂CH390H芯片的以太网卡）驱动模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为多网卡驱动模块，核心业务逻辑为：
1、调用exnetif.set_priority_order配置多网卡的控制参数以及优先级；
直接使用Air780EPM V1.3版本开发板硬件测试即可；
本文件没有对外接口，直接在其他功能模块中require "netdrv_multiple"就可以加载运行；
]]
local exnetif = require "exnetif"
-- 网卡状态变化通知回调函数
-- 当exnetif中检测到网卡切换或者所有网卡都断网时，会触发调用此回调函数
-- 当网卡切换切换时：
-- net_type：string类型，表示当前使用的网卡字符串
-- adapter：number类型，表示当前使用的网卡id
-- 当所有网卡断网时：
-- net_type：为nil
-- adapter：number类型，为-1
local function netdrv_multiple_notify_cbfunc(net_type,adapter)
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
if type(net_type)=="string" then
log.info("netdrv_multiple_notify_cbfunc", "use new adapter", net_type, adapter)
elseif type(net_type)=="nil" then
log.warn("netdrv_multiple_notify_cbfunc", "no available adapter", net_type, adapter)
else
log.warn("netdrv_multiple_notify_cbfunc", "unknown status", net_type, adapter)
end
end
local function netdrv_multiple_task_func()
--设置网卡优先级
exnetif.set_priority_order(
{
-- "通过SPI外挂CH390H芯片"的以太网卡，使用Air780EPM V1.3版本开发板验证
{
ETHERNET = {
-- 供电使能GPIO
pwrpin = 20,
-- 设置的多个"已经IP READY，但是还没有ping通"网卡，循环执行ping动作的间隔（单位毫秒，可选）
-- 如果没有传入此参数，exnetif会使用默认值10秒
ping_time = 3000,
-- 连通性检测ip(选填参数)；
-- 如果没有传入ip地址，exnetif中会默认使用httpdns能否成功获取baidu.com的ip作为是否连通的判断条件；
-- 如果传入，一定要传入可靠的并且可以ping通的ip地址；
-- ping_ip = "填入可靠的并且可以ping通的ip地址",
-- 网卡芯片型号(选填参数)，仅spi方式外挂以太网时需要填写。
tp = netdrv.CH390,
opts = {spi=0, cs=8, irq=22}
}
},
-- 4G网卡
{
LWIP_GP = true
}
}
)
end
-- 设置网卡状态变化通知回调函数netdrv_multiple_notify_cbfunc
exnetif.notify_status(netdrv_multiple_notify_cbfunc)
-- 如果存在udp网络应用，并且udp网络应用中，根据应用层的心跳能够判断出来udp数据通信出现了异常；
-- 可以在判断出现异常的位置，调用一次exnetif.check_network_status()接口，强制对当前正式使用的网卡进行一次连通性检测；
-- 如果存在tcp网络应用，不需要用户调用exnetif.check_network_status()接口去控制，exnetif会在tcp网络应用通信异常时自动对当前使用的网卡进行连通性检测。
-- 启动一个task，task的处理函数为netdrv_multiple_task_func
-- 在处理函数中调用exnetif.set_priority_order设置网卡优先级
-- 因为exnetif.set_priority_order要求必须在task中被调用，所以此处启动一个task
sys.taskInit(netdrv_multiple_task_func)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/netdrv/netdrv_pc.lua
+45
View File
@@ -0,0 +1,45 @@
--[[
@module netdrv_pc
@summary "pc模拟器网卡"驱动模块
@version 1.0
@date 2025.07.01
@author 朱天华
@usage
本文件为pc模拟器网卡驱动模块，核心业务逻辑为：
1、监听"IP_READY"和"IP_LOSE"，在日志中进行打印；
本文件没有对外接口，直接在其他功能模块中require "netdrv_pc"就可以加载运行；
]]
local function ip_ready_func(ip, adapter)
if adapter == socket.ETH0 then
-- 在位置1和2设置自定义的DNS服务器ip地址：
-- "223.5.5.5"，这个DNS服务器IP地址是阿里云提供的DNS服务器IP地址；
-- "114.114.114.114"，这个DNS服务器IP地址是国内通用的DNS服务器IP地址；
-- 可以加上以下两行代码，在自动获取的DNS服务器工作不稳定的情况下，这两个新增的DNS服务器会使DNS服务更加稳定可靠；
-- 如果使用专网卡，不要使用这两行代码；
-- 如果使用国外的网络，不要使用这两行代码；
socket.setDNS(adapter, 1, "223.5.5.5")
socket.setDNS(adapter, 2, "114.114.114.114")
log.info("netdrv_pc.ip_ready_func", "IP_READY", socket.localIP(socket.ETH0))
end
end
local function ip_lose_func(adapter)
if adapter == socket.ETH0 then
log.warn("netdrv_pc.ip_lose_func", "IP_LOSE")
end
end
--此处订阅"IP_READY"和"IP_LOSE"两种消息
--在消息的处理函数中，仅仅打印了一些信息，便于实时观察pc模拟器网络的连接状态
--也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
sys.subscribe("IP_READY", ip_ready_func)
sys.subscribe("IP_LOSE", ip_lose_func)
-- 设置默认网卡为socket.ETH0
-- pc模拟器上的默认网卡仍然需要使用接口(socket.ETH0)来设置，因为exnetif扩展库当前还不支持模拟器
socket.dft(socket.ETH0)
luatos/air780epm/module/Air780EPM/demo/fota/fota3(使用libfota3扩展库)/support_ui/netdrv_device.lua
+34
View File
@@ -0,0 +1,34 @@
--[[
@module netdrv_device
@summary 网络驱动设备功能模块
@version 1.0
@date 2026.08.24
@author 马梦阳
@usage
本文件为网络驱动设备功能模块，核心业务逻辑为：根据项目需求，选择并且配置合适的网卡(网络适配器)
1、netdrv_4g：socket.LWIP_GP，4G网卡；
2、netdrv_eth_spi：socket.LWIP_USER1，通过SPI外挂CH390H芯片的以太网卡；
3、netdrv_multiple：可以配置多种网卡的优先级，按照优先级配置，使用其中一种网卡连接外网；
4、netdrv_pc：socket.ETH0，PC模拟器网卡；
根据自己的项目需求，只需要require以上四种中的一种即可；
本文件没有对外接口，直接在main.lua中require "netdrv_device"就可以加载运行；
]]
-- 根据自己的项目需求，只需要require以下四种中的一种即可；
-- 加载"4G网卡"驱动模块
require "netdrv_4g"
-- 加载"通过SPI外挂CH390H芯片的以太网卡"驱动模块
-- require "netdrv_eth_spi"
-- 加载"可以配置优先级的多种网卡"驱动模块
-- require "netdrv_multiple"
-- 加载"PC模拟器网卡"驱动模块
-- require "netdrv_pc"