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,59 @@
--[[
@module log_test
@summary log功能测试模块
@version 1.0
@date 2025.11.19
@author 王世豪
@usage
本demo演示的核心功能为:
1. log.debug 日志等级测试
2. log.info 日志等级测试
3. log.warn 日志等级测试
4. log.error 日志等级测试
]]
local function test_log_output(level_name)
print(string.format("测试日志级别: %s", level_name))
log.debug(PROJECT, "debug message")
log.info(PROJECT, "info message")
log.warn(PROJECT, "warn message")
log.error(PROJECT, "error message")
end
local function logtest_task()
-- 打印当前默认日志输出等级
local default_level = log.getLevel()
print("日志功能测试开始")
print(string.format("默认日志级别: %s", default_level))
-- 实验1:使用默认日志输出等级测试
test_log_output(default_level)
-- 实验2:设置为INFO级别,只输出info及以上级别的日志
log.setLevel("INFO")
test_log_output("INFO")
-- 实验3:设置为WARN级别,只输出warn及以上级别的日志
log.setLevel("WARN")
test_log_output("WARN")
-- 实验4:设置为ERROR级别,只输出error级别的日志
log.setLevel("ERROR")
test_log_output("ERROR")
-- 实验5:设置为SILENT级别,完全关闭日志输出
log.setLevel("SILENT")
test_log_output("SILENT")
-- 实验6:恢复默认日志输出等级,验证日志输出恢复
log.setLevel(default_level)
print("恢复默认日志输出等级: " .. log.getLevel())
-- 测试不同参数类型的日志输出
log.info(PROJECT, "数值:", 123, "布尔值:", true, "表:", {name="test", value=456})
end
-- 启动测试任务
sys.taskInit(logtest_task)
@@ -0,0 +1,58 @@
--[[
@module main
@summary LuatOS用户应用脚本文件入口,总体调度应用逻辑
@version 1.0
@date 2025.11.19
@author 王世豪
@usage
本demo演示的核心功能为:
日志功能测试,包括log.info、log.error、log.debug、log.warn等日志等级的测试。
通过加载log_test模块来运行相关测试功能。
更多说明参考本目录下的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 = "logdemo"
VERSION = "001.999.000"
log.info("main", "project name is ", PROJECT, "version is ", 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)
-- 加载 log_test 功能模块
require "log_test"
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后后面不要加任何语句!!!!!
@@ -0,0 +1,67 @@
## 功能模块介绍
1、main.lua:主程序入口,负责初始化系统环境;
2、log_test.lua:日志功能测试模块,演示Air780EPM的日志输出功能;
## 演示功能概述
1、log_test:日志输出等级测试
默认日志输出等级为 DEBUG,即输出 debug 及以上级别的日志;
log.setLevel("INFO") 输出 info 及以上级别的日志;
log.setLevel("WARN") 输出 warn 及以上级别的日志;
log.setLevel("ERROR") 输出 error 级别的日志;
log.setLevel("SILENT") 静默所有日志,即禁止日志有任何内容输出;
## 演示硬件环境
1、Air780EPM核心板一个:
2、TYPE-C USB数据线一根,Air780EPM核心板和数据线的硬件接线方式为:
- Air780EPM核心板通过TYPE-C USB口供电,核心板正面的 ON/OFF 拨动开关 拨到ON一端;
- TYPE-C USB数据线直接插到核心板的TYPE-C USB座子,另外一端连接电脑USB口;
## 演示软件环境
1、Luatools下载调试工具
2、[Air780EPM 固件](https://docs.openluat.com/air780epm/luatos/firmware/version/)
## 演示核心步骤
1、搭建好硬件环境
2、Luatools烧录内核固件和demo脚本代码
3、烧录成功后,自动开机运行,通过luatools日志可以观察到以下信息:
``` lua
[2025-10-25 15:49:25.278][000000000.654] I/user.main project name is logdemo version is 001.000.000
[2025-10-25 15:49:26.074][000000001.663] 日志功能测试开始
[2025-10-25 15:49:26.079][000000001.663] 默认日志级别: 1
[2025-10-25 15:49:26.084][000000001.663] 测试日志级别: 1
[2025-10-25 15:49:26.089][000000001.664] D/user.logdemo debug message
[2025-10-25 15:49:26.094][000000001.664] I/user.logdemo info message
[2025-10-25 15:49:26.097][000000001.664] W/user.logdemo warn message
[2025-10-25 15:49:26.102][000000001.664] E/user.logdemo error message
[2025-10-25 15:49:26.105][000000001.665] 测试日志级别: INFO
[2025-10-25 15:49:26.108][000000001.665] I/user.logdemo info message
[2025-10-25 15:49:26.111][000000001.665] W/user.logdemo warn message
[2025-10-25 15:49:26.114][000000001.665] E/user.logdemo error message
[2025-10-25 15:49:26.117][000000001.665] 测试日志级别: WARN
[2025-10-25 15:49:26.122][000000001.666] W/user.logdemo warn message
[2025-10-25 15:49:26.125][000000001.666] E/user.logdemo error message
[2025-10-25 15:49:26.128][000000001.666] 测试日志级别: ERROR
[2025-10-25 15:49:26.131][000000001.666] E/user.logdemo error message
[2025-10-25 15:49:26.135][000000001.667] 测试日志级别: SILENT
[2025-10-25 15:49:26.139][000000001.667] 恢复默认日志级别: 1
[2025-10-25 15:49:26.142][000000001.667] I/user.logdemo 数值: 123 布尔值: true 表: table: 0C7F6DC8
```