RT-Thread SPI驱动实战：手把手教你用BMP280传感器读取环境数据（附完整代码）

在嵌入式开发领域，环境数据采集是物联网终端设备的基础功能之一。BMP280作为博世推出的高精度数字气压传感器，能够同时测量大气压和温度，在气象站、室内环境监测等场景中应用广泛。本文将基于RT-Thread实时操作系统，详细讲解如何通过SPI接口驱动BMP280传感器，实现环境数据的稳定采集。

1. 开发环境准备

1.1 硬件选型与连接

推荐使用主流的STM32系列开发板作为硬件平台，本文以STM32F407为核心控制器。BMP280传感器模块通常采用8引脚封装，其SPI接口定义如下：

引脚名称	功能描述	连接目标
VCC	电源(3.3V)	开发板3.3V输出
GND	地线	开发板GND
SCK	SPI时钟线	MCU SPI_SCK引脚
MOSI	主出从入数据线	MCU SPI_MOSI引脚
MISO	主入从出数据线	MCU SPI_MISO引脚
CSB	片选信号	MCU GPIO引脚

注意：BMP280的SPI接口支持模式0和模式3，实际连接时需确保开发板与传感器的电平匹配。

1.2 软件环境配置

1. 安装RT-Thread Studio开发环境
2. 创建基于STM32F407的RT-Thread项目
3. 在RT-Thread Settings中启用SPI驱动支持：

   RT-Thread Components → Device Drivers → Using SPI Bus/Device device drivers
   

4. 配置SPI总线参数：

   #define BSP_USING_SPI2
   #define BSP_SPI2_SCK_PIN  "PB13"
   #define BSP_SPI2_MISO_PIN "PB14"
   #define BSP_SPI2_MOSI_PIN "PB15"
   

2. SPI驱动框架解析

RT-Thread的SPI驱动架构采用分层设计，主要包含三个核心层次：

1. SPI核心层：提供统一的设备管理接口
2. SPI控制器驱动层：实现具体硬件操作
3. SPI设备驱动层：处理设备特定的通信协议

2.1 SPI设备注册流程

典型的SPI设备初始化代码如下所示：

static int rt_hw_spi_init(void)
{
    __HAL_RCC_SPI2_CLK_ENABLE();
    
    static struct rt_spi_bus spi_bus;
    if (rt_spi_bus_register(&spi_bus, "spi2", &stm32_spi_ops) != RT_EOK)
    {
        return -RT_ERROR;
    }
    
    return RT_EOK;
}
INIT_BOARD_EXPORT(rt_hw_spi_init);

关键函数说明：

• rt_spi_bus_register()：注册SPI总线控制器
• rt_hw_spi_device_attach()：挂载SPI从设备
• rt_spi_configure()：配置SPI通信参数

2.2 SPI传输模式对比

传输方式	优点	缺点	适用场景
轮询模式	实现简单	占用CPU资源	低速设备
中断模式	提高CPU利用率	增加中断处理复杂度	中等速率设备
DMA模式	最大化传输效率	配置复杂	高速大数据量传输

3. BMP280驱动实现

3.1 传感器寄存器映射

BMP280的主要控制寄存器如下：

寄存器地址	名称	功能描述
0xD0	ID	芯片标识(0x58)
0xF3	STATUS	设备状态
0xF4	CTRL_MEAS	测量控制
0xF5	CONFIG	配置参数
0xF7-0xF9	PRESS_MSB/LSB	气压数据
0xFA-0xFC	TEMP_MSB/LSB	温度数据

3.2 驱动核心代码实现

创建bmp280.c文件实现传感器驱动：

#include <rtthread.h>
#include <rtdevice.h>

#define BMP280_SPI_DEV_NAME "spi20"
#define BMP280_REG_ID       0xD0

struct bmp280_calib_param {
    uint16_t dig_T1;
    int16_t dig_T2, dig_T3;
    // 其他校准参数...
};

static rt_err_t bmp280_read_reg(struct rt_spi_device *dev, 
                               uint8_t reg, uint8_t *data, rt_size_t len)
{
    uint8_t send_buf = reg | 0x80; // 设置读位
    struct rt_spi_message msg[2] = {
        { .send_buf = &send_buf, .length = 1 },
        { .recv_buf = data, .length = len }
    };
    
    return rt_spi_transfer_message(dev, msg, 2);
}

