
ESP32 实战教程:智能环境监测站
项目背景
随着物联网(IoT)技术的快速发展,环境监测在智能家居、智慧农业、工业自动化等领域得到了广泛应用。通过实时监测环境参数,如温度、湿度等,可以实现对环境的智能控制和管理。ESP32 作为一款功能强大的物联网芯片,集成了 Wi-Fi 和蓝牙功能,非常适合用于搭建智能环境监测站。本项目将基于 ESP32,使用温湿度传感器(DHT22)、OLED 显示屏和 MQTT 协议,搭建一个智能环境监测站,实现环境数据的实时采集、显示和远程传输。
硬件清单
- ESP32 开发板(如 ESP32 DevKit V1)
- DHT22 温湿度传感器
- 0.96 寸 OLED 显示屏(基于 SSD1306 驱动)
- 面包板和杜邦线
- 10kΩ 电阻(用于 DHT22 上拉)
- USB 数据线(用于连接 ESP32 和电脑)
接线图说明
接线图

接线说明
- DHT22 温湿度传感器
- VCC 接 ESP32 的 3.3V
- GND 接 ESP32 的 GND
- DATA 接 ESP32 的 GPIO 4
- 在 DATA 和 VCC 之间并联一个 10kΩ 电阻作为上拉电阻
- OLED 显示屏
- VCC 接 ESP32 的 3.3V
- GND 接 ESP32 的 GND
- SCL 接 ESP32 的 GPIO 22
- SDA 接 ESP32 的 GPIO 21
- 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); // 每分钟更新一次
}
调试
- 连接 WiFi 和 MQTT 服务器
- 确保 ESP32 连接到正确的 WiFi 网络。
- 确认 MQTT 服务器地址和端口正确,并且服务器正常运行。
- 传感器和显示屏测试
- 使用串口监视器查看温度和湿度数据是否正确读取。
- 确认 OLED 显示屏上显示的数据与串口监视器一致。
- MQTT 数据传输
- 使用 MQTT 客户端工具(如 MQTT.fx 或 MQTT Explorer)订阅 environment/data 主题,查看是否接收到 ESP32 发布的数据。
- 常见问题排查
- 检查接线是否正确,尤其是电源和数据线。
- 确认 DHT22 上拉电阻是否连接。
- 确认 OLED 显示屏的 I2C 地址是否正确(常见为 0x3C)。
扩展
1. 数据存储与可视化
将收集到的环境数据存储到数据库中,并通过 Web 界面进行可视化展示。可以使用 InfluxDB 存储数据,Grafana 进行数据可视化。
2. 远程控制与报警
通过 MQTT 协议,实现对环境监测站的远程控制,如设置报警阈值。当温度或湿度超过设定值时,触发报警,可以通过短信、邮件或手机通知等方式通知用户。
3. 集成其他传感器
在现有基础上,集成更多类型的传感器,如空气质量传感器(PM2.5)、光照传感器等,实现更全面的环境监测。
4. 低功耗优化
为了延长设备的使用时间,可以对 ESP32 进行低功耗优化,如使用深度睡眠模式,定期唤醒采集数据并传输。
5. 云平台集成
将数据上传到云平台,如 AWS IoT、Azure IoT 或阿里云物联网平台,实现数据的集中管理和分析。
通过以上扩展,可以将智能环境监测站打造成一个功能全面、可靠的物联网应用,满足不同场景的需求。