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

TM1650 数码管驱动芯片演示

一、功能模块介绍

1.1 核心主程序模块

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

1.2 扩展库模块

1. exs_tm1650 - TM1650 扩展库，提供数码管段码显示、按键检测、亮度调节、模式切换等 API

二、演示流程介绍

本 demo 按顺序演示 exs_tm1650 扩展库的 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] 亮度调节 - 展示 0~7 级亮度调节效果
4. [4/6] 按键回调 - 通过 set_key_callback() API 设置按键回调函数，15 秒演示窗口
5. [5/6] 模式切换 - 8 段与 7 段模式切换演示
6. [6/6] 综合演示 - 倒计时、HELLO 闪烁、全 8 显示、亮度渐变、日期展示、温度展示

三、显示效果

四、演示硬件环境

3.1 硬件清单

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

3.2 接线配置

3.2.1 TM1650 模块接线

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

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

五、演示软件环境

5.1 开发工具

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

5.2 内核固件

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

5.3 脚本文件

1. main.lua - 主程序入口
2. tm1650_demo.lua - TM1650 功能演示模块
3. exs_tm1650 - TM1650 扩展库

六、演示核心步骤

6.1 硬件准备

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

6.2 软件配置

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

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

6.3 软件烧录

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

6.4 功能测试

6.4.1 字符串显示演示

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

6.4.2 按键检测演示

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

6.4.3 亮度调节演示

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

6.4.4 按键回调演示

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

6.4.5 模式切换演示

1. 自动进入 [5/6] 模式切换演示
2. 观察数码管从 8 段模式切换到 7 段模式
3. 再切回 8 段模式，观察显示效果变化
4. 确认小数点（DP）在 7 段模式下不显示

6.4.6 综合演示

1. 自动进入 [6/6] 综合演示
2. 观察倒计时效果：5 → 4 → 3 → 2 → 1 → 0
3. 观察 "HELO" 闪烁效果，重复 4 次
4. 观察全 8 显示 + 亮度渐变
5. 日期展示：显示格式 "YY-MM-DD"（如 "26-07-13"），停留 3 秒
6. 温度展示：
   • 摄氏度：25°C → 32°C 逐度变化，亮度随温度升高而增加
   • 华氏度：77°F → 90°F 逐度变化
7. 演示结束后显示 "End" 并停留 3 秒

6.5 预期效果

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

