如果你也跟我一样曾经对着一抽屉吃灰的电子元件发呆大概率能理解那种感觉想做一个真正能落地、能天天用、还能带出去跟人分享的DIY智能电子项目但翻遍教程要么只讲单点功能要么一上来就是一堆晦涩的电路图。我前后折腾过十几个方案最后锁定了一个特别朴素但极其实用的方向——做一个能实时监测环境、自动控制电器、还能用手机远程查看状态的小主机。这篇文章就把这个项目从设计思路、硬件选型、接线、固件开发到排错优化的完整过程写下来整个过程零基础也能跟着跑通而且所有代码和接线图都在后面给出你完全可以照着“抄作业”。项目全貌拆解与设计思路1.1 这个项目到底在做什么这个DIY智能电子项目本质上是一个“环境监测 设备控制 远程查看”的小型智能中枢。我给它起名叫 HomeEnv-Box一个巴掌大的小盒子放在客厅或者书桌上每隔几秒采集一次温湿度数据实时显示在自带的小屏幕上同时根据预设的温度阈值自动控制一路继电器的开关比如冬天自动开关加湿器、夏天自动启动风扇再通过板载Wi-Fi让手机浏览器随时看到当前环境数据和运行状态。为什么要做这样一个东西而不是只做一个“炫技”的跑马灯或者温湿度计因为一个合格的DIY项目不能只是“点亮一个屏”就完事。HomeEnv-Box覆盖了完整的产品级链路数据采集、逻辑处理、人机交互、执行控制、远程通信。这个链路是绝大多数智能硬件项目的通用骨架——你做智能鱼缸、智能花盆、智能门禁本质上都跑不出这个框架。所以这个项目的价值不只是“做出一个东西”而是通过它把整个嵌入式开发的思维方式跑一遍。1.2 设计上的三个关键取舍第一主控选型要用ESP32而不是Arduino Uno。原因很简单ESP32自带Wi-Fi和蓝牙算力、内存、存储都大一个量级价格却和Uno差不多。如果用Uno想联网还得外挂ESP8266模块串口资源被占掉一大半代码逻辑被割裂成两套调试痛苦翻倍。ESP32用一套代码搞定采集、显示、联网和控制这对初学者友好太多了。第二传感器不能只图便宜。DHT11只要几块钱网上也一堆教程但它的精度是±2°C和±5%RH读数跳变、响应慢做演示可以做“真正每天用”的东西就不太够了。我最终选了SHT30数字I2C接口精度高价格也就十几块。这个取舍在后面“传感器选型”里详细说。第三交互方式坚持“屏幕 按键 手机”三条腿走路。屏幕负责本地直观显示按键负责不需要联网就能设置阈值手机页面负责远距离查看。很多DIY项目只做手机App一旦局域网断了就抓瞎实体屏幕和按键在这种时候反而最可靠。1.3 整体架构采集、处理、显示、控制四层模型HomeEnv-Box的逻辑可以拆成四层采集层SHT30温湿度传感器通过I2C总线把物理信号变成数字信号。处理层ESP32主控读取原始数据做平滑滤波、阈值判断同时管理按键输入和Wi-Fi服务。显示层0.96英寸OLED显示屏本地呈现即时数据和设备状态。控制层继电器模块根据处理层的指令接通或切断负载电源。这个分层思维是嵌入式项目的通用骨架。不管以后做多复杂的系统只要你保持“采集端、控制端、决策端互不纠缠”代码可维护性就会好很多。HomeEnv-Box的代码我就明显感受到分层清晰之后排错特别轻松——数据不对就去查传感器控制不对就去查继电器逻辑互不干扰。核心硬件选型与原理详解2.1 主控板ESP32凭什么是最优解这里给的结论不是“ESP32最好”而是“ESP32最适合这个项目”。ESP32的双核240MHz处理器应对这种轻量任务绰绰有余520KB SRAM、4MB Flash跑一个WebServer同时处理传感器中断都毫无压力。更关键的是ESP32的Arduino生态非常成熟库函数丰富DHT/SHT驱动、OLED驱动、Wi-Fi库全都现成对新手极其友好。如果你以前只玩过Arduino Uno你会发现ESP32的开发体验几乎是无缝迁移的除了引脚编号、ADC精度这些细节基本没有额外学习成本。接线层面我选择的是板上带有型USB口的ESP32 DevKitC开发板直接USB供电和烧录初期调试不用额外买USB转TTL工具。如果你手头的是NodeMCU-32S之类的板子使用方式也完全相同。2.2 传感器选型温湿度监测的精度与成本博弈温湿度传感器是环境监测类项目的灵魂。我做了个简单对比型号接口精度温度/湿度单颗参考价适合场景DHT11单总线±2°C / ±5%RH3~5元纯入门演示DHT22单总线±0.5°C / ±2%RH10~15元性价比之选SHT30I2C±0.3°C / ±2%RH12~18元长期监测、本项目使用DHT11和DHT22走的是单总线协议虽然接线只有一根数据线但时序要求极其严格读取期间一旦被中断就会出错。ESP32的Wi-Fi任务经常抢占CPU时间导致DHT系列偶尔读到错误数据典型故障就是显示“NaN”或者温度跳到负数。SHT30走I2C协议数据线SDA和时钟线SCL独立时序宽容度高读取出错的概率小得多。再说精度差异。温度±2°C的误差意味着冬天你屋里实际22°CDHT11可能显示20°C而SHT30的±0.3°C就基本能反映真实情况。湿度更是如此DHT11的±5%RH在实际使用中经常出现“浴室湿度71%还是85%”的疑惑追求靠谱数据就直接上SHT30。2.3 显示与按键OLED和交互设计里的细节显示方案选的是0.96英寸SSD1306驱动的OLED屏128×64分辨率I2C接口。SSD1306是一个极其通用的显示驱动在Arduino生态下用Adafruit SSD1306库或者U8g2库都能驱动。我选U8g2因为它内置中文字库直接显示中文不会乱码避免自己处理字模的麻烦。按键设计上我用一个四脚轻触开关做“设置/确认”按钮配合另一个按键做“加/减”调整。按一次进入菜单短按调整数值长按确认退出。按键不多但配合屏幕上的菜单提示可以完成温度阈值、湿度阈值、继电器模式等所有参数设置。实际使用下来一个入门的智能硬件项目交互层级做到“两层菜单”以内是最舒服的太深了你自己都会忘。2.4 继电器与负载安全控制的红线继电器模块负责控制220V交流电的的通断——这一层必须把安全放在所有体验之前。选继电器模块时注意两个关键点触发电平市面上常见的模块有高电平触发和低电平触发两种。ESP32的GPIO默认上电瞬间是低电平我选低电平触发模块并让控制引脚默认置高即默认不吸合这样即使程序跑飞导致引脚复位继电器也不会意外吸合。隔离等级模块上必须有光耦隔离至少要有线圈侧和触点侧的电气隔离。便宜的模块可能省略光耦长期带负载有安全隐患不建议买。接线原则就一条低压区和高压区严格分离。继电器模块的触点端接220V负载走线时尽量远离传感器和OLED的低压线束避免干扰和短路风险。如果你没有把握处理220V建议先接12V的直流风扇或者LED灯带做测试把继电器当“低压开关”跑通逻辑后再考虑交流负载。从零开始接线硬件搭建全程记录3.1 物料清单和工具清单这个项目的物料全家福照着买不亏ESP32 DevKitC开发板 × 1SHT30温湿度传感器模块 × 10.96寸OLED SSD1306 I2C屏 × 15V继电器模块低电平触发 × 1轻触按键 × 2一个菜单/确认一个加/减10KΩ电阻 × 2按键上拉部分模组可省面包板 × 1、杜邦线若干、USB电源5V/2A × 1可选3D打印外壳或ABS塑料盒、DC电源座、接线端子工具方面一把好的剥线钳、电烙铁和万用表是“长期主义”的标配。初期面包板阶段不需要焊接但一旦进入正式组装烙铁温度控制在350°C左右焊点光亮饱满、不虚焊是基本功。3.2 面包板阶段的接线图表面包板阶段的接线逻辑非常简单所有I2C设备挂同一组总线所有控制信号从ESP32引出即可ESP32引脚连接目标说明3V3SHT30 VCC、OLED VCC3.3V供电GNDSHT30 GND、OLED GND、继电器GND公共地GPIO21SHT30 SDA、OLED SDAI2C数据线ESP32默认SDAGPIO22SHT30 SCL、OLED SCLI2C时钟线ESP32默认SCLGPIO15继电器IN低电平触发控制GPIO4按键1菜单/确认GPIO16按键2加减接好以后先别急着写业务代码第一步是烧一个I2C扫描程序。Arduino IDE里直接选“ESP32 Dev Module”上传I2C扫描器串口监视器波特率设115200看是否打印出0x44SHT30和0x3COLED两个地址。如果扫不出来99%是SDA/SCL接反或者供电不足先解决再继续。3.3 先别焊验证最小系统的顺序我的习惯是“最小系统先行”先只接ESP32和OLED屏烧一个“Hello World”显示程序然后加上SHT30串口打印温湿度最后才接继电器和按键。每加一个模块就验证一块功能这样出问题时你永远知道bug在哪一层不用面对一次接好七八根线后“所有设备都不工作”的崩溃现场。这一步非常像炒菜先热锅——真正的高手不是一次炒完而是分阶段控制变量。你如果跳过验证直接焊接到PCB上一旦某个器件损坏拆焊的伤害比返工重新接线大得多。3.4 从面包板到正式组装面包板验证通过后再考虑把系统固定下来。我自己的做法是先用一块5×7cm的洞洞板把ESP32、继电器、传感器端子焊在板子上用接线端子把传感器和继电器引出来方便以后更换元件。然后把板子装进一个便宜的ABS塑料盒电源线从侧面开孔引出OLED屏装在盒盖正面按键装在侧面用热熔胶固定。组装完成后做一次“断电重启测试”拔电再上电确认屏幕显示、继电器默认状态、Wi-Fi重连都正常。做过这个小测试你就能规避掉“焊好了只有插电顺序对了才能用”的尴尬问题。固件开发核心逻辑与代码实现4.1 工程结构与开发环境开发环境用Arduino IDE ESP32开发板包方便资料多适合零基础。项目代码的模块划分main.ino初始化、主循环sensor.h/cppSHT30读取、滤波display.h/cppOLED渲染controller.h/cpp阈值判断、继电器控制webserver.h/cpp手机页面这种模块划分本身也是分层思想的落地。你不需要一开始就写得很完美但至少要给每个“层”建一个文件后面维护起来会舒服很多。4.2 传感器读取与数据平滑SHT30通过I2C返回6个字节温度MSB、LSB、CRC然后是湿度的MSB、LSB、CRC。直接用Adafruit_SHT31库能省不少事但我更建议你读一遍Arduino库源码理解一下原始数据的拼接过程——这是你用I2C总线的基础功。读取后一定要做数据平滑。我采用最简单的“队列滑动平均”维护一个长度为5的数组每次读取新值就丢掉最旧的值取平均。这样大大降低传感器偶发跳变带来的控制抖动。float tempHistory[5] {0}; float humiHistory[5] {0}; int historyIndex 0; float smoothValue(float newValue, float *history, int len, int index) { history[index] newValue; float sum 0; for (int i 0; i len; i) sum history[i]; return sum / len; }4.3 OLED显示与交互界面用U8g2库驱动初始化时指定SSD1306和I2C硬件接口。显示界面分三块第一行当前温度显示为“温度25.3°C”第二行当前湿度“湿度48.2%”第三行继电器状态“控制开启”或“控制关闭”主循环里每秒刷新一次即可不要刷太快OLED是I2C设备刷新过快会占用过多总线时间影响传感器读时序。按键扫描放在主循环里做一个简单的软件消抖检测到按下后延时20ms再读一次确认电平变化。按键短按和长按的区分靠计时变量实现短按切换菜单项长按进入设置模式并保存参数。4.4 自动控制逻辑滞回控制详解控制逻辑是整个项目最体现“产品思维”的地方。如果只在温度低于阈值时开继电器、高于阈值时关继电器会有一个麻烦当温度在阈值附近徘徊时继电器会频繁通断不仅触点寿命急剧下降还会让你觉得这设备“疯了”。解决办法是滞回控制设定“开启阈值”和“关闭阈值”两个阈值之间留一个差值一般2°C左右。比如温度低于26°C开启加湿器或风扇高于28°C关闭。这样只有当温度穿越整个滞回区间时状态才切换一次从根上解决频繁抖动。const float ON_TEMP 26.0; const float OFF_TEMP 28.0; bool relayState false; void updateRelay(float temp) { if (!relayState temp ON_TEMP) { relayState true; digitalWrite(RELAY_PIN, LOW); // 低电平触发吸合 } else if (relayState temp OFF_TEMP) { relayState false; digitalWrite(RELAY_PIN, HIGH); // 释放 } }顺便说一句继电器在吸合/释放瞬间会有“咔哒”声这是正常的。如果你听到的是连续“滴滴滴”快速响那就是没有滞回或者代码逻辑有问题。4.5 手机远程查看ESP32的WebServer实现远程查看功能用ESP32的WebServer库实现。思路是跑一个异步HTTP服务器当你用手机浏览器访问ESP32的IP时返回一个极简HTML页面页面上通过AJAX定时请求/api/status接口拿最新数据。server.on(/api/status, HTTP_GET, [](AsyncWebServerRequest *request) { String json {\temp\: String(currentTemp) ,\humi\: String(currentHumi) ,\relay\: String(relayState) }; request-send(200, application/json, json); });为了不在局域网内每次都得查IP我加了一行mDNS服务访问homeenv.local就能打开页面体验感和智能音箱的管理后台很像。联调、排错与长期运行优化5.1 新手最容易踩的六个坑这个项目做到现在身边至少有几十个朋友照着跑过我整理了一张高频问题速查表现象大概率原因解决办法OLED不亮I2C地址不对或SDA/SCL接反跑I2C扫描器确认0x3C/0x44串口输出乱码波特率不匹配串口监视器设置为115200温度读数跳变成0传感器电源不稳单独给传感器接3.3V避免和继电器共用电源继电器自己咔哒响阈值没有滞回增加2°C滞回区间ESP32反复重启供电电流不足换成5V/2A的USB电源不要用电脑USB口带继电器手机页面打不开ESP32没连上路由器或IP变了串口打印连接结果和IP检查Wi-Fi密码5.2 实战排障记录我自己调试时最折腾的一个问题是“继电器吸合瞬间屏幕闪一下”。现象是继电器每次切换OLED屏都会闪烁半秒有时干脆白屏。排查后发现继电器线圈吸合瞬间电流波动很大直接拉低了3.3V电压导致OLED瞬时欠压。解决方案有两个层面硬件上继电器模块用独立的5V供电不跟ESP32、OLED共用同一个LDO输出软件上避免在显示刷新的中途操作继电器我做了个简单的“锁定标志”当继电器状态切换时显示屏暂停刷新200ms避开电流尖峰。这个问题排查完我对“模块供电隔离”的体会比读十篇文章都深。5.3 长时间稳定运行的三条建议第一看门狗必须加。ESP32在长时间运行中偶尔会因为内存碎片或Wi-Fi异常卡死加一个硬件看门狗Arduino中启用定时器喂狗超时不喂就重启可以让你几个月不用管它。我设置了5小时自动重启一次实测连续跑了三个月没有任何问题。第二数据写入Flash要谨慎。ESP32的Flash写入寿命有限不要每个周期都存数据。我的策略是每10分钟才记录一条最新数据并且用“环形覆盖”的方式只保留最近100条既保留了历史参考又不损耗Flash。第三电源是稳定性的基石。整个系统最容易被忽视的就是供电质量。继电器和主控分开供电传感器用主控的3.3V但要在传感器电源引脚旁边加一个10µF的电解电容滤除纹波。这个小改动让SHT30的读数肉眼可见地稳定下来。项目的横向扩展玩法6.1 从单机到联网接入Home Assistant如果你家里已经有Home Assistant简称HAHomeEnv-Box可以作为MQTT设备接入实现智能家居联动。ESP32上用PubSubClient库把温湿度发布到home/env/temp和home/env/humi然后HA里配置自动化和仪表盘。这样你在手机上用的就不再是简陋的网页而是专业智能家居面板。整个改装代码量不大核心就是增加一个MQTT客户端类在原有采集和显示逻辑上叠加发布逻辑。唯一要注意的是MQTT断线重连机制一定要写好否则路由器一重启设备就“失联”了。6.2 数据记录与可视化的两个方向想把历史数据保存下来两个省事的路线轻量路线ESP32定时把数据通过HTTP POST发给内网的Node-REDNode-RED写SQLite并生成图表。免服务器路线用ThingSpeak这类免费IoT平台ESP32定期GET请求上报数据平台自带曲线图。我这边长期用的是ThingSpeak方案因为不需要额外维护服务器跑了一年后回看湿度全年曲线才真正意识到南方梅雨季和北方冬季供暖的室内湿度差异有多大。6.3 硬件扩展空间HomeEnv-Box这一套框架可以承载的扩展非常多加一块BH1750光照传感器做成“天黑自动亮夜灯”加一个PIR人体红外传感器实现“人走近屏幕才亮”把继电器通道从1路扩到4路控制更多电器加一个DHT22同时监测室内外两个点计算温差这些扩展都不需要推翻原有架构只是在“采集层”增加一个传感器、在“控制层”增加两路IO的事。这也是我一开始强调分层设计的原因——你留出的扩展空间决定了这个项目能被你玩多久。我个人在实际操作中的体会是做DIY智能电子项目最大的收获不是那个最终作品而是建立了一套“硬件选型、分层设计、控制逻辑、长期运行维护”的完整思维方式。HomeEnv-Box做完之后我再去看市面上各类智能家居产品一眼就能看出它们的传感器类型、控制策略和潜在问题。最后分享一个实用小技巧如果你也决定用ESP32做这类项目建议把原理图和数据手册PDF下载保存到本地哪怕现在看不懂等某天排查疑难问题翻出来查绝对比你临时上网搜资料快得多。数据手册才是硬件世界里最权威的“老师”。
基于ESP32的DIY智能环境监测与远程控制小主机实战
如果你也跟我一样曾经对着一抽屉吃灰的电子元件发呆大概率能理解那种感觉想做一个真正能落地、能天天用、还能带出去跟人分享的DIY智能电子项目但翻遍教程要么只讲单点功能要么一上来就是一堆晦涩的电路图。我前后折腾过十几个方案最后锁定了一个特别朴素但极其实用的方向——做一个能实时监测环境、自动控制电器、还能用手机远程查看状态的小主机。这篇文章就把这个项目从设计思路、硬件选型、接线、固件开发到排错优化的完整过程写下来整个过程零基础也能跟着跑通而且所有代码和接线图都在后面给出你完全可以照着“抄作业”。项目全貌拆解与设计思路1.1 这个项目到底在做什么这个DIY智能电子项目本质上是一个“环境监测 设备控制 远程查看”的小型智能中枢。我给它起名叫 HomeEnv-Box一个巴掌大的小盒子放在客厅或者书桌上每隔几秒采集一次温湿度数据实时显示在自带的小屏幕上同时根据预设的温度阈值自动控制一路继电器的开关比如冬天自动开关加湿器、夏天自动启动风扇再通过板载Wi-Fi让手机浏览器随时看到当前环境数据和运行状态。为什么要做这样一个东西而不是只做一个“炫技”的跑马灯或者温湿度计因为一个合格的DIY项目不能只是“点亮一个屏”就完事。HomeEnv-Box覆盖了完整的产品级链路数据采集、逻辑处理、人机交互、执行控制、远程通信。这个链路是绝大多数智能硬件项目的通用骨架——你做智能鱼缸、智能花盆、智能门禁本质上都跑不出这个框架。所以这个项目的价值不只是“做出一个东西”而是通过它把整个嵌入式开发的思维方式跑一遍。1.2 设计上的三个关键取舍第一主控选型要用ESP32而不是Arduino Uno。原因很简单ESP32自带Wi-Fi和蓝牙算力、内存、存储都大一个量级价格却和Uno差不多。如果用Uno想联网还得外挂ESP8266模块串口资源被占掉一大半代码逻辑被割裂成两套调试痛苦翻倍。ESP32用一套代码搞定采集、显示、联网和控制这对初学者友好太多了。第二传感器不能只图便宜。DHT11只要几块钱网上也一堆教程但它的精度是±2°C和±5%RH读数跳变、响应慢做演示可以做“真正每天用”的东西就不太够了。我最终选了SHT30数字I2C接口精度高价格也就十几块。这个取舍在后面“传感器选型”里详细说。第三交互方式坚持“屏幕 按键 手机”三条腿走路。屏幕负责本地直观显示按键负责不需要联网就能设置阈值手机页面负责远距离查看。很多DIY项目只做手机App一旦局域网断了就抓瞎实体屏幕和按键在这种时候反而最可靠。1.3 整体架构采集、处理、显示、控制四层模型HomeEnv-Box的逻辑可以拆成四层采集层SHT30温湿度传感器通过I2C总线把物理信号变成数字信号。处理层ESP32主控读取原始数据做平滑滤波、阈值判断同时管理按键输入和Wi-Fi服务。显示层0.96英寸OLED显示屏本地呈现即时数据和设备状态。控制层继电器模块根据处理层的指令接通或切断负载电源。这个分层思维是嵌入式项目的通用骨架。不管以后做多复杂的系统只要你保持“采集端、控制端、决策端互不纠缠”代码可维护性就会好很多。HomeEnv-Box的代码我就明显感受到分层清晰之后排错特别轻松——数据不对就去查传感器控制不对就去查继电器逻辑互不干扰。核心硬件选型与原理详解2.1 主控板ESP32凭什么是最优解这里给的结论不是“ESP32最好”而是“ESP32最适合这个项目”。ESP32的双核240MHz处理器应对这种轻量任务绰绰有余520KB SRAM、4MB Flash跑一个WebServer同时处理传感器中断都毫无压力。更关键的是ESP32的Arduino生态非常成熟库函数丰富DHT/SHT驱动、OLED驱动、Wi-Fi库全都现成对新手极其友好。如果你以前只玩过Arduino Uno你会发现ESP32的开发体验几乎是无缝迁移的除了引脚编号、ADC精度这些细节基本没有额外学习成本。接线层面我选择的是板上带有型USB口的ESP32 DevKitC开发板直接USB供电和烧录初期调试不用额外买USB转TTL工具。如果你手头的是NodeMCU-32S之类的板子使用方式也完全相同。2.2 传感器选型温湿度监测的精度与成本博弈温湿度传感器是环境监测类项目的灵魂。我做了个简单对比型号接口精度温度/湿度单颗参考价适合场景DHT11单总线±2°C / ±5%RH3~5元纯入门演示DHT22单总线±0.5°C / ±2%RH10~15元性价比之选SHT30I2C±0.3°C / ±2%RH12~18元长期监测、本项目使用DHT11和DHT22走的是单总线协议虽然接线只有一根数据线但时序要求极其严格读取期间一旦被中断就会出错。ESP32的Wi-Fi任务经常抢占CPU时间导致DHT系列偶尔读到错误数据典型故障就是显示“NaN”或者温度跳到负数。SHT30走I2C协议数据线SDA和时钟线SCL独立时序宽容度高读取出错的概率小得多。再说精度差异。温度±2°C的误差意味着冬天你屋里实际22°CDHT11可能显示20°C而SHT30的±0.3°C就基本能反映真实情况。湿度更是如此DHT11的±5%RH在实际使用中经常出现“浴室湿度71%还是85%”的疑惑追求靠谱数据就直接上SHT30。2.3 显示与按键OLED和交互设计里的细节显示方案选的是0.96英寸SSD1306驱动的OLED屏128×64分辨率I2C接口。SSD1306是一个极其通用的显示驱动在Arduino生态下用Adafruit SSD1306库或者U8g2库都能驱动。我选U8g2因为它内置中文字库直接显示中文不会乱码避免自己处理字模的麻烦。按键设计上我用一个四脚轻触开关做“设置/确认”按钮配合另一个按键做“加/减”调整。按一次进入菜单短按调整数值长按确认退出。按键不多但配合屏幕上的菜单提示可以完成温度阈值、湿度阈值、继电器模式等所有参数设置。实际使用下来一个入门的智能硬件项目交互层级做到“两层菜单”以内是最舒服的太深了你自己都会忘。2.4 继电器与负载安全控制的红线继电器模块负责控制220V交流电的的通断——这一层必须把安全放在所有体验之前。选继电器模块时注意两个关键点触发电平市面上常见的模块有高电平触发和低电平触发两种。ESP32的GPIO默认上电瞬间是低电平我选低电平触发模块并让控制引脚默认置高即默认不吸合这样即使程序跑飞导致引脚复位继电器也不会意外吸合。隔离等级模块上必须有光耦隔离至少要有线圈侧和触点侧的电气隔离。便宜的模块可能省略光耦长期带负载有安全隐患不建议买。接线原则就一条低压区和高压区严格分离。继电器模块的触点端接220V负载走线时尽量远离传感器和OLED的低压线束避免干扰和短路风险。如果你没有把握处理220V建议先接12V的直流风扇或者LED灯带做测试把继电器当“低压开关”跑通逻辑后再考虑交流负载。从零开始接线硬件搭建全程记录3.1 物料清单和工具清单这个项目的物料全家福照着买不亏ESP32 DevKitC开发板 × 1SHT30温湿度传感器模块 × 10.96寸OLED SSD1306 I2C屏 × 15V继电器模块低电平触发 × 1轻触按键 × 2一个菜单/确认一个加/减10KΩ电阻 × 2按键上拉部分模组可省面包板 × 1、杜邦线若干、USB电源5V/2A × 1可选3D打印外壳或ABS塑料盒、DC电源座、接线端子工具方面一把好的剥线钳、电烙铁和万用表是“长期主义”的标配。初期面包板阶段不需要焊接但一旦进入正式组装烙铁温度控制在350°C左右焊点光亮饱满、不虚焊是基本功。3.2 面包板阶段的接线图表面包板阶段的接线逻辑非常简单所有I2C设备挂同一组总线所有控制信号从ESP32引出即可ESP32引脚连接目标说明3V3SHT30 VCC、OLED VCC3.3V供电GNDSHT30 GND、OLED GND、继电器GND公共地GPIO21SHT30 SDA、OLED SDAI2C数据线ESP32默认SDAGPIO22SHT30 SCL、OLED SCLI2C时钟线ESP32默认SCLGPIO15继电器IN低电平触发控制GPIO4按键1菜单/确认GPIO16按键2加减接好以后先别急着写业务代码第一步是烧一个I2C扫描程序。Arduino IDE里直接选“ESP32 Dev Module”上传I2C扫描器串口监视器波特率设115200看是否打印出0x44SHT30和0x3COLED两个地址。如果扫不出来99%是SDA/SCL接反或者供电不足先解决再继续。3.3 先别焊验证最小系统的顺序我的习惯是“最小系统先行”先只接ESP32和OLED屏烧一个“Hello World”显示程序然后加上SHT30串口打印温湿度最后才接继电器和按键。每加一个模块就验证一块功能这样出问题时你永远知道bug在哪一层不用面对一次接好七八根线后“所有设备都不工作”的崩溃现场。这一步非常像炒菜先热锅——真正的高手不是一次炒完而是分阶段控制变量。你如果跳过验证直接焊接到PCB上一旦某个器件损坏拆焊的伤害比返工重新接线大得多。3.4 从面包板到正式组装面包板验证通过后再考虑把系统固定下来。我自己的做法是先用一块5×7cm的洞洞板把ESP32、继电器、传感器端子焊在板子上用接线端子把传感器和继电器引出来方便以后更换元件。然后把板子装进一个便宜的ABS塑料盒电源线从侧面开孔引出OLED屏装在盒盖正面按键装在侧面用热熔胶固定。组装完成后做一次“断电重启测试”拔电再上电确认屏幕显示、继电器默认状态、Wi-Fi重连都正常。做过这个小测试你就能规避掉“焊好了只有插电顺序对了才能用”的尴尬问题。固件开发核心逻辑与代码实现4.1 工程结构与开发环境开发环境用Arduino IDE ESP32开发板包方便资料多适合零基础。项目代码的模块划分main.ino初始化、主循环sensor.h/cppSHT30读取、滤波display.h/cppOLED渲染controller.h/cpp阈值判断、继电器控制webserver.h/cpp手机页面这种模块划分本身也是分层思想的落地。你不需要一开始就写得很完美但至少要给每个“层”建一个文件后面维护起来会舒服很多。4.2 传感器读取与数据平滑SHT30通过I2C返回6个字节温度MSB、LSB、CRC然后是湿度的MSB、LSB、CRC。直接用Adafruit_SHT31库能省不少事但我更建议你读一遍Arduino库源码理解一下原始数据的拼接过程——这是你用I2C总线的基础功。读取后一定要做数据平滑。我采用最简单的“队列滑动平均”维护一个长度为5的数组每次读取新值就丢掉最旧的值取平均。这样大大降低传感器偶发跳变带来的控制抖动。float tempHistory[5] {0}; float humiHistory[5] {0}; int historyIndex 0; float smoothValue(float newValue, float *history, int len, int index) { history[index] newValue; float sum 0; for (int i 0; i len; i) sum history[i]; return sum / len; }4.3 OLED显示与交互界面用U8g2库驱动初始化时指定SSD1306和I2C硬件接口。显示界面分三块第一行当前温度显示为“温度25.3°C”第二行当前湿度“湿度48.2%”第三行继电器状态“控制开启”或“控制关闭”主循环里每秒刷新一次即可不要刷太快OLED是I2C设备刷新过快会占用过多总线时间影响传感器读时序。按键扫描放在主循环里做一个简单的软件消抖检测到按下后延时20ms再读一次确认电平变化。按键短按和长按的区分靠计时变量实现短按切换菜单项长按进入设置模式并保存参数。4.4 自动控制逻辑滞回控制详解控制逻辑是整个项目最体现“产品思维”的地方。如果只在温度低于阈值时开继电器、高于阈值时关继电器会有一个麻烦当温度在阈值附近徘徊时继电器会频繁通断不仅触点寿命急剧下降还会让你觉得这设备“疯了”。解决办法是滞回控制设定“开启阈值”和“关闭阈值”两个阈值之间留一个差值一般2°C左右。比如温度低于26°C开启加湿器或风扇高于28°C关闭。这样只有当温度穿越整个滞回区间时状态才切换一次从根上解决频繁抖动。const float ON_TEMP 26.0; const float OFF_TEMP 28.0; bool relayState false; void updateRelay(float temp) { if (!relayState temp ON_TEMP) { relayState true; digitalWrite(RELAY_PIN, LOW); // 低电平触发吸合 } else if (relayState temp OFF_TEMP) { relayState false; digitalWrite(RELAY_PIN, HIGH); // 释放 } }顺便说一句继电器在吸合/释放瞬间会有“咔哒”声这是正常的。如果你听到的是连续“滴滴滴”快速响那就是没有滞回或者代码逻辑有问题。4.5 手机远程查看ESP32的WebServer实现远程查看功能用ESP32的WebServer库实现。思路是跑一个异步HTTP服务器当你用手机浏览器访问ESP32的IP时返回一个极简HTML页面页面上通过AJAX定时请求/api/status接口拿最新数据。server.on(/api/status, HTTP_GET, [](AsyncWebServerRequest *request) { String json {\temp\: String(currentTemp) ,\humi\: String(currentHumi) ,\relay\: String(relayState) }; request-send(200, application/json, json); });为了不在局域网内每次都得查IP我加了一行mDNS服务访问homeenv.local就能打开页面体验感和智能音箱的管理后台很像。联调、排错与长期运行优化5.1 新手最容易踩的六个坑这个项目做到现在身边至少有几十个朋友照着跑过我整理了一张高频问题速查表现象大概率原因解决办法OLED不亮I2C地址不对或SDA/SCL接反跑I2C扫描器确认0x3C/0x44串口输出乱码波特率不匹配串口监视器设置为115200温度读数跳变成0传感器电源不稳单独给传感器接3.3V避免和继电器共用电源继电器自己咔哒响阈值没有滞回增加2°C滞回区间ESP32反复重启供电电流不足换成5V/2A的USB电源不要用电脑USB口带继电器手机页面打不开ESP32没连上路由器或IP变了串口打印连接结果和IP检查Wi-Fi密码5.2 实战排障记录我自己调试时最折腾的一个问题是“继电器吸合瞬间屏幕闪一下”。现象是继电器每次切换OLED屏都会闪烁半秒有时干脆白屏。排查后发现继电器线圈吸合瞬间电流波动很大直接拉低了3.3V电压导致OLED瞬时欠压。解决方案有两个层面硬件上继电器模块用独立的5V供电不跟ESP32、OLED共用同一个LDO输出软件上避免在显示刷新的中途操作继电器我做了个简单的“锁定标志”当继电器状态切换时显示屏暂停刷新200ms避开电流尖峰。这个问题排查完我对“模块供电隔离”的体会比读十篇文章都深。5.3 长时间稳定运行的三条建议第一看门狗必须加。ESP32在长时间运行中偶尔会因为内存碎片或Wi-Fi异常卡死加一个硬件看门狗Arduino中启用定时器喂狗超时不喂就重启可以让你几个月不用管它。我设置了5小时自动重启一次实测连续跑了三个月没有任何问题。第二数据写入Flash要谨慎。ESP32的Flash写入寿命有限不要每个周期都存数据。我的策略是每10分钟才记录一条最新数据并且用“环形覆盖”的方式只保留最近100条既保留了历史参考又不损耗Flash。第三电源是稳定性的基石。整个系统最容易被忽视的就是供电质量。继电器和主控分开供电传感器用主控的3.3V但要在传感器电源引脚旁边加一个10µF的电解电容滤除纹波。这个小改动让SHT30的读数肉眼可见地稳定下来。项目的横向扩展玩法6.1 从单机到联网接入Home Assistant如果你家里已经有Home Assistant简称HAHomeEnv-Box可以作为MQTT设备接入实现智能家居联动。ESP32上用PubSubClient库把温湿度发布到home/env/temp和home/env/humi然后HA里配置自动化和仪表盘。这样你在手机上用的就不再是简陋的网页而是专业智能家居面板。整个改装代码量不大核心就是增加一个MQTT客户端类在原有采集和显示逻辑上叠加发布逻辑。唯一要注意的是MQTT断线重连机制一定要写好否则路由器一重启设备就“失联”了。6.2 数据记录与可视化的两个方向想把历史数据保存下来两个省事的路线轻量路线ESP32定时把数据通过HTTP POST发给内网的Node-REDNode-RED写SQLite并生成图表。免服务器路线用ThingSpeak这类免费IoT平台ESP32定期GET请求上报数据平台自带曲线图。我这边长期用的是ThingSpeak方案因为不需要额外维护服务器跑了一年后回看湿度全年曲线才真正意识到南方梅雨季和北方冬季供暖的室内湿度差异有多大。6.3 硬件扩展空间HomeEnv-Box这一套框架可以承载的扩展非常多加一块BH1750光照传感器做成“天黑自动亮夜灯”加一个PIR人体红外传感器实现“人走近屏幕才亮”把继电器通道从1路扩到4路控制更多电器加一个DHT22同时监测室内外两个点计算温差这些扩展都不需要推翻原有架构只是在“采集层”增加一个传感器、在“控制层”增加两路IO的事。这也是我一开始强调分层设计的原因——你留出的扩展空间决定了这个项目能被你玩多久。我个人在实际操作中的体会是做DIY智能电子项目最大的收获不是那个最终作品而是建立了一套“硬件选型、分层设计、控制逻辑、长期运行维护”的完整思维方式。HomeEnv-Box做完之后我再去看市面上各类智能家居产品一眼就能看出它们的传感器类型、控制策略和潜在问题。最后分享一个实用小技巧如果你也决定用ESP32做这类项目建议把原理图和数据手册PDF下载保存到本地哪怕现在看不懂等某天排查疑难问题翻出来查绝对比你临时上网搜资料快得多。数据手册才是硬件世界里最权威的“老师”。
