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,152 @@
+--[[
+@module  lis2dh12_demo
+@summary LIS2DH12 三轴加速度传感器演示模块，包含所有功能的演示用例
+@version 2.0
+@date    2026.07.17
+@author  江访
+@usage
+本文件包含 LIS2DH12 的逐项功能演示。
+通过 exs_lis2dh12 扩展库的 API 逐一演示数据读取、量程切换、输出速率切换、温度读取、休眠唤醒等功能。
+]]
+
+local exs_lis2dh12 = require "exs_lis2dh12"
+
+local function lis2dh12_int1_cb(data)
+    if data.dir then
+        log.info("lis2dh12_demo", string.format("int1: 朝向=%s X=%.3f Y=%.3f Z=%.3f g", data.dir, data.x, data.y, data.z))
+    else
+        log.info("lis2dh12_demo", string.format("int1: X=%.3f Y=%.3f Z=%.3f g", data.x, data.y, data.z))
+    end
+end
+
+-- [1/5] 初始化与数据读取
+local function demo_init_and_read()
+    log.info("lis2dh12_demo", "===== [1/5] 初始化与数据读取 =====")
+    local result = exs_lis2dh12.setup("I2C", {
+        scl = 31,
+        sda = 30,
+        powermode = "highres",
+        enable_direction = "6d",
+        int1 = { int_gpio = 29, tap = true, direction = true, cb = lis2dh12_int1_cb },
+    })
+
+    if not result then
+        log.error("lis2dh12_demo", "LIS2DH12 初始化失败，请检查接线")
+        return false
+    end
+    log.info("lis2dh12_demo", "LIS2DH12 初始化成功，版本:", exs_lis2dh12.version())
+    exs_lis2dh12.dump_regs()
+
+    sys.wait(200)
+    local data = exs_lis2dh12.get_data()
+    if data then
+        log.info("lis2dh12_demo", string.format("X=%.3f Y=%.3f Z=%.3f g", data.x, data.y, data.z))
+    else
+        log.error("lis2dh12_demo", "读取数据失败")
+    end
+    sys.wait(1000)
+
+    for i = 1, 3 do
+        sys.wait(500)
+        local d = exs_lis2dh12.get_data()
+        if d then
+            log.info("lis2dh12_demo", string.format("第%d次读取: X=%.3f Y=%.3f Z=%.3f g", i, d.x, d.y, d.z))
+        end
+    end
+    log.info("lis2dh12_demo", "---- [1/5] 完成 ----")
+    return true
+end
+
+-- [2/5] 量程切换演示
+local function demo_range_switch()
+    log.info("lis2dh12_demo", "===== [2/5] 量程切换演示 =====")
+    log.info("lis2dh12_demo", "切换量程为 4g")
+    exs_lis2dh12.set_range("4g")
+    sys.wait(300)
+    local data = exs_lis2dh12.get_data()
+    if data then
+        log.info("lis2dh12_demo", string.format("4g 量程: X=%.3f Y=%.3f Z=%.3f g", data.x, data.y, data.z))
+    end
+    sys.wait(1000)
+
+    log.info("lis2dh12_demo", "切换量程为 2g（高精度）")
+    exs_lis2dh12.set_range("2g")
+    sys.wait(300)
+    data = exs_lis2dh12.get_data()
+    if data then
+        log.info("lis2dh12_demo", string.format("2g 量程: X=%.3f Y=%.3f Z=%.3f g", data.x, data.y, data.z))
+    end
+    sys.wait(1000)
+    log.info("lis2dh12_demo", "---- [2/5] 完成 ----")
+end
+
+-- [3/5] 输出速率切换
+local function demo_odr_switch()
+    log.info("lis2dh12_demo", "===== [3/5] 输出速率切换 =====")
+    local odr_list = { 25, 50, 100, 200 }
+    for _, odr in ipairs(odr_list) do
+        log.info("lis2dh12_demo", string.format("设置输出速率为 %dHz", odr))
+        exs_lis2dh12.set_odr(odr)
+        sys.wait(500)
+        local data = exs_lis2dh12.get_data()
+        if data then
+            log.info("lis2dh12_demo", string.format("%dHz 下: X=%.3f Y=%.3f Z=%.3f g", odr, data.x, data.y, data.z))
+        end
+        sys.wait(500)
+    end
+    exs_lis2dh12.set_odr(100)
+    log.info("lis2dh12_demo", "---- [3/5] 完成 ----")
+end
+
+-- [4/5] 温度读取演示
+local function demo_temp_read()
+    log.info("lis2dh12_demo", "===== [4/5] 温度读取演示 =====")
+    log.info("lis2dh12_demo", "使能温度传感器")
+    exs_lis2dh12.enable_temp(true)
+    sys.wait(200)
+    local temp = exs_lis2dh12.get_temp()
+    if temp then
+        log.info("lis2dh12_demo", string.format("芯片温度: %.1f °C", temp))
+    else
+        log.error("lis2dh12_demo", "读取温度失败")
+    end
+    exs_lis2dh12.enable_temp(false)
+    log.info("lis2dh12_demo", "---- [4/5] 完成 ----")
+end
+
+-- [5/5] 休眠与唤醒演示
+local function demo_sleep_wakeup()
+    log.info("lis2dh12_demo", "===== [5/5] 休眠与唤醒演示 =====")
+    log.info("lis2dh12_demo", "进入 power-down 模式（低功耗）")
+    exs_lis2dh12.sleep(); sys.wait(10000)
+    sys.wait(500)
+    log.info("lis2dh12_demo", "从 power-down 模式唤醒")
+    exs_lis2dh12.wakeup()
+    sys.wait(200)
+    local data = exs_lis2dh12.get_data()
+    if data then
+        log.info("lis2dh12_demo", string.format("唤醒后数据: X=%.3f Y=%.3f Z=%.3f g", data.x, data.y, data.z))
+    end
+    log.info("lis2dh12_demo", "---- [5/5] 完成 ----")
+end
+
+local function lis2dh12_demo_task_func()
+    log.info("lis2dh12_demo", "HELLO")
+    sys.wait(1000)
+    local ok = demo_init_and_read()
+    if not ok then return end
+    sys.wait(500)
+    demo_range_switch()
+    sys.wait(500)
+    demo_odr_switch()
+    sys.wait(500)
+    demo_temp_read()
+    sys.wait(500)
+    demo_sleep_wakeup()
+    sys.wait(500)
+    log.info("lis2dh12_demo", "===== [演示完毕] =====")
+    exs_lis2dh12.close()
+    log.info("lis2dh12_demo", "End")
+end
+
+sys.taskInit(lis2dh12_demo_task_func)
@@ -0,0 +1,70 @@
+--[[
+@module  main
+@summary LIS2DH12 三轴加速度传感器 Demo 入口
+@version 1.0
+@date    2026.07.16
+@author  江访
+]]
+
+--[[
+=== 演示内容 ===
+
+本 demo 演示 exs_lis2dh12 扩展库的完整功能，顺序为：
+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 = "LIS2DH12_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)
+
+-- 加载 lis2dh12_demo.lua 演示模块
+require "lis2dh12_demo"
+
+
+-- 用户代码已结束
+-- 结尾总是这一句
+sys.run()
+-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行
@@ -0,0 +1,243 @@
+# LIS2DH12 三轴加速度传感器演示
+
+## 一、功能模块介绍
+
+### 1.1 核心主程序模块
+
+1. **main.lua** - 主程序入口，负责项目初始化、版本定义和任务调度
+2. **lis2dh12_demo.lua** - LIS2DH12 功能演示模块，包含数据读取、量程切换、输出速率切换、温度读取等所有功能的演示用例
+
+### 1.2 扩展库模块
+
+1. **exs_lis2dh12** - LIS2DH12 扩展库，提供初始化、三轴加速度数据读取、量程切换、输出速率切换、功耗模式切换、温度读取、睡眠/唤醒、关闭等 API
+
+### 1.3 I2C 模式说明
+
+**推荐使用软件 I2C 模式**：LIS2DH12 在异常 I2C 通信后可能锁死 SDA 总线。本库已内置 I2C 总线卡死自动检测与恢复功能。本 demo 使用软件 I2C 模式演示。
+
+## 二、演示流程介绍
+
+本 demo 按顺序演示 exs_lis2dh12 扩展库的 5 项功能：HELLO → [1/5] → [2/5] → [3/5] → [4/5] → [5/5] → End
+
+### 2.1 功能演示项说明
+
+1. **[1/5] 初始化与数据读取** - 初始化 LIS2DH12 传感器并读取三轴加速度数据（X/Y/Z，单位 g），附带 data_ready 中断示例
+2. **[2/5] 量程切换演示** - 在 ±2g（高精度）和 ±4g（宽范围）量程之间切换，观察数据变化
+3. **[3/5] 输出速率切换** - 依次切换 25Hz / 50Hz / 100Hz / 200Hz 输出速率
+4. **[4/5] 温度读取演示** - 使能温度传感器并读取芯片温度
+5. **[5/5] 休眠与唤醒演示** - 演示 sleep()/wakeup() 待机与唤醒
+
+
+## 三、演示硬件环境
+
+### 3.1 硬件清单
+
+- Air780EPM 核心板 × 1
+- CJMCU-LIS2DH12 三轴加速度传感器模块 × 1
+  demo所演示的LIS2DH12 三轴加速度传感器模块[购买链接](https://item.taobao.com/item.htm?abbucket=12&id=558250923931&mi_id=0000CnnCsR0FV7f0P7irmdBj13iLAdQybnwMchjjsbtxS9Q&ns=1&priceTId=215045e417839190178541937e1198&skuId=4867682785456&spm=a21n57.1.hoverItem.2&utparam=%7B%22aplus_abtest%22%3A%2259cc019145c3f9fde211bc6c0f71f883%22%7D&xxc=taobaoSearch)
+- 母对母杜邦线 × 6
+- TYPE-C 数据线 × 1
+
+### 3.2 接线配置
+
+#### 3.2.1 I2C 模式接线
+
+<table>
+<tr>
+<td>Air780EPM 核心板<br/></td><td>CJMCU-LIS2DH12 模块<br/></td></tr>
+<tr>
+<td>32/GPIO31<br/></td><td>SCL<br/></td></tr>
+<tr>
+<td>31/GPIO30<br/></td><td>SDA<br/></td></tr>
+<tr>
+<td>30/GPIO29<br/></td><td>INT1<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>
+
+> 说明：接线时注意杜邦线不宜过长，以免通信不稳定。
+
+![](https://docs.openluat.com/cdn/image/Air780EHM_exs_lis2dh12.png)
+
+
+## 四、演示软件环境
+
+### 4.1 开发工具
+
+- [Luatools下载调试工具](https://docs.openluat.com/air780egh/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. **lis2dh12_demo.lua** - LIS2DH12 功能演示模块
+3. **exs_lis2dh12** - LIS2DH12 扩展库
+
+## 五、演示核心步骤
+
+### 5.1 硬件准备
+
+1. 按照接线表将 CJMCU-LIS2DH12 模块连接到核心板
+2. 确保电源连接正确，通过 TYPE-C USB 口供电
+3. 检查所有接线无误，避免短路
+
+### 5.2 软件配置
+
+在 `main.lua` 中加载对应的演示模块：
+
+```lua
+-- 加载 lis2dh12_demo.lua 演示模块
+require "lis2dh12_demo"
+```
+
+### 5.3 软件烧录
+
+1. 使用 Luatools 选择最新内核固件
+2. 下载本项目所有脚本文件
+3. 将固件和脚本一起烧录到设备
+4. 烧录成功后设备自动重启后开始运行
+
+### 5.4 功能测试
+
+#### 5.4.1 初始化与数据读取演示
+
+1. 设备启动后打印 "HELLO"，随后自动进入 [1/5] 初始化与数据读取
+2. 观察日志输出，确认初始化成功
+3. 观察三轴加速度数据（X/Y/Z，单位 g）的连续读取
+
+#### 5.4.2 量程切换演示
+
+1. 自动进入 [2/5] 量程切换演示
+2. 观察 ±4g 宽范围量程下的数据
+3. 观察 ±2g 高精度量程下的数据
+
+#### 5.4.3 输出速率切换演示
+
+1. 自动进入 [3/5] 输出速率切换演示
+2. 依次观察 25Hz / 50Hz / 100Hz / 200Hz 下的数据读取
+3. 最终恢复为 100Hz
+
+#### 5.4.4 温度读取演示
+
+1. 自动进入 [4/5] 温度读取演示
+2. 使能温度传感器并等待稳定
+3. 读取并显示芯片温度（单位 °C）
+
+#### 5.4.5 休眠与唤醒演示
+
+1. 自动进入 [5/5] 休眠与唤醒演示
+2. 观察 sleep() 进入待机模式
+3. 观察 wakeup() 唤醒后数据恢复
+
+### 5.5 预期效果
+
+- **初始化与数据读取**：LIS2DH12 初始化成功，三轴加速度数据正常输出
+- **量程切换**：量程切换后数据范围随之变化，灵敏度不同
+- **输出速率切换**：不同速率下均能正常读取数据
+- **温度读取**：正常读取芯片温度（约 20-40°C）
+- **休眠与唤醒**：sleep 后进入低功耗，wakeup 后数据读取正常
+- **日志如下：**
+```lua
+[2026-07-21 10:30:03.304][000000000.179] I/main LuatOS@Air780EPM base 26.04 bsp V2046 32bit
+[2026-07-21 10:30:03.305][000000000.179] I/main ROM Build: Jul  7 2026 20:39:17
+[2026-07-21 10:30:03.307][000000000.181] W/pins /luadb/pins_air780epm.json not exist!!
+[2026-07-21 10:30:03.310][000000000.183] D/main loadlibs luavm 1048568 14784 14784
+[2026-07-21 10:30:03.312][000000000.184] D/main loadlibs sys   2366664 82756 89356
+[2026-07-21 10:30:03.315][000000000.184] D/main loadlibs psram 2366664 82756 89356
+[2026-07-21 10:30:03.317][000000000.201] I/user.main LIS2DH12_Demo 001.999.000
+[2026-07-21 10:30:03.319][000000000.217] D/user.exs_lis2dh12 version -> 202607170900
+[2026-07-21 10:30:03.320][000000000.218] I/user.lis2dh12_demo HELLO
+[2026-07-21 10:30:03.512][000000001.218] I/user.lis2dh12_demo ===== [1/5] 初始化与数据读取 =====
+[2026-07-21 10:30:03.515][000000001.233] I/user.exs_lis2dh12 LIS2DH12 @ I2C 0x19
+[2026-07-21 10:30:03.517][000000001.243] I/user.exs_lis2dh12 REG读回 CTRL1=0x57 CTRL4=0x88 STATUS=0x0F INT1_CFG=0x00
+[2026-07-21 10:30:03.518][000000001.252] I/user.exs_lis2dh12 INT1 已注册, gpio=29
+[2026-07-21 10:30:03.520][000000001.252] I/user.exs_lis2dh12 初始化完成 mode=I2C range=2g odr=100Hz mode=highres
+[2026-07-21 10:30:03.533][000000001.253] I/user.lis2dh12_demo LIS2DH12 初始化成功，版本: 202607170900
+[2026-07-21 10:30:03.539][000000001.269] I/user.exs_lis2dh12 CTRL1=0x57 CTRL2=0x00 CTRL3=0xC0 CTRL4=0x88 CTRL5=0x0C CTRL6=0x00 STATUS=0xFF INT1_SRC=0x00 INT2_SRC=0x00 FIFO_SRC=0x20
+[2026-07-21 10:30:03.544][000000001.478] I/user.lis2dh12_demo X=-0.965 Y=-0.008 Z=-0.029 g
+[2026-07-21 10:30:04.086][000000002.295] I/mobile sim0 sms ready
+[2026-07-21 10:30:04.091][000000002.296] D/mobile cid1, state0
+[2026-07-21 10:30:04.096][000000002.296] D/mobile bearer act 0, result 0
+[2026-07-21 10:30:04.100][000000002.297] D/mobile NETIF_LINK_ON -> IP_READY
+[2026-07-21 10:30:04.104][000000002.353] D/mobile TIME_SYNC 0 tm 1784601007
+[2026-07-21 10:30:04.724][000000002.986] I/user.lis2dh12_demo 第1次读取: X=-0.368 Y=-0.170 Z=-0.713 g
+[2026-07-21 10:30:05.223][000000003.494] I/user.lis2dh12_demo 第2次读取: X=-0.083 Y=0.008 Z=-1.023 g
+[2026-07-21 10:30:05.732][000000004.004] I/user.lis2dh12_demo 第3次读取: X=-0.119 Y=0.108 Z=0.237 g
+[2026-07-21 10:30:05.735][000000004.004] I/user.lis2dh12_demo ---- [1/5] 完成 ----
+[2026-07-21 10:30:06.013][000000004.271] I/user.lis2dh12_demo int1: 朝向=front X=-0.670 Y=-0.097 Z=-0.194 g
+[2026-07-21 10:30:06.243][000000004.504] I/user.lis2dh12_demo ===== [2/5] 量程切换演示 =====
+[2026-07-21 10:30:06.247][000000004.505] I/user.lis2dh12_demo 切换量程为 4g
+[2026-07-21 10:30:06.252][000000004.508] I/user.exs_lis2dh12 量程切换为 4g
+[2026-07-21 10:30:06.555][000000004.816] I/user.lis2dh12_demo 4g 量程: X=0.102 Y=0.350 Z=-0.872 g
+[2026-07-21 10:30:07.549][000000005.816] I/user.lis2dh12_demo 切换量程为 2g（高精度）
+[2026-07-21 10:30:07.553][000000005.819] I/user.exs_lis2dh12 量程切换为 2g
+[2026-07-21 10:30:07.861][000000006.127] I/user.lis2dh12_demo 2g 量程: X=-0.063 Y=0.379 Z=0.801 g
+[2026-07-21 10:30:08.856][000000007.127] I/user.lis2dh12_demo ---- [2/5] 完成 ----
+[2026-07-21 10:30:09.369][000000007.627] I/user.lis2dh12_demo ===== [3/5] 输出速率切换 =====
+[2026-07-21 10:30:09.374][000000007.628] I/user.lis2dh12_demo 设置输出速率为 25Hz
+[2026-07-21 10:30:09.378][000000007.631] I/user.exs_lis2dh12 输出速率切换为 25Hz
+[2026-07-21 10:30:09.881][000000008.139] I/user.lis2dh12_demo 25Hz 下: X=0.033 Y=0.084 Z=0.999 g
+[2026-07-21 10:30:10.377][000000008.639] I/user.lis2dh12_demo 设置输出速率为 50Hz
+[2026-07-21 10:30:10.382][000000008.643] I/user.exs_lis2dh12 输出速率切换为 50Hz
+[2026-07-21 10:30:10.890][000000009.151] I/user.lis2dh12_demo 50Hz 下: X=0.145 Y=0.163 Z=0.982 g
+[2026-07-21 10:30:11.385][000000009.651] I/user.lis2dh12_demo 设置输出速率为 100Hz
+[2026-07-21 10:30:11.388][000000009.654] I/user.exs_lis2dh12 输出速率切换为 100Hz
+[2026-07-21 10:30:11.898][000000010.162] I/user.lis2dh12_demo 100Hz 下: X=0.754 Y=0.033 Z=0.060 g
+[2026-07-21 10:30:12.395][000000010.662] I/user.lis2dh12_demo 设置输出速率为 200Hz
+[2026-07-21 10:30:12.398][000000010.665] I/user.exs_lis2dh12 输出速率切换为 200Hz
+[2026-07-21 10:30:12.905][000000011.173] I/user.lis2dh12_demo 200Hz 下: X=-0.589 Y=-0.397 Z=0.942 g
+[2026-07-21 10:30:13.215][000000011.481] I/user.lis2dh12_demo int1: 朝向=down X=-0.341 Y=-0.250 Z=0.819 g
+[2026-07-21 10:30:13.419][000000011.676] I/user.exs_lis2dh12 输出速率切换为 100Hz
+[2026-07-21 10:30:13.423][000000011.676] I/user.lis2dh12_demo ---- [3/5] 完成 ----
+[2026-07-21 10:30:13.915][000000012.176] I/user.lis2dh12_demo ===== [4/5] 温度读取演示 =====
+[2026-07-21 10:30:13.919][000000012.177] I/user.lis2dh12_demo 使能温度传感器
+[2026-07-21 10:30:13.923][000000012.178] I/user.exs_lis2dh12 温度传感器 已使能
+[2026-07-21 10:30:14.087][000000012.353] I/user.lis2dh12_demo int1: 朝向=front X=-0.906 Y=0.708 Z=-0.263 g
+[2026-07-21 10:30:14.118][000000012.381] I/user.lis2dh12_demo 芯片温度: 39.0 °C
+[2026-07-21 10:30:14.122][000000012.382] I/user.exs_lis2dh12 温度传感器 已禁用
+[2026-07-21 10:30:14.125][000000012.382] I/user.lis2dh12_demo ---- [4/5] 完成 ----
+[2026-07-21 10:30:14.616][000000012.883] I/user.lis2dh12_demo ===== [5/5] 休眠与唤醒演示 =====
+[2026-07-21 10:30:14.619][000000012.884] I/user.lis2dh12_demo 进入 power-down 模式（低功耗）
+[2026-07-21 10:30:14.623][000000012.886] I/user.exs_lis2dh12 已进入 power-down 模式
+[2026-07-21 10:30:25.117][000000023.386] I/user.lis2dh12_demo 从 power-down 模式唤醒
+[2026-07-21 10:30:25.120][000000023.389] I/user.exs_lis2dh12 已从 power-down 模式唤醒，ODR=100Hz
+[2026-07-21 10:30:25.336][000000023.597] I/user.lis2dh12_demo 唤醒后数据: X=-0.933 Y=0.196 Z=-0.178 g
+[2026-07-21 10:30:25.340][000000023.597] I/user.lis2dh12_demo ---- [5/5] 完成 ----
+[2026-07-21 10:30:25.833][000000024.098] I/user.lis2dh12_demo ===== [演示完毕] =====
+[2026-07-21 10:30:25.837][000000024.104] I/user.exs_lis2dh12 传感器已关闭
+[2026-07-21 10:30:25.842][000000024.104] I/user.lis2dh12_demo End
+```
+
+### 5.6 故障排除
+
+1. **传感器初始化失败**：
+
+   - 检查 LIS2DH12 接线是否正确（SCL、SDA、VCC、GND）
+   - 确认 GPIO 引脚配置与接线一致
+   - 检查电源电压是否稳定（3.3V）
+   - 确认 exs_lis2dh12 扩展库已正常加载
+
+2. **读取数据始终为零**：
+
+   - 检查传感器供电是否正常
+   - 检查 I2C 地址是否正确（SA0=GND 时地址 0x18，SA0=VCC 时地址 0x19）
+   - 确认接线无松动
+
+3. **量程切换无效果**：
+
+   - 确认 `set_range()` 参数为 "2g"、"4g"、"8g" 或 "16g"
+   - 切换后需等待传感器稳定再读取数据
+
+4. **温度读取失败**：
+
+   - 确认已在 setup 时设置 `enable_temp = true` 或调用 `enable_temp(true)`
+   - 使能后需等待约 200ms 让 ADC 稳定
+
+### 5.7 扩展功能建议
+
+exs_lis2dh12 更多接口的使用可以查看 [exs_lis2dh12 扩展库说明](https://docs.openluat.com/osapi/ext/sensor/exs_lis2dh12/)