init: Air780EPM 官方 LuatOS 项目代码基线

- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
2026-08-31 08:53:49 +08:00
commit 173dd6874f
813 changed files with 125484 additions and 0 deletions
@@ -0,0 +1,73 @@
+--[[
+@module  main
+@summary TM1637 数码管驱动芯片测试 Demo 入口
+@version 1.0
+@date    2026.07.13
+@author  江访
+]]
+
+--[[
+=== 演示内容 ===
+
+本 demo 演示 exs_tm1637 扩展库的完整功能，顺序为：
+HELLO→[1/6]→[2/6]→[3/6]→[4/6]→[5/6]→[6/6]→End
+1、数码管字符串显示（[1/6]）
+2、按键轮询检测（[2/6]）
+3、亮度调节（[3/6]）
+4、按键回调（[4/6]）
+5、综合演示（[5/6]）
+6、日期/时钟/温度（[6/6]）
+
+]]
+
+
+--[[
+VERSION：项目版本号，ascii string类型
+        如果使用合宙iot.openluat.com进行远程升级，必须按照"XXX.YYY.ZZZ"三段格式定义：
+            X、Y、Z各表示1位数字，三个X表示的数字可以相同，也可以不同，同理三个Y和三个Z表示的数字也是可以相同，可以不同
+            因为历史原因，YYY这三位数字必须存在，但是没有任何用处，可以一直写为000
+        如果不使用合宙iot.openluat.com进行远程升级，根据自己项目的需求，自定义格式即可
+]]
+-- main.lua - 程序入口文件
+
+PROJECT = "TM1637_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)
+
+-- 加载 tm1637_demo.lua 演示模块
+require "tm1637_demo"
+
+
+-- 用户代码已结束
+-- 结尾总是这一句
+sys.run()
+-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
@@ -0,0 +1,240 @@
+# 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）
+
+## 三、显示效果
+
+![](https://docs.openluat.com/cdn/image/Air780EHM_tm1637.png)
+
+## 四、演示硬件环境
+
+### 3.1 硬件清单
+
+- Air780EPM 核心板 × 1
+- TM1637 数码管模块（6 位数码管 + 16 个按键） × 1
+  demo所演示的TM1637数码管[购买链接](https://item.taobao.com/item.htm?abbucket=12&id=1007027539110&mi_id=0000QVgQh2GhxEs_zMNZK6bhYAbQv0eR95YG6IfO11pxPlY&ns=1&priceTId=213e00d417839212452374999e1068&skuId=6005284956850&spm=a21n57.1.hoverItem.5&utparam=%7B%22aplus_abtest%22%3A%22d1bf89b9b16b6e795e9cbd76e360f1b3%22%7D&xxc=taobaoSearch)
+- 母对母杜邦线 × 4
+- TYPE-C 数据线 × 1
+
+### 3.2 接线配置
+
+#### 3.2.1 TM1637 模块接线
+
+<table>
+<tr>
+<td>Air780EPM 核心板<br/></td><td>TM1637 模块<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>VDD_EXT<br/></td><td>VCC<br/></td></tr>
+<tr>
+<td>GND<br/></td><td>GND<br/></td></tr>
+</table>
+
+> 说明：接线时注意杜邦线不宜过长，以免通信不稳定。
+
+## 五、演示软件环境
+
+### 4.1 开发工具
+
+- [Luatools下载调试工具](https://docs.openluat.com/air780epm/luatos/common/download/) - 固件烧录和代码调试
+
+### 4.2 内核固件
+
+- [点击下载Air780EPM系列最新版本内核固件](https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/)，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` 中加载对应的演示模块：
+
+```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 符号正常显示
+- **日志如下：**
+```lua
+[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 扩展库说明](https://docs.openluat.com/osapi/ext/sensor/exs_tm1637/)
@@ -0,0 +1,232 @@
+--[[
+@module  tm1637_demo
+@summary TM1637 驱动芯片演示模块，包含所有功能的演示用例
+@version 1.0
+@date    2026.07.13
+@author  江访
+@usage
+本文件包含 TM1637 的逐项功能演示和综合展示。
+通过 exs_tm1637 扩展库的 API 逐一演示数码管显示、按键检测等功能。
+]]
+
+-- 加载 exs_tm1637 扩展库
+local exs_tm1637 = require "exs_tm1637"
+
+-- 演示字符串显示
+local function demo_string()
+    log.info("tm1637_demo", "===== [1/6] 字符串显示 =====")
+
+    log.info("tm1637_demo", "显示 123456")
+    exs_tm1637.clear()
+    exs_tm1637.set_display("123456")
+    sys.wait(1500)
+
+    log.info("tm1637_demo", "显示 88.88")
+    exs_tm1637.clear()
+    exs_tm1637.set_display("88.88")
+    sys.wait(1500)
+
+    log.info("tm1637_demo", "显示 AbCd")
+    exs_tm1637.clear()
+    exs_tm1637.set_display("AbCd")
+    sys.wait(1500)
+
+    log.info("tm1637_demo", "从第 3 位开始显示 1234")
+    exs_tm1637.clear()
+    exs_tm1637.set_display("1234", 3)
+    sys.wait(1500)
+
+    exs_tm1637.clear()
+    sys.wait(500)
+end
+
+-- 演示按键轮询
+local function demo_keys()
+    log.info("tm1637_demo", "===== [2/6] 按键轮询 =====")
+    log.info("tm1637_demo", "按下任意按键测试，10 秒无操作后自动结束")
+
+    exs_tm1637.clear()
+    exs_tm1637.set_display("KEY---")
+
+    local timeout = 10000
+    local step = 100
+    local elapsed = 0
+
+    while elapsed < timeout do
+        local key = exs_tm1637.get_key()
+        if key then
+            log.info("tm1637_demo", "检测到按键, 编码:", key)
+            local key_str = string.format("K%02d", key)
+            exs_tm1637.set_display(key_str)
+            sys.wait(800)
+            exs_tm1637.clear()
+            exs_tm1637.set_display("KEY---")
+        else
+            sys.wait(step)
+            elapsed = elapsed + step
+        end
+    end
+
+    log.info("tm1637_demo", "按键检测结束")
+end
+
+-- 演示亮度调节
+local function demo_brightness()
+    log.info("tm1637_demo", "===== [3/6] 亮度调节 =====")
+
+    exs_tm1637.clear()
+    exs_tm1637.set_display("888888")
+    sys.wait(500)
+
+    for brightness = 0, 7 do
+        log.info("tm1637_demo", "设置亮度:", brightness)
+        exs_tm1637.set_brightness(brightness)
+        sys.wait(800)
+    end
+
+    exs_tm1637.set_brightness(4)
+    exs_tm1637.clear()
+    sys.wait(500)
+end
+
+-- 按键回调函数
+local function on_key(key_code)
+    log.info("tm1637_demo", "按键回调触发, 编码:", key_code)
+    local display = string.format("K%02d", key_code)
+    exs_tm1637.set_display(display)
+end
+
+-- 演示按键回调
+local function demo_key_callback()
+    log.info("tm1637_demo", "===== [4/6] 按键回调 =====")
+    log.info("tm1637_demo", "接下来 12 秒内按按键查看回调效果")
+
+    exs_tm1637.clear()
+    exs_tm1637.set_display("Cb-Key")
+    exs_tm1637.set_key_callback(on_key)
+
+    sys.wait(12000)
+
+    exs_tm1637.set_key_callback(nil)
+    log.info("tm1637_demo", "按键回调演示结束")
+end
+
+-- 综合演示
+local function demo_final_show()
+    log.info("tm1637_demo", "===== [5/6] 综合演示 =====")
+
+    for i = 5, 0, -1 do
+        exs_tm1637.clear()
+        exs_tm1637.set_display(string.format("%d", i))
+        sys.wait(500)
+    end
+
+    for i = 0, 3 do
+        exs_tm1637.clear()
+        exs_tm1637.set_display("-HELLO")
+        sys.wait(500)
+        exs_tm1637.clear()
+        sys.wait(300)
+    end
+
+    exs_tm1637.clear()
+    exs_tm1637.set_display("888888")
+
+    for i = 0, 7 do
+        exs_tm1637.set_brightness(i)
+        sys.wait(200)
+    end
+
+    sys.wait(1000)
+    exs_tm1637.clear()
+
+    log.info("tm1637_demo", "---- 综合演示结束 ----")
+end
+
+-- 展示日期：6 位数码管，格式 "260713"
+local function show_date()
+    log.info("tm1637_demo", "日期展示: 260713")
+    exs_tm1637.set_display("260713")
+    sys.wait(3000)
+    exs_tm1637.clear()
+end
+
+-- 展示时间：模拟走时 "083000" ~ "083009"
+local function show_clock()
+    exs_tm1637.clear()
+    sys.wait(200)
+    log.info("tm1637_demo", "时钟展示: 083000 ~ 083009")
+    for sec = 0, 9 do
+        exs_tm1637.set_display(string.format("0830%02d", sec))
+        sys.wait(500)
+    end
+end
+
+-- 展示温度：摄氏度用 "°C"，华氏度用 "°F"
+local function show_temperature()
+    exs_tm1637.clear()
+    sys.wait(200)
+    local DEGREE = "°"
+    for temp = 25, 32 do
+        local cel = string.format("%02d", temp) .. DEGREE .. "C"
+        exs_tm1637.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_tm1637.set_brightness(bright)
+        sys.wait(800)
+    end
+
+    for temp = 77, 90, 2 do
+        local fah = string.format("%02d", temp) .. DEGREE .. "F"
+        exs_tm1637.set_display(fah)
+        sys.wait(600)
+    end
+
+    exs_tm1637.set_brightness(5)
+    sys.wait(1000)
+    exs_tm1637.clear()
+end
+
+local function run_main()
+    log.info("tm1637_demo", "===== [6/6] 日期/时钟/温度 =====")
+
+    show_date()
+    sys.wait(300)
+    show_clock()
+    sys.wait(300)
+    show_temperature()
+end
+
+-- 演示主函数（运行在协程中）
+local function tm1637_demo_task_func()
+    -- 初始化
+    local result = exs_tm1637.setup({
+        clk    = 31,
+        dio    = 30,
+        bright = 5,
+    })
+    if not result then
+        log.error("tm1637_demo", "TM1637 初始化失败，请检查接线")
+        return
+    end
+
+    log.info("tm1637_demo", "TM1637 初始化成功，版本:", exs_tm1637.version())
+
+    -- HELLO 开始 → [1/6] → [2/6] → [3/6] → [4/6] → [5/6] → [6/6] → End
+    exs_tm1637.set_display("HELLO")
+    sys.wait(1000)
+
+    demo_string()
+    demo_keys()
+    demo_key_callback()
+    demo_brightness()
+    demo_final_show()
+    run_main()
+
+    exs_tm1637.set_display("End")
+    sys.wait(3000)
+    log.info("tm1637_demo", "===== [演示完毕] =====")
+end
+
+sys.taskInit(tm1637_demo_task_func)