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,74 @@
--[[
@module main
@summary TM1638 数码管驱动芯片测试 Demo 入口
@version 1.0
@date 2026.07.07
@author 江访
]]
--[[
=== 演示内容 ===
本 demo 演示 exs_tm1638 扩展库的完整功能,顺序为:
HELLO→[1/7]→[2/7]→[3/7]→[4/7]→[5/7]→[6/7]→[7/7]→End
1、数码管字符串显示([1/7]
2、LED 指示灯控制([2/7]
3、按键轮询检测([3/7]
4、亮度调节([4/7]
5、按键回调([5/7]
6、综合演示([6/7]
7、日期/时钟/温度([7/7]
]]
--[[
VERSION:项目版本号,ascii string类型
如果使用合宙iot.openluat.com进行远程升级,必须按照"XXX.YYY.ZZZ"三段格式定义:
X、Y、Z各表示1位数字,三个X表示的数字可以相同,也可以不同,同理三个Y和三个Z表示的数字也是可以相同,可以不同
因为历史原因,YYY这三位数字必须存在,但是没有任何用处,可以一直写为000
如果不使用合宙iot.openluat.com进行远程升级,根据自己项目的需求,自定义格式即可
]]
-- main.lua - 程序入口文件
PROJECT = "TM1638_Demo" -- 项目命名
VERSION = "001.999.000" -- 项目版本号
-- 在日志中打印项目名和项目版本号
log.info("main", PROJECT, VERSION)
-- 设置日志输出风格为样式2(建议调试时开启)
-- log.style(2)
-- 如果内核固件支持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)
-- 加载 tm1638_demo.lua 演示模块
require "tm1638_demo"
-- 用户代码已结束
-- 结尾总是这一句
sys.run()
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
@@ -0,0 +1,249 @@
# TM1638 数码管驱动芯片演示
## 一、功能模块介绍
### 1.1 核心主程序模块
1. **main.lua** - 主程序入口,负责项目初始化、版本定义和任务调度
2. **tm1638_demo.lua** - TM1638 功能演示模块,包含数码管显示、LED 控制、按键检测、亮度调节、综合展示等所有功能的演示用例
### 1.2 扩展库模块
1. **exs_tm1638** - TM1638 扩展库,提供数码管段码显示、LED 指示灯控制、按键检测、亮度调节等 API
## 二、演示流程介绍
本 demo 按顺序演示 exs_tm1638 扩展库的 7 项功能:HELLO → [1/7] → [2/7] → [3/7] → [4/7] → [5/7] → [6/7] → [7/7] → End
### 2.1 功能演示项说明
1. **[1/7] 字符串显示** - 数码管逐项显示数字、带小数点数字、字母组合、指定位置显示
2. **[2/7] LED 控制** - 逐个点亮/熄灭 LED 指示灯、LED 跑马灯效果
3. **[3/7] 按键轮询** - 通过 `get_key()` API 轮询检测按键,10 秒超时
4. **[4/7] 亮度调节** - 展示 0~7 级亮度调节效果
5. **[5/7] 按键回调** - 通过 `set_key_callback()` API 设置按键回调函数,15 秒演示窗口
6. **[6/7] 综合演示** - 倒计时、HELLO 闪烁、全亮全灭、亮度渐变
7. **[7/7] 日期/时钟/温度** - 日期展示(YY-MM-DD 格式)、时钟模拟走时(HH-MM-SS)、温度展示(摄氏度°C 和华氏度°F)
## 三、显示效果
![](https://docs.openluat.com/cdn/image//Air780EPM_tm1638.png)
## 四、演示硬件环境
### 4.1 硬件清单
- Air780EPM 核心板 × 1
- TM1638 数码管模块(8 位数码管 + 8 个 LED 指示灯 + 8 个按键) × 1
demo所演示的TM1638数码管[购买链接](https://item.taobao.com/item.htm?abbucket=12&id=862890736053&mi_id=0000hQbdi599Ci7xSkwlh3JRFNce012vqjQLR8ZnTZt0bG8&ns=1&spm=a21n57.1.hoverItem.7&utparam=%7B%22aplus_abtest%22%3A%22224c84d139b925f8f3d8268f9e91b200%22%7D&xxc=taobaoSearch)
- 母对母杜邦线 × 5
- TYPE-C 数据线 × 1
### 4.2 接线配置
#### 4.2.1 TM1638 模块接线
<table>
<tr>
<td>Air780EPM 核心板<br/></td><td>TM1638 模块<br/></td></tr>
<tr>
<td>32/GPIO31<br/></td><td>CLK<br/></td></tr>
<tr>
<td>31/GPIO30<br/></td><td>DIO<br/></td></tr>
<tr>
<td>33/GPIO32<br/></td><td>STB<br/></td></tr>
<tr>
<td>VDD_EXT<br/></td><td>VCC<br/></td></tr>
<tr>
<td>GND<br/></td><td>GND<br/></td></tr>
</table>
> 说明:TM1638 模块通常还带有 VCC 和 GND 引脚,直接连接核心板的 VDD_EXT(3.3V)和 GND 即可。接线时注意杜邦线不宜过长,以免通信不稳定。
## 五、演示软件环境
### 5.1 开发工具
- [Luatools下载调试工具](https://docs.openluat.com/air780egh/luatos/common/download/) - 固件烧录和代码调试
### 5.2 内核固件
- [点击下载Air780EPM系列最新版本内核固件](https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/)demo所使用的是 LuatOS-SoC_V2046_Air780EPM 1号固件
### 5.3 脚本文件
1. **main.lua** - 主程序入口
2. **tm1638_demo.lua** - TM1638 功能演示模块
3. **exs_tm1638** - TM1638 扩展库
## 六、演示核心步骤
### 6.1 硬件准备
1. 按照接线表将 TM1638 模块连接到核心板
2. 确保电源连接正确,通过 TYPE-C USB 口供电
3. 检查所有接线无误,避免短路
### 6.2 软件配置
`main.lua` 中加载对应的演示模块:
```lua
-- 加载 tm1638_demo.lua 演示模块
require "tm1638_demo"
```
### 6.3 软件烧录
1. 使用 Luatools 选择最新内核固件
2. 下载本项目所有脚本文件
3. 将固件和脚本一起烧录到设备
4. 烧录成功后设备自动重启后开始运行
### 6.4 功能测试
#### 6.4.1 字符串显示演示
1. 设备启动后显示 "HELLO",随后自动进入 [1/7] 字符串显示
2. 观察数码管依次显示:`87654321``88.88``AbCd` → 从第 3 位显示 `1234`
3. 检查字符显示是否正确,带小数点功能是否正常
#### 6.4.2 LED 控制演示
1. 自动进入 [2/7] LED 控制演示
2. 观察 LED 指示灯从 1 到 8 逐个点亮,再逐个熄灭
3. 观察 LED 跑马灯效果,共循环 3 轮
4. 数码管同步显示当前位置数字
#### 6.4.3 按键检测演示
1. 自动进入 [3/7] 按键轮询演示,数码管显示 "KEY----"
2. 在 10 秒内按下 TM1638 模块上的任意按键
3. 观察数码管显示按键编码(如 "K01"、"K02" 等)
4. 若 10 秒内无按键按下,自动跳过
#### 6.4.4 亮度调节演示
1. 自动进入 [4/7] 亮度调节演示,数码管显示 "88888888"
2. 观察数码管亮度从 0 级到 7 级逐级变化
3. 最终恢复到 4 级亮度
#### 6.4.5 按键回调演示
1. 自动进入 [5/7] 按键回调演示,数码管显示 "Cb-Key"
2. 在 15 秒内按下任意按键,观察数码管显示对应按键编码
3. 观察日志输出,确认回调函数 `on_key` 被正常触发
4. 15 秒后自动结束回调演示
#### 6.4.6 综合演示
1. 自动进入 [6/7] 综合演示
2. 观察倒计时效果:5 → 4 → 3 → 2 → 1 → 0
3. 观察 "-HELLO-" 闪烁效果,重复 4 次
4. 观察全 8 显示 + 全部 LED 点亮 + 亮度渐变
5. 数字和 LED 指示灯全灭
#### 6.4.7 日期/时钟/温度演示
1. 自动进入 [7/7] 日期/时钟/温度演示
2. 日期展示:显示格式 "YY-MM-DD"(如 "26-07-08"),停留 3 秒
3. 时钟展示:模拟走时 "08-30-00" → "08-30-01" → ... → "08-30-09"
4. 温度展示:
- 摄氏度:25°C → 32°C 逐度变化,亮度随温度升高而增加
- 华氏度:77°F → 90°F 逐度变化
5. 演示结束后显示 "End" 并停留 3 秒
### 6.5 预期效果
- **字符串显示**:数字、字母、小数点均能正确显示,支持指定起始位置
- **LED 控制**:8 颗 LED 指示灯均可独立控制,跑马灯效果流畅
- **按键检测**:轮询模式和回调模式均能正确检测按键,编码显示正常
- **亮度调节**:0~7 级亮度逐级变化,效果明显
- **日期/时钟/温度**:格式显示正确,°C 和 °F 符号正常显示
- **日志如下:**
```lua
[2026-07-21 10:36:28.010][000000000.184] I/main LuatOS@Air780EPM base 26.04 bsp V2046 32bit
[2026-07-21 10:36:28.014][000000000.184] I/main ROM Build: Jul 7 2026 20:39:17
[2026-07-21 10:36:28.017][000000000.186] W/pins /luadb/pins_air780epm.json not exist!!
[2026-07-21 10:36:28.020][000000000.188] D/main loadlibs luavm 1048568 14784 14784
[2026-07-21 10:36:28.044][000000000.188] D/main loadlibs sys 2366664 82756 89356
[2026-07-21 10:36:28.046][000000000.189] D/main loadlibs psram 2366664 82756 89356
[2026-07-21 10:36:28.048][000000000.207] I/user.main TM1638_Demo 001.999.000
[2026-07-21 10:36:28.051][000000000.223] D/user.exs_tm1638 version -> 202607131200
[2026-07-21 10:36:28.055][000000000.239] I/user.exs_tm1638 , clk=31 dio=30 stb=32 =5
[2026-07-21 10:36:28.058][000000000.239] I/user.tm1638_demo TM1638 : 202607131200
[2026-07-21 10:36:28.689][000000001.251] I/user.tm1638_demo ===== [1/7] =====
[2026-07-21 10:36:28.692][000000001.252] I/user.tm1638_demo 87654321
[2026-07-21 10:36:29.798][000000002.300] I/mobile sim0 sms ready
[2026-07-21 10:36:29.800][000000002.300] D/mobile cid1, state0
[2026-07-21 10:36:29.801][000000002.301] D/mobile bearer act 0, result 0
[2026-07-21 10:36:29.810][000000002.301] D/mobile NETIF_LINK_ON -> IP_READY
[2026-07-21 10:36:29.818][000000002.356] D/mobile TIME_SYNC 0 tm 1784601393
[2026-07-21 10:36:30.210][000000002.776] I/user.tm1638_demo 88.88
[2026-07-21 10:36:31.730][000000004.300] I/user.tm1638_demo AbCd
[2026-07-21 10:36:33.254][000000005.824] I/user.tm1638_demo 3 1234
[2026-07-21 10:36:35.285][000000007.859] I/user.tm1638_demo ===== [2/7] LED =====
[2026-07-21 10:36:38.805][000000011.371] I/user.tm1638_demo
[2026-07-21 10:36:40.422][000000012.987] I/user.tm1638_demo LED
[2026-07-21 10:36:44.912][000000017.474] I/user.tm1638_demo ===== [3/7] =====
[2026-07-21 10:36:45.426][000000017.998] I/user.tm1638_demo : 0
[2026-07-21 10:36:46.229][000000018.799] I/user.tm1638_demo : 1
[2026-07-21 10:36:47.036][000000019.600] I/user.tm1638_demo : 2
[2026-07-21 10:36:47.826][000000020.401] I/user.tm1638_demo : 3
[2026-07-21 10:36:48.631][000000021.202] I/user.tm1638_demo : 4
[2026-07-21 10:36:49.437][000000022.003] I/user.tm1638_demo : 5
[2026-07-21 10:36:50.242][000000022.804] I/user.tm1638_demo : 6
[2026-07-21 10:36:51.033][000000023.605] I/user.tm1638_demo : 7
[2026-07-21 10:36:52.356][000000024.919] I/user.tm1638_demo ===== [4/7] =====
[2026-07-21 10:36:52.366][000000024.919] I/user.tm1638_demo 10 TM1638 ...
[2026-07-21 10:36:53.831][000000026.399] I/user.tm1638_demo , : 17
[2026-07-21 10:36:54.842][000000027.412] I/user.tm1638_demo [5/7] 15
[2026-07-21 10:36:55.774][000000028.342] I/user.tm1638_demo , : 19
[2026-07-21 10:36:56.721][000000029.292] I/user.tm1638_demo , : 21
[2026-07-21 10:36:57.468][000000030.042] I/user.tm1638_demo , : 23
[2026-07-21 10:36:58.227][000000030.792] I/user.tm1638_demo , : 18
[2026-07-21 10:36:58.929][000000031.492] I/user.tm1638_demo , : 20
[2026-07-21 10:36:59.581][000000032.142] I/user.tm1638_demo , : 22
[2026-07-21 10:37:00.218][000000032.792] I/user.tm1638_demo , : 24
[2026-07-21 10:37:09.864][000000042.439] I/user.tm1638_demo
[2026-07-21 10:37:09.876][000000042.439] I/user.tm1638_demo ===== [6/7] =====
[2026-07-21 10:37:19.103][000000051.675] I/user.tm1638_demo ---- 综合演示结束 ----
[2026-07-21 10:37:19.116][000000051.675] I/user.tm1638_demo ===== [7/7] // =====
[2026-07-21 10:37:19.128][000000051.675] I/user.tm1638_demo : 26-07-08
[2026-07-21 10:37:22.644][000000055.209] I/user.tm1638_demo : 08-30-00 ~ 08-30-09
[2026-07-21 10:37:43.095][000000075.654] I/user.tm1638_demo ===== [] =====
```
### 6.6 故障排除
1. **数码管无显示**
- 检查 TM1638 接线是否正确(CLK、DIO、STB、VCC、GND
- 确认 GPIO 引脚配置与接线一致
- 检查电源电压是否稳定(3.3V
- 确认 exs_tm1638 扩展库已正常加载
2. **LED 指示灯不亮**
- 检查 TM1638 模块供电是否正常
- 确认模块是否支持 LED 功能(部分精简模块可能没有 LED)
3. **按键无响应**
- 检查按键接线和 TM1638 模块是否正常
- 确认扩展库初始化成功
- 查看日志确认 `init()` 返回值为 true
4. **亮度无法调节**
- 确认调用 `set_brightness()` 时参数为 0~7
5. **显示内容错乱**
- 检查杜邦线是否过长导致通信不稳定
### 6.7 扩展功能建议
exs_tm1638 更多接口的使用可以查看 [exs_tm1638 扩展库说明](https://docs.openluat.com/osapi/ext/sensor/exs_tm1638/)
@@ -0,0 +1,280 @@
--[[
@module tm1638_demo
@summary TM1638 驱动芯片演示模块,包含所有功能的演示用例
@version 2.0
@date 2026.07.13
@author 江访
@usage
本文件包含 TM1638 的逐项功能演示和综合展示。
通过 exs_tm1638 扩展库的 API 逐一演示数码管显示、LED 控制、按键检测等功能。
]]
-- 加载 exs_tm1638 扩展库
local exs_tm1638 = require "exs_tm1638"
-- 演示字符串显示
local function demo_string()
log.info("tm1638_demo", "===== [1/7] 字符串显示 =====")
log.info("tm1638_demo", "显示 87654321")
exs_tm1638.clear()
exs_tm1638.set_display("87654321")
sys.wait(1500)
log.info("tm1638_demo", "显示 88.88")
exs_tm1638.clear()
exs_tm1638.set_display("88.88")
sys.wait(1500)
log.info("tm1638_demo", "显示 AbCd")
exs_tm1638.clear()
exs_tm1638.set_display("AbCd")
sys.wait(1500)
log.info("tm1638_demo", "从第 3 位开始显示 1234")
exs_tm1638.clear()
exs_tm1638.set_display("1234", 3)
sys.wait(1500)
exs_tm1638.clear()
sys.wait(500)
end
-- 演示 LED 指示灯
local function demo_leds()
log.info("tm1638_demo", "===== [2/7] LED =====")
for i = 1, 8 do
exs_tm1638.set_display(string.format("%d", i))
exs_tm1638.set_led(true, i)
sys.wait(300)
end
sys.wait(1000)
log.info("tm1638_demo", "逐个熄灭")
for i = 1, 8 do
exs_tm1638.set_led(false, i)
sys.wait(200)
end
log.info("tm1638_demo", "LED 跑马灯")
exs_tm1638.clear()
for round = 1, 3 do
for i = 1, 8 do
if i > 1 then
exs_tm1638.set_led(false, i - 1)
else
exs_tm1638.set_led(false, 8)
end
exs_tm1638.set_led(true, i)
exs_tm1638.set_display(string.format("%d", i))
sys.wait(150)
end
end
exs_tm1638.clear()
sys.wait(500)
end
-- 演示亮度调节
local function demo_brightness()
log.info("tm1638_demo", "===== [3/7] 亮度调节 =====")
exs_tm1638.clear()
exs_tm1638.set_display("88888888")
sys.wait(500)
for brightness = 0, 7 do
log.info("tm1638_demo", "设置亮度:", brightness)
exs_tm1638.set_brightness(brightness)
sys.wait(800)
end
exs_tm1638.set_brightness(4)
exs_tm1638.clear()
sys.wait(500)
end
-- 演示按键轮询
local function demo_keys()
log.info("tm1638_demo", "===== [4/7] 按键轮询 =====")
log.info("tm1638_demo", "请在 10 秒内按下连接到 TM1638 的按键...")
exs_tm1638.clear()
exs_tm1638.set_display("KEY----")
local timeout = 10000
local step = 100
local elapsed = 0
while elapsed < timeout do
local key = exs_tm1638.get_key()
if key then
exs_tm1638.clear()
log.info("tm1638_demo", "检测到按键, 编码:", key)
local key_str = string.format("K%02d", key)
exs_tm1638.set_display(key_str)
sys.wait(1000)
return
end
sys.wait(step)
elapsed = elapsed + step
end
log.info("tm1638_demo", "按键检测超时,跳过")
end
-- 按键回调函数
local function on_key(key_code)
log.info("tm1638_demo", "按键回调触发, 编码:", key_code)
local display = string.format("K%02d", key_code)
exs_tm1638.set_display(display)
end
-- 演示按键回调
local function demo_key_callback()
log.info("tm1638_demo", "[5/7] 按键回调(15 秒内按按键演示)")
exs_tm1638.clear()
exs_tm1638.set_display("Cb-Key")
exs_tm1638.set_key_callback(on_key)
sys.wait(15000)
exs_tm1638.set_key_callback(nil)
log.info("tm1638_demo", "按键回调演示结束")
end
-- 综合演示
local function demo_final_show()
log.info("tm1638_demo", "===== [6/7] 综合演示 =====")
for i = 5, 0, -1 do
exs_tm1638.clear()
exs_tm1638.set_display(string.format("%d", i))
for j = 1, 8 do
exs_tm1638.set_led(false, j)
end
sys.wait(500)
end
for i = 0, 3 do
exs_tm1638.clear()
exs_tm1638.set_display("-HELLO-")
sys.wait(500)
exs_tm1638.clear()
sys.wait(300)
end
exs_tm1638.clear()
exs_tm1638.set_display("88888888")
for i = 1, 8 do
exs_tm1638.set_led(true, i)
end
for i = 0, 7 do
exs_tm1638.set_brightness(i)
sys.wait(200)
end
sys.wait(1000)
exs_tm1638.clear()
for i = 1, 8 do
exs_tm1638.set_led(false, i)
end
log.info("tm1638_demo", "---- 综合演示结束 ----")
end
-- 展示日期:格式 "26-07-08"
local function show_date()
log.info("tm1638_demo", "日期展示: 26-07-08")
exs_tm1638.set_display("26-07-08")
sys.wait(3000)
exs_tm1638.clear()
end
-- 展示时间:模拟走时 "08-30-00" ~ "08-30-09"
local function show_clock()
exs_tm1638.clear()
sys.wait(200)
log.info("tm1638_demo", "时钟展示: 08-30-00 ~ 08-30-09")
for sec = 0, 9 do
exs_tm1638.set_display(string.format("08-30-%02d", sec))
sys.wait(500)
end
end
-- 展示温度:摄氏度用 "°C",华氏度用 "°F"
local function show_temperature()
exs_tm1638.clear()
sys.wait(200)
local DEGREE = "°"
for temp = 25, 32 do
local cel = string.format("%02d", temp) .. DEGREE .. "C"
exs_tm1638.set_display(cel)
local bright = math.floor((temp - 25) / 7 * 7 + 0.5)
if bright < 0 then bright = 0 end
if bright > 7 then bright = 7 end
exs_tm1638.set_brightness(bright)
sys.wait(800)
end
for temp = 77, 90, 2 do
local fah = string.format("%02d", temp) .. DEGREE .. "F"
exs_tm1638.set_display(fah)
sys.wait(600)
end
exs_tm1638.set_brightness(5)
sys.wait(1000)
exs_tm1638.clear()
end
local function run_main()
log.info("tm1638_demo", "===== [7/7] 日期/时钟/温度 =====")
show_date()
sys.wait(300)
show_clock()
sys.wait(300)
show_temperature()
end
-- 演示主函数(运行在协程中)
local function tm1638_demo_task_func()
-- 初始化
local result = exs_tm1638.setup({
clk = 31,
dio = 30,
stb = 32,
bright = 5,
write_mode = "auto",
})
if not result then
log.error("tm1638_demo", "TM1638 初始化失败,请检查接线")
return
end
log.info("tm1638_demo", "TM1638 初始化成功,版本:", exs_tm1638.version())
-- HELLO 开始 → [1/7] → [2/7] → [3/7] → [4/7] → [5/7] → [6/7] → [7/7] → End
exs_tm1638.set_display("HELLO")
sys.wait(1000)
demo_string()
demo_leds()
demo_brightness()
demo_keys()
demo_key_callback()
demo_final_show()
run_main()
exs_tm1638.set_display("End")
sys.wait(3000)
log.info("tm1638_demo", "===== [演示完毕] =====")
end
sys.taskInit(tm1638_demo_task_func)