待补充
theyosh/TerrariumPI
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Home automated terrarium/aquarium or other enclosed environment with a Raspberry Pi
TerrariumPI 是一款专为爬虫饲养箱、水族箱、温室等封闭环境设计的开源智能家居控制软件，至今已稳定运行超过10年。它的核心使命是帮助用户以低成本实现环境自动化管理，让温度、湿度等关键指标保持恒定，从而为动植物提供稳定舒适的生存条件。
标签
项目特点
**多传感器支持**：兼容 DHT22、DS18B20、BME280、AM2302 等多种温湿度传感器，灵活搭配。
**多路控制输出**：支持继电器、调光器、水泵、风扇、加热灯等设备，实现闭环自动调节。
**Web 可视化面板**：提供实时仪表盘、历史曲线、报警通知，手机电脑都能访问。
**定时与触发规则**：可设置时间计划、阈值触发、联动逻辑，满足复杂环境控制需求。
**低功耗长期运行**：基于树莓派 Zero/3B/4B，功耗低，适合 7×24 小时无人值守。
**插件化扩展**：支持摄像头、MQTT、GPIO 扩展板、I2C 设备等，功能可自由组合。
技术规格
| 硬件平台 | Raspberry Pi Zero / 3B / 3B+ / 4B |
|---|---|
| 操作系统 | Raspberry Pi OS (32-bit) Lite / Desktop |
| 编程语言 | Python 3 |
| Web 框架 | Flask |
| 数据库 | SQLite |
| 传感器接口 | GPIO (I2C / 1-Wire / SPI) |
| 支持传感器 | DHT22, DS18B20, BME280, AM2302, SHT30, BH1750, MLX90614 等 |
| 控制输出 | GPIO 继电器 / MOSFET / PWM 调光 / 步进电机 |
| 通信协议 | MQTT, HTTP API, WebSocket |
| 显示支持 | OLED SSD1306, LCD 1602/2004 (I2C) |
| 摄像头 | Raspberry Pi Camera Module / USB 摄像头 |
| 电源要求 | 5V DC (2.5A 以上推荐) |
| 存储要求 | 最小 8GB microSD 卡 |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Raspberry Pi 3B+ / 4B | 1 | — | 推荐 2GB RAM 以上 |
| microSD 卡 16GB+ | 1 | — | Class 10 以上 |
| 5V 3A USB-C 电源适配器 | 1 | — | 树莓派专用 |
| DHT22 / AM2302 | 1-3 | — | 精度 ±0.5°C |
| DS18B20 (防水型) | 1-5 | — | 1-Wire 接口 |
| BME280 | 1 | — | I2C 接口 |
| BH1750 | 1 | — | I2C 接口 |
| 2路/4路 5V 继电器 | 1-2 | — | 控制加热/灯光/水泵 |
| MOSFET PWM 调光器 | 1 | — | 控制灯带亮度 |
| 12V 散热风扇 | 1-2 | — | 配合继电器使用 |
| OLED 128x64 (SSD1306) | 1 | — | I2C 接口，可选 |
| Raspberry Pi Camera v2 | 1 | — | 可选，用于监控 |
| 公对母/公对公 | 若干 | — | 连接传感器 |
| 830 孔面包板 | 1 | — | 原型搭建 |
能力画像
**记忆与知识检索**：3/5 — 需要查阅传感器接线图、GPIO 引脚定义和官方文档，但大部分信息集中在一个 Wiki 里。
**动手与操作**：4/5 — 需要焊接、接线、固定传感器和继电器，适合有一定手工基础的爱好者。
**编程与算法**：2/5 — 基本不需要写代码，配置文件即可；如需自定义逻辑则需要 Python 基础。
**设计与建模**：1/5 — 不涉及 3D 建模或 PCB 设计，但可自行设计外壳。
**实验与调试**：4/5 — 需要反复测试传感器读数、继电器动作、网络连接，调试过程较多。
**协作与分享**：3/5 — 可通过 GitHub Issues 和 Wiki 贡献，社区活跃度中等。
**学习与研究**：4/5 — 能学到树莓派 GPIO、传感器协议、PID 控制、Web 服务搭建等实用技能。
**系统集成**：3/5 — 支持 MQTT 和 HTTP API，可接入 Home Assistant 等智能家居平台。
项目图库
视频
所需技能
基础电子知识（电压、电流、GPIO 引脚）
树莓派系统安装与 SSH 操作
简单的 Python 脚本阅读与修改
传感器接线与面包板搭建
基本的 Linux 命令行操作（文件编辑、服务管理）
网络配置（静态 IP、Wi-Fi 设置）
适用场景
爬虫饲养箱（蜥蜴、蛇、龟）的温度与湿度自动控制
水族箱的灯光定时、水温监测与过滤泵控制
小型温室或植物培育箱的环境自动化
昆虫饲养箱（螳螂、甲虫）的昼夜节律模拟
实验室或教学用的低成本环境监测平台
智能家居 DIY 爱好者的传感器与控制实践项目