工程:basic_task_02_lis3dh
平台:NUCLEO-H533RE / Zephyr RTOS
1. 任务目标与实际完成范围
基础任务二要求采集加速度计数据,并通过串口打印。本工程在任务一的 LED、按键及日志服务基础上,增加独立的 LIS3DHTR 采集服务,验证传感器连接、三轴方向和加速度量纲,为电机数据采集提供基础。
| 连接方式 | Grove LIS3DHTR,I2C1,地址 0x19 |
| 参数配置 | ±2 g、12 位高分辨率、BDU、内部 ODR 100 Hz |
| 应用读取 | 约每 100 ms 获取一次最新 XYZ,非连续保存所有硬件样本 |
| 数据输出 | USART2,921600、8N1、无流控,整数 mg |
| 故障处理 | 无新数据跳过、读取错误限频、连续错误退避 |
| 保留功能 | LED 三档闪烁和 B1 长短按操作 |
2. 硬件资源与接线
2.1 器件与管脚对应
| LIS3DHTR SCL | PB6 / I2C1_SCL | D15 / CN5-10 | i2c1,i2c1_scl_pb6 | I²C 时钟,主控侧 3.3 V |
| LIS3DHTR SDA | PB7 / I2C1_SDA | D14 / CN5-9 | i2c1,i2c1_sda_pb7 | 双向数据,主控侧 3.3 V |
| LIS3DHTR VCC | 3V3 | CN6-4 | 无 GPIO 对应 | 模块供电 |
| LIS3DHTR GND | GND | CN6-6 或 CN6-7 | 无 GPIO 对应 | 共地 |
| LIS3DHTR INT1/INT2 | 未分配 | 不接 | 本阶段无中断采集 | 四线轮询方案 |
| LD2 | PA5 | 板载 | led0 / LED 服务 | 保留任务一功能 |
| B1 | PC13 | 板载 | sw0 / 按键服务 | 保留任务一功能 |
| 串口 TX/RX | PA2 / PA3 | ST-LINK VCP | usart2 / UART Logging | PC 接收日志 |
| 下载调试 | PA13 / PA14 | 板载 ST-LINK | SWD | 保留 |
采用 D14/D15 接口,无需调整 A4/A5 焊桥。Grove 转接线按信号与丝印确认,不能仅按颜色判断。CS/SDO 沿用模块默认接法;只有确认地址选择脚状态后才将 0x19 改为 0x18。
2.2 原理图与连接示意
资料入口沿用仓库硬件说明,具体以实物版本为准:

主控侧总线空闲电平应接近 3.3 V。当前采用模块已有电路和短线连接,不盲目增加并联上拉;若通信异常,检查供电、地、地址及总线波形。
2.3 实物图占位
图 2-1:Grove 加速度计与开发板四线连接
由于加速度计是倒扣在电机上,所以 Z 轴数据是负值。
图 2-2:三轴串口打印
3. 开发环境与工程组织
目标板为 nucleo_h533re/stm32h533xx,使用 Zephyr Sensor API 和 lis2dh 兼容驱动。应用设备树的兼容字符串为 st,lis2dh,不能因芯片名为 LIS3DH 就自行改成不存在的绑定。
| src/main.c | 显式启动 LED、按键、加速度服务 |
| src/accel_service.c | 配置、读取、mg 换算及错误处理 |
| include/accel_service.h | 采集服务启动接口 |
| src/led_service.c、src/button_service.c | 原有基础交互 |
| boards/nucleo_h533re.overlay | I²C 引脚、时钟、器件地址及 UART 参数 |
| prj.conf | Sensor、LIS2DH、运行时配置、高分辨率和延迟日志 |
| CMakeLists.txt | 编译三个服务及主程序 |
4. 实现思路
4.1 独立线程配置与读取
采集线程采用静态 2048 字节栈、抢占优先级 9,仅由该线程访问 Sensor API。accel_service_start() 检查设备是否就绪并防止重复启动。返回 0 只代表线程创建成功;出现 ready 日志才说明量程和 ODR 配置完成。
配置过程先设置 ±2 g,再设置 100 Hz ODR,等待 100 ms 后开始读取。每轮先调用 sensor_sample_fetch(),成功后再通过 sensor_channel_get() 获取 XYZ。读取失败时不打印旧值。
4.2 单位换算与采样边界
Sensor API 输出单位为 m/s²。先把整数和微单位部分合并为有符号 64 位数,再按标准重力加速度换算为 mg,避免负小数处理错误和中间乘法溢出。
100 Hz 是芯片内部更新频率,100 ms 是应用读取周期,正常情况下每秒约输出十组三轴。中间硬件样本未保留;日志中的 read_ms 是主机读取时间,不是每个硬件样本的采样时刻。
4.3 故障处理
-ENODATA 单独统计并跳过;其他错误最多每秒报告一次。连续通信失败达到 5 次后,循环改为 1 秒退避,成功读取后清除连续错误计数。配置失败则退出采集线程,修复后需要复位;LED 和按键仍可独立工作。
5. 工作流程图

