📚 课程目录第3章 I2C通信基础实验

3. I2C通信基础实验：使用ESP32读取BME280传感器的温度、湿度、气压数据

好，咱们正式开始动手。这一章的目标很明确：让ESP32通过I2C总线，把BME280这个三合一传感器里的温度、湿度和气压数据读出来，然后扔到串口监视器上。

你可能会想，不就是读个传感器吗？有什么难的？嗯，我刚开始做物联网项目时也这么想，结果第一次调BME280，死活读不到数据，折腾了大半天才发现是I2C地址搞错了。所以这一章，咱们把每一步都走扎实。

3.1 硬件连接：别小看这几根线

BME280模块一般有4个或6个引脚。咱们用最常用的4线模式：VCC、GND、SCL、SDA。

BME280引脚	ESP32引脚	说明
VCC	3.3V	供电，千万别接5V，会烧
GND	GND	共地
SCL	GPIO 22	时钟线
SDA	GPIO 21	数据线

注意：ESP32的默认I2C引脚是GPIO 22（SCL）和GPIO 21（SDA）。虽然大部分引脚都能复用，但我建议新手先别改，就用默认的。我曾经在一个项目里为了布线方便把SCL换到了GPIO 18，结果跟SD卡冲突，排查了两天才发现。

连接时记得把VCC接3.3V，别接5V。BME280是3.3V器件，接5V直接冒烟。我见过不止一个新手犯这个错。

3.2 I2C地址：两个地址的坑

BME280的I2C地址有两种可能：0x76 或 0x77。具体是哪个，取决于模块上SDO引脚的电平。

SDO接GND（低电平）：地址为 0x76
SDO接VCC（高电平）：地址为 0x77

大多数成品模块默认SDO已经拉低，地址是0x76。但也不绝对。我建议你在代码里先做个I2C扫描，确认一下实际地址。后面我会给扫描代码。

3.3 代码实现：一步一步来

咱们用Arduino框架，配合Adafruit的BME280库。这个库封装得很好，但咱们不能只当调包侠，得知道底层发生了什么。

3.3.1 安装库

在Arduino IDE的库管理器里搜索并安装：

Adafruit BME280 Library
Adafruit Unified Sensor（依赖库）

3.3.2 完整代码

#include <Wire.h>
#include <Adafruit_Sensor.h>
#include <Adafruit_BME280.h>

#define SEALEVELPRESSURE_HPA (1013.25)

Adafruit_BME280 bme;  // I2C

void setup() {
  Serial.begin(115200);
  while (!Serial);  // 等待串口连接（部分开发板需要）

  Serial.println(F("BME280 测试开始"));

  // 初始化I2C，指定引脚
  Wire.begin(21, 22);  // SDA, SCL

  // 检查传感器是否连接
  if (!bme.begin(0x76)) {  // 如果地址是0x77，改成0x77
    Serial.println(F("找不到BME280传感器，请检查接线或地址！"));
    while (1);  // 卡住
  }

  Serial.println(F("BME280 初始化成功"));
}

void loop() {
  // 读取数据
  float temperature = bme.readTemperature();
  float humidity    = bme.readHumidity();
  float pressure    = bme.readPressure() / 100.0F;  // 转为hPa

  // 打印到串口
  Serial.print("温度: ");
  Serial.print(temperature);
  Serial.println(" °C");

  Serial.print("湿度: ");
  Serial.print(humidity);
  Serial.println(" %");

  Serial.print("气压: ");
  Serial.print(pressure);
  Serial.println(" hPa");

  Serial.println("-------------------");

  delay(2000);  // 每2秒读一次
}

小技巧：代码里我用了 F() 宏把字符串放到Flash里，省RAM。ESP32的RAM虽然不小，但养成好习惯没坏处。我在做低功耗项目时，省下来的每一字节RAM都可能决定系统稳定性。

3.4 I2C扫描：排查问题的利器

如果你发现传感器读不到数据，别急着怀疑硬件坏了。先跑个I2C扫描程序，看看总线上到底有哪些设备。

#include <Wire.h>

void setup() {
  Serial.begin(115200);
  Wire.begin(21, 22);
  Serial.println("I2C扫描开始");

  byte error, address;
  int nDevices = 0;

  for (address = 1; address < 127; address++) {
    Wire.beginTransmission(address);
    error = Wire.endTransmission();

    if (error == 0) {
      Serial.print("发现设备，地址: 0x");
      if (address < 16) Serial.print("0");
      Serial.println(address, HEX);
      nDevices++;
    }
  }

  if (nDevices == 0) {
    Serial.println("未发现任何I2C设备，请检查接线！");
  }
}

void loop() {}

这个扫描程序会列出所有应答的I2C设备地址。如果BME280正常，你应该看到0x76或0x77。如果啥都没有，先查供电和接线。

3.5 数据解读：别被数值骗了

读出来的数据直接打印，但有几个坑要注意：

温度：单位是摄氏度，但BME280对热源敏感。手摸一下传感器，温度会跳好几度。所以测量环境温度时，传感器要远离发热元件。
湿度：相对湿度，范围0~100%。刚焊完的板子湿度读数可能偏高，因为助焊剂残留。放一会儿就正常了。
气压：代码里除以100转为hPa（百帕）。海平面标准气压约1013.25 hPa。如果你在高原，读数会低很多。我在拉萨测过，只有650 hPa左右。

3.6 知识结构图：I2C通信流程

下面这张图展示了ESP32通过I2C读取BME280的完整流程。我建议你对照着代码看，理解每一步在干什么。

3.7 常见问题与避坑

  核心要点：I2C通信的关键是地址正确、接线可靠、时序匹配。只要这三点没问题，数据就能稳定读取。

避坑指南：我曾经在一个项目里用了10cm长的杜邦线连接BME280，结果数据偶尔跳变。后来换成屏蔽线，问题解决。I2C总线对线长和干扰敏感，尤其是时钟线。如果数据不稳定，先检查线缆和连接器。

调试技巧：如果串口打印出奇怪的值（比如温度-273.15°C），说明读取失败。常见原因：
1. 传感器地址写错了
2. 接线松动
3. 供电不足（BME280需要至少1.8V，但3.3V最稳）
4. I2C上拉电阻缺失（大部分模块内置了，但有些没有）

3.8 实验验证：你该看到什么

上传代码后，打开串口监视器（波特率115200），你应该看到类似这样的输出：

BME280 测试开始
BME280 初始化成功
温度: 25.34 °C
湿度: 45.67 %
气压: 1012.89 hPa
-------------------
温度: 25.36 °C
湿度: 45.62 %
气压: 1012.91 hPa
-------------------

数值会轻微波动，这是正常的。如果数值稳定不变，反而有问题——传感器可能卡在某个状态了。