用ESP32-WROOM-32和xiaozhi开源项目，5分钟搞定一个智能温湿度监测站（附Home Assistant联动配置）
5分钟打造ESP32智能温湿度站：从零接入Home Assistant全指南
周末在家突发奇想——能不能用最简硬件搭建一个实时监测卧室环境的装置？当看到书桌角落吃灰的ESP32开发板和几块钱的DHT11传感器时，这个想法突然有了落地的可能。本文将带你用最低成本和最少代码，完成从硬件组装、数据采集到智能家居联动的完整闭环。无需复杂电路知识，只要会插线就能完成；无需理解MQTT协议细节，复制粘贴配置文件即可实现数据可视化。
1. 硬件准备与接线图解
在开始烧录代码前，我们需要准备以下硬件组件。这些元件均可在主流电商平台以极低成本购得，建议选择带有防反插接口的模块以降低接线错误风险：
- ESP32-WROOM-32开发板（约25元）：选择带有Micro-USB接口的版本，便于供电和烧录程序
- DHT11温湿度传感器（约5元）：注意选择三针版本（VCC/GND/DATA）
- Micro-USB数据线：建议使用带磁环的优质线材减少信号干扰
- 杜邦线（3根）：推荐使用母对母接口线
接线操作只需三步，对应引脚关系如下表所示：
| 元件 | ESP32引脚 | 连接说明 |
|---|---|---|
| DHT11 VCC | 3.3V | 红色线，供电正极 |
| DHT11 GND | GND | 黑色线，供电地线 |
| DHT11 DATA | GPIO4 | 黄色线，数据信号线 |
提示：若使用四针DHT11（带空置NC引脚），只需忽略未使用的引脚即可。所有连接应在断电状态下完成。
完成接线后，建议用绝缘胶带固定线材接头处。我曾因接头松动导致数据断续，后来用热熔胶简单加固就再未出现异常。硬件组装阶段最易犯的错误是电源接反，务必反复确认VCC与GND的连接方向。
2. 开发环境快速配置
我们将使用Arduino IDE进行代码编写和烧录，其优势在于库管理简单且社区资源丰富。以下是经过验证的稳定版本配置方案：
- 从Arduino官网下载1.8.19版本IDE（非最新版，因ESP32支持更稳定）
- 安装后打开首选项，在"附加开发板管理器网址"中添加：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - 通过工具菜单安装ESP32开发板支持包（选择版本2.0.11）
关键库安装命令（通过库管理器搜索安装）：
#include <WiFi.h> // ESP32内置WiFi库 #include <PubSubClient.h> // MQTT客户端库 #include <DHT.h> // 传感器驱动库遇到网络问题时，可尝试修改hosts文件添加以下解析记录：
185.199.108.133 raw.githubusercontent.com3. 核心代码解析与烧录
完整代码已托管在Gitee仓库（见文末），这里重点讲解几个关键配置段。首先创建DHT对象并初始化串口：
#define DHTPIN 4 // 对应GPIO4引脚 #define DHTTYPE DHT11 // 传感器类型声明 DHT dht(DHTPIN, DHTTYPE); // 创建传感器对象 void setup() { Serial.begin(115200); dht.begin(); // 启动传感器 initWiFi("你的WiFi名", "密码"); initMQTT("mqtt服务器IP", 1883); // 本地部署或使用公共broker }WiFi连接函数包含智能重试机制，当网络异常时会自动每隔10秒尝试重连：
void initWiFi(const char* ssid, const char* pass) { WiFi.mode(WIFI_STA); WiFi.begin(ssid, pass); Serial.print("Connecting..."); while (WiFi.status() != WL_CONNECTED) { delay(10000); // 10秒重试间隔 Serial.print("."); } Serial.println("\nConnected! IP: " + WiFi.localIP()); }数据上报逻辑采用状态机设计，避免阻塞主线程：
void loop() { static unsigned long lastMsg = 0; if (millis() - lastMsg > 5000) { // 5秒上报间隔 float h = dht.readHumidity(); float t = dht.readTemperature(); if (isnan(h) || isnan(t)) { Serial.println("传感器读取失败"); } else { mqttPublish("home/bedroom/temp", String(t).c_str()); mqttPublish("home/bedroom/humidity", String(h).c_str()); } lastMsg = millis(); } mqttClient.loop(); // 维持MQTT心跳 }4. Home Assistant自动化配置
在configuration.yaml中添加以下配置启用MQTT自动发现：
mqtt: discovery: true broker: 192.168.x.x # ESP32连接的MQTT服务器IP username: mqtt_user password: mqtt_pass sensor: - platform: mqtt name: "Bedroom Temperature" state_topic: "home/bedroom/temp" unit_of_measurement: "°C" device_class: temperature - platform: mqtt name: "Bedroom Humidity" state_topic: "home/bedroom/humidity" unit_of_measurement: "%" device_class: humidity进阶用户可以通过Node-RED创建自动化流，当温度超过28℃时发送手机通知：
[{ "id": "温度告警流", "type": "mqtt in", "topic": "home/bedroom/temp", "actions": [{ "type": "condition", "conditions": [{ "param": "payload", "operator": ">", "value": 28 }], "then": [ { "type": "notification", "service": "mobile_app", "message": "卧室温度过高" } ] }] }]5. 常见问题与性能优化
数据抖动处理：DHT11的精度为±2℃，可通过软件滤波提升读数稳定性。在代码中添加滑动平均算法：
float tempReadings[5] = {0}; int readIndex = 0; float smoothTemperature() { tempReadings[readIndex] = dht.readTemperature(); readIndex = (readIndex + 1) % 5; float sum = 0; for (int i=0; i<5; i++) sum += tempReadings[i]; return sum / 5; }电源优化方案：如需电池供电，可修改代码启用深度睡眠模式：
#define uS_TO_S_FACTOR 1000000 // 微秒到秒转换 void deepSleep(int seconds) { esp_sleep_enable_timer_wakeup(seconds * uS_TO_S_FACTOR); esp_deep_sleep_start(); } // 在loop()末尾添加： deepSleep(300); // 睡眠5分钟实际部署时，建议将开发板装入3D打印外壳（Thingiverse有现成模型）。我在外壳顶部开了透气孔，既保证空气流通又避免灰尘影响传感器精度。