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/xmodem/main.lua
+67
View File
@@ -0,0 +1,67 @@
--[[
@module main
@summary LuatOS用户应用脚本文件入口，总体调度应用逻辑
@version 1.0
@date 2025.10.14
@author 李源龙
@usage
本demo演示的核心功能为：
用Air780EPM整机开发板利用xmodem协议，将模块内的文件从串口发送到对端
主要提供了两种方式：
1、文件存到脚本区里面，通过xmodem协议，把脚本区文件发给对端
2、通过http下载文件到文件系统区，通过xmodem协议，把文件系统区文件发给对端
更多说明参考本目录下的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 = "xmodem_demo"
VERSION = "001.999.000"
-- 在日志中打印项目名和项目版本号
log.info("main", PROJECT, VERSION)
-- 如果内核固件支持errDump功能，此处进行配置，【强烈建议打开此处的注释】
-- 因为此功能模块可以记录并且上传脚本在运行过程中出现的语法错误或者其他自定义的错误信息，可以初步分析一些设备运行异常的问题
-- 以下代码是最基本的用法，更复杂的用法可以详细阅读API说明文档
-- 启动errDump日志存储并且上传功能，600秒上传一次
-- if errDump then
-- errDump.config(true, 600)
-- end
-- 使用LuatOS开发的任何一个项目，都强烈建议使用远程升级FOTA功能
-- 可以使用合宙的iot.openluat.com平台进行远程升级
-- 也可以使用客户自己搭建的平台进行远程升级
-- 远程升级的详细用法，可以参考fota的demo进行使用
-- 启动一个循环定时器
-- 每隔3秒钟打印一次总内存，实时的已使用内存，历史最高的已使用内存情况
-- 方便分析内存使用是否有异常
-- sys.timerLoopStart(function()
-- log.info("mem.lua", rtos.meminfo())
-- log.info("mem.sys", rtos.meminfo("sys"))
-- end, 3000)
-- 加载xmodem_demo模块
require "xmodem_demo"
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
luatos/air780epm/module/Air780EPM/demo/xmodem/readme.md
+82
View File
@@ -0,0 +1,82 @@
## 演示功能概述
本demo演示的核心功能为：
使用Air780EPM整机开发板的UART1连接PC端的串口工具，通过xmodem协议接收文件。
## 演示硬件环境
1、Air780EPM整机开发板一块
2、TYPE-C USB数据线一根
3、USB转串口线数据线一根
4、Air780EPM整机开发板和数据线的硬件接线方式为
- Air780EPM整机开发板通过TYPE-C USB口供电；
- 如果测试发现软件频繁重启，重启原因值为：poweron reason 0，可能是供电不足，此时再通过直流稳压电源对核心板的vbat管脚进行4V供电，或者VIN管脚进行5V供电；
- TYPE-C USB数据线直接插到核心板的TYPE-C USB座子，另外一端连接电脑USB口；
- USB转串口数据线，一般来说，白线连接核心板的16/U1TX，绿线连接核心板的17/U1RX，黑线连接核心板的gnd，另外一端连接电脑USB口；
| Air780EPM整机开发板 | USB转串口数据线 |
| -------------- | -------------- |
| UART1_TX | UART_RX |
| UART1_RX | UART_TX |
| GND | GND |
## 演示软件环境
1、Luatools下载调试工具
2、[Air780EPM最新版本固件](https://docs.openluat.com/air780epm/luatos/firmware/version/)
3、PC端的串口工具，例如SSCOM、LLCOM等都可以；
## 演示核心步骤
1、搭建好演示硬件环境
2、不需要修改demo脚本代码
3、Luatools烧录内核固件和demo脚本代码
4、烧录成功后，自动开机运行
5、打开串口工具，连接上Air780EPM UATR1端口，Air780EPM等待接收到工具发送过来的字符'C'，然后780EPM开始发送数据，工具端接收到数据返回0x06，0x06为xmodem协议的ack值表示正确接收，然后模块返回0x04,0x04为xmodem协议的​EOT​值，表示传输结束，然后对端发送0x06表示确认结束，Luatools的运行日志输出：
发送脚本区的文件，日志内容如下：
``` lua
[2025-10-17 15:41:21.708][000000007.048] I/user.xmodem uart读取到数据: 430D0A 6
[2025-10-17 15:41:21.754][000000007.050] I/user.xmodem 发送第 1 包
[2025-10-17 15:41:21.762][000000007.107] D/mobile TIME_SYNC 0
[2025-10-17 15:41:31.029][000000016.785] I/user.xmodem uart读取到数据: 06 2
[2025-10-17 15:41:31.056][000000016.786] I/user.xmodem 文件到头了
[2025-10-17 15:41:31.067][000000016.787] I/user.Xmodem start
[2025-10-17 15:41:31.070][000000016.787] I/user.Xmodem send result true
[2025-10-17 15:41:31.073][000000016.787] I/user.Xmodem send success
```
HTTP下载到文件系统区的，再通过xmodem协议发送日志如下：
``` lua
[2025-10-17 15:59:02.210][000000007.027] dns_run 676:airtest.openluat.com state 0 id 1 ipv6 0 use dns server2, try 0
[2025-10-17 15:59:02.216][000000007.050] D/mobile TIME_SYNC 0
[2025-10-17 15:59:02.231][000000007.070] dns_run 693:dns all done ,now stop
[2025-10-17 15:59:02.249][000000007.183] I/user.http success 200
[2025-10-17 15:59:02.261][000000007.183] I/user.HTTP receive ok 29
[2025-10-17 15:59:02.270][000000007.187] I/user.文件读取 路径:/send.bin 内容:AA BB CC DD 01 02 03 04 05 06
[2025-10-17 15:59:02.277][000000007.190] Uart_ChangeBR 1338:uart1, 115200 115203 26000000 3611
[2025-10-17 15:59:03.762][000000008.800] I/user.xmodem uart读取到数据: 430D0A 6
[2025-10-17 15:59:03.796][000000008.802] I/user.xmodem 发送第 1 包
[2025-10-17 15:59:09.955][000000014.991] I/user.xmodem uart读取到数据: 06 2
[2025-10-17 15:59:09.980][000000014.992] I/user.xmodem 文件到头了
[2025-10-17 15:59:09.990][000000014.993] I/user.Xmodem start
[2025-10-17 15:59:09.995][000000014.993] I/user.Xmodem send result true
[2025-10-17 15:59:10.006][000000014.993] I/user.Xmodem send success
```
luatos/air780epm/module/Air780EPM/demo/xmodem/xmodem_demo.lua
+93
View File
@@ -0,0 +1,93 @@
--[[
@module main
@summary xmodem 发送文件应用功能模块
@version 1.0
@date 2025.07.01
@author 李源龙
@usage
本文件为Air780EPM整机开发板演示xmodem功能的代码示例，本文档主要提供了两种方案：
1、把模块脚本区的文件利用xmodem协议通过uart发送到过去
2、进行http下载文件，利用xmodem协议通过uart发送到过去
]]
--加载xmodem模块
xmodem=require ("xmodem")
--设置默认filepath为脚本区的send.bin文件
local filepath="/luadb/send.bin"
local taskName = "xmodem_run"
local uart_id = 1 --串口号
local baudrate = 115200 --波特率
local file_path=filepath --文件路径
local send_type=true --true表示单次发送128字节，false表示单次发送1024字节
local inform_data="wait C" --发送前提示信息，告知对方要发送C字符来接收文件
-- 处理未识别的消息
local function xmodem_run_cb(msg)
log.info("xmodem_run_cb", msg[1], msg[2], msg[3], msg[4])
end
--http获取文件函数
local function http_recived_cb()
while not socket.adapter(socket.dft()) do
log.warn("httpplus_app_task_func", "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
local path = "/send.bin"
-- 以下链接仅用于测试，禁止用于生产环境
local code, headers, body_size = http.request("GET", "http://airtest.openluat.com:2900/download/send.bin", nil, nil, {dst=path}).wait()
log.info("http", code==200 and "success" or "error", code)
if code==200 then
log.info("HTTP receive ok",body_size)
file = io.open(path, "rb")
if file then
content = file:read("*a")
log.info("文件读取", "路径:" .. path, "内容:" .. content)
file:close()
else
log.error("文件操作", "无法打开文件读取内容", "路径:" .. path)
end
file_path=path
end
end
-- 定义一个xmodem_run函数，用于用xmodem发送文件
local function xmodem_run()
--如果需要http下载文件，然后发送下载的文件，可以打开下面的http_recived_cb()函数
http_recived_cb()
--启动xmodem发送
local result=xmodem.send(uart_id,baudrate,file_path,send_type)
--等待时间12秒，等待接收方发送C字符启动发送，发送结束后接收端发送ACK:0x06表示接收完成，文件全部传输完成之后模块发送EOT​：0x04表示传输结束，接收端返回0x06表示确认结束
log.info("Xmodem", "start")
log.info("Xmodem", "send result", result)
--判断是否传输成功，传输是否成功，都需要关闭xmodem
if result then
log.info("Xmodem", "send success")
xmodem.close(uart_id)
else
log.info("Xmodem", "send failed")
xmodem.close(uart_id)
end
end
--创建并且启动一个task
--运行这个task的主函数xmodem_run
sys.taskInit(xmodem_run, taskName,xmodem_run_cb)