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,71 @@
|
||||
--[[
|
||||
@module main
|
||||
@summary TM1640 数码管驱动芯片测试 Demo 入口
|
||||
@version 1.0
|
||||
@date 2026.07.13
|
||||
@author 江访
|
||||
]]
|
||||
|
||||
--[[
|
||||
=== 演示内容 ===
|
||||
|
||||
本 demo 演示 exs_tm1640 扩展库的完整功能，顺序为：
|
||||
HELLO→[1/4]→[2/4]→[3/4]→[4/4]→End
|
||||
1、数码管字符串显示（[1/4]）
|
||||
2、亮度调节（[2/4]）
|
||||
3、综合演示（[3/4]）
|
||||
4、日期/时钟/温度（[4/4]）
|
||||
|
||||
]]
|
||||
|
||||
|
||||
--[[
|
||||
VERSION：项目版本号，ascii string类型
|
||||
如果使用合宙iot.openluat.com进行远程升级，必须按照"XXX.YYY.ZZZ"三段格式定义：
|
||||
X、Y、Z各表示1位数字，三个X表示的数字可以相同，也可以不同，同理三个Y和三个Z表示的数字也是可以相同，可以不同
|
||||
因为历史原因，YYY这三位数字必须存在，但是没有任何用处，可以一直写为000
|
||||
如果不使用合宙iot.openluat.com进行远程升级，根据自己项目的需求，自定义格式即可
|
||||
]]
|
||||
-- main.lua - 程序入口文件
|
||||
|
||||
PROJECT = "TM1640_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)
|
||||
|
||||
-- 加载 tm1640_demo.lua 演示模块
|
||||
require "tm1640_demo"
|
||||
|
||||
|
||||
-- 用户代码已结束
|
||||
-- 结尾总是这一句
|
||||
sys.run()
|
||||
-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
|
||||
@@ -0,0 +1,195 @@
|
||||
# TM1640 数码管驱动芯片演示
|
||||
|
||||
## 一、功能模块介绍
|
||||
|
||||
### 1.1 核心主程序模块
|
||||
|
||||
1. **main.lua** - 主程序入口，负责项目初始化、版本定义和任务调度
|
||||
2. **tm1640_demo.lua** - TM1640 功能演示模块，包含数码管显示、亮度调节、综合展示等所有功能的演示用例
|
||||
|
||||
### 1.2 扩展库模块
|
||||
|
||||
1. **exs_tm1640** - TM1640 扩展库，提供数码管段码显示、亮度调节等 API
|
||||
|
||||
## 二、演示流程介绍
|
||||
|
||||
本 demo 按顺序演示 exs_tm1640 扩展库的 4 项功能：HELLO → [1/4] → [2/4] → [3/4] → [4/4] → End
|
||||
|
||||
### 2.1 功能演示项说明
|
||||
|
||||
1. **[1/4] 字符串显示** - 数码管逐项显示数字、带小数点数字、字母组合、指定位置显示（利用 16 位显示能力）
|
||||
2. **[2/4] 亮度调节** - 展示 0~7 级亮度调节效果
|
||||
3. **[3/4] 综合演示** - 倒计时、HELLO 闪烁、全亮全灭、亮度渐变
|
||||
4. **[4/4] 日期/时钟/温度** - 日期展示（YY-MM-DD HH:MM 格式）、时钟模拟走时（HH-MM-SS）、温度展示（摄氏度°C 和华氏度°F）
|
||||
|
||||
## 三、显示效果
|
||||
|
||||
|
||||
|
||||
## 四、演示硬件环境
|
||||
|
||||
### 4.1 硬件清单
|
||||
|
||||
- Air780EPM 核心板 × 1
|
||||
- TM1640 数码管模块（16 位数码管） × 1
|
||||
demo所演示的TM1640数码管[购买链接](https://item.taobao.com/item.htm?abbucket=12&id=993241354836&mi_id=0000snMzr-QYn9Az44HHVAD7gjY_XJWQal2Z8EbIpIZRa-k&ns=1&priceTId=213e00d417839211007372882e1068&skuId=5970246265328&spm=a21n57.1.hoverItem.4&utparam=%7B%22aplus_abtest%22%3A%22dc10f02e922922befeb0841a2cbe561e%22%7D&xxc=taobaoSearch)
|
||||
- 母对母杜邦线 × 4
|
||||
- TYPE-C 数据线 × 1
|
||||
|
||||
### 4.2 接线配置
|
||||
|
||||
#### 4.2.1 TM1640 模块接线
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td>Air780EPM 核心板<br/></td><td>TM1640 模块<br/></td></tr>
|
||||
<tr>
|
||||
<td>32/GPIO31<br/></td><td>CLK<br/></td></tr>
|
||||
<tr>
|
||||
<td>31/GPIO30<br/></td><td>DIN<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>
|
||||
|
||||
> 说明：接线时注意杜邦线不宜过长，以免通信不稳定。
|
||||
|
||||
## 五、演示软件环境
|
||||
|
||||
### 5.1 开发工具
|
||||
|
||||
- [Luatools下载调试工具](https://docs.openluat.com/air780epm/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. **tm1640_demo.lua** - TM1640 功能演示模块
|
||||
3. **exs_tm1640** - TM1640 扩展库
|
||||
|
||||
## 六、演示核心步骤
|
||||
|
||||
### 6.1 硬件准备
|
||||
|
||||
1. 按照接线表将 TM1640 模块连接到核心板
|
||||
2. 确保电源连接正确，通过 TYPE-C USB 口供电
|
||||
3. 检查所有接线无误，避免短路
|
||||
|
||||
### 6.2 软件配置
|
||||
|
||||
在 `main.lua` 中加载对应的演示模块：
|
||||
|
||||
```lua
|
||||
-- 加载 tm1640_demo.lua 演示模块
|
||||
require "tm1640_demo"
|
||||
|
||||
```
|
||||
|
||||
### 6.3 软件烧录
|
||||
|
||||
1. 使用 Luatools 选择最新内核固件
|
||||
2. 下载本项目所有脚本文件
|
||||
3. 将固件和脚本一起烧录到设备
|
||||
4. 烧录成功后设备自动重启后开始运行
|
||||
|
||||
### 6.4 功能测试
|
||||
|
||||
#### 6.4.1 字符串显示演示
|
||||
|
||||
1. 设备启动后显示 "HELLO"，随后自动进入 [1/4] 字符串显示
|
||||
2. 观察数码管依次显示：`0123456789ABCDEF` → `88.88` → 从第 3 位显示 `AbCd` → 从第 8 位显示 `1234` → 从第 12 位显示 `5678`
|
||||
3. 检查字符显示是否正确，带小数点功能是否正常
|
||||
|
||||
#### 6.4.2 亮度调节演示
|
||||
|
||||
1. 自动进入 [2/4] 亮度调节演示，数码管显示 16 个 8
|
||||
2. 观察数码管亮度从 0 级到 7 级逐级变化
|
||||
3. 最终恢复到 4 级亮度
|
||||
|
||||
#### 6.4.3 综合演示
|
||||
|
||||
1. 自动进入 [3/4] 综合演示
|
||||
2. 观察倒计时效果：5 → 4 → 3 → 2 → 1 → 0
|
||||
3. 观察 "HELLO" 闪烁效果，重复 4 次
|
||||
4. 观察 16 位全 8 显示 + 亮度渐变
|
||||
5. 数码管全灭
|
||||
|
||||
#### 6.4.4 日期/时钟/温度演示
|
||||
|
||||
1. 自动进入 [4/4] 日期/时钟/温度演示
|
||||
2. 日期时钟展示：显示格式 "YY-MM-DD HH:MM"（如 "26-07-13 08:30"），停留 4 秒
|
||||
3. 时钟展示：模拟走时 "08-30-00" → "08-30-01" → ... → "08-30-09"
|
||||
4. 温度展示：
|
||||
- 摄氏度：25°C → 32°C 逐度变化，亮度随温度升高而增加
|
||||
- 华氏度：77°F → 90°F 逐度变化
|
||||
5. 演示结束后显示 "End" 并停留 3 秒
|
||||
|
||||
### 6.5 预期效果
|
||||
|
||||
- **字符串显示**：数字、字母、小数点均能正确显示，支持指定起始位置，16 位完整显示
|
||||
- **亮度调节**：0~7 级亮度逐级变化，效果明显
|
||||
- **日期/时钟/温度**：格式显示正确，°C 和 °F 符号正常显示
|
||||
- **日志如下：**
|
||||
```lua
|
||||
[2026-07-21 10:40:01.164][000000000.185] I/main LuatOS@Air780EPM base 26.04 bsp V2046 32bit
|
||||
[2026-07-21 10:40:01.175][000000000.185] I/main ROM Build: Jul 7 2026 20:39:17
|
||||
[2026-07-21 10:40:01.185][000000000.187] W/pins /luadb/pins_air780epm.json not exist!!
|
||||
[2026-07-21 10:40:01.193][000000000.190] D/main loadlibs luavm 1048568 14784 14784
|
||||
[2026-07-21 10:40:01.201][000000000.190] D/main loadlibs sys 2366664 82756 89356
|
||||
[2026-07-21 10:40:01.210][000000000.190] D/main loadlibs psram 2366664 82756 89356
|
||||
[2026-07-21 10:40:01.221][000000000.209] I/user.main TM1640_Demo 001.999.000
|
||||
[2026-07-21 10:40:01.229][000000000.223] D/user.exs_tm1640 version -> 202607131200
|
||||
[2026-07-21 10:40:01.237][000000000.250] I/user.exs_tm1640 初始化完成, clk=31 din=30 亮度=5
|
||||
[2026-07-21 10:40:01.245][000000000.250] I/user.tm1640_demo TM1640 初始化成功，版本: 202607131200
|
||||
[2026-07-21 10:40:01.745][000000001.273] I/user.tm1640_demo ===== [1/4] 字符串显示 =====
|
||||
[2026-07-21 10:40:01.752][000000001.274] I/user.tm1640_demo 显示 0123456789ABCDEF
|
||||
[2026-07-21 10:40:02.854][000000002.318] I/mobile sim0 sms ready
|
||||
[2026-07-21 10:40:02.859][000000002.319] D/mobile cid1, state0
|
||||
[2026-07-21 10:40:02.865][000000002.320] D/mobile bearer act 0, result 0
|
||||
[2026-07-21 10:40:02.889][000000002.320] D/mobile NETIF_LINK_ON -> IP_READY
|
||||
[2026-07-21 10:40:02.905][000000002.374] D/mobile TIME_SYNC 0 tm 1784601606
|
||||
[2026-07-21 10:40:03.797][000000003.323] I/user.tm1640_demo 显示 88.88
|
||||
[2026-07-21 10:40:05.337][000000004.870] I/user.tm1640_demo 从第 3 位开始显示 AbCd
|
||||
[2026-07-21 10:40:06.878][000000006.416] I/user.tm1640_demo 偏移显示 1234 在第 8 位
|
||||
[2026-07-21 10:40:08.430][000000007.962] I/user.tm1640_demo 从第 12 位显示 5678
|
||||
[2026-07-21 10:40:10.496][000000010.032] I/user.tm1640_demo ===== [2/4] 亮度调节 =====
|
||||
[2026-07-21 10:40:11.041][000000010.579] I/user.tm1640_demo 设置亮度: 0
|
||||
[2026-07-21 10:40:11.851][000000011.380] I/user.tm1640_demo 设置亮度: 1
|
||||
[2026-07-21 10:40:12.644][000000012.181] I/user.tm1640_demo 设置亮度: 2
|
||||
[2026-07-21 10:40:13.454][000000012.982] I/user.tm1640_demo 设置亮度: 3
|
||||
[2026-07-21 10:40:14.252][000000013.783] I/user.tm1640_demo 设置亮度: 4
|
||||
[2026-07-21 10:40:15.060][000000014.584] I/user.tm1640_demo 设置亮度: 5
|
||||
[2026-07-21 10:40:15.854][000000015.385] I/user.tm1640_demo 设置亮度: 6
|
||||
[2026-07-21 10:40:16.646][000000016.186] I/user.tm1640_demo 设置亮度: 7
|
||||
[2026-07-21 10:40:17.983][000000017.510] I/user.tm1640_demo ===== [3/4] 综合演示 =====
|
||||
[2026-07-21 10:40:27.394][000000026.923] I/user.tm1640_demo ---- 综合演示结束 ----
|
||||
[2026-07-21 10:40:27.410][000000026.924] I/user.tm1640_demo ===== [4/4] 日期/时钟/温度 =====
|
||||
[2026-07-21 10:40:27.421][000000026.924] I/user.tm1640_demo 日期时钟展示: 26-07-13 08:30
|
||||
[2026-07-21 10:40:31.964][000000031.492] I/user.tm1640_demo 时钟展示: 08-30-00 ~ 08-30-09
|
||||
[2026-07-21 10:40:52.715][000000052.244] I/user.tm1640_demo ===== [演示完毕] =====
|
||||
```
|
||||
|
||||
### 6.6 故障排除
|
||||
|
||||
1. **数码管无显示**：
|
||||
|
||||
- 检查 TM1640 接线是否正确（CLK、DIN、VCC、GND）
|
||||
- 确认 GPIO 引脚配置与接线一致
|
||||
- 检查电源电压是否稳定（3.3V）
|
||||
- 确认 exs_tm1640 扩展库已正常加载
|
||||
|
||||
2. **亮度无法调节**：
|
||||
|
||||
- 确认调用 `set_brightness()` 时参数为 0~7
|
||||
|
||||
3. **显示内容错乱**：
|
||||
|
||||
- 检查杜邦线是否过长导致通信不稳定
|
||||
|
||||
### 6.7 扩展功能建议
|
||||
|
||||
exs_tm1640 更多接口的使用可以查看 [exs_tm1640 扩展库说明](https://docs.openluat.com/osapi/ext/sensor/exs_tm1640/)
|
||||
@@ -0,0 +1,186 @@
|
||||
--[[
|
||||
@module tm1640_demo
|
||||
@summary TM1640 驱动芯片演示模块，包含所有功能的演示用例
|
||||
@version 1.0
|
||||
@date 2026.07.13
|
||||
@author 江访
|
||||
@usage
|
||||
本文件包含 TM1640 的逐项功能演示和综合展示。
|
||||
通过 exs_tm1640 扩展库的 API 逐一演示数码管显示、亮度调节等功能。
|
||||
]]
|
||||
|
||||
-- 加载 exs_tm1640 扩展库
|
||||
local exs_tm1640 = require "exs_tm1640"
|
||||
|
||||
-- 演示字符串显示（利用 16 位数码管）
|
||||
local function demo_string()
|
||||
log.info("tm1640_demo", "===== [1/4] 字符串显示 =====")
|
||||
|
||||
log.info("tm1640_demo", "显示 0123456789ABCDEF")
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("0123456789ABCDEF")
|
||||
sys.wait(2000)
|
||||
|
||||
log.info("tm1640_demo", "显示 88.88")
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("88.88")
|
||||
sys.wait(1500)
|
||||
|
||||
log.info("tm1640_demo", "从第 3 位开始显示 AbCd")
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("AbCd", 3)
|
||||
sys.wait(1500)
|
||||
|
||||
log.info("tm1640_demo", "偏移显示 1234 在第 8 位")
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("1234", 8)
|
||||
sys.wait(1500)
|
||||
|
||||
log.info("tm1640_demo", "从第 12 位显示 5678")
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("5678", 12)
|
||||
sys.wait(1500)
|
||||
|
||||
exs_tm1640.clear()
|
||||
sys.wait(500)
|
||||
end
|
||||
|
||||
-- 演示亮度调节
|
||||
local function demo_brightness()
|
||||
log.info("tm1640_demo", "===== [2/4] 亮度调节 =====")
|
||||
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("8888888888888888")
|
||||
sys.wait(500)
|
||||
|
||||
for brightness = 0, 7 do
|
||||
log.info("tm1640_demo", "设置亮度:", brightness)
|
||||
exs_tm1640.set_brightness(brightness)
|
||||
sys.wait(800)
|
||||
end
|
||||
|
||||
exs_tm1640.set_brightness(4)
|
||||
exs_tm1640.clear()
|
||||
sys.wait(500)
|
||||
end
|
||||
|
||||
-- 综合演示
|
||||
local function demo_final_show()
|
||||
log.info("tm1640_demo", "===== [3/4] 综合演示 =====")
|
||||
|
||||
-- 倒计时
|
||||
for i = 5, 0, -1 do
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display(string.format("%d", i))
|
||||
sys.wait(500)
|
||||
end
|
||||
|
||||
-- HELLO 闪烁
|
||||
for i = 0, 3 do
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("HELLO")
|
||||
sys.wait(500)
|
||||
exs_tm1640.clear()
|
||||
sys.wait(300)
|
||||
end
|
||||
|
||||
-- 全 8 显示加亮度渐变
|
||||
exs_tm1640.clear()
|
||||
exs_tm1640.set_display("8888888888888888")
|
||||
|
||||
for i = 0, 7 do
|
||||
exs_tm1640.set_brightness(i)
|
||||
sys.wait(200)
|
||||
end
|
||||
|
||||
sys.wait(1000)
|
||||
exs_tm1640.clear()
|
||||
|
||||
log.info("tm1640_demo", "---- 综合演示结束 ----")
|
||||
end
|
||||
|
||||
-- 展示日期：16 位显示 "26-07-13 08:30"
|
||||
local function show_datetime()
|
||||
log.info("tm1640_demo", "日期时钟展示: 26-07-13 08:30")
|
||||
exs_tm1640.set_display("26-07-13 08:30")
|
||||
sys.wait(4000)
|
||||
exs_tm1640.clear()
|
||||
end
|
||||
|
||||
-- 展示时间：模拟走时 "08-30-00" ~ "08-30-09"
|
||||
local function show_clock()
|
||||
exs_tm1640.clear()
|
||||
sys.wait(200)
|
||||
log.info("tm1640_demo", "时钟展示: 08-30-00 ~ 08-30-09")
|
||||
for sec = 0, 9 do
|
||||
exs_tm1640.set_display(string.format("08-30-%02d", sec))
|
||||
sys.wait(500)
|
||||
end
|
||||
end
|
||||
|
||||
-- 展示温度：摄氏度用 "°C"，华氏度用 "°F"
|
||||
local function show_temperature()
|
||||
exs_tm1640.clear()
|
||||
sys.wait(200)
|
||||
local DEGREE = "°"
|
||||
for temp = 25, 32 do
|
||||
local cel = string.format("%02d", temp) .. DEGREE .. "C"
|
||||
exs_tm1640.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_tm1640.set_brightness(bright)
|
||||
sys.wait(800)
|
||||
end
|
||||
|
||||
for temp = 77, 90, 2 do
|
||||
local fah = string.format("%02d", temp) .. DEGREE .. "F"
|
||||
exs_tm1640.set_display(fah)
|
||||
sys.wait(600)
|
||||
end
|
||||
|
||||
exs_tm1640.set_brightness(5)
|
||||
sys.wait(1000)
|
||||
exs_tm1640.clear()
|
||||
end
|
||||
|
||||
local function run_main()
|
||||
log.info("tm1640_demo", "===== [4/4] 日期/时钟/温度 =====")
|
||||
|
||||
show_datetime()
|
||||
sys.wait(300)
|
||||
show_clock()
|
||||
sys.wait(300)
|
||||
show_temperature()
|
||||
end
|
||||
|
||||
-- 演示主函数（运行在协程中）
|
||||
local function tm1640_demo_task_func()
|
||||
-- 初始化（2-wire：CLK + DIN，无 STB）
|
||||
local result = exs_tm1640.setup({
|
||||
clk = 31,
|
||||
din = 30,
|
||||
bright = 5,
|
||||
})
|
||||
if not result then
|
||||
log.error("tm1640_demo", "TM1640 初始化失败，请检查接线")
|
||||
return
|
||||
end
|
||||
|
||||
log.info("tm1640_demo", "TM1640 初始化成功，版本:", exs_tm1640.version())
|
||||
|
||||
-- HELLO → [1/4] → [2/4] → [3/4] → [4/4] → End
|
||||
exs_tm1640.set_display("HELLO")
|
||||
sys.wait(1000)
|
||||
|
||||
demo_string()
|
||||
demo_brightness()
|
||||
demo_final_show()
|
||||
run_main()
|
||||
|
||||
exs_tm1640.set_display("End")
|
||||
sys.wait(3000)
|
||||
log.info("tm1640_demo", "===== [演示完毕] =====")
|
||||
end
|
||||
|
||||
sys.taskInit(tm1640_demo_task_func)
|
||||
Reference in New Issue
Block a user