ESP32 水族箱/爬虫箱控制器
esp32-aquarium-controller
已发布
项目简介
基于ESP32的水族箱/雨林缸控制器。
这是一个基于ESP32的开源智能环境控制器，专为水族箱和爬宠饲养箱设计。项目的诞生源于作者朋友的需求——为宠物蛇打造一个能精确调控温湿度的生存环境。核心硬件采用ESP32微控制器，通过连接温湿度传感器实时采集数据，并利用4路继电器输出模块控制加热灯、加湿器、风扇等外围设备，实现自动化闭环调节。技术栈方面，固件基于PlatformIO和Arduino框架开发，集成了异步Web服务器，用户可通过浏览器访问HTML控制界面进行参数设置和状态监控，网页资源存储在ESP32的SPIFFS文件系统中。该项目解决了爬宠饲养中环境参数波动大、人工调节繁琐的痛点，尤其适合需要24小时恒温恒湿的蛇类、蜥蜴等冷血动物饲养场景，也可扩展用于植物培育箱或小型温室。值得注意的是，当前版本（revA）存在一些已知问题：电源模块封装错误需反向安装、缺少安装孔位、与特定外壳的匹配需要调整。此外，由于涉及220V市电控制，项目明确标注了安全警告，要求使用者具备电气知识。整体而言，这是一个功能完整但处于原型阶段的实用型物联网项目，适合有一定硬件基础的爱好者进行二次开发或直接购买成品板。
标签
项目特点
**ESP32 核心**：使用 ESP32 模块作为主控，具备 Wi-Fi 和蓝牙功能，可实现远程监控和控制。
**4路继电器输出**：可独立控制加热、加湿、照明等设备，灵活调节环境。
**传感器驱动**：通过传感器采集温湿度数据，实现闭环自动控制。
**异步Web服务器**：提供 HTML 页面进行本地配置和状态查看（需上传 SPIFFS 数据）。
**开源硬件与软件**：PCB 设计文件和固件代码完全开源，方便修改和定制。
**可购买成品**：作者在 Tindie 商店提供组装好的电路板，方便不想自行焊接的用户。
技术规格
| 主控芯片 | ESP32 |
|---|---|
| 继电器数量 | 4 路 |
| 输入电源 | 市电（需注意安全） |
| 固件平台 | PlatformIO + Arduino |
| Web服务器 | 异步 Web 服务器（AsyncWebServer） |
| 文件系统 | SPIFFS（用于存储 HTML 页面） |
| 已知问题 (revA) | 电源模块封装错误（需反装）、无安装孔、外壳适配需调整 |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| ESP32 模块 | 1 | — | 核心处理器 |
| 继电器模块 (5V) | 4 | — | 控制外部设备 |
| 电源模块 (AC-DC) | 1 | — | 需注意 revA 封装错误 |
| 温湿度传感器 (如 DHT22) | 1 | — | 用于环境监测 |
| PCB (revA) | 1 | — | 自行打样或购买成品 |
| 接线端子、电阻、电容等 | 若干 | — | 详见原理图 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| 电脑 | 开发、编译、烧录固件 | ✅ 是 |
| USB数据线 | 连接ESP32到电脑 | ✅ 是 |
| 焊台 | 焊接面包板电路 | ▢ 推荐 |
| 万用表 | 测量电压、电阻 | ▢ 推荐 |
| 树莓派 | 运行MQTT broker和服务端 | ✅ 是 |
能力画像
⚪ 记忆与知识检索: 2/5
🔵 逻辑推演: 3/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 2/5
⚪ 数理与计算: 3/5
⚪ 动手与操作: 4/5
⚪ 狂热与坚持: 3/5
⚪ 创造与创新: 3/5
项目图库
视频
Hlmbx2yu9M0
所需技能
🔧 **动手能力**：需要熟练的焊接技能，能够处理 PCB 上的 SMD 和 DIP 元件；具备基本的电子组装和接线能力，尤其涉及市电连接时需格外小心。
💻 **编程能力**：需要了解 PlatformIO 和 Arduino 框架，能够编译和上传固件到 ESP32；熟悉 SPIFFS 文件系统操作，能够上传 HTML 页面。
⚡ **电子电路**：需要理解继电器驱动电路、传感器接口和电源模块的基本原理；能够阅读原理图并根据已知问题（如 revA 的封装错误）进行调整。
适用场景
为蛇、蜥蜴等爬行动物的饲养箱提供恒温恒湿环境控制。
水族箱的自动加热、照明、过滤等设备控制。
小型温室或植物培育箱的环境监测与调节。
作为学习 ESP32 物联网应用和硬件设计的教学项目。