6. 关键代码
6.1 设备树配置总线和器件
来源:boards/nucleo_h533re.overlay,核心属性摘录。
clocks = <&rcc STM32_CLOCK(APB1, 21)>, <&rcc STM32_SRC_HSI I2C1_SEL(2)>; pinctrl-0 = <&i2c1_scl_pb6 &i2c1_sda_pb7>; clock-frequency = <I2C_BITRATE_STANDARD>;
lis3dh: accelerometer@19 {
compatible = "st,lis2dh";
reg = <0x19>;
status = "okay";
};I²C 门控仍由 APB1 控制,时序计算使用 HSI 64 MHz。总线目标速率为 100 kHz,与传感器 ODR 100 Hz 是不同参数。
6.2 带符号的 mg 换算
来源:src/accel_service.c 的 accel_to_mg()。
int64_t micro_ms2 = (int64_t)value->val1 * 1000000 + value->val2; return (int32_t)(micro_ms2 * 1000 / 9806650);
换算向零截断到整数 mg。静止时包含重力分量,三轴不应全部为零。
6.3 读取与退避
来源:accel_worker(),分别摘录读取入口和循环等待。
int ret = sensor_sample_fetch(accel_dev);
仅在 fetch 成功后调用:
ret = sensor_channel_get(accel_dev, SENSOR_CHAN_ACCEL_XYZ, xyz);
k_msleep(stats.consecutive_errors >= ACCEL_ERROR_THRESHOLD ? ACCEL_BACKOFF_MS : ACCEL_READ_PERIOD_MS);
这种处理避免异常时忙循环,也避免把 fetch 失败前的旧 XYZ 当作新样本输出。
7. Debug 问题与修复
7.1 I²C 无法找到 prescaler
现象: 启动出现 I2C:failed to find prescaler value,控制器初始化失败,尚未开始器件地址通信。
原因: 仓库调试记录指出,本机驱动简化时序算法在默认 PCLK1 240 MHz 下无法找到可表示的标准模式延时参数。
修改: 在 overlay 中保留 APB1 门控,显式选择 HSI 64 MHz 内核时钟。
已有验证: 2026-10-30 编译链接与生成设备树检查通过;按本机驱动整数算法,64 MHz 可得到 prescaler=5。该条记录本身未烧录。后续专项文档记录了静态数据正常,但不能据此补写本次总线波形或 SCL 实测值。
7.2 Windows 构建路径过长
现象: 深层构建目录使 STM32 HAL 对象路径达到约 260 字符,出现 CMake 路径警告,归档阶段报 No such file or directory。
修改: 将构建目录缩短为 basic_task_02_lis3dh/build_h533re,同步 IDE 配置并执行干净构建。
已有验证: 2026-11-10 全量构建 182/182 通过,原路径警告消失,HAL 归档及链接成功。记录环境为 Zephyr 4.4.99、SDK 1.0.1、GNU 14.3.0,Flash 49,476 字节、RAM 14,120 字节;该次仅验证构建。
7.3 统计日志在 INFO 级别不可见
当前源码每 10 秒调用 LOG_DBG 输出累计统计,默认 INFO 配置下不可见。这是当前实现的诊断限制,不应写成默认已显示统计。需要查看时,应调整相应日志级别或通过调试器检查;报告不将打印行数等同于硬件有效样本数。
7.4 资料状态不一致的处理
工程 README 的早期章节仍写“未上板”,而 docs/basic_task_02_lis3dh.md 已记录用户提供的静止读数。报告按证据粒度描述:有历史静态读数依据,有独立构建记录,完整六面、长时间和故障恢复验收仍待补齐。
8. 构建、运行与最终效果
8.1 复现命令
在已激活 Zephyr 环境的终端、仓库根目录执行:
west build -p always -b nucleo_h533re/stm32h533xx -d basic_task_02_lis3dh/build_h533re basic_task_02_lis3dh -- "-DDTC_OVERLAY_FILE=boards/nucleo_h533re.overlay" "-DCONFIG_SPEED_OPTIMIZATIONS=y" west flash -d basic_task_02_lis3dh/build_h533re -r pyocd --no-rebuild
连接实际 ST-LINK 虚拟串口,使用 921600、8N1、无流控,复位后观察 ready 和 XYZ 日志。检查生成的 zephyr.dts 与 .config,确认实际引脚、地址、模式及波特率。
8.2 已有观测与效果
专项文档记录的静止数据约为 (144, -950, -292) mg,合加速度约 1.004 g,支持 I²C 通信、单位换算和静态重力读数基本正常。记录的日志间隔约 101 ms,即主机约 9.9 Hz 读取最新值,不能证明连续采样完整性。
以下为当前源码对应的预期日志示意,非本次实测:
accel ready: addr=0x19, bus=100000Hz, odr=100Hz, range=2g, mode=HR accel seq=1 read_ms=1234 x_mg=144 y_mg=-950 z_mg=-292
| 构建链接 | 2026-11-10 短目录全量构建成功 | 对应构建截图与版本存档 |
| 静态重力 | 专项文档保留用户读数 | 原始串口截图、安装姿态 |
| XYZ 方向 | 软件支持三轴输出 | 六面静置与方向变化记录 |
| 长时间稳定性 | 已有错误统计与退避机制 | 至少 10 分钟运行、错误数和栈余量 |
| 联合交互 | LED/按键服务保留 | 采集时按键切频与长按操作记录 |
| 错误诊断 | 源码有错误分支 | 错地址、断线和恢复测试 |
当前实现完成基础三轴读取及日志输出,为任务三的连续振动数据采集提供了接线、量纲和时钟配置基础。


我要赚赏金