static rt_err_t bmp280_init(void)
{
    struct rt_spi_device *spi_dev;
    struct rt_spi_configuration cfg;
    uint8_t chip_id;
    
    // 1. 查找SPI设备
    spi_dev = (struct rt_spi_device *)rt_device_find(BMP280_SPI_DEV_NAME);
    if (!spi_dev) {
        rt_kprintf("BMP280 device not found!\n");
        return -RT_ERROR;
    }
    
    // 2. 配置SPI参数
    cfg.mode = RT_SPI_MODE_0 | RT_SPI_MSB;
    cfg.data_width = 8;
    cfg.max_hz = 10 * 1000 * 1000; // 10MHz
    rt_spi_configure(spi_dev, &cfg);
    
    // 3. 读取芯片ID验证
    bmp280_read_reg(spi_dev, BMP280_REG_ID, &chip_id, 1);
    if (chip_id != 0x58) {
        rt_kprintf("Invalid BMP280 ID: 0x%02X\n", chip_id);
        return -RT_ERROR;
    }
    
    // 4. 初始化传感器配置
    uint8_t config[2] = {
        0xF4,  // CTRL_MEAS寄存器
        0x27   // 温度oversampling x1, 压力oversampling x1, 正常模式
    };
    rt_spi_send(spi_dev, config, 2);
    
    return RT_EOK;
}

4. 数据采集与处理

4.1 原始数据读取

实现温度气压数据读取函数：

static rt_err_t bmp280_read_data(struct rt_spi_device *dev, 
                                float *temperature, float *pressure)
{
    uint8_t data[6];
    
    // 读取0xF7-0xFC的6个字节数据
    if (bmp280_read_reg(dev, 0xF7, data, 6) != RT_EOK) {
        return -RT_ERROR;
    }
    
    // 组合原始数据
    int32_t adc_T = (data[3] << 12) | (data[4] << 4) | (data[5] >> 4);
    int32_t adc_P = (data[0] << 12) | (data[1] << 4) | (data[2] >> 4);
    
    // 温度补偿计算(简化版)
    *temperature = adc_T / 100.0f;
    
    // 气压补偿计算(简化版)
    *pressure = adc_P / 256.0f;
    
    return RT_EOK;
}

4.2 数据校准优化

BMP280提供了一系列校准参数用于提高测量精度，完整的温度补偿算法如下：

static float bmp280_compensate_T(int32_t adc_T, struct bmp280_calib_param *calib)
{
    float var1, var2, T;
    
    var1 = (((float)adc_T)/16384.0 - ((float)calib->dig_T1)/1024.0) 
           * ((float)calib->dig_T2);
    var2 = ((((float)adc_T)/131072.0 - ((float)calib->dig_T1)/8192.0) 
           * (((float)adc_T)/131072.0 - ((float)calib->dig_T1)/8192.0)) 
           * ((float)calib->dig_T3);
    
    T = (var1 + var2) / 5120.0;
    return T;
}

5. 实际应用示例

5.1 创建数据采集线程

static void bmp280_thread_entry(void *parameter)
{
    struct rt_spi_device *spi_dev;
    float temp, press;
    
    spi_dev = (struct rt_spi_device *)rt_device_find(BMP280_SPI_DEV_NAME);
    if (!spi_dev) {
        rt_kprintf("Device not found\n");
        return;
    }
    
    while (1) {
        if (bmp280_read_data(spi_dev, &temp, &press) == RT_EOK) {
            rt_kprintf("Temperature: %.2f C, Pressure: %.2f hPa\n", 
                      temp, press/100.0);
        }
        rt_thread_mdelay(1000); // 1秒采样一次
    }
}

static int bmp280_start(void)
{
    rt_thread_t tid;
    
    tid = rt_thread_create("bmp280", 
                          bmp280_thread_entry, 
                          RT_NULL,
                          1024, 
                          25, 
                          10);
    if (tid != RT_NULL) {
        rt_thread_startup(tid);
    }
    
    return RT_EOK;
}
MSH_CMD_EXPORT(bmp280_start, Start BMP280 sampling);

5.2 常见问题排查

1. 无法读取芯片ID：

   • 检查SPI线路连接是否正确
   • 确认片选信号有效
   • 验证SPI模式设置(模式0或模式3)

2. 数据读数异常：

   • 确保已正确加载校准参数
   • 检查电源稳定性(推荐3.3V±5%)
   • 确认传感器已完成初始化配置

3. SPI通信失败：

   • 降低SPI时钟频率测试
   • 检查DMA缓冲区配置(如果使用DMA)
   • 验证SPI相位和极性设置

在实际项目中，BMP280的采样率可以根据需求调整，通过修改CTRL_MEAS寄存器的配置值，可以实现从1Hz到182Hz的采样频率。对于低功耗应用，建议使用强制模式而非连续测量模式，只在需要时唤醒传感器进行单次测量。