ESP32 实战 · 2026-06-17 配图
AI Know 自有配图 · 嵌入式 · IoT · 硬件编程

ESP32 实战教程:智能环境监测站

项目背景

随着物联网(IoT)技术的快速发展,环境监测在智能家居、智慧农业、工业自动化等领域得到了广泛应用。通过实时监测环境参数,如温度、湿度等,可以实现对环境的智能控制和管理。ESP32 作为一款功能强大的物联网芯片,集成了 Wi-Fi 和蓝牙功能,非常适合用于搭建智能环境监测站。本项目将基于 ESP32,使用温湿度传感器(DHT22)、OLED 显示屏和 MQTT 协议,搭建一个智能环境监测站,实现环境数据的实时采集、显示和远程传输。

硬件清单

  1. ESP32 开发板(如 ESP32 DevKit V1)
  2. DHT22 温湿度传感器
  3. 0.96 寸 OLED 显示屏(基于 SSD1306 驱动)
  4. 面包板和杜邦线
  5. 10kΩ 电阻(用于 DHT22 上拉)
  6. USB 数据线(用于连接 ESP32 和电脑)

接线图说明

接线图

![ESP32 环境监测站接线图](https://i.imgur.com/your-image-link.png)

接线说明

  1. DHT22 温湿度传感器

- VCC 接 ESP32 的 3.3V

- GND 接 ESP32 的 GND

- DATA 接 ESP32 的 GPIO 4

- 在 DATA 和 VCC 之间并联一个 10kΩ 电阻作为上拉电阻

  1. OLED 显示屏

- VCC 接 ESP32 的 3.3V

- GND 接 ESP32 的 GND

- SCL 接 ESP32 的 GPIO 22

- SDA 接 ESP32 的 GPIO 21

  1. ESP32 开发板

- 通过 USB 数据线连接到电脑

完整代码

以下是使用 Arduino IDE 编写的完整代码:


#include <WiFi.h>
#include <PubSubClient.h>
#include <Adafruit_Sensor.h>
#include <DHT.h>
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define DHTPIN 4
#define DHTTYPE DHT22
DHT dht(DHTPIN, DHTTYPE);

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_RESET    -1
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

const char* ssid = "你的WiFi名称";
const char* password = "你的WiFi密码";
const char* mqtt_server = "你的MQTT服务器地址";
const int mqtt_port = 1883;
const char* mqtt_topic = "environment/data";

WiFiClient espClient;

void setup_wifi() {
  delay(10);
  Serial.println();
  Serial.print("连接到 ");
  Serial.println(ssid);

  WiFi.begin(ssid, password);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println("");
  Serial.println("WiFi 已连接");
  Serial.println("IP 地址: ");
}

void reconnect() {
  while (!client.connected()) {
    Serial.print("尝试连接到 MQTT 服务器...");
    if (client.connect("ESP32Client")) {
      Serial.println("连接成功");
    } else {
      Serial.print("连接失败,状态码=");
      Serial.print(client.state());
      Serial.println(" 5 秒后重试");
      delay(5000);
    }
  }
}

void setup() {
  Serial.begin(115200);
  dht.begin();
  setup_wifi();

  if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { 
    Serial.println(F("SSD1306 初始化失败!"));
    for(;;);
  }
  display.clearDisplay();
  display.setTextSize(1);
  display.setCursor(0,0);
  display.println("环境监测站启动");
  display.display();
  delay(2000);
}

void loop() {
  if (!client.connected()) {
    reconnect();
  }
  client.loop();

  float h = dht.readHumidity();
  float t = dht.readTemperature();

  if (isnan(h) || isnan(t)) {
    Serial.println("读取 DHT22 失败!");
    return;
  }

  Serial.print("温度: ");
  Serial.print(t);
  Serial.print(" °C\t");
  Serial.print("湿度: ");
  Serial.print(h);
  Serial.println(" %");

  display.clearDisplay();
  display.setCursor(0,0);
  display.println("环境监测站");
  display.setCursor(0,20);
  display.printf("温度: %.1f C", t);
  display.setCursor(0,40);
  display.printf("湿度: %.1f %%", h);
  display.display();

  String message = "{\"temperature\":" + String(t) + ",\"humidity\":" + String(h) + "}";

  delay(60000); // 每分钟更新一次
}

调试

  1. 连接 WiFi 和 MQTT 服务器

- 确保 ESP32 连接到正确的 WiFi 网络。

- 确认 MQTT 服务器地址和端口正确,并且服务器正常运行。

  1. 传感器和显示屏测试

- 使用串口监视器查看温度和湿度数据是否正确读取。

- 确认 OLED 显示屏上显示的数据与串口监视器一致。

  1. MQTT 数据传输

- 使用 MQTT 客户端工具(如 MQTT.fx 或 MQTT Explorer)订阅 environment/data 主题,查看是否接收到 ESP32 发布的数据。

  1. 常见问题排查

- 检查接线是否正确,尤其是电源和数据线。

- 确认 DHT22 上拉电阻是否连接。

- 确认 OLED 显示屏的 I2C 地址是否正确(常见为 0x3C)。

扩展

1. 数据存储与可视化

将收集到的环境数据存储到数据库中,并通过 Web 界面进行可视化展示。可以使用 InfluxDB 存储数据,Grafana 进行数据可视化。

2. 远程控制与报警

通过 MQTT 协议,实现对环境监测站的远程控制,如设置报警阈值。当温度或湿度超过设定值时,触发报警,可以通过短信、邮件或手机通知等方式通知用户。

3. 集成其他传感器

在现有基础上,集成更多类型的传感器,如空气质量传感器(PM2.5)、光照传感器等,实现更全面的环境监测。

4. 低功耗优化

为了延长设备的使用时间,可以对 ESP32 进行低功耗优化,如使用深度睡眠模式,定期唤醒采集数据并传输。

5. 云平台集成

将数据上传到云平台,如 AWS IoT、Azure IoT 或阿里云物联网平台,实现数据的集中管理和分析。

通过以上扩展,可以将智能环境监测站打造成一个功能全面、可靠的物联网应用,满足不同场景的需求。