mobile_comm/luatos/air780epm/module/Air780EPM/demo/sensor/tm1637

TM1637 数码管驱动芯片演示

一、功能模块介绍

1.1 核心主程序模块

1. main.lua - 主程序入口，负责项目初始化、版本定义和任务调度
2. tm1637_demo.lua - TM1637 功能演示模块，包含数码管显示、按键检测、亮度调节、综合展示等所有功能的演示用例

1.2 扩展库模块

1. exs_tm1637 - TM1637 扩展库，提供数码管段码显示、按键检测、亮度调节等 API

二、演示流程介绍

本 demo 按顺序演示 exs_tm1637 扩展库的 6 项功能：HELLO → [1/6] → [2/6] → [3/6] → [4/6] → [5/6] → [6/6] → End

2.1 功能演示项说明

1. [1/6] 字符串显示 - 数码管逐项显示数字、带小数点数字、字母组合、指定位置显示
2. [2/6] 按键轮询 - 通过 get_key() API 轮询检测按键，10 秒超时
3. [3/6] 按键回调 - 通过 set_key_callback() API 设置按键回调函数，12 秒演示窗口
4. [4/6] 亮度调节 - 展示 0~7 级亮度调节效果
5. [5/6] 综合演示 - 倒计时、HELLO 闪烁、全 8 显示、亮度渐变
6. [6/6] 日期/时钟/温度 - 日期展示（YY-MM-DD 格式）、时钟模拟走时（HH-MM-SS）、温度展示（摄氏度°C 和华氏度°F）

三、显示效果

四、演示硬件环境

3.1 硬件清单

• Air780EPM 核心板 × 1
• TM1637 数码管模块（6 位数码管 + 16 个按键） × 1 demo所演示的TM1637数码管购买链接
• 母对母杜邦线 × 4
• TYPE-C 数据线 × 1

3.2 接线配置

3.2.1 TM1637 模块接线

Air780EPM 核心板	TM1637 模块
32/GPIO31	CLK
31/GPIO30	DIO
VDD_EXT	VCC
GND	GND

说明：接线时注意杜邦线不宜过长，以免通信不稳定。

五、演示软件环境

4.1 开发工具

• Luatools下载调试工具 - 固件烧录和代码调试

4.2 内核固件

• 点击下载Air780EPM系列最新版本内核固件，demo所使用的是 LuatOS-SoC_V2046_Air780EPM 1号固件

4.3 脚本文件

1. main.lua - 主程序入口
2. tm1637_demo.lua - TM1637 功能演示模块
3. exs_tm1637 - TM1637 扩展库

六、演示核心步骤

6.1 硬件准备

1. 按照接线表将 TM1637 模块连接到核心板
2. 确保电源连接正确，通过 TYPE-C USB 口供电
3. 检查所有接线无误，避免短路

6.2 软件配置

在 main.lua 中加载对应的演示模块：

-- 加载 tm1637_demo.lua 演示模块
require "tm1637_demo"

6.3 软件烧录

1. 使用 Luatools 选择最新内核固件
2. 下载本项目所有脚本文件
3. 将固件和脚本一起烧录到设备
4. 烧录成功后设备自动重启后开始运行

6.4 功能测试

6.4.1 字符串显示演示

1. 设备启动后显示 "HELLO"，随后自动进入 [1/6] 字符串显示
2. 观察数码管依次显示：123456 → 88.88 → AbCd → 从第 3 位显示 1234
3. 检查字符显示是否正确，带小数点功能是否正常

6.4.2 按键检测演示

1. 自动进入 [2/6] 按键轮询演示，数码管显示 "KEY---"
2. 在 10 秒内按下 TM1637 模块上的任意按键
3. 观察数码管显示按键编码（如 "K01"、"K02" 等）
4. 若 10 秒内无按键按下，自动跳过

6.4.3 按键回调演示

1. 自动进入 [3/6] 按键回调演示，数码管显示 "Cb-Key"
2. 在 12 秒内按下任意按键，观察数码管显示对应按键编码
3. 观察日志输出，确认回调函数 on_key 被正常触发
4. 12 秒后自动结束回调演示

6.4.4 亮度调节演示

1. 自动进入 [4/6] 亮度调节演示，数码管显示 "888888"
2. 观察数码管亮度从 0 级到 7 级逐级变化
3. 最终恢复到 4 级亮度

