LPS331AP SPI嵌入式驱动库：Mbed平台高精度气压温度传感器底层控制

1. LPS331AP_SPI 库概述

LPS331AP_SPI 是一个专为 Mbed OS 平台设计的轻量级 SPI 驱动库，面向意法半导体（STMicroelectronics）推出的高精度数字气压/温度传感器 LPS331AP。该器件采用 MEMS 技术，集成压力传感单元与温度传感单元，通过 I²C 或 SPI 接口输出原始 24 位压力数据（PDATA）和 16 位温度数据（TDATA），具备 ±0.012 hPa（约 ±10 cm 高度分辨率）的压力测量精度、±0.2 °C 的温度精度，以及 260–1260 hPa 的宽量程工作范围，适用于无人机高度计、可穿戴设备气压计、气象站及工业环境监测等对静态精度与长期稳定性要求严苛的应用场景。

本库严格遵循 LPS331AP 数据手册（DS9758, Rev 6）中定义的 SPI 通信协议，不依赖 Mbed OS 的通用 I²C/SPI 抽象层（如DigitalOut,SPI类的高层封装），而是直接操作底层SPI对象并精确控制片选（CS）、时钟极性（CPOL）、时钟相位（CPHA）及数据帧格式，确保在高速采样（最高支持 10 MHz SCLK）与低功耗模式切换时的时序鲁棒性。其核心设计哲学是“最小抽象、最大可控”：所有寄存器读写均以字节/字为单位显式完成，无隐式状态缓存或自动重试逻辑，将寄存器配置权完全交予用户，从而满足嵌入式系统中对确定性行为与资源占用的硬性约束。

值得注意的是，该库不执行任何浮点运算或物理量转换。它仅提供对原始 ADC 值（uint32_t pressure_raw,int16_t temp_raw）的可靠读取能力。压力值（hPa）、温度值（°C）的最终计算需由上层应用代码依据 ST 官方提供的线性化公式完成。这种设计并非功能缺失，而是嵌入式底层驱动的工程共识：将传感器物理模型（含温度补偿系数、非线性校准参数）与硬件访问逻辑解耦，既避免在资源受限 MCU 上引入不可控的浮点库依赖，又赋予开发者对校准策略（如查表法、多项式拟合、自适应补偿）的完全控制权。

2. 硬件接口与电气特性

2.1 引脚连接规范

LPS331AP 采用 16 引脚 LGA 封装，SPI 模式下关键引脚定义如下（对应 Mbed Nucleo/F4xx/L4xx 等主流开发板）：

关键时序约束（摘自 DS9758 §6.2）

• t_CSH（CS 保持低电平时间）：≥ 100 ns（写操作），≥ 200 ns（读操作）
• t_CSL（CS 上升沿到 SCLK 第一脉冲延迟）：≥ 100 ns
• t_SUC（SCLK 最小周期）：100 ns（即 SCLK ≤ 10 MHz）
• t_SUO（MISO 数据建立时间）：≥ 20 ns（相对于 SCLK 下降沿）
  LPS331AP_SPI 库内部通过wait_us(1)实现t_CSH和t_CSL的保守延时，确保在所有 Mbed 目标平台上兼容。

2.2 SPI 模式配置

LPS331AP 仅支持Mode 0（CPOL=0, CPHA=0），即：

• 空闲时钟为低电平（CPOL=0）
• 数据在 SCLK 上升沿采样，在下降沿变化（CPHA=0）

MbedSPI对象初始化必须显式指定此模式：

#include "mbed.h" #include "LPS331AP_SPI.h" SPI spi(PA_7, PA_6, PA_5); // mosi, miso, sclk (Nucleo-F411RE) DigitalOut cs(PA_4); // 关键：必须设置为 Mode 0，且禁用硬件 NSS（因 CS 由 DigitalOut 独立控制） spi.format(8, 0); // 8-bit data, mode 0 spi.frequency(1000000); // 1 MHz 安全起见，可提升至 10 MHz

若错误配置为 Mode 3（CPOL=1, CPHA=1），将导致所有寄存器读写失败，表现为read_register()返回全 0xFF 或随机值，且无硬件报错机制——这是初学者最常见的集成故障点。

3. 寄存器映射与核心 API

3.1 关键寄存器地址表

LPS331AP 的寄存器空间为 8 位地址（0x00–0x25），SPI 访问需在地址字节最高位（MSB）置 1 表示“读操作”，置 0 表示“写操作”。LPS331AP_SPI 库已内建此地址掩码逻辑，用户仅需传入纯地址值。

注：PRESS_OUT_XL/H/L三字节构成 24 位无符号整数，TEMP_OUT_H/L两字节构成 16 位有符号整数（补码表示）。STATUS_REG的P_DA（Pressure Data Available）位为 1 时，表明压力数据已就绪，可安全读取。

3.2 核心 API 函数详解

bool init(uint8_t odr = ODR_12_5Hz)

初始化传感器并配置输出数据速率（ODR）。odr参数为预定义枚举值，对应CTRL_REG1[7:4]位：

函数执行流程：

1. 拉低cs
2. 发送写地址0x20（0x20 & 0xFE = 0x20）
3. 发送odr值（0b00001000 | (odr << 4)，其中 bit3=1 启用压力通道，bit1=1 启用温度通道）
4. 拉高cs
5. 延迟10 ms等待上电稳定
6. 读取STATUS_REG (0x27)验证P_DA/T_DA是否可置位

返回true表示初始化成功，否则返回false（常见于 CS 连接错误或电源异常）。

bool read_pressure_raw(uint32_t *p_raw)

读取 24 位原始压力值。必须确保P_DA已置位，否则返回false。实现细节：

