
想在项目里同时拿到温度、湿度和气压,BME280 几乎是绕不开的一颗传感器:一颗芯片出三组数据,出厂已校准,外围几乎不用搭。天气站、楼层高度估算、智能家居里的环境感知,都能看到它的影子。这篇把 BME280 接 Arduino 的完整流程理顺一遍:引脚、接线、装库、代码、串口读数,一次说清楚。
先认识 BME280:一颗芯片管三件事
BME280 是博世(Bosch)推出的数字温湿度气压三合一传感器,是 BMP180、BMP085、BMP183 这几代气压传感器的后继型号。它把温度、相对湿度、大气压三项测量集成进一颗邮票大小的芯片里,且出厂已完成校准。
三项能力的官方指标大致是:温度量程 -40℃ 到 85℃,在 0 到 65℃ 区间精度 ±1.0℃;湿度量程 0 到 100% RH,精度 ±3%;气压量程 300Pa 到 1100hPa,绝对精度 ±1 hPa。气压测量足够准,换个算法就能反推海拔,误差约 ±1 米。
有个细节值得留意:温度读数会被内部用来补偿气压和湿度的计算,而芯片自身通电会发热,所以测出的温度通常比环境真实温度略高一点。如果你的项目对温度精度要求高,可以拿一只参考温度计对比,在代码里减一个固定偏移。

模块硬件:为什么能直接接 5V 的 Arduino
常见的 BME280 紫色模块板上,除了传感器芯片本身,还集成了一个 3.3V 稳压器和一个 I2C 电平转换芯片。这很关键:BME280 芯片本体只吃 1.7V 到 3.6V,但有了这两颗元件,模块的 VIN 可以直接接 3.3V 或 5V 的开发板,不用担心烧芯片。
功耗也很低:测量时电流不到 1mA,空闲时只有 5μA 左右,拿去做电池供电的环境记录仪完全没压力。
I2C 地址方面,模块支持两个地址:0x76 和 0x77。默认地址是 0x76,想改成 0x77 要动板上的焊接跳线:用刀片切断中间与左侧铜箔之间的连线,再在中间与右侧焊盘之间补一颗锡点。改了地址就能在同一根 I2C 总线上挂两个 BME280。
引脚定义与接线:四根线搞定
模块对外只有 4 个引脚:
- VIN:供电,接 3.3V 到 5V;
- GND:地;
- SCL:I2C 时钟线;
- SDA:I2C 数据线。
接 Arduino UNO 这类 R3 布局的板子时,I2C 引脚在 AREF 引脚旁边的排针上,也就是 A4(SDA)和 A5(SCL)。对应关系如下表:
| BME280 模块 | Arduino UNO |
|---|---|
| VIN | 5V |
| GND | GND |
| SCL | SCL(A5) |
| SDA | SDA(A4) |

