1. 认识LIS3DH加速度传感器

LIS3DH是一款超低功耗的三轴加速度传感器，在嵌入式开发中特别受欢迎。我自己在做智能手环项目时就用过它，实测下来功耗确实很低，特别适合电池供电的设备。这款传感器支持IIC和SPI两种通信方式，IIC相对简单一些，但SPI的速度更快，抗干扰能力也更强，适合对数据采集速率要求高的场景。

很多人刚开始接触LIS3DH时，会觉得SPI配置比较麻烦。其实只要理解了SPI的工作原理和LIS3DH的寄存器配置，就能轻松搞定。我最初用SPI驱动LIS3DH时也踩过坑，花了整整两天时间才调通，所以特别能理解新手遇到的困难。

LIS3DH可以测量±2g到±16g范围内的加速度，分辨率最高达到12位。在实际项目中，我常用±2g量程，这样灵敏度更高，适合检测细微的运动变化。传感器还内置了温度传感器和6D方向检测功能，非常实用。

2. SPI硬件连接与配置

2.1 引脚连接要点

SPI通信需要连接4根线：SCK（时钟）、MISO（主设备输入从设备输出）、MOSI（主设备输出从设备输入）和CS（片选）。我在STM32L051C8T6上的具体连接是：PA5作为SCK，PA6作为MISO，PA7作为MOSI，PA4作为CS片选引脚。

这里有个容易出错的地方：CS引脚最好不要用硬件SPI自带的片选，而是用普通GPIO来手动控制。我自己就吃过这个亏，一开始用了硬件片选，结果通信老是失败。后来改用软件控制CS引脚，问题就解决了。这是因为LIS3DH对片选信号的时序有特定要求，手动控制更灵活。

电源连接也很重要。LIS3DH的工作电压是1.71V到3.6V，需要稳定的电源供应。我在PCB布局时，都会在VDD和GND之间加一个100nF的去耦电容，这样可以减少电源噪声对测量精度的影响。

2.2 CubeMX配置步骤

打开STM32CubeMX，先选择正确的MCU型号。在Pinout界面中，找到SPI1并设置为Full-Duplex Master模式。这里要注意时钟极性（CPOL）和时钟相位（CPHA）的设置，根据LIS3DH的数据手册，应该设置为CPOL=1，CPHA=1。

具体参数配置如下：时钟分频设置为8分频（这样SPI时钟频率就是系统时钟的1/8），数据大小选择8位，MSB先行。片选信号选择软件管理模式，这样我们就可以用GPIO来控制CS引脚了。

在GPIO设置中，将PA4设置为GPIO Output，并给这个引脚起个有意义的标签，比如LIS3DH_CS。这样在代码中就能很容易地识别和控制这个引脚。最后生成代码时，记得选择HAL库，这样就能使用ST提供的硬件抽象层函数了。

3. SPI通信原理深度解析

3.1 时钟极性与相位详解

SPI通信中最关键的就是时钟极性（CPOL）和时钟相位（CPHA）的设置。这两个参数决定了数据采样的时机和时钟信号的电平状态。CPOL决定时钟线在空闲时的电平状态：CPOL=0时空闲为低电平，CPOL=1时空闲为高电平。

CPHA决定数据在时钟的哪个边沿被采样。CPHA=0时，在第一个时钟边沿采样；CPHA=1时，在第二个时钟边沿采样。对于LIS3DH，需要设置CPOL=1，CPHA=1。这意味着时钟空闲时为高电平，数据在第二个时钟边沿（也就是下降沿）被采样。

我自己调试时有个小技巧：用逻辑分析仪观察SPI波形。如果看到数据在时钟上升沿变化，在下陷沿采样，那就说明CPHA=1的设置是正确的。如果没有逻辑分析仪，也可以用示波器观察时钟和数据线的波形，确保它们符合预期。

3.2 读写时序分析

LIS3DH的SPI读写操作有固定的时序要求。写操作时，先发送寄存器地址，最高位设为0表示写操作，然后发送要写入的数据。读操作时，先发送寄存器地址，最高位设为1表示读操作，然后传感器会返回请求的数据。

片选信号CS的时序也很重要。CS需要在数据传输前至少拉低5ns，传输结束后保持低电平至少5ns才能拉高。在实际编程中，我通常会在操作前后加入小的延时，确保时序满足要求。虽然HAL库已经处理了大部分时序，但手动控制CS时还是需要注意这些细节。

