init: Air780EPM 官方 LuatOS 项目代码基线
- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
This commit is contained in:
wangfq
@@ -0,0 +1,52 @@
|
||||
--[[
|
||||
@module main
|
||||
@summary LuatOS用户应用脚本文件入口,总体调度应用逻辑
|
||||
@version 1.0
|
||||
@date 2025.07.15
|
||||
@author 王城钧
|
||||
@usage
|
||||
|
||||
本demo演示的功能为：
|
||||
1.抽样10个ADC计算值
|
||||
2.升序排列后去掉一个最大值和一个最小值,并计算平均值
|
||||
3.得到ADC测量值,并通过两种方式打印,一种为特殊通道温度的形式打印,另一种以毫伏的方式打印
|
||||
]]
|
||||
--[[
|
||||
必须定义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 = "ADC_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进行使用
|
||||
|
||||
-- 加载ADC测量功能模块
|
||||
require "test_adc"
|
||||
|
||||
|
||||
-- 用户代码已结束---------------------------------------------
|
||||
-- 结尾总是这一句
|
||||
sys.run()
|
||||
-- sys.run()之后后面不要加任何语句!!!!!
|
||||
@@ -0,0 +1,58 @@
|
||||
## 演示模块概述
|
||||
|
||||
1、main.lua：主程序入口；
|
||||
|
||||
2、test_adc.lua：ADC测量功能模块；
|
||||
|
||||
## 演示功能概述
|
||||
|
||||
使用Air780EPM核心板测试ADC功能。
|
||||
|
||||
## 演示硬件环境
|
||||
|
||||
1、Air780EPM核心板一块
|
||||
|
||||
2、TYPE-C USB数据线一根
|
||||
|
||||
3、杜邦线若干
|
||||
|
||||
4、外部供电电源Air9000P
|
||||
|
||||
|
||||
|
||||
## 演示软件环境
|
||||
|
||||
1、Luatools下载调试工具
|
||||
|
||||
2、[Air780EPM V2014版本固件]([固件和Demo - luatos@air780epm - 合宙模组资料中心](https://docs.openluat.com/air780epm/luatos/))（理论上，2025年8月10日之后发布的固件都可以）
|
||||
|
||||
## 演示核心步骤
|
||||
|
||||
1、搭建好硬件环境
|
||||
|
||||
2、Luatools烧录内核固件和demo脚本代码
|
||||
|
||||
3、烧录成功后，自动开机运行
|
||||
|
||||
4、如下是adc通道0设置ADC_RANGE_MIN量程外部供电1.2V，adc通道1设置ADC_RANGE_MAX量程外部供电1.2V，adc通道2设置ADC_RANGE_MAX量程外部供电3.3V，adc通道3设置ADC_RANGE_MIN量程外部供电3.3V的环境下测试的，代码运行结果如下：
|
||||
|
||||
这样设置量程和外部供电是为了更直观的观察两种量程下不同供电电压对精准度的影响，可以看到如下测量的数据是符合预期的
|
||||
|
||||
对于Air780EPM：ADC_RANGE_MIN对应量程为0-1.5V，ADC_RANGE_MAX对应量程为0-3.3V。
|
||||
|
||||
在外部供电1.2V的情况下，ADC_RANGE_MIN量程下获取到的数据更精准；在外部供电3.3V的情况下，ADC_RANGE_MIN量程下会限制在1.5v左右，ADC_RANGE_MAX可以正常测量。
|
||||
|
||||
```
|
||||
[2025-09-10 16:13:57.926][000000517.170] I/user.adc通道0 处理值: 1194.88 mV (样本数:10)
|
||||
|
||||
[2025-09-10 16:13:57.946][000000517.174] I/user.adc通道1 处理值: 1189.00 mV (样本数:10)
|
||||
|
||||
[2025-09-10 16:13:57.967][000000517.178] I/user.adc通道2 处理值: 3376.75 mV (样本数:10)
|
||||
|
||||
[2025-09-10 16:13:57.992][000000517.182] I/user.adc通道3 处理值: 1565.00 mV (样本数:10)
|
||||
|
||||
[2025-09-10 16:13:58.016][000000517.187] I/user.CPU TEMP 温度值: 34.00 ℃(样本数:10)
|
||||
|
||||
[2025-09-10 16:13:58.042][000000517.191] I/user.VBAT 处理值: 4414.75 mV (样本数:10)
|
||||
|
||||
```
|
||||
@@ -0,0 +1,140 @@
|
||||
--[[
|
||||
@module test_adc
|
||||
@summary ADC功能测试
|
||||
@version 1.0
|
||||
@date 2025.07.15
|
||||
@author 王城钧
|
||||
@usage
|
||||
本功能模块演示的内容为：
|
||||
1. ADC通道配置与量程设置
|
||||
2. 数据采集并处理
|
||||
3. 循环打印处理过的ADC数据
|
||||
|
||||
本文件没有对外接口,直接在main.lua中require "test_adc"就可以加载运行；
|
||||
]]
|
||||
|
||||
--[[
|
||||
|
||||
1. Air780EPM内部ADC接口为12bits,ADC量程为0-3.6V
|
||||
2. Air780EPM内部具有4路通用ADC通道,通道0 -- 3
|
||||
3. 特殊通道,CPU内部温度Temp -- adc.CH_CPU,主供电脚电压 VBAT -- adc.CH_VBAT
|
||||
4. 设置分压(adc.setRange)要在adc.open之前设置,否则无效!!
|
||||
]]
|
||||
|
||||
|
||||
local function process_channel(channel_samples, tag)
|
||||
if #channel_samples > 2 then
|
||||
-- 升序排序
|
||||
table.sort(channel_samples)
|
||||
|
||||
-- 创建剔除极值后的新数组
|
||||
local trimmed = {}
|
||||
for i = 2, #channel_samples-1 do
|
||||
table.insert(trimmed, channel_samples[i])
|
||||
end
|
||||
|
||||
-- 计算平均值
|
||||
local sum = 0
|
||||
for _, v in ipairs(trimmed) do
|
||||
sum = sum + v
|
||||
end
|
||||
local avg_value = sum / #trimmed
|
||||
|
||||
-- 根据tag进行不同处理
|
||||
if tag == "CPU TEMP" then
|
||||
log.info(tag, string.format("温度值: %.2f ℃(样本数:%d)", avg_value/1000, #trimmed+2))
|
||||
else
|
||||
log.info(tag, string.format("处理值: %.2f mV (样本数:%d)", avg_value, #trimmed+2))
|
||||
end
|
||||
|
||||
-- -- 格式化输出
|
||||
-- log.info(tag, string.format("处理值: %.2f mV (样本数:%d)", avg_value, #trimmed+2))
|
||||
else
|
||||
log.info(tag, "样本不足无法处理")
|
||||
end
|
||||
end
|
||||
|
||||
-- 主采集函数
|
||||
function adc_all_func()
|
||||
local num_samples = 10 -- 每个通道采集样本数（可配置）
|
||||
local samples = {
|
||||
[0] = {}, -- 通道0样本数组
|
||||
[1] = {}, -- 通道1
|
||||
[2] = {}, -- 通道2
|
||||
[3] = {}, -- 通道3
|
||||
[4] = {}, -- CH_CPU
|
||||
[5] = {} -- CH_VBAT
|
||||
}
|
||||
|
||||
while true do
|
||||
sys.wait(1000) -- 延时1秒,为了方便观察luatools日志,非必须
|
||||
|
||||
-- 通道0采集处理
|
||||
adc.setRange(adc.ADC_RANGE_MIN)
|
||||
-- 设置ADC量程,注意量程设置一定要在adc.open()之前,通道0的量程设置为了adc.ADC_RANGE_MIN
|
||||
-- 此演示对通道0外加了1.2V电压,这样设置与通道1形成对比,方便观察1.2V外部供电下adc.ADC_RANGE_MAX和adc.ADC_RANGE_MIN两种量程的测量精准度。
|
||||
adc.open(0)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[0], adc.get(0))
|
||||
end
|
||||
adc.close(0)
|
||||
process_channel(samples[0], "adc通道0")
|
||||
|
||||
-- 通道1采集处理
|
||||
adc.setRange(adc.ADC_RANGE_MAX)
|
||||
-- 设置ADC量程,注意量程设置一定要在adc.open()之前,通道1的量程设置为了adc.ADC_RANGE_MAX
|
||||
-- 此演示对通道1外加了1.2V电压,这样设置与通道0形成对比,方便观察1.2V外部供电下adc.ADC_RANGE_MAX和adc.ADC_RANGE_MIN两种量程的测量精准度。
|
||||
adc.open(1)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[1], adc.get(1))
|
||||
end
|
||||
adc.close(1)
|
||||
process_channel(samples[1], "adc通道1")
|
||||
|
||||
-- 通道2采集处理
|
||||
adc.setRange(adc.ADC_RANGE_MAX)
|
||||
-- 设置ADC量程,注意量程设置一定要在adc.open()之前,通道2的量程设置为了adc.ADC_RANGE_MAX
|
||||
-- 此演示对通道2外加3.3V电压,这样设置可以与通道3形成对比,方便观察3.3V外部供电下adc.ADC_RANGE_MAX和adc.ADC_RANGE_MIN两种量程的测量精准度。
|
||||
adc.open(2)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[2], adc.get(2))
|
||||
end
|
||||
adc.close(2)
|
||||
process_channel(samples[2], "adc通道2")
|
||||
|
||||
-- 通道3采集处理
|
||||
adc.setRange(adc.ADC_RANGE_MIN)
|
||||
-- 设置ADC量程,注意量程设置一定要在adc.open()之前,通道3的量程设置为了adc.ADC_RANGE_MIN
|
||||
-- 此演示对通道3外加3.3V电压,这样设置可以与通道2形成对比,方便观察3.3V外部供电下adc.ADC_RANGE_MAX和adc.ADC_RANGE_MIN两种量程的测量精准度。
|
||||
adc.open(3)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[3], adc.get(3))
|
||||
end
|
||||
adc.close(3)
|
||||
process_channel(samples[3], "adc通道3")
|
||||
|
||||
-- CPU温度通道采集处理
|
||||
adc.open(adc.CH_CPU)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[4], adc.get(adc.CH_CPU))
|
||||
end
|
||||
adc.close(adc.CH_CPU)
|
||||
process_channel(samples[4], "CPU TEMP")
|
||||
|
||||
-- VBAT通道采集处理
|
||||
adc.open(adc.CH_VBAT)
|
||||
for _ = 1, num_samples do
|
||||
table.insert(samples[5], adc.get(adc.CH_VBAT))
|
||||
end
|
||||
adc.close(adc.CH_VBAT)
|
||||
process_channel(samples[5], "VBAT")
|
||||
|
||||
-- 清空样本数组
|
||||
for i = 0, 5 do
|
||||
samples[i] = {}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
sys.taskInit(adc_all_func)
|
||||
|
||||
Reference in New Issue
Block a user