简介面向STM32开发者的一套LIS2DH12三轴加速度计驱动源码基于IIC通信实现传感器初始化、寄存器配置、加速度数据读取与中断检测适用于物联网终端、可穿戴设备等低功耗场景也可为LIS3DH12或BMA250等同类传感器的驱动移植提供参考。压缩包共8个文件包含4个C源文件与4个头文件代码体积约6KB结构精炼。目前已有4554人学习下载适合具备STM32基础、需要快速集成加速度传感器的开发者参考。源码中已实现IIC底层读写函数、LIS2DH12寄存器配置模块、原始数据到重力加速度单位的换算以及基于EXTI的外部中断驱动便于捕获跌落或运动事件后及时响应。整套代码可直接嵌入现有STM32工程也可作为课程设计或产品原型的驱动模板。1. 自己写 LIS2DH12 的 STM32 IIC 驱动比直接抄例程到底值在哪很多开发者第一次接触 LIS2DH12 加速度传感器习惯去网上找一份现成的驱动源码改个引脚就上线。结果往往卡在同一个地方IIC 从机地址对不上、数据读出来全是 0、或者寄存器配置看起来没问题但数值永远不变。LIS2DH12 这颗传感器本身不复杂它和 STM32 之间走 IIC 只有两根线但要真正把它跑稳绕不开寄存器时序、地址判定、量程换算和 FIFO 中断这几个点。这篇笔记就从我实际调试这套驱动的过程出发把 IIC 配置、寄存器初始化、数据读取、FIFO 和中断、以及常见的翻车点一次说清楚。新手可以照着代码把工程跑通熟手可以直接看参数边界和踩坑记录。2. IIC 接线和从机地址为什么第一行代码是先读 WHO_AM_I2.1 SA0 引脚怎么决定 0x18 还是 0x19LIS2DH12 的 IIC 从机地址不是固定写死的它由 SA0 引脚的电平决定。SA0 接地时7 位地址是 0x18对应的 8 位写地址是 0x30读地址是 0x31。SA0 接高电平时7 位地址是 0x19写地址是 0x32读地址是 0x33。这一点经常被忽略因为很多例程默认 SA0 接 VCC写地址直接用 0x32如果你的板子恰好把 SA0 接地所有通信都会失败。我一般会把这几个地址定义成宏方便切换避免在代码里到处改数字。#define LIS2DH12_SA0_HIGH 1 #if LIS2DH12_SA0_HIGH #define LIS2DH12_ADDR_W 0x32 #define LIS2DH12_ADDR_R 0x33 #else #define LIS2DH12_ADDR_W 0x30 #define LIS2DH12_ADDR_R 0x31 #endif注意 STM32 的 HAL 库 I2C 接口里DevAddress参数要求传 8 位地址也就是把 7 位地址左移一位再拼上读写位。上面定义的 0x32 和 0x33 就是给 HAL 用的 8 位地址不要在 HAL 层再左移一次否则地址会变成 0x64总线上的从机根本不响应。这块是很多新手在 HAL 库里翻车的重灾区HAL 的HAL_I2C_Mem_Read和HAL_I2C_Mem_Write都已经帮你做了地址拼接传 8 位完整地址即可。2.2 STM32 的 IIC 引脚配置开漏、上拉和时钟速率LIS2DH12 的 IIC 接口是标准的开漏结构SCL 和 SDA 必须配上拉电阻才能正常工作。STM32 的 GPIO 在作为 I2C 引脚时要配置成开漏输出模式同时外部接 4.7kΩ 左右的上拉电阻到 VCC。有些开发板内部已经带了上拉但很多自制板子容易漏掉这一步导致通信时好时坏。GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin GPIO_PIN_6 | GPIO_PIN_7; gpio.Mode GPIO_MODE_AF_OD; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_HIGH; gpio.Alternate GPIO_AF4_I2C1; HAL_GPIO_Init(GPIOB, gpio);这里我用的是 I2C1 的 PB6 和 PB7复用功能 AF4。GPIO_MODE_AF_OD是开漏复用模式GPIO_NOPULL表示不启用内部上拉靠外部电阻。如果你的板子已经焊了上拉内部上拉开不开影响不大但没焊外部上拉的时候内部上拉也能勉强让通信跑起来只是稳定性没有保障。IIC 时钟速率方面LIS2DH12 支持标准模式 100kHz 和快速模式 400kHz我一般直接配 400kHz在hi2c1.Init.ClockSpeed 400000里设置。400kHz 下读取 6 字节加速度数据只需要几个毫秒的 IIC 操作时间完全够用。2.3 用 WHO_AM_I 确认通信链路返回 0x33 才算过IIC 通信有没有通不需要急着配置寄存器。LIS2DH12 的 WHO_AM_I 寄存器地址是 0x0F固定值 0x33上电后任何时候都能读。先把这一行跑通后续的寄存器配置才有意义。uint8_t lis2dh12_read_who_am_i(void) { uint8_t id 0; HAL_StatusTypeDef ret; ret HAL_I2C_Mem_Read(hi2c1, LIS2DH12_ADDR_R, 0x0F, I2C_MEMADD_SIZE_8BIT, id, 1, 100); if (ret ! HAL_OK) { return 0; } return id; }调用后如果返回 0x33说明从机地址、引脚配置、上拉电阻都对了。如果返回 0xFF大概率是地址错了或者 SA0 电平不对。如果返回 0x00可能是 SDA 线没接通或者传感器没上电。如果 HAL 函数直接超时返回 HAL_ERROR优先查 SCL 和 SDA 是不是接反了或者 GPIO 复用配置有没有生效。这一步是整套驱动的定心丸做完再往下走心里有底。3. 寄存器配置和加速度读取把 0x33 变成能用的 g 值3.1 初始化寄存器的顺序和关键位LIS2DH12 的寄存器配置看似简单但顺序有讲究。我的初始化顺序是先配 CTRL_REG4量程和 BDU再配 CTRL_REG1ODR 和轴使能然后根据需求配 CTRL_REG2、CTRL_REG3、CTRL_REG5 和 CTRL_REG6。先配 CTRL_REG4 的目的是让传感器在还没开始输出数据之前就把量程和字节更新模式定好避免中途切换量程导致数据跳变。uint8_t lis2dh12_init(void) { uint8_t id lis2dh12_read_who_am_i(); if (id ! 0x33) { return 0; } uint8_t buf; // CTRL_REG4: BDU1, FS00(±2g), HR0(正常模式) buf 0x80; lis2dh12_write_reg(0x23, buf); // CTRL_REG1: ODR100Hz, Zen/Yen/Xen1 buf 0x57; lis2dh12_write_reg(0x20, buf); // CTRL_REG2: 关闭高通滤波, 使用默认值 buf 0x00; lis2dh12_write_reg(0x21, buf); return 1; }CTRL_REG4 这个寄存器最重要的两个位是 BDU 和 FS。BDU 置 1 表示 Block Data Update也就是当读取数据时输出寄存器不会在读取过程中被更新防止读到高低字节来自不同采样时刻的拼接数据。FS[1:0] 是量程选择00 对应 ±2g01 是 ±4g10 是 ±8g11 是 ±16g。CTRL_REG1 的 bit7~bit4 是 ODR 输出速率0101 表示 100Hz这个值适合大多数姿态检测场景。bit3 的 LPen 是低功耗模式使能bit2~bit0 分别是 Z 轴、Y 轴、X 轴使能0x57 是 100Hz 加三轴全开。3.2 连续读 6 字节与灵敏度换算LIS2DH12 的输出寄存器从 OUT_X_L 地址 0x28 开始连续 6 个字节分别是 X、Y、Z 三个轴的低字节和高字节。IIC 读取时可以利用寄存器地址自动递增的特性一次读 6 个字节效率比单字节读 6 次高得多。int16_t lis2dh12_read_acc_raw(int16_t *x, int16_t *y, int16_t *z) { uint8_t buf[6]; HAL_StatusTypeDef ret; ret HAL_I2C_Mem_Read(hi2c1, LIS2DH12_ADDR_R, 0x28, I2C_MEMADD_SIZE_8BIT, buf, 6, 100); if (ret ! HAL_OK) { return -1; } *x (int16_t)((buf[1] 8) | buf[0]); *y (int16_t)((buf[3] 8) | buf[2]); *z (int16_t)((buf[5] 8) | buf[4]); return 0; }读取时有一点要特别注意LIS2DH12 的 12 位数据是左对齐存放在 16 位寄存器里的也就是高 12 位有效低 4 位补 0。换算成物理值时有两种做法。一种是把读到的 16 位数右移 4 位得到 12 位有效值再乘以对应量程的灵敏度系数。±2g 量程下 12 位模式每 LSB 是 1mg也就是 0.001g。另一种做法是不右移直接用 16 位数乘以 0.061mg/LSB因为 12 位数据左对齐后相当于 16 位尺度下的灵敏度变成了 16mg/65536约等于 0.061mg/LSB。两种方法结果一致但混用就会差 16 倍这是驱动里最容易出现的奇怪数据来源。float lis2dh12_read_acc_g(int16_t *x_g, int16_t *y_g, int16_t *z_g) { int16_t x, y, z; if (lis2dh12_read_acc_raw(x, y, z) 0) { return -1; } *x_g (float)(x 4) * 0.001f; // ±2g, 12位模式, 1 LSB 1mg *y_g (float)(y 4) * 0.001f; *z_g (float)(z 4) * 0.001f; return 0; }因为在读数据之前已经把 CTRL_REG4 的 BDU 置 1所以这里不用担心读到一半数据被更新。如果你用的是低功耗模式或者 8 位数据模式换算公式会不一样但在这个初始化配置下右移 4 位乘 0.001 是最稳妥的写法。3.3 量程、ODR 和数据精度的参数选择量程和 ODR 是 LIS2DH12 驱动里最核心的两个参数它们直接决定数据分辨率、功耗和响应速度。我把常用配置整理成了一张表方便在做不同项目时直接查阅参数配置值说明量程 FS00±2g适合倾角、姿态检测分辨率最高量程 FS01±4g适合手持设备运动检测量程 FS10±8g适合剧烈运动、冲击检测量程 FS11±16g适合碰撞、跌落记录ODR00011Hz超低功耗适合静态倾角监控ODR0101100Hz平衡功耗和实时性最常用ODR1000400Hz高动态场景适合振动分析ODR10011kHz高速场景注意 IIC 读取时序选量程时不要盲目选大的。±2g 量程下 1 LSB 对应 1mg能分辨很细微的倾斜变化±16g 下 1 LSB 对应 12mg同样一个微小的倾角变化读出来的数值可能只在几个 LSB 之间跳动。很多做倾角测量的开发者把量程设在 ±16g然后发现数据噪声很大其实不是因为传感器差而是量程选大了。ODR 和 IIC 读取频率之间也有关系。如果 ODR 设为 1kHz而你的 IIC 读取速度跟不上FIFO 又没有启用数据就会丢。这种情况下要么开 FIFO 缓存要么把 ODR 降到 400Hz 以下。LIS2DH12 的 IIC 快速模式最高 400kHz读 6 字节大概耗时 100 多微秒只要不是每次读之前都做一堆无关计算跟 1kHz 的 ODR 是能匹配上的但主循环里如果有其他耗时操作就一定要开 FIFO。4. FIFO、中断和低功耗驱动从“能读”到“好用”4.1 FIFO 模式选择和触发水位当主控需要处理其他任务没法保证每次采样都及时读取时LIS2DH12 的 32 级 FIFO 就能派上用场。FIFO_CTRL_REG 地址是 0x2Ebit7~bit6 是 FIFO 模式选择bit5~bit0 是触发阈值 FTH。FIFO 模式有旁路、FIFO、流式和触发式几种最常用的是 FIFO 模式和流模式。FIFO 模式是数据存满后再输出流模式是存满后覆盖旧数据按生产环境的需求选。void lis2dh12_fifo_config(uint8_t mode, uint8_t threshold) { uint8_t buf; // CTRL_REG5 bit7: FIFO_EN, 必须置1 buf lis2dh12_read_reg(0x24); buf | 0x80; lis2dh12_write_reg(0x24, buf); // FIFO_CTRL_REG: mode 01FIFO, 10Stream, threshold 为水位值 buf (mode 6) | (threshold 0x1F); lis2dh12_write_reg(0x2E, buf); }这里的 threshold 是 FIFO 水位线比如设为 16意思是 FIFO 里存了 16 个样本时触发中断。FIFO_SRC_REG 地址 0x2F 的 bit5 WTM 是水位标志bit6 是溢出标志bit4~bit0 是当前 FIFO 里有多少个样本。读取时先判断 WTM 或溢出标志再批量读数据可以有效避免数据错位。4.2 中断引脚映射与唤醒配置LIS2DH12 有两个中断引脚 INT1 和 INT2可以通过寄存器把不同事件映射到不同引脚。这里的关键是记住 CTRL_REG3 控制 INT1 的映射CTRL_REG6 控制 INT2 的映射。比如要把 FIFO 水位中断映射到 INT1就在 CTRL_REG3 里把 I1_WTM 位置 1同时把 FIFO 模式配好外部 MCU 的 EXTI 配置对应引脚为上升沿触发。// 把 FIFO 水位中断映射到 INT1 void lis2dh12_int1_fifo_wtm_enable(void) { uint8_t buf; // CTRL_REG3: I1_WTM 1 buf lis2dh12_read_reg(0x22); buf | 0x40; lis2dh12_write_reg(0x22, buf); }除了 FIFO 中断运动检测中断也很常用。INT1_CFG 地址 0x30 配置使能哪些轴的阈值检测INT1_THS 地址 0x32 是阈值INT1_DURATION 地址 0x33 是持续时间。比如要检测设备是否被拿起可以配置三轴任意一轴超过 500mg 持续 100ms 触发中断。阈值寄存器在 ±2g 量程下每 LSB 对应 16mg500mg 就是约 31写 0x1F。4.3 低功耗模式参数怎么配LIS2DH12 的低功耗设计在电池供电产品里很关键它有几个功耗档位可以用。最简单的办法是把 ODR 设为 1HzCTRL_REG1 的 LPen 置 1此时传感器工作在低功耗模式电流消耗能降到很低。其次是掉电模式把 ODR 设为 0000传感器停止输出但 IIC 接口仍然可以访问寄存器可以用来在待机时保留配置。void lis2dh12_low_power_enable(void) { uint8_t buf; // CTRL_REG1: ODR1Hz(0001), LPen1, 三轴使能 buf 0x1F; lis2dh12_write_reg(0x20, buf); // CTRL_REG4: HR0 低功耗模式不能和高分辨率同时使用 buf lis2dh12_read_reg(0x23); buf ~0x08; lis2dh12_write_reg(0x23, buf); }低功耗模式下要注意HR 高分辨率位必须清零因为低功耗模式和 12 位高分辨率模式不能同时开启。如果你想在低功耗下保持较高精度可以试着折中比如 ODR 50Hz 加 LPen精度会下降到 8 位但对大多数运动检测场景已经够用。真正需要高精度的时候我一般直接拉回正常模式加 400Hz宁可多耗点电。5. LIS2DH12 驱动排查避坑5 个真实调试记录5.1 WHO_AM_I 读回全 0xFF 或 0x00现象调用读 WHO_AM_I 的函数返回 0xFF 或者 0x00有时候 HAL 直接超时。原因0xFF 通常是 SDA 拉不低说明从机没有响应或者地址不对。0x00 是 SDA 被拉低但没有有效数据可能是线序接反。我遇到过最隐蔽的一次是 SA0 引脚悬空导致芯片内部上拉把地址判定成了 0x19而代码里写的是 0x18。解决先把 SA0 明确接 GND 或 VCC不要悬空。然后在代码里把 LIS2DH12_ADDR_W 和 LIS2DH12_ADDR_R 都打印出来核对。最后用示波器看 SCL 和 SDA 波形确认主控有没有发出 START 信号这是判断引脚复用配置是否生效的最直接方法。5.2 数据读出来永远不变现象WHO_AM_I 正常返回 0x33但读加速度数据时三个轴的数值固定不变或者只有某一位在跳。原因最常见的是 CTRL_REG1 的轴使能位没置 1或者 ODR 配成了 0000 掉电模式。还有一种可能是传感器进入了自检模式CTRL_REG4 的 ST 位没有清零这种情况下输出数据会套上一个固定的偏移量。解决初始化时先把 CTRL_REG1 设为 0x57确认读到 STATUS_REG 的 ZYXDA 数据就绪位为 1。如果数据还不更新读一下 CTRL_REG4 确认 ST 位是 00。自检模式只在产线测试时用正常驱动里必须保持为 0。5.3 FIFO 读出的数据错位现象开了 FIFO 之后读出来的三轴数据偶尔出现 X 轴数值突然变得很大Y 轴和 Z 轴像串了一样。原因FIFO 模式下数据是连续写入的如果没有先读 FIFO_SRC_REG 确认水位直接在 WTM 中断处理里一次读 6 字节容易和上一次未读完的数据混在一起。另一个常见坑是 CTRL_REG5 的 FIFO_EN 没置 1导致 FIFO_CTRL_REG 的配置根本没生效。解决读数据前先读 0x2F判断 FSS 位数按实际样本数读取。批量读取时每次读 6 字节读取间隔不要在中断里插入耗时操作。FIFO_EN 这个位很多人会漏建议在 4.1 的配置函数里强制置位别把它留在应用层配置。5.4 硬件 IIC 总线挂死现象程序跑一段时间后IIC 通信突然失败SCL 正常但 SDA 一直被拉低重启后才恢复。原因硬件 IIC 外设在从机响应异常时可能进入总线忙状态。常见诱因是拔线、强干扰或者从机复位时序不完整。STM32 的硬件 IIC 在总线 BUSY 状态下不会自动恢复需要软件干预。解决在每次 IIC 通信超时后尝试复位 IIC 外设。我常用的办法是先把 I2C 外设 DeInit重新 Init再把 SCL 引脚手动翻转 9 个时钟脉冲让总线上的从机释放 SDA。这个方法虽然不是官方标准流程但在实际项目里救了我很多次。模拟 IIC 在总线异常时反而更好排查因为它完全由 GPIO 控制时序。5.5 中断不触发现象寄存器配置看起来都对阈值也设了但 INT1 引脚永远没有电平变化。原因中断不触发有几种典型情况。一是中断事件没有映射到对应的引脚CTRL_REG3 和 CTRL_REG6 的位配置弄混。二是阈值设置太大信号根本达不到。三是 INT1_CFG 的 AOI 位配置和中断极性不匹配导致中断信号刚触发就被内部逻辑清掉。解决先确认映射位在正确的寄存器里然后减小阈值到接近零值比如 INT1_THS 写 0x01看引脚有没有反应。如果还是没反应把 INT1_DURATION 写成 0排除持续时间过滤的影响。最后用示波器抓传感器端的中断引脚看芯片到底有没有输出脉冲这样能快速定位是芯片侧问题还是 MCU 侧 EXTI 配置问题。6. 让 FIFO 水印中断驱动一轮数据流水线一个可以直接抄的高级配置把 FIFO、中断和低功耗组合起来就成一个优雅的数据采集方案。传感器数据写入 FIFO达到水位后通过 INT1 通知 MCUMCU 在中断里批量读取平时主循环完全不关心数据采集把资源释放给其他任务。我在做某便携式姿态检测产品时就是按这套思路把 100Hz 的采样和主循环逻辑彻底解耦的。void lis2dh12_start_pipeline(void) { // 使能 FIFO 水位中断到 INT1 lis2dh12_int1_fifo_wtm_enable(); // FIFO 模式, 水位 16 lis2dh12_fifo_config(0x01, 16); // 清除 FIFO 状态, 确保从干净状态开始 lis2dh12_write_reg(0x2E, 0x00); } void EXTI0_IRQHandler(void) { uint8_t src; int16_t x, y, z; src lis2dh12_read_reg(0x2F); if (src 0x20) { while (1) { if (lis2dh12_read_acc_raw(x, y, z) 0) { // 这里把 x,y,z 存入应用缓冲区 } src lis2dh12_read_reg(0x2F); if ((src 0x1F) 0) { break; } } } HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0); }这套配置有三个细节值得注意。一是 FIFO 水位设为 16意味着中断频率是 ODR 除以 16100Hz 的 ODR 下就是 6.25Hz 的中断频率MCU 负担很轻。二是在中断里循环读取直到 FIFO_SRC_REG 的 FSS 变为 0确保所有数据都被消费完。三是每次重新开始采集前把 FIFO_CTRL_REG 清零这样下一个批次的数据不会和上一批混在一起。我踩过直接复用 FIFO 导致首包数据异常的坑后来养成惯例每次启动都重置 FIFO。还有个小技巧如果你希望某个方向上的运动被重点检测可以在 FIFO 流水线之外叠加 INT1 的阈值中断。比如设备静止时让主控睡死一旦加速度绝对值超过阈值INT1 唤醒 MCUMCU 再启动 FIFO 流水线采集完整数据。这样既省电又能保证关键事件不丢设计思路是把两条中断链分开用FIFO 水位中断负责采样阈值中断负责唤醒。不过要提醒的是这套方案里中断优先级和临界区保护要做薄。我在一次联调里因为中断里调用了 HAL_I2C_Mem_Read 而被打断导致读到的数据错位后来把 IIC 读取放到临界区并且把中断优先级调低问题才消失。每套方案都有它适用的环境别盲目把中断里的逻辑写得过于复杂让驱动在简单和可靠之间找到平衡点。希望帮到你。本文还有配套的精品资源点击获取