每次读写操作最好连续完成，不要在中途被其他中断打断。我在代码中会把SPI操作放在临界区中，禁用中断，操作完成后再启用中断。这样可以避免因为中断处理导致的时序问题。

4. 寄存器配置实战

4.1 关键寄存器详解

LIS3DH有很多功能寄存器，但最常用的也就那么几个。CTRL_REG1（0x20）是控制寄存器1，用来设置数据速率和使能各轴。我一般设置为0x47，表示100Hz数据速率，使能X、Y、Z三轴。

CTRL_REG4（0x23）用来设置量程和分辨率。我通常设置为0x00，表示±2g量程，高分辨率模式。如果需要更大的量程，可以设置为0x10（±4g）、0x20（±8g）或0x30（±16g）。

WHO_AM_I寄存器（0x0F）是设备标识寄存器，读出来应该是0x33。这个寄存器特别有用，可以用来检查SPI通信是否正常。如果读出来是0xFF或0x00，说明通信有问题。

4.2 初始化流程

传感器初始化需要按照特定顺序配置寄存器。首先软复位，将0x40写入CTRL_REG5，然后延时一小会儿。接着配置CTRL_REG1设置数据速率和轴使能，再配置CTRL_REG4设置量程和分辨率。

我习惯在初始化后读取WHO_AM_I寄存器来验证通信是否正常。如果读出的值不是0x33，就需要检查硬件连接和SPI配置。初始化完成后，最好延时100ms左右，让传感器稳定工作。

这里有个小技巧：在初始化前先尝试读取一次WHO_AM_I寄存器，如果读成功，说明硬件连接基本正确；如果失败，就要先排查硬件问题。这样可以避免在软件调试上浪费太多时间。

5. 数据采集与处理

5.1 原始数据读取

读取加速度数据需要先发送起始寄存器地址（0x28 | 0x80），然后连续读取6个字节的数据。这6个字节分别对应X轴低字节、X轴高字节、Y轴低字节、Y轴高字节、Z轴低字节、Z轴高字节。

读取到的数据是16位有符号整数，需要转换成实际加速度值。转换公式是：加速度值 = (原始数据 * 量程) / 32768。例如，使用±2g量程时，转换公式就是：加速度值 = (原始数据 * 2) / 32768。

我在代码中会定义一个结构体来存储三轴加速度数据，这样使用起来更方便。读取数据时，最好连续读取多次取平均值，这样可以减少随机噪声的影响。我通常读取10次然后取平均，效果不错。

5.2 数据滤波处理

原始加速度数据通常包含很多噪声，需要进行滤波处理。最简单的就是移动平均滤波，我常用的是窗口大小为5的移动平均滤波器。对于要求更高的应用，可以使用卡尔曼滤波或者互补滤波。

这里分享一个简单的移动平均滤波实现：维护一个数组存储最近几次的采样值，每次读取新数据时，去掉最早的数据，加入新数据，然后计算平均值。这种方法简单有效，计算量也小。

对于动态响应要求高的应用，可以适当减小滤波窗口大小；对于静态测量，可以增大窗口大小获得更平滑的数据。实际项目中需要根据具体需求调整滤波参数。

6. 加速度数据转换为角度

6.1 基本原理

加速度计可以测量重力加速度在各个轴上的分量，利用这个特性可以计算出设备相对于水平面的倾斜角度。当设备静止时，加速度计测量到的就是重力加速度，大小约为9.8m/s²。

X轴角度计算公式：θx = atan2(Y, Z) * 180 / π Y轴角度计算公式：θy = atan2(X, Z) * 180 / π Z轴角度计算公式：θz = atan2(X, Y) * 180 / π

其中atan2是双参数反正切函数，可以处理所有象限的角度计算。在实际编程中，可以使用math.h库中的atan2f函数，注意要链接数学库（-lm）。

6.2 实际应用中的注意事项

角度计算假设设备处于静止状态或者缓慢移动。如果设备有剧烈运动，计算出的角度会有很大误差。在实际项目中，我通常会结合陀螺仪数据，使用互补滤波或卡尔曼滤波来获得更准确的角度信息。

计算角度时要注意各轴数据的正负号，这取决于传感器的安装方向。我建议先测试各轴的正方向：将设备水平放置，分别让各轴正方向朝下，观察对应的加速度值是否接近+1g或-1g。

角度计算需要浮点运算，如果MCU没有硬件浮点单元，计算速度可能会比较慢。这时可以使用查表法或者定点数运算来优化性能。我在STM32L051上使用浮点运算还能接受，但如果需要更高性能，可以考虑优化算法。

