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

- 来源: 合宙 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
@@ -0,0 +1,63 @@
--[[
@module main
@summary LuatOS用户应用脚本文件入口,总体调度应用逻辑
@version 1.0
@date 2025.10.28
@author 沈园园
@usage
本demo演示的核心功能为:
演示如何对数据压缩解压
更多说明参考本目录下的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 = "luatos_miniz_app"
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)
-- 加载miniz_app应用功能模块
require "miniz_app"
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
@@ -0,0 +1,47 @@
--[[
@module miniz_app
@summary miniz_app应用功能模块
@version 1.0
@date 2025.10.28
@author 沈园园
@usage
本文件为miniz应用功能模块,核心业务逻辑为:
1、如何对数据压缩解压;
本文件没有对外接口,直接在main.lua中require "miniz_app"就可以加载运行;
]]
local function miniz_task_func()
-- 压缩过的字符串, 为了方便演示, 这里用了base64编码
-- miniz能解压标准zlib数据流
-- 将字符串进行base64解码
local b64str = "eAEFQIGNwyAMXOUm+E2+OzjhCCiOjYyhyvbVR7K7IR0l+iau8G82eIW5jXVoPzF5pse/B8FaPXLiWTNxEMsKI+WmIR0l+iayEY2i2V4UbqqPh5bwimyEuY11aD8xeaYHxAquvom6VDFUXqQjG1Fek6efCFfCK0b0LUnQMjiCxhUT05GNL75dFUWCSMcjN3EE5c4Wvq42/36R41fa"
local str = b64str:fromBase64()
-- 快速解压
local dstr = miniz.uncompress(str)
-- 压缩过的数据长度 156
-- 解压后的数据长度,即原始数据的长度 235
log.info("miniz", "压缩过的数据长度: ", #str, "解压后的数据长度:", #dstr)
-- 演示压缩解压
local ostr = "abcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz"
log.info("压缩前的字符串:", #ostr, ostr)
-- 压缩字符串
local zstr = miniz.compress(ostr)
log.info("压缩后的字符串:",#zstr, zstr:toHex())
-- 解压字符串
local lstr = miniz.uncompress(zstr)
log.info("解压后的字符串:", #lstr, lstr)
-- 演示从文件读取2K数据压缩
local ostr = io.readFile("/luadb/test.txt")
local zstr = miniz.compress(ostr)
if zstr then
log.info("miniz", "压缩前的数据长度: ", #ostr, "压缩后的数据长度: ", #zstr)
end
end
--创建一个task,并且运行task的主函数miniz_task_func
sys.taskInit(miniz_task_func)
@@ -0,0 +1,51 @@
## 功能模块介绍
1、main.lua:主程序入口;
2、miniz_app.lua:如何对数据压缩解压;
## 演示功能概述
1、创建一个task
2、演示如何对数据压缩解压;
## 演示硬件环境
![](https://docs.openluat.com/air780epm/luatos/common/hwenv/image/Air780EPM2.png)
1、Air780EPM核心板一块
2、TYPE-C USB数据线一根
3、Air780EPM核心板和数据线的硬件接线方式为
- Air780EPM核心板通过TYPE-C USB口连接TYPE-C USB 数据线,数据线的另外一端连接电脑的USB口;
- 核心板正面的 ON/OFF 拨动开关 拨到ON一端;
## 演示软件环境
1、[Luatools下载调试工具](https://docs.openluat.com/air780epm/luatos/common/download/)
2、[Air780EPM 最新版本的内核固件](https://docs.openluat.com/air780epm/luatos/firmware/version/)
## 演示核心步骤
1、搭建好硬件环境
2、Luatools烧录内核固件和demo脚本代码
3、烧录成功后,自动开机运行
4、出现类似于下面的日志,就表示运行成功:
``` lua
[2025-10-28 11:39:11.816][000000000.379] I/user.miniz 压缩过的数据长度: 156 解压后的数据长度: 235
[2025-10-28 11:39:11.821][000000000.380] I/user.压缩前的字符串: 108 abcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz
[2025-10-28 11:39:11.826][000000000.383] I/user.压缩后的字符串: 92 780105C0040D80B04A383CCEDDDD9F9E4184C97E9CD7FDBC1FD828E3422A6DACF321A65C6AEB632E8830D98FF3BA9FF7031B655C48A58D753EC4944B6D7DCC051126FB715EF7F37E60A38C0BA9B4B1CE879872A9AD8FB97E17A42785 184
[2025-10-28 11:39:11.832][000000000.383] I/user.解压后的字符串: 108 abcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz
[2025-10-28 11:39:11.836][000000000.389] I/user.miniz 压缩前的数据长度: 2048 压缩后的数据长度: 1350
```
@@ -0,0 +1 @@
abcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyzabcd1234567890efghijklmnopqrstuvwxyz123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaiosabcd1234567890efghijklcd12345890A