接线只有四根,没有别的元器件要加。唯一容易出错的是 SDA/SCL 接反,烧录后如果一直提示找不到传感器,第一件事就是检查这两根线有没有对调。
装两个库:Adafruit BME280 和 Unified Sensor
读数前要装 Adafruit BME280 Library。打开 Arduino IDE,进 Sketch > Include Library > Manage Libraries…,等库管理器把索引下载完,搜索 bme280,选 Adafruit 出品的 Adafruit BME280 Library 点安装。
这个库依赖 Adafruit Sensor 支持后端,所以在库管理器里再搜 Adafruit Unified Sensor,一并装上。少装第二个库,编译时会报错找不到 Adafruit_Sensor.h,新手常卡在这一步。
示例代码:温湿度气压海拔一次读完
下面这个程序每秒读一次温度、相对湿度、气压和估算海拔,从串口监视器打印出来。串口波特率是 9600,打开串口监视器时记得选一致。
#include "Wire.h"
#include "Adafruit_Sensor.h"
#include "Adafruit_BME280.h"
#define SEALEVELPRESSURE_HPA (1013.25)
Adafruit_BME280 bme;
void setup() {
Serial.begin(9600);
if (!bme.begin(0x76)) {
Serial.println("Could not find a valid BME280 sensor, check wiring!");
while (1);
}
}
void loop() {
Serial.print("Temperature = ");
Serial.print(bme.readTemperature());
Serial.println("*C");
Serial.print("Pressure = ");
Serial.print(bme.readPressure() / 100.0F);
Serial.println("hPa");
Serial.print("Approx. Altitude = ");
Serial.print(bme.readAltitude(SEALEVELPRESSURE_HPA));
Serial.println("m");
Serial.print("Humidity = ");
Serial.print(bme.readHumidity());
Serial.println("%");
Serial.println();
delay(1000);
}说明一点:上面 #include 里的头文件用的是双引号写法,与尖括号写法在 Arduino 工具链下对库搜索路径是等价的,两种写法都能正常编译。
代码讲解:四个函数各管一项
程序开头引入三个库:Wire.h 负责 I2C 通信,Adafruit_Sensor.h 是统一传感器后端,Adafruit_BME280.h 才是传感器本体库。
SEALEVELPRESSURE_HPA 这个宏存的是海平面气压,单位 hPa(毫巴),默认 1013.25。它只影响海拔估算:拿当前气压与海平面气压比较,反算出高度。要得到更准的绝对海拔,就把它改成你所在地区当天的实际海平面气压;只关心相对高度变化(比如从桌面拿到地板)的话,默认值就够了。
setup() 里两件事:初始化 9600 波特的串口,然后调 bme.begin(0x76)。begin() 的参数是模块的 I2C 地址——如果你改过焊接跳线,这里必须跟着改成 0x77,否则初始化会失败。begin() 内部会用给定地址初始化 I2C 接口、校验芯片 ID、软复位并等待传感器校准完成。初始化失败就打印错误并停在死循环里,避免主程序带着错误状态继续跑。
loop() 里的四个读取函数一一对应四项输出:readTemperature() 返回摄氏温度;readPressure() 返回帕斯卡单位的气压,除以 100 换算成 hPa;readAltitude(SEALEVELPRESSURE_HPA) 返回估算海拔,单位米;readHumidity() 返回相对湿度百分比。
串口读数:正常输出长什么样
烧录后打开串口监视器,正常情况下每秒刷新一组数据,类似下面这样:

四行分别是温度(*C)、气压(hPa)、估算海拔(m)和湿度(%)。如果串口一直打印 Could not find a valid BME280 sensor,按顺序排查:SDA/SCL 是否接反、地址是 0x76 还是改成了 0x77、VIN 有没有供电。
ESP32 板子同样适用
同一套库和代码在 ESP32 上也跑得通,接线逻辑一致:模块 VIN 接 3.3V,SDA/SCL 接 ESP32 默认的 I2C 引脚。ESP32 本身自带 WiFi,把 BME280 的读数推到网页或手机上做气象站,是很常见的进阶玩法。

写在最后
BME280 的上手成本很低:四根线、两个库、一段官方示例,就能把环境三项数据拿全。真正的分水岭在两处:一是海平面气压宏要不要改成当地实时值,决定海拔读数是"参考值"还是"可用值";二是自热带来的温度偏高要不要补偿,取决于你的项目对温度有多敏感。把这两点想清楚,这颗三合一传感器就能在你的项目里稳定服役。











装库那步补充一下,新版IDE 2.x直接在左侧库管理器面板搜就行,不用进菜单。Adafruit Unified Sensor那个依赖确实容易漏。
这颗我去年买过三个,都挂在同一根I2C总线上做了一个房间的温湿度记录,两个0x76一个改跳线到0x77,实测一年没掉过线。文章里提到的自热温升确实存在,我这边比水银温度计常年高0.8℃左右,代码里减了个偏移就准了。
A4/A5接反这个坑我踩过,串口一直报check wiring,查了半小时线才发现SCL和SDA调了个。
海平面气压那个宏一定要改,我住在高原,默认1013.25算出来的海拔能差出一百多米,改成当地气象站实时值后误差缩小到几米。