• 发送读地址序列：0xA8,0xA9,0xAA（0x28 | 0x80,0x29 | 0x80,0x2A | 0x80）
• 三次spi.write(0x00)获取三字节数据
• 组包：*p_raw = (data_h << 16) | (data_l << 8) | data_xl

uint32_t press_raw; if (lps.read_pressure_raw(&press_raw)) { printf("P_RAW = 0x%06X\n", press_raw); }

bool read_temperature_raw(int16_t *t_raw)

读取 16 位原始温度值。同理需检查T_DA标志。

• 发送读地址：0xAB,0xAC（0x2B | 0x80,0x2C | 0x80）
• spi.write(0x00)两次获取高低字节
• 组包：*t_raw = (int16_t)((data_h << 8) | data_l)

uint8_t read_register(uint8_t reg_addr)

通用寄存器读取函数，用于调试或高级配置（如读取INT_SOURCE）：

uint8_t int_src = lps.read_register(0x25); printf("INT_SRC = 0x%02X\n", int_src);

void write_register(uint8_t reg_addr, uint8_t value)

通用寄存器写入函数，用于手动配置（如使能 FIFO）：

// 使能 FIFO，设置 Watermark = 16 samples lps.write_register(0x21, 0x04); // CTRL_REG2[2]=1 lps.write_register(0x2E, 0x10); // FIFO_CTRL[7:0] = 0x10

4. 物理量转换算法与工程实践

4.1 压力计算：从 RAW 到 hPa

LPS331AP 的压力输出为线性关系，但需进行零点偏移与灵敏度校准。ST 提供的转换公式为：

[ P_{hPa} = \frac{P_{RAW} - P_{OFF}}{SENS_AI} \times 10 ]

其中：

• P_RAW：24 位无符号整数（0–16777215）
• P_OFF：出厂校准的零点偏移（存储于OUT_P_L/OUT_P_H寄存器，需在CTRL_REG1中设置PD=1后读取，本库未内置此功能）
• SENS_AI：出厂校准的灵敏度因子（单位：LSB/hPa），典型值为4096（对应 1 hPa = 4096 LSB）

工程简化方案（适用于大多数应用）：
若无需亚帕斯卡级精度，可采用固定比例换算，并通过实测校准零点：

// 假设海平面标准大气压为 1013.25 hPa，此时读取 RAW 值为 4150000 const uint32_t P_RAW_SEALEVEL = 4150000; const float SENSITIVITY = 4096.0f; // LSB/hPa float calculate_pressure_hpa(uint32_t p_raw) { return 1013.25f + (p_raw - P_RAW_SEALEVEL) / SENSITIVITY; }

4.2 温度计算：从 RAW 到 °C

温度输出为有符号 16 位，转换关系为：

[ T_{°C} = \frac{T_{RAW}}{480} + 42.5 ]

T_RAW范围：-32768 至 32767，对应温度范围：-40°C 至 +85°C。

float calculate_temperature_c(int16_t t_raw) { return (static_cast<float>(t_raw) / 480.0f) + 42.5f; } // 示例：t_raw = 12000 → T = 12000/480 + 42.5 = 25 + 42.5 = 67.5°C

4.3 FreeRTOS 集成示例：周期性采样任务

在实时操作系统中，应避免在中断上下文调用read_*_raw()（因涉及 SPI 总线操作与延时）。推荐创建独立任务：

#include "rtos.h" #include "LPS331AP_SPI.h" LPS331AP_SPI lps(PA_7, PA_6, PA_5, PA_4); // mosi, miso, sclk, cs Queue<uint32_t, 10> pressure_queue; void pressure_task(void *args) { uint32_t p_raw; while (true) { if (lps.read_pressure_raw(&p_raw)) { pressure_queue.try_put_for(500ms, p_raw); // 500ms 超时 } ThisThread::sleep_for(100ms); // 10 Hz 采样 } } int main() { if (!lps.init(LPS331AP_SPI::ODR_10Hz)) { error("LPS331AP init failed!\n"); } Thread pressure_thread(osPriorityNormal, 1024); pressure_thread.start(pressure_task); while (true) { uint32_t p_raw; if (pressure_queue.try_get_for(1s, &p_raw)) { float p_hpa = calculate_pressure_hpa(p_raw); printf("P = %.2f hPa\n", p_hpa); } ThisThread::sleep_for(1000ms); } }

5. 故障诊断与性能优化

5.1 常见故障模式与排查

5.2 低功耗模式实践

LPS331AP 支持两种省电模式：

• Power-down 模式：CTRL_REG1[7:4]=0b0000，电流 < 1 µA
• One-shot 模式：CTRL_REG1[7:4]=0b0000且CTRL_REG1[3]=1，触发单次测量后自动返回 Power-down

在电池供电设备中，应优先使用 One-shot 模式：

// 进入 One-shot 模式 lps.write_register(0x20, 0x08); // PD=0, ONE_SHOT=1, BDU=1, TEMP_EN=1, PCE=1 // 触发测量 lps.write_register(0x20, 0x88); // PD=1, ONE_SHOT=1... // 等待 DRDY 或轮询 STATUS_REG while (!(lps.read_register(0x27) & 0x01)); // P_DA // 读取数据... // 测量完成后自动进入 Power-down，无需额外指令

此模式下，平均功耗可降至微安级别，显著延长纽扣电池寿命。

6. 与 HAL/LL 库的协同开发

虽然 LPS331AP_SPI 为 Mbed 专用，但其寄存器操作逻辑可无缝迁移到 STM32 HAL/LL 生态。关键映射关系如下：

在 STM32CubeIDE 项目中，可将LPS331AP_SPI.cpp中的read_pressure_raw()函数体直接替换为 HAL 调用，仅需修改 SPI 句柄与 GPIO 引脚定义。这种跨平台一致性，正是遵循标准寄存器协议的底层驱动的核心价值。