简介：这是基于STM32F103CBT6主控的LSM6DSL运动传感器（加速度计+陀螺仪）驱动源码包，面向嵌入式运动传感与STM32外设编程学习者，解决传感器数据采集与串口输出的快速验证问题。压缩包共144个文件、约4.53MB，文件类型以34个.h头文件、33个.c源文件为主，包含ST标准外设库、Keil工程文件、编译中间文件及清理脚本，目录内还含有keilkilll.bat等辅助工具，便于重新编译与工程维护。驱动同时提供IIC和SPI两种接口方式，默认通过IIC读取LSM6DSL数据，如需改用SPI只需修改初始化调用部分，无需大面积改动，适配性强；程序将实时加速度和陀螺仪数据通过串口打印，方便示波器或串口助手观察调试。目前已有3091人学习下载，适合希望快速掌握传感器驱动编写、串口通信或STM32工程搭建的开发者参考。 前两天折腾了一个STM32F103 + LSM6DSL的工程包，看到压缩包名字的时候我就知道里面是什么：一块芯片、一个六轴传感器，加上一堆标准外设库代码。这类包网上很多，但大多数解压后不是直接能跑，而是要花不少时间在接线、初始化、寄存器配置这些细节上。这个组合其实很典型，STM32F103 是入门首选 MCU，LSM6DSL 是 ST 出品的低功耗六轴惯性传感器，加速度计加陀螺仪，适合做姿态、计步、人机交互、跌倒检测这类应用。把这颗传感器调通并读出稳定数据，中间确实有不少值得记录的细节，我分几块讲清楚。
H2 2. 解压之后，先搞清这颗 LSM6DSL 到底能干什么
H3 2.1 六轴数据是什么，别把加速度和角速度搞混
LSM6DSL 内部集成了三轴加速度计和三轴陀螺仪，输出的是 6 路原始数据。加速度计测量的是物体受到的比力，静止时垂直轴能读出 1g 的重力加速度，所以它能给出“倾斜”信息；陀螺仪测量的是绕三个轴的旋转角速度，把它积分后能估算转过的角度，但会随时间漂移。两者配合，才能通过滤波得到稳定姿态角，单靠任何一个都不行。我在调试时遇到过不少人只盯着加速度计看，发现稍微一晃角度就乱跳，其实是因为没有陀螺仪数据参与融合。
这颗传感器支持 I2C 和 SPI 两种接口，默认我一般用 I2C，因为接线少，只要 SCL、SDA 两根线。它支持 1.8V 到 3.3V 供电，和 3.3V 的 STM32F103 正好匹配。需要注意的是，STM32F103 的 GPIO 虽然标称可以容忍 5V，但 LSM6DSL 可不是 5V 器件，I2C 上拉电阻必须接到 3.3V，千万不能顺手拉到 5V 上，否则长时间运行容易把传感器烧掉。
H3 2.2 为什么用 STM32F103 搭配 LSM6DSL
STM32F103 这款芯片主频 72MHz，自带 I2C、SPI、USART、USB 等外设，开发资料和固件库都非常成熟，成本也低，是目前学习 IMU 驱动最常用的 MCU 之一。搭配 LSM6DSL 的 I2C 接口，一个工程下来能同时练习到外设初始化、寄存器读写、中断处理、低功耗设计这些嵌入式基本功。工程包里通常会有几个目录：CORE 放启动文件，HARDWARE 放外设驱动，SYSTEM 放时钟和延时，USER 放 main。我拿到这类包后的第一步，不是看 main，而是先找lsm6dsl.c和lsm6dsl.h，确认驱动层接口有没有封装好，再看主函数里怎么调用。
这类参考工程普遍是基于标准外设库写的，对于新人来说其实比 HAL 库更容易看清寄存器操作逻辑，因为每一行都对应手册里的寄存器位。但说白了，工程包的代码是别人的思路，你要做的是把它消化成自己的，理解每一步为什么这么写。
H3 2.3 重要寄存器与 WHO_AM_I 校验
开始写初始化之前，一定要先学会读WHO_AM_I寄存器。LSM6DSL 的地址是 0x0F，读出来的固定值应该是0x6A。这一步能验证三件事：接线是否正确、I2C 地址是否选对、传感器是否处于正常的通信状态。我在移植时发现，相当多问题出在这里，有人读回来是0xFF，那就是 SDA 上拉没接或者从机地址不对；有人读回来是 0x00，大概率是 SCL 被拉死或者芯片没供上电。只有确认 WHO_AM_I 正确，再继续往下配寄存器才有意义。
I2C 从机地址由 SA0 引脚的电平决定，常见地址是 0x6A 或 0x6B。注意这个 0x6A 和 WHO_AM_I 的 0x6A 只是数值巧合，不是一回事，很多新手在这里绕晕。驱动代码里addr和who_am_i要分开看，别混了。
H2 3. 从零跑通 I2C 通信：硬件接线与初始化顺序
H3 3.1 接线图和我常用的引脚选择
STM32F103 的硬件 I2C 控制器在业界口碑不太好，很多人宁可花时间软件模拟也不愿意用硬件 I2C。我用过几次硬件 I2C 后，最终还是把工程里的读取函数改成 GPIO 模拟 I2C，原因后面详细说。这里先给一套我实测稳定的接线方案：使用 PB6 作 SCL，PB7 作 SDA，两个引脚各接一个 4.7kΩ 上拉电阻到 3.3V，LSM6DSL 的 VDD 接 3.3V，GND 共地，SA0 我默认接 GND，这样 I2C 地址就是 0x6A。如果你把 SA0 接 VDD，地址会变成 0x6B，代码里别写死。
如果只是验证通信，不需要接 INT 引脚；但如果要用中断唤醒，就把 INT1 接到 STM32 的外部中断引脚，比如 PA0。还有一个容易忽略的是 LSM6DSL 的VDD_IO引脚，它决定 I2C 接口电平，必须接 3.3V，否则通信时序会异常。
H3 3.2 初始化序列：先复位、开 BDU，再配量程和采样频率
LSM6DSL 的初始化顺序很关键，不建议直接跳过复位。我的推荐顺序是：
- 对
CTRL3_C（地址 0x12）写入0x01，触发软件复位，然后等待 20ms。 - 再次向
CTRL3_C写入0x04，把BDU位置 1。BDU 是“Block Data Update”，它的作用是确保读取高字节和低字节时不会被新数据打断，防止出现前一刻读高位、下一刻数据已经更新的半截数据。 - 配置
CTRL1_XL（0x10）设置加速度计量程和输出数据速率，比如写入0x60表示 ±8g、1.66kHz。 - 配置
CTRL2_G（0x11）设置陀螺仪量程和数据速率，比如写入0x58表示 ±1000dps、1.66kHz。 - 配置
CTRL6_C（0x15）等辅助寄存器，默认也可以不写。 - 读取
STATUS_REG（0x1E），等待数据就绪位。
很多人初始化不检查返回状态，直接从输出寄存器读数据。我建议在每个寄存器写入后都跟着读一遍，至少在关键寄存器上验证写成功，不然后面出了问题很难定位是通信问题还是寄存器配置问题。
H3 3.3 为什么我推荐软件 I2C 而不是硬件 I2C
STM32F103 的硬件 I2C 在引脚复用时配置麻烦，一旦遇到总线错误，I2C_SR1里的各种错误标志常常让新手手足无措。我实测在 400kHz 速率下，硬件 I2C 偶尔会因为 interrupt 优先级问题出现 BUSY 标志清不掉的情况，尤其在高负载时更明显。软件模拟 I2C 的做法是直接用 GPIO 翻转 SCL，按数据手册时序拉高拉低 SDA，虽然多占一点 CPU，但对 LSM6DSL 这种数据量不大的传感器来说毫无压力。而且软件 I2C 的时钟频率更容易控制，遇到长线路或上拉电阻偏大时，把延时调大一点就能稳定通信。
当然，硬件 I2C 也不是不能用，如果你后续要用 DMA 搬大量数据，硬件 I2C 有优势。但从稳定性和快速出成果的角度，我建议先把软件 I2C 跑通，再去研究硬件 I2C 的进阶玩法。
H2 4. 把原始值变成物理量：量程换算与标定
H3 4.1 原始数据的读取与灵敏度换算
LSM6DSL 的每个输出通道是 16 位，数据存在两个 8 位寄存器里，比如加速度计 X 轴输出是OUTX_L_XL（0x28）和OUTX_H_XL（0x29）。读取时要先读低字节，再读高字节，合成int16_t，注意不能定义为uint16_t，因为带符号补码，负的半轴数据需要符号扩展。合成后乘上当前量程的灵敏度，才能得到物理单位。
我常用的灵敏度表：
| 加速度计量程 | 灵敏度 (mg/LSB) |
|---|---|
| ±2g | 0.061 |
| ±4g | 0.122 |
| ±8g | 0.244 |
| ±16g | 0.488 |
| 陀螺仪量程 | 灵敏度 (mdps/LSB) |
|---|---|
| ±125 dps | 4.375 |
| ±250 dps | 8.75 |
| ±500 dps | 17.5 |
| ±1000 dps | 35 |
| ±2000 dps | 70 |
比如加速度计配置成 ±8g，读到的原始值是1234，那么实际加速度约等于1234 * 0.244 mg/LSB，再除以 1000 就是 g 值。陀螺仪同理，读到的原始值转成float后乘以 mdps/LSB 再除以 1000，就得到 dps。注意 LSM6DSL 手册里的灵敏度单位是mg/LSB和mdps/LSB，换算时单位别抄错。
H3 4.2 陀螺仪零偏：静止时它不归零
陀螺仪静止时，理论上输出应该全 0，但实际上每个轴都会有一个固定偏置，这个偏置来自芯片内部结构，不同批次芯片也不一样。解决方法是上电后先让设备静止放一会儿，采集 100 次数据取平均，作为该轴零偏。之后每次读取原始数据时先减掉零偏，再乘以灵敏度。我在实测中发现，温度变化会让零偏缓慢漂移，所以如果产品工作温度范围大，只做了常温零偏校准还是不够，最好在设备启动时做一次短时静止校准，或者在算法上增加零点漂移抑制。
加速度计也可以做类似校准，最简单的做法是水平静止采集 Z 轴读数，如果不等于满量程对应的 1g，就说明有偏移。但加速度计标定更完整的做法是采集六个姿态面的数据，求出三个轴的偏移和比例系数，这个工程包如果没有带标定程序，建议自己补一个简易版，否则姿态精度受影响。
H3 4.3 数据就绪怎么判断
LSM6DSL 的STATUS_REG（0x1E）每一位代表当前数据是否已更新。第 0 位XLDA表示加速度计新数据是否就绪，第 1 位GDA表示陀螺仪新数据是否就绪。我见过不少代码不读状态寄存器，直接一进来就读取当前寄存器值，这样偶尔能行，但一旦速度跟不上，就会读到同一个数据两次或者读到半截更新数据。正确流程是：先读STATUS_REG，判断对应位是否为 1；如果为 1，继续读取 6 个寄存器的数据；读完后再进入下一轮。这种轮询方式在单线程裸机代码里足够用，也不会丢数据。
H2 5. 数据搬运的工程实现：状态机、FIFO 与低功耗
H3 5.1 裸机轮询和状态机，我推荐怎么选
如果项目里只有这一个传感器，main 里一个while循环轮询STATUS_REG就够了。但只要你后续加了按键、LED、串口打印，循环里被其他操作占用的时间太长，就容易把 IMU 数据覆盖。我后来一般会把传感器读取逻辑做成一个简单的状态机：空闲、等待数据、读取数据、处理数据、发送数据。这样每个状态耗时短，随时能进入更低功耗阶段。如果你想跑 RTOS，这个状态机可以直接塞进一个线程里，整个逻辑不会乱。
H3 5.2 用 FIFO 批量读取，减少 CPU 打扰
LSM6DSL 内置 3KB 的 FIFO，连续高频率采样时，可以让传感器先把一批数据存进 FIFO，MCU 每过一段时间批量读一次。这个机制在两种场景下特别有用：一是 MCU 要睡眠省电，可以用 FIFO 暂停在低功耗状态；二是数据需要通过无线模块发送时，攒一批再发，比一包一包发更高效。配置 FIFO 时，我建议先关注FIFO_CTRL3和FIFO_CTRL4的FTH阈值设置，比如设置 FIFO 水位到 20 个样本时产生中断，MCU 就会收到 INT 信号去读取。读取时要用FIFO_DATA_OUT_TAG寄存器按标签判断当前数据属于加速度计还是陀螺仪，不是简单按顺序连续读六个寄存器就行。
H3 5.3 低功耗场景：停机模式与唤醒
热搜词里多次出现“stm32f103 停机模式”，这个和 IMU 项目关系很大。如果设备靠电池供电，大部分时间静止，就可以让 STM32F103 进入停机模式，同时 LSM6DSL 只开加速度计低功耗模式，检测到运动时通过中断引脚唤醒 MCU。配置要点有几个：LSM6DSL 的CTRL3_C里IF_INC保持默认，INT1_CTRL（0x0D）中把INT1_DRDY_XL或INT1_EMB_FUNC按需打开，然后设置TAP_THS_X、WAKE_DUR等参数配置唤醒阈值。唤醒中断接到 MCU 的 PA0/WKUP 引脚，MCU 进入PWR_STOP模式后，外部中断能把内核唤醒。实际测量下来，这个组合能大幅降低静态功耗，比一直让 MCU 空转轮询要省几十倍电。
H3 5.4 掉电保存标定数据：用内部 Flash
MCU 停机不会丢 RAM，但完全掉电后，采集到的陀螺仪零偏、加速度计偏移这些校准参数就没了。如果不想外挂 EEPROM，可以把参数存到 STM32F103 内部 Flash 的最后几页。F103 的 Flash 容量几十 KB 到一百多 KB，校准数据只占几十字节，放在最后一页比较安全。注意写 Flash 前要先擦除整个扇区，不能只改某几个字节；擦写期间 CPU 会暂停。我把校准参数在上电后读出来，发现异常就不使用改回默认值，同时把“需要重新标定”标志记录在另一个变量里，方便上位机提示用户。Flash 擦写次数有限，正常设备不会频繁掉电，所以不用担心寿命。
H2 6. 调试 IMU 时的三个典型翻车现场
H3 6.1 I2C 读到全0xFF或者状态卡死
这个问题出现频率最高。先检查 SCL/SDA 上拉电阻，很多最小系统板做 I2C 时已经带了上拉，你不用再加；但如果板子没有，就一定要补。其次检查从机地址，LSM6DSL 在 SA0 接 GND 时是 0x6A，接 VDD 是 0x6B，代码里的地址要跟硬件对上。如果这些都正常，再用逻辑分析仪抓一下波形，看看 SCL 是否输出稳定时钟，SDA 有没有被拉死。我遇到过因为引脚复用配置错，SCL 和 SDA 实际不在 PB6/PB7 上的情况，这种问题靠肉眼很难看出来，直接看波形最直接。
H3 6.2 数据漂移、野值，先查电源和接线
加速度计和陀螺仪数据偶尔跳一下，很多情况下不是代码问题，而是电源纹波太大或者传感器部分接触不良。我用开发板供电时数据很干净，换成劣质 USB 供电后 X 轴出现周期性尖峰，后来在 VDD 和 GND 之间加了一个 0.1uF 和 10uF 电容，尖峰消失了。传感器排线如果你用杜邦线连接，长度不要超过 20cm，线材晃动时也会带入噪声。软件上可以加一个简单的滑动平均，但要注意滑动窗口过大会把真实运动信息抹平，所以尽量先解决硬件噪声。
H3 6.3 用内部晶振时，I2C 时序如何调
热搜词里有“让 STM32F103 工作在内部晶振模式下”。如果项目为了省成本，不接外部晶振，用 HSI 8MHz 作为系统时钟，那硬件 I2C 的分频配置就需要重新算。F103 的 I2C 时钟源来自 APB1，而 APB1 最高 36MHz，如果用 HSI 倍频到 64MHz，再配置好 APB1 分频，I2C 速率才能正确。但我自己的经验是，这种场景下直接改用软件 I2C 更省事——它就是 GPIO 翻转延时，和系统时钟频率关系不大，只要主循环频率够高就行。不过要注意，一旦为了 USB 或更高精度应用，内部晶振通常不够用，LSM6DSL 这种靠 I2C 时序通信的传感器反而容易受影响。
H2 7. 关于这个工程包，最后补充三个可扩展方向
H3 7.1 用 USB CDC 串口打印 IMU 数据调试
F103 的 USB 外设可以配置为 CDC 虚拟串口，把 IMU 的六轴数据直接传给上位机。这个方案比普通串口省一个 USB 转 TTL 模块，还能同时保留另一个串口输出调试信息。需要留意的是，USB 时钟必须以 48MHz 工作，通常从外部 8MHz 晶振倍频得到，如果你用内部晶振，USB 枚举很可能失败。给有需要的朋友提个醒：先确认板子有没有外部晶振再上 USB CDC，否则还是老老实实用普通 UART 调试。
H3 7.2 融合出姿态角：F103 上没有 DMP 的替代方案
很多人从 MPU6050 转过来，习惯用芯片自带的 DMP 输出四元数，但 LSM6DSL 没有 DMP，需要自己做姿态融合。我推荐在 F103 上跑互补滤波，它计算量小，代码逻辑容易理解。陀螺仪积分提供短期角度变化，加速度计姿态供长期修正，两者按比例融合。如果想要更高精度，可以用 Madgwick 或者 Mahony 算法，但 F103 没有 FPU，浮点运算量会偏大。建议把姿态解算频率控制在 100Hz 到 200Hz，数据更新率没必要和传感器 1.6kHz 对齐，否则 CPU 占用太高，主循环会被拖垮。实际测试，F103 在 72MHz 主频下跑一阶互补滤波，解算 200Hz 的姿态角完全够用。
H3 7.3 代码分层：驱动层、中间层、应用层
很多工程包把传感器驱动和业务逻辑揉在 main.c 里，能跑，但维护起来极其痛苦。我习惯把 I2C 底层接口单独放到i2c_driver.c，把 LSM6DSL 的寄存器操作放到lsm6dsl.c，然后再包一层imu_app.c处理数据处理和姿态解算。这样以后想换传感器，只需要改驱动层，上层不用动。同时也方便写测试用例。如果你准备在这个工程包的基础上做产品，别嫌麻烦，一定要先分层再写业务逻辑，不然以后每次改上位机协议都可能把传感器驱动搞乱。
个人实际体验是，这类STM32F103 + LSM6DSL资料包最核心的参考价值就是帮你在最短时间内绕过通信坑，但它不能替代你读数据手册。把 WHO_AM_I 和 STATUS_REG 这两个寄存器吃透，后面基本不会走太大弯路。如果你手头也有这个组合在调，碰到某个具体问题，可以按这个排查顺序走一遍，大概率能省一个下午的时间。
本文还有配套的精品资源，点击获取