7. 常见问题与调试技巧

7.1 硬件问题排查

SPI通信失败很多时候是硬件问题。首先检查电源电压是否稳定，我在调试时都会先用万用表测量VDD电压，确保在3.3V左右。然后检查各引脚连接是否正确，特别是SCK、MISO、MOSI、CS这四根线。

可以用示波器观察SPI波形，看时钟和数据信号是否正常。正常的SPI波形应该时钟边沿陡直，数据信号在时钟边沿稳定。如果看到信号有振铃或者边沿缓慢，可能是阻抗匹配问题，可以尝试串联小电阻。

ESD保护也很重要，LIS3DH是敏感器件，容易被静电损坏。我在焊接时都使用防静电手环，PCB上也会加上ESD保护器件。如果怀疑传感器损坏，可以换一个新的试试。

7.2 软件调试技巧

软件调试时，先确保SPI基本通信正常。我最常用的方法是读取WHO_AM_I寄存器，如果读不出0x33，就说明SPI配置有问题。可以尝试降低SPI时钟频率，有时候频率太高会导致通信失败。

在HAL库中，很多SPI函数都有超时参数。如果函数返回HAL_TIMEOUT，说明SPI通信没有在指定时间内完成。可以增大超时时间，或者检查SPI时钟配置是否正确。

使用调试器单步执行SPI读写函数，观察返回值。如果HAL_SPI_Transmit或HAL_SPI_Receive返回HAL_ERROR，可以查看具体的错误代码。常见的错误有总线忙、超时等，根据错误代码可以更快定位问题。

8. 实战代码示例

8.1 初始化代码

下面是LIS3DH的初始化代码示例，包括SPI初始化和传感器配置：

void LIS3DH_Init(void)
{
    // 初始化CS引脚
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = GPIO_PIN_4;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET);
    
    // 软复位
    LIS3DH_WriteReg(0x24, 0x40);
    HAL_Delay(10);
    
    // 配置CTRL_REG1：100Hz数据速率，使能XYZ轴
    LIS3DH_WriteReg(0x20, 0x47);
    
    // 配置CTRL_REG4：±2g量程，高分辨率模式
    LIS3DH_WriteReg(0x23, 0x00);
    
    HAL_Delay(100);
}

8.2 数据读取与转换

加速度数据读取和角度计算的完整示例：

void LIS3DH_ReadAcceleration(float *x, float *y, float *z)
{
    uint8_t buffer[6];
    int16_t raw_x, raw_y, raw_z;
    
    // 读取6字节加速度数据
    LIS3DH_ReadRegs(0x28 | 0x80, buffer, 6);
    
    // 组合16位数据
    raw_x = (int16_t)((buffer[1] << 8) | buffer[0]);
    raw_y = (int16_t)((buffer[3] << 8) | buffer[2]);
    raw_z = (int16_t)((buffer[5] << 8) | buffer[4]);
    
    // 转换为加速度值（g）
    *x = (float)raw_x * 2.0f / 32768.0f;
    *y = (float)raw_y * 2.0f / 32768.0f;
    *z = (float)raw_z * 2.0f / 32768.0f;
}

void LIS3DH_CalculateAngles(float x, float y, float z, float *roll, float *pitch)
{
    // 计算滚转角和俯仰角
    *roll = atan2f(y, z) * 180.0f / M_PI;
    *pitch = atan2f(-x, sqrtf(y*y + z*z)) * 180.0f / M_PI;
}

在实际项目中，我会把这些函数封装成单独的模块，提供清晰的接口。这样主程序只需要调用LIS3DH_ReadAcceleration和LIS3DH_CalculateAngles就能获取角度信息，不需要关心底层SPI细节。

9. 性能优化建议

9.1 功耗优化

LIS3DH有很多低功耗模式，可以根据应用需求选择合适的模式。如果对功耗要求很高，可以使用低功耗模式，数据速率设置为1Hz或10Hz。需要更高数据速率时再切换到正常模式。

我通常这样配置：在空闲时使用低功耗模式，每秒采样一次；当检测到运动时，自动切换到正常模式，提高采样率。这样既能节省功耗，又不影响运动检测的实时性。

电源管理也很重要，不使用时可以进入睡眠模式。STM32的低功耗模式与LIS3DH的低功耗模式配合使用，可以显著延长电池寿命。我在智能手环项目中，采用这种策略后，电池续航时间提高了30%以上。

9.2 精度优化

为了提高测量精度，我在PCB布局时会特别注意传感器的位置