6.4.5 综合演示

1. 自动进入 [5/6] 综合演示
2. 观察倒计时效果：5 → 4 → 3 → 2 → 1 → 0
3. 观察 "-HELLO" 闪烁效果，重复 4 次
4. 观察全 8 显示 + 亮度渐变
5. 数码管全灭

6.4.6 日期/时钟/温度演示

1. 自动进入 [6/6] 日期/时钟/温度演示
2. 日期展示：6 位数码管显示 "YYMMDD"（如 "260713"），停留 3 秒
3. 时钟展示：模拟走时 "083000" → "083001" → ... → "083009"
4. 温度展示：
   • 摄氏度：25°C → 32°C 逐度变化，亮度随温度升高而增加
   • 华氏度：77°F → 90°F 逐度变化
5. 演示结束后显示 "End" 并停留 3 秒

6.5 预期效果

• 字符串显示：数字、字母、小数点均能正确显示，支持指定起始位置
• 按键检测：轮询模式和回调模式均能正确检测按键，编码显示正常
• 亮度调节：0~7 级亮度逐级变化，效果明显
• 日期/时钟/温度：格式显示正确，°C 和 °F 符号正常显示
• 日志如下：

[2026-07-21 10:33:01.174][000000000.180] I/main LuatOS@Air780EPM base 26.04 bsp V2046 32bit
[2026-07-21 10:33:01.177][000000000.180] I/main ROM Build: Jul  7 2026 20:39:17
[2026-07-21 10:33:01.179][000000000.182] W/pins /luadb/pins_air780epm.json not exist!!
[2026-07-21 10:33:01.180][000000000.185] D/main loadlibs luavm 1048568 14784 14784
[2026-07-21 10:33:01.182][000000000.185] D/main loadlibs sys   2366664 82756 89356
[2026-07-21 10:33:01.184][000000000.185] D/main loadlibs psram 2366664 82756 89356
[2026-07-21 10:33:01.186][000000000.203] I/user.main TM1637_Demo 001.999.000
[2026-07-21 10:33:01.188][000000000.217] D/user.exs_tm1637 version -> 202607161200
[2026-07-21 10:33:01.190][000000000.226] I/user.exs_tm1637 初始化完成, clk=31 dio=30 亮度=5
[2026-07-21 10:33:01.193][000000000.227] I/user.tm1637_demo TM1637 初始化成功，版本: 202607161200
[2026-07-21 10:33:01.396][000000001.233] I/user.tm1637_demo ===== [1/6] 字符串显示 =====
[2026-07-21 10:33:01.397][000000001.234] I/user.tm1637_demo 显示 123456
[2026-07-21 10:33:02.359][000000002.745] I/user.tm1637_demo 显示 88.88
[2026-07-21 10:33:03.870][000000004.258] I/user.tm1637_demo 显示 AbCd
[2026-07-21 10:33:05.377][000000005.770] I/user.tm1637_demo 从第 3 位开始显示 1234
[2026-07-21 10:33:05.497][000000005.829] I/mobile sim0 sms ready
[2026-07-21 10:33:05.506][000000005.830] D/mobile cid1, state0
[2026-07-21 10:33:05.512][000000005.831] D/mobile bearer act 0, result 0
[2026-07-21 10:33:05.516][000000005.831] D/mobile NETIF_LINK_ON -> IP_READY
[2026-07-21 10:33:05.521][000000005.886] D/mobile TIME_SYNC 0 tm 1784601188
[2026-07-21 10:33:07.395][000000007.790] I/user.tm1637_demo ===== [2/6] 按键轮询 =====
[2026-07-21 10:33:07.399][000000007.791] I/user.tm1637_demo 按下任意按键测试，10 秒无操作后自动结束
[2026-07-21 10:33:08.328][000000008.724] I/user.tm1637_demo 检测到按键, 编码: 1
[2026-07-21 10:33:09.461][000000009.851] I/user.tm1637_demo 检测到按键, 编码: 2
[2026-07-21 10:33:11.605][000000011.999] I/user.tm1637_demo 检测到按键, 编码: 3
[2026-07-21 10:33:12.428][000000012.822] I/user.tm1637_demo 检测到按键, 编码: 4
[2026-07-21 10:33:13.452][000000013.846] I/user.tm1637_demo 检测到按键, 编码: 5
[2026-07-21 10:33:14.382][000000014.771] I/user.tm1637_demo 检测到按键, 编码: 6
[2026-07-21 10:33:15.203][000000015.592] I/user.tm1637_demo 检测到按键, 编码: 7
[2026-07-21 10:33:16.431][000000016.822] I/user.tm1637_demo 检测到按键, 编码: 8
[2026-07-21 10:33:17.350][000000017.744] I/user.tm1637_demo 检测到按键, 编码: 9
[2026-07-21 10:33:18.280][000000018.668] I/user.tm1637_demo 检测到按键, 编码: 10
[2026-07-21 10:33:19.103][000000019.488] I/user.tm1637_demo 检测到按键, 编码: 11
[2026-07-21 10:33:20.018][000000020.412] I/user.tm1637_demo 检测到按键, 编码: 12
[2026-07-21 10:33:20.843][000000021.233] I/user.tm1637_demo 检测到按键, 编码: 13
[2026-07-21 10:33:21.668][000000022.055] I/user.tm1637_demo 检测到按键, 编码: 14
[2026-07-21 10:33:22.490][000000022.875] I/user.tm1637_demo 检测到按键, 编码: 15
[2026-07-21 10:33:23.811][000000024.206] I/user.tm1637_demo 检测到按键, 编码: 16
[2026-07-21 10:33:30.758][000000031.145] I/user.tm1637_demo 按键检测结束
[2026-07-21 10:33:30.761][000000031.145] I/user.tm1637_demo ===== [4/6] 按键回调 =====
[2026-07-21 10:33:30.766][000000031.146] I/user.tm1637_demo 接下来 12 秒内按按键查看回调效果
[2026-07-21 10:33:32.123][000000032.512] I/user.tm1637_demo 按键回调触发, 编码: 16
[2026-07-21 10:33:42.771][000000043.160] I/user.tm1637_demo 按键回调演示结束
[2026-07-21 10:33:42.774][000000043.160] I/user.tm1637_demo ===== [3/6] 亮度调节 =====
[2026-07-21 10:33:43.282][000000043.673] I/user.tm1637_demo 设置亮度: 0
[2026-07-21 10:33:44.090][000000044.475] I/user.tm1637_demo 设置亮度: 1
[2026-07-21 10:33:44.880][000000045.277] I/user.tm1637_demo 设置亮度: 2
[2026-07-21 10:33:45.688][000000046.078] I/user.tm1637_demo 设置亮度: 3
[2026-07-21 10:33:46.494][000000046.880] I/user.tm1637_demo 设置亮度: 4
[2026-07-21 10:33:47.285][000000047.681] I/user.tm1637_demo 设置亮度: 5
[2026-07-21 10:33:48.092][000000048.483] I/user.tm1637_demo 设置亮度: 6
[2026-07-21 10:33:48.895][000000049.285] I/user.tm1637_demo 设置亮度: 7
[2026-07-21 10:33:50.199][000000050.594] I/user.tm1637_demo ===== [5/6] 综合演示 =====
[2026-07-21 10:33:59.171][000000059.565] I/user.tm1637_demo ---- 综合演示结束 ----
[2026-07-21 10:33:59.175][000000059.566] I/user.tm1637_demo ===== [6/6] 日期/时钟/温度 =====
[2026-07-21 10:33:59.179][000000059.566] I/user.tm1637_demo 日期展示: 260713
[2026-07-21 10:34:02.692][000000063.084] I/user.tm1637_demo 时钟展示: 083000 ~ 083009
[2026-07-21 10:34:22.982][000000083.365] I/user.tm1637_demo ===== [演示完毕] =====

6.6 故障排除

1. 数码管无显示：

   • 检查 TM1637 接线是否正确（CLK、DIO、VCC、GND）
   • 确认 GPIO 引脚配置与接线一致
   • 检查电源电压是否稳定（3.3V）
   • 确认 exs_tm1637 扩展库已正常加载

2. 按键无响应：

   • 检查按键接线和 TM1637 模块是否正常
   • 确认扩展库初始化成功
   • 查看日志确认 setup() 返回值为 true

3. 亮度无法调节：

   • 确认调用 set_brightness() 时参数为 0~7

4. 显示内容错乱：

   • 检查杜邦线是否过长导致通信不稳定

6.7 扩展功能建议

exs_tm1637 更多接口的使用可以查看 exs_tm1637 扩展库说明