[2026-07-21 10:42:14.862][000000000.178] I/main LuatOS@Air780EPM base 26.04 bsp V2046 32bit
[2026-07-21 10:42:14.863][000000000.178] I/main ROM Build: Jul  7 2026 20:39:17
[2026-07-21 10:42:14.865][000000000.180] W/pins /luadb/pins_air780epm.json not exist!!
[2026-07-21 10:42:14.867][000000000.182] D/main loadlibs luavm 1048568 14784 14784
[2026-07-21 10:42:14.870][000000000.182] D/main loadlibs sys   2366664 82756 89356
[2026-07-21 10:42:14.872][000000000.182] D/main loadlibs psram 2366664 82756 89356
[2026-07-21 10:42:14.874][000000000.200] I/user.main TM1650_Demo 001.000.001
[2026-07-21 10:42:14.876][000000000.213] D/user.exs_tm1650 version -> 202607161200
[2026-07-21 10:42:14.878][000000000.224] I/user.exs_tm1650 初始化完成, clk=31 dio=30 亮度=5
[2026-07-21 10:42:14.880][000000000.224] I/user.tm1650_demo TM1650 初始化成功，版本: 202607161200
[2026-07-21 10:42:15.073][000000001.230] I/user.tm1650_demo ===== [1/6] 字符串显示 =====
[2026-07-21 10:42:15.075][000000001.231] I/user.tm1650_demo 显示 1234
[2026-07-21 10:42:15.958][000000002.611] I/mobile sim0 sms ready
[2026-07-21 10:42:15.960][000000002.611] D/mobile cid1, state0
[2026-07-21 10:42:15.973][000000002.612] D/mobile bearer act 0, result 0
[2026-07-21 10:42:15.977][000000002.613] D/mobile NETIF_LINK_ON -> IP_READY
[2026-07-21 10:42:15.982][000000002.654] D/mobile TIME_SYNC 0 tm 1784601739
[2026-07-21 10:42:16.024][000000002.744] I/user.tm1650_demo 显示 88.8
[2026-07-21 10:42:17.529][000000004.256] I/user.tm1650_demo 显示 AbCd
[2026-07-21 10:42:19.038][000000005.768] I/user.tm1650_demo 从第 3 位开始显示 12
[2026-07-21 10:42:20.562][000000007.280] I/user.tm1650_demo 显示 HELO
[2026-07-21 10:42:22.567][000000009.297] I/user.tm1650_demo ===== [2/6] 按键轮询 =====
[2026-07-21 10:42:22.571][000000009.298] I/user.tm1650_demo 请在 10 秒内按下连接到 TM1650 的按键...
[2026-07-21 10:42:24.405][000000011.130] I/user.tm1650_demo 检测到按键, 编码: 1
[2026-07-21 10:42:24.515][000000011.238] I/user.tm1650_demo 检测到按键, 编码: 1
[2026-07-21 10:42:25.431][000000012.155] I/user.tm1650_demo 检测到按键, 编码: 2
[2026-07-21 10:42:25.540][000000012.262] I/user.tm1650_demo 检测到按键, 编码: 2
[2026-07-21 10:42:26.053][000000012.774] I/user.tm1650_demo 检测到按键, 编码: 3
[2026-07-21 10:42:26.161][000000012.881] I/user.tm1650_demo 检测到按键, 编码: 3
[2026-07-21 10:42:26.674][000000013.394] I/user.tm1650_demo 检测到按键, 编码: 4
[2026-07-21 10:42:27.389][000000014.107] I/user.tm1650_demo 检测到按键, 编码: 5
[2026-07-21 10:42:27.903][000000014.620] I/user.tm1650_demo 检测到按键, 编码: 6
[2026-07-21 10:42:28.308][000000015.030] I/user.tm1650_demo 检测到按键, 编码: 7
[2026-07-21 10:42:28.711][000000015.440] I/user.tm1650_demo 检测到按键, 编码: 8
[2026-07-21 10:42:29.333][000000016.054] I/user.tm1650_demo 检测到按键, 编码: 9
[2026-07-21 10:42:29.738][000000016.465] I/user.tm1650_demo 检测到按键, 编码: 10
[2026-07-21 10:42:30.250][000000016.977] I/user.tm1650_demo 检测到按键, 编码: 11
[2026-07-21 10:42:30.670][000000017.387] I/user.tm1650_demo 检测到按键, 编码: 12
[2026-07-21 10:42:31.278][000000018.000] I/user.tm1650_demo 检测到按键, 编码: 13
[2026-07-21 10:42:31.682][000000018.413] I/user.tm1650_demo 检测到按键, 编码: 14
[2026-07-21 10:42:32.103][000000018.823] I/user.tm1650_demo 检测到按键, 编码: 15
[2026-07-21 10:42:32.507][000000019.233] I/user.tm1650_demo 检测到按键, 编码: 16
[2026-07-21 10:42:32.817][000000019.541] I/user.tm1650_demo 按键检测超时，跳过
[2026-07-21 10:42:32.822][000000019.541] I/user.tm1650_demo ===== [3/6] 按键回调 =====
[2026-07-21 10:42:32.827][000000019.542] I/user.tm1650_demo 接下来 15 秒内按按键查看回调效果
[2026-07-21 10:42:33.035][000000019.755] I/user.tm1650_demo 按键回调触发, 编码: 17
[2026-07-21 10:42:33.581][000000020.306] I/user.tm1650_demo 按键回调触发, 编码: 18
[2026-07-21 10:42:34.125][000000020.855] I/user.tm1650_demo 按键回调触发, 编码: 19
[2026-07-21 10:42:34.529][000000021.255] I/user.tm1650_demo 按键回调触发, 编码: 20
[2026-07-21 10:42:35.024][000000021.755] I/user.tm1650_demo 按键回调触发, 编码: 21
[2026-07-21 10:42:35.428][000000022.155] I/user.tm1650_demo 按键回调触发, 编码: 22
[2026-07-21 10:42:35.833][000000022.556] I/user.tm1650_demo 按键回调触发, 编码: 23
[2026-07-21 10:42:36.175][000000022.905] I/user.tm1650_demo 按键回调触发, 编码: 24
[2026-07-21 10:42:36.577][000000023.305] I/user.tm1650_demo 按键回调触发, 编码: 25
[2026-07-21 10:42:36.981][000000023.705] I/user.tm1650_demo 按键回调触发, 编码: 26
[2026-07-21 10:42:37.323][000000024.055] I/user.tm1650_demo 按键回调触发, 编码: 27
[2026-07-21 10:42:37.730][000000024.455] I/user.tm1650_demo 按键回调触发, 编码: 28
[2026-07-21 10:42:47.837][000000034.556] I/user.tm1650_demo 按键回调演示结束
[2026-07-21 10:42:47.841][000000034.556] I/user.tm1650_demo ===== [4/6] 亮度调节 =====
[2026-07-21 10:42:48.350][000000035.068] I/user.tm1650_demo 设置亮度: 0
[2026-07-21 10:42:49.141][000000035.870] I/user.tm1650_demo 设置亮度: 1
[2026-07-21 10:42:49.950][000000036.672] I/user.tm1650_demo 设置亮度: 2
[2026-07-21 10:42:50.742][000000037.474] I/user.tm1650_demo 设置亮度: 3
[2026-07-21 10:42:51.550][000000038.276] I/user.tm1650_demo 设置亮度: 4
[2026-07-21 10:42:52.360][000000039.078] I/user.tm1650_demo 设置亮度: 5
[2026-07-21 10:42:53.154][000000039.880] I/user.tm1650_demo 设置亮度: 6
[2026-07-21 10:42:53.963][000000040.682] I/user.tm1650_demo 设置亮度: 7
[2026-07-21 10:42:55.268][000000041.991] I/user.tm1650_demo ===== [5/6] 7段/8段模式切换 =====
[2026-07-21 10:43:01.812][000000048.536] I/user.tm1650_demo ===== [6/6] 综合演示 =====
[2026-07-21 10:43:10.772][000000057.497] I/user.tm1650_demo 日期展示: 0713
[2026-07-21 10:43:26.692][000000073.417] I/user.tm1650_demo ---- 综合演示结束 ----
[2026-07-21 10:43:29.693][000000076.423] I/user.tm1650_demo ===== [演示完毕] =====

6.6 故障排除

1. 数码管无显示：

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

2. 按键无响应：

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

3. 亮度无法调节：

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

4. 显示内容错乱：

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

6.7 扩展功能建议

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