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

- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
2026-08-31 08:53:49 +08:00
commit 173dd6874f
813 changed files with 125484 additions and 0 deletions
@@ -0,0 +1,24 @@
+--[[
+@module  helloworld_app
+@summary helloworld应用功能模块 
+@version 1.0
+@date    2026.04.15
+@author  沈园园
+@usage
+本文件为helloworld应用功能模块，核心业务逻辑为：
+1、每隔三秒钟通过日志输出一次hello world；
+
+本文件没有对外接口，直接在main.lua中require "helloworld_app"就可以加载运行；
+]]
+
+
+local function helloworld_task_func()
+    while true do
+        -- 每隔三秒钟通过日志输出一次hello world
+        log.info("hello world")
+        sys.wait(3000)
+    end
+end
+
+--创建一个task，并且运行task的主函数helloworld_task_func
+sys.taskInit(helloworld_task_func)
@@ -0,0 +1,73 @@
+
+--[[
+@module  main
+@summary LuatOS用户应用脚本文件入口，总体调度应用逻辑 
+@version 1.0
+@date    2026.04.15
+@author  沈园园
+@usage
+本demo演示的核心功能为：
+每隔三秒钟通过日志输出一次hello world
+更多说明参考本目录下的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_helloworld_app"
+VERSION = "001.999.000"
+
+
+-- 在日志中打印项目名和项目版本号
+log.info("main", PROJECT, VERSION)
+
+
+-- 如果内核固件支持wdt看门狗功能，此处对看门狗进行初始化和定时喂狗处理
+-- 如果脚本程序死循环卡死，就会无法及时喂狗，最终会自动重启
+if wdt then
+    --配置喂狗超时时间为9秒钟
+    wdt.init(9000)
+    --启动一个循环定时器，每隔3秒钟喂一次狗
+    sys.timerLoopStart(wdt.feed, 3000)
+end
+
+
+-- 如果内核固件支持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)
+
+-- 加载helloworld_app应用功能模块
+require "helloworld_app"
+
+-- 用户代码已结束---------------------------------------------
+-- 结尾总是这一句
+sys.run()
+-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
+
@@ -0,0 +1,51 @@
+## 功能模块介绍
+
+1、main.lua：主程序入口；
+
+2、helloworld_app.lua：每3秒打印1次hello world；
+
+## 演示功能概述
+
+1、创建一个task；
+
+2、在task中的任务处理函数中，每隔三秒钟通过日志输出一次hello world；
+
+## 演示硬件环境
+
+![](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/common/Luatools/)；
+
+2.内核固件文件（底层 core 固件文件）：本demo开发测试时使用的固件为[LuatOS-SOC_V2034_Air780EPM 版本固件](https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/)，本demo对固件版本没有什么特殊要求，所以你如果要测试本demo时，可以直接使用最新版本的内核固件；如果发现最新版本的内核固件测试有问题，可以使用我们开发本demo时使用的内核固件版本来对比测试；
+
+## 演示核心步骤
+
+1、搭建好硬件环境
+
+2、Luatools烧录内核固件和demo脚本代码
+
+3、烧录成功后，自动开机运行
+
+4、出现类似于下面的日志，就表示运行成功：
+
+``` lua
+[2026-04-15 16:28:00.277][LTOS/N][000000201.039]:I/user.hello world
+[2026-04-15 16:28:03.265][LTOS/N][000000204.039]:I/user.hello world
+[2026-04-15 16:28:06.249][LTOS/N][000000207.039]:I/user.hello world
+[2026-04-15 16:28:09.246][LTOS/N][000000210.040]:I/user.hello world
+[2026-04-15 16:28:12.245][LTOS/N][000000213.040]:I/user.hello world
+[2026-04-15 16:28:15.229][LTOS/N][000000216.040]:I/user.hello world
+[2026-04-15 16:28:18.217][LTOS/N][000000219.041]:I/user.hello world
+
+```