
1小时搭建ESPHome漏水检测报警系统指南【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome凌晨两点卫生间地漏渗水你被客厅的蜂鸣器声叫醒此时地面只湿了一小片——因为 ESPHome 漏水检测系统在传感器触发后 1 秒内就拉响了本地警报。整套方案物料成本不到 50 元1 小时可完成从配置到通电的全过程只需写一段 YAML 配置文件一种用缩进描述设备行为的文本格式无需编写代码。 三种漏水检测方案选型对比方案成本上手难度可维护性商用 Wi‑Fi 漏水探测器百元级/台开箱即用依赖厂商 App 与云服务固件不可改ESPHome ESP8266 自组本文方案几十元复制粘贴 YAML 即可配置即源码改哪看哪可逐行回退接入 Zigbee 漏水传感器需另购网关两百元起中等传感器本身不可定制逻辑选择 ESPHome 方案的理由是单点成本最低且所有配置都是明文 YAML 文件出问题时可以对照排查而不是黑盒。 漏水检测物料与环境准备清单☐ NodeMCU ESP8266 开发板 ×1 —— 控制核心负责联网与状态判断 ☐ 金属探针 ×2或带 DO 数字输出的水浸探头模块—— 感知水用裸探针时一个接 GPIO 引脚、一个接 GND 地线 ☐ 5V 有源蜂鸣器 ×1有源型通电即响无需信号驱动—— 本地声音告警 ☐ 杜邦线 4 根 —— 连接各部件 ☐ 5V/1A 电源适配器 —— 给开发板稳定供电 ☐ 一台可联网电脑已安装 Python 3.9 及以上 —— 运行 ESPHome 编译工具若已装 Home Assistant 的 ESPHome 附加组件可跳过此项直接用界面操作 ESPHome 漏水检测系统动手实施步骤步骤1安装 ESPHome 工具并新建设备文件目标装好命令行工具为设备建立配置文件。操作在终端执行pip install esphome然后新建文件leak-detector.yaml。验证执行esphome version能打印出版本号。步骤2配置 ESP8266 基础信息与 WiFi目标让开发板连上家里 WiFi。操作在leak-detector.yaml写入以下内容esphome: name: leak-detector platform: ESP8266 board: nodemcuv2 wifi: ssid: 你的WiFi名称 password: 你的WiFi密码验证执行esphome config leak-detector.yaml末尾提示 configuration is valid。步骤3配置 GPIO 水浸传感器与蜂鸣器目标把探针的“有水/无水”翻译成设备的 ON/OFF 状态并联动蜂鸣器。操作探针两片金属一片接 GPIO14另一片接 GND蜂鸣器负极接 GPIO5正极接 3V3。再追加两段配置binary_sensor: - platform: gpio pin: number: GPIO14 mode: INPUT_PULLUP # 内部上拉遇水拉低触发 name: 厨房漏水传感器 device_class: moisture # 标记为潮湿类传感器 filters: - delayed_on: 1s # 接触1秒才报ON过滤误触发 - delayed_off: 3s on_press: - switch.turn_on: 报警蜂鸣器switch: - platform: gpio pin: GPIO5 name: 报警蜂鸣器验证再次执行esphome config仍提示 valid。步骤4编译烧录固件并通电目标把配置变成固件写进开发板。操作USB 连接开发板执行esphome run leak-detector.yaml烧录期间保持板子不动出现上传成功后设备自动重启。验证串口日志出现WiFi connected且设备名 leak-detector 出现在局域网或 Home Assistant 的设备列表中。✅ 漏水检测验收清单与常见故障处理☐ Home Assistant 中出现binary_sensor.厨房漏水传感器实体初始状态为 OFF ☐ 探针两触点间滴一滴水约 1 秒后状态变 ON蜂鸣器同时响起 ☐ 擦干探针约 3 秒后状态恢复 OFF ☐ 断电重启后无残留 ON 状态蜂鸣器不响Q状态乱跳或没滴水也报警把delayed_on从 1s 调到 3s确认探针悬空高度在潮湿墙面以上两触点间距保持 5mm 以上。Q上电后一直显示 ON、蜂鸣器长响先断电用干布擦净探针触点检查 GPIO14 是否误接到 3V3重新接线后重试。Q想在手机上收到推送怎么加在 Home Assistant 里基于binary_sensor.厨房漏水传感器建一条“状态变为 ON 时发送通知”的自动化或在 ESPHome 的on_press中追加mqtt.publish动作由后端负责推送。Q想加第二个检测点复制一份 yaml改name、探针的number和蜂鸣器引脚即可每块板建议只挂 1~2 个探针。 漏水检测方案的边界与进阶方向当前成果是本地声音告警加 Home Assistant 状态展示不记录积水历史单块板驱动一组“探针 蜂鸣器”远程推送依赖 Home Assistant 或 MQTT 后端。进阶方向有两个一是用 ESP-NOW 组件 组多点节点一套主节点覆盖全屋二是把该传感器接入 Home Assistant 自动化联动自动关阀或推送分级告警。更多配置细节可查阅 README 与 binary_sensor 组件源码。本文配置基于 ESPHome 2026.10开发版编写YAML 语法与 Home Assistant ESPHome 附加组件 2023.12 及以上版本兼容换用其他开发板时请相应调整 GPIO 编号与 board 参数。【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考