四根线接上传感器,记录阳台一天的温湿度变化
用树莓派和BME280记录植物周围的温度、湿度与气压,在同一局域网的手机浏览器查看实时数字和历史曲线。本页是基于Mycodo官方支持器件整理的监测入门方案;自动浇水、灯光和水培控制属于后续扩展,不在本页BOM内。
alan000
准备 Raspberry Pi 4(或带标准 40 针 GPIO 的兼容 Pi)、BME280 温湿度气压模块、四根母对母跳线、microSD 卡、Pi 电源和局域网。检查传感器芯片/包装确认为 BME280;BMP280 不含湿度测量,不能代替。
1. 对照传感器板上的 `VIN/3V`、`GND`、`SDA`、`SCL` 丝印,确认四个引脚都可识别。
2. 准备能稳定固定小板的非导电支架或外壳,避免模块触碰 Pi 的金属接口。
3. 将电脑、Pi 和手机接入同一局域网;Pi 第一次启动前准备系统卡。
检查:BME280 型号和四个引脚标识清楚,四根跳线和电源已备齐。
[Adafruit BME280 模块资料](https://www.adafruit.com/product/2652)
在 Storage 页面按读卡器名称和容量选中 microSD,再点 NEXT。图中的 29.7 GB 是原厂示例容量,实际以你的卡为准。
图片:[Raspberry Pi 官方文档](https://github.com/raspberrypi/documentation/blob/master/documentation/asciidoc/computers/getting-started/images/imager/storage-tab.png) · [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) · 原图
为 Mycodo 8.17.0 准备 Raspberry Pi OS 13 Trixie。该版本官方 README 测试 Lite/Desktop、32/64 位版本。
1. 在电脑打开 Raspberry Pi Imager,选择对应的 Raspberry Pi 机型,再选 Raspberry Pi OS 13 Trixie(Lite 或 Desktop)。
2. 选择专用 microSD 卡作为存储目标;确认设备名称和容量后再开始写入,此操作会覆盖卡内数据。
3. 在 Imager 设置中配置 Wi-Fi 国家、SSID/密码、主机名和 SSH(若采用无屏远程管理),然后写卡并安全弹出。
4. 将卡插入 Pi,连接路由器和电源;从路由器客户端列表查出 Pi 的 IP,或使用设置的主机名通过 SSH 登录。
检查:Pi 完成启动并能从同一网络登录;记录系统发行版与 IP/主机名。
[Raspberry Pi Imager](https://www.raspberrypi.com/software/) · [Mycodo 8.17.0 系统要求](https://github.com/kizniche/Mycodo/blob/v8.17.0/README.rst)
先拔掉 Pi 电源。BME280 的四个信号按传感器丝印接到 Pi 物理针脚:VIN/3V → 1 号(3.3V),GND → 6 号(Ground),SDA → 3 号(GPIO2/SDA1),SCL → 5 号(GPIO3/SCL1)。图中线色仅作识别辅助,以两端丝印和针脚编号为准。
1. 传感器板 VIN/3V 接 Pi 物理针脚 1;不要接 5V 针脚。
2. 传感器 GND 接物理针脚 6。
3. 传感器 SDA 接物理针脚 3,SCL 接物理针脚 5;区分物理编号与 BCM GPIO 编号。
4. 轻拉每根杜邦线确认已插到底,检查两根电源线未短接。
检查:四根线两端与上述映射一致,Pi 仍断电,传感器板没有反插/松脱。
[Adafruit BME280 接线与 I²C 指南](https://learn.adafruit.com/adafruit-bme280-humidity-barometric-pressure-temperature-sensor-breakout)
把 BME280 放在待观测空气中,并与 Pi、电源适配器和其他发热部件分开;不要浸水或让冷凝水滴落到板上。
1. 将传感器固定在外壳外侧或通风开口处,传感器周围留出空气流通空间。
2. 避免紧贴 Pi CPU、散热器、窗玻璃、加湿器喷口或直射阳光;这些位置会改变局部读数。
3. 整理线束,防止模块悬垂拉扯 GPIO 排针;再次检查第 3 步接线后给 Pi 接电。
4. 在登录终端检查系统正常启动;若出现反复重启或传感器发热,先断电检查线路。
检查:传感器固定、远离 Pi 热源和水滴,Pi 稳定启动。
用方向键选中 3 Interface Options,回车后选择 I2C 并启用。截图来自 Raspberry Pi 官方文档,顶部 Pi 5 是示例机型。
图片:[Raspberry Pi 官方文档](https://github.com/raspberrypi/documentation/blob/master/documentation/asciidoc/computers/configuration/images/raspi-config.png) · [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) · 原图
在 Pi 终端运行配置工具,启用 I²C 接口并重启。
1. 执行 `sudo raspi-config`。
2. 打开 `Interface Options` → `I2C`,选择启用并确认。
3. 选择 `Finish`,按提示重启:`sudo reboot`。
4. 重连 Pi 后运行 `sudo apt update && sudo apt install -y i2c-tools`,再用 `i2cdetect -y 1` 检查 I²C 总线 1;BME280 常见地址应显示为 0x76 或 0x77。
检查:扫描表出现与传感器地址对应的 `76` 或 `77`;若未出现,关机后复查 SDA/SCL、电源、地线与 I²C 启用状态,不在 Mycodo 中猜地址。
[Raspberry Pi 官方 raspi-config/I²C 文档](https://www.raspberrypi.com/documentation/computers/configuration.html)
在 Pi 终端启动官方安装器。安装器会下载最新发布版;本教程的菜单和驱动核对版本为 v8.17.0。安装会修改系统并安装服务,建议在专用 Pi 上执行。
1. 确认 Pi 使用 Debian 系 Raspberry Pi OS 13 Trixie 且网络可访问安装源。
2. 登录 Pi 的终端,运行官方命令:`curl -L https://kizniche.github.io/Mycodo/install | bash`,按脚本提示完成设置;不要中途关闭终端。
3. 安装结束后查看 `/opt/Mycodo/install/setup.log` 末尾,确认没有 error/failed。
4. 在同一局域网的手机或电脑浏览器打开 `https://<Pi的IP地址>/`,接受本地 HTTPS 证书提示后进入 Mycodo,按页面引导创建自己的管理员账户。
检查:Mycodo 登录页可打开,安装日志以成功完成结束;在网页页脚查看并记录实际版本。若版本已高于 8.17.0,先对照该版本说明检查后续输入和 Dashboard 菜单。
[v8.17.0 发布说明及安装命令](https://github.com/kizniche/Mycodo/releases/tag/v8.17.0) · [Mycodo 官方手册](https://kizniche.github.io/Mycodo/)
Mycodo 8.17.0 内置 `BME280` Bosch 输入模块;添加时它会检测并安装所需 Python 依赖。
1. 登录后从左侧菜单打开 `Setup` → `Input`。
2. 点击添加输入控件,在设备/模块列表选择 `BME280`(制造商 Bosch,测量名称 Pressure/Humidity/Temperature)。不要选 BMP280 或自定义 CircuitPython 模块。
3. 如页面询问安装模块依赖,确认安装;等待安装状态完成后回到该输入配置页。
4. 给输入命名,例如 `Room BME280`,便于后续在图表中区分。
检查:Input 列表出现该 BME280 实例,配置表单显示地址、测量项和周期选项;无安装错误。
[Mycodo Input 操作说明](https://kizniche.github.io/Mycodo/Inputs/) · [v8.17.0 BME280 驱动源码](https://github.com/kizniche/Mycodo/blob/v8.17.0/mycodo/inputs/bme280.py)
将输入配置与第 5 步扫描到的地址对应,再开启三项环境测量。
1. 在 BME280 表单的 I²C Address/Location 下拉框选择扫描结果:`0x76` 或 `0x77`;地址选项由 v8.17.0 驱动限定。保留当前 Raspberry Pi I²C bus 设置,不要把物理针脚号当成总线号。
2. 在 Measurements 中启用 Temperature、Humidity 和 Pressure;其余 dewpoint、altitude、VPD 为可选计算量,本次基础记录可不选。
3. 将 Period 设为 `60` 秒作为一分钟采样间隔,然后保存输入配置并点 Activate。
4. 先等待一个采样周期,再打开该输入的测量/状态视图;若未出值,先核对地址与第 5 步扫描,不把气压 Pa 当成温度或湿度读数。
检查:Input 状态为 active,三项测量出现带时间戳的数值;温度单位为 °C、湿度为百分比、压力存储单位为 Pa。
[Mycodo v8.17.0 BME280 地址/测量定义](https://github.com/kizniche/Mycodo/blob/v8.17.0/mycodo/inputs/bme280.py) · [Period、Activate 与测量说明](https://kizniche.github.io/Mycodo/Inputs/)
用 Dashboard 的图表组件查看 BME280 的连续读数。
1. 从左侧菜单打开 `Data` → `Dashboard`。
2. 新建或编辑一个 Dashboard,点击添加 Dashboard Widget,选择图表/Graph 类组件并打开配置。
3. 在贡献项/数据源列表中选择本次 BME280 Input 的 temperature、humidity、pressure 通道;分别配置或将可比单位的测量放入同一图表。温度、湿度与气压量纲不同,初次可分三张图。
4. 设置可查看的时间窗口并创建组件;拖动组件调整布局。手机浏览器打开同一 Pi 地址即可访问。
检查:Dashboard 显示带时间轴的三条数据,横坐标持续延伸;手机和电脑在局域网都能打开该页面。旧截图为 Mycodo 5.2.0,仅作效果参考,当前 v8.17.0 控件外观不同。
[Mycodo 官方 Dashboard 与 Widget 文档](https://kizniche.github.io/Mycodo/Data-Viewing/)

连续记录一个昼夜,核对读数变化与放置环境,并导出配置。
1. 保持 BME280 输入 active 至少 24 小时;在 Dashboard 选择完整时间范围,确认各项曲线有连续时间戳。
2. 记录开窗、加湿、人员活动等可观察事件,比较曲线在事件前后的变化;如温度持续偏高,检查是否靠近 Pi 或阳光直射。
3. 可将传感器与另一支温湿度计并排放置一段时间进行读数对照;记录两者差值,并把对照结果附在记录中。
4. 用 Mycodo 的 Export/Backup 功能保存系统配置,并另存设备版本、传感器地址和接线照片;确认备份文件存在。
检查:Dashboard 可回看 24 小时,事件时间与曲线可对照,配置备份能在文件管理器中看到。
[Mycodo 官方备份与恢复说明](https://kizniche.github.io/Mycodo/Upgrade-Backup-Restore/) · [Mycodo 数据查看说明](https://kizniche.github.io/Mycodo/Data-Viewing/)
