【免费下载链接】ha_washdataHome Assistant integration for smart-plug appliance monitoring: detects cycles, matches programs, estimates time remaining. Supports washing machines, dryers, dishwashers and more.项目地址https://gitcode.com/gh_mirrors/ha/ha_washdata点击查看免费下载WashData 四字段配置是使用 Home Assistant 自定义集成 WashData 的第一步它通过智能插座读取家电功率自动检测洗衣机、烘干机的循环起止并识别当前运行程序、估算剩余时间。本文用一篇完整教程带你填对 Name、Device Type、Power Sensor、Minimum Power 这4 个核心字段检测出你的第一个洗衣机循环并避开 6 个新手最常见的坑。一、WashData 是什么为什么只需 4 个字段WashData 是一个本地运行的 Home Assistant 集成⚡循环检测—— 从功率曲线判断机器何时开始、何时结束工作程序匹配—— 按功率形状、时长和总能耗识别这是快洗还是棉麻程序⏱剩余时间估算—— 结合历史循环给出 ETA还能提前推送快洗完了通知整个安装向导只有 4 个字段定义见 config_flow.py 中的STEP_USER_DATA_SCHEMA全部填完即可开始检测其余精细调参都放在 WashData 面板的 Settings 页里完成。入口路径设置 设备与服务 添加集成 搜索 WashData。二、四字段逐一填写指南1️⃣ Name设备名称给设备起个好认的名字例如Washing Machine、Balcony Washer。它会出现在所有通知、实体和面板标题里。 默认值是Washing Machine见 const.py 的DEFAULT_NAME。多台设备时请用名称区分开。2️⃣ Device Type设备类型下拉框提供 9 种类型Washing Machine、Dryer、Washer-Dryer Combo、Dishwasher、Air Fryer、Bread Maker、Pump / Sump Pump以及两个兜底项Other (Advanced)和Threshold Device完整列表见 const.py 的DEVICE_TYPES。这个字段的作用是为内部检测逻辑预设一套合理的默认阈值比如洗衣机默认会启用防皱anti-crease保护、结束尖峰处理等专属策略。选错类型不会报错但检测行为可能不符合预期——新手请如实选择后续可随时在面板里修改。3️⃣ Power Sensor功率传感器——最关键的字段选择你智能插座的实时功率实体单位瓦特 W如sensor.my_plug_power。避坑要点❌ 常见错误✅ 正确做法选了当日耗电量kWh实体必须是**瞬时功率W**实体选了总开合状态开关实体必须是sensor域的数值实体实体单位是 kW在集成端换算成 W或选择单位正确的实体如果下拉框里找不到实体先确认插座的功率上报是否正常在 HA 开发者工具 状态里看一眼有没有数值。Zigbee2MQTT 用户注意请调低报告间隔Min 1–10 sMax 1200 s和最小报告阈值5 W 降到 1–2 W否则小功率变化如脱水结束可能上报不及时。4️⃣ Minimum Power最小功率阈值单位 W功率读数高于此阈值才认为设备在运行低于它则视为待机/关闭。默认值2 Wconst.py 的DEFAULT_MIN_POWER大多数设备直接保留默认即可。插座待机时显示 5–8 W 的幽灵负载把它调高到实测待机值之上填0 或负数会直接报错Power threshold must be greater than 0见 config_flow.py四个字段填完点提交WashData 就会自动为这台设备创建传感器、按钮和侧边栏面板入口。三、配置完成后检测你的第一个循环第一步跑一个循环验证检测打开侧边栏的WashData面板进入Overview页。此时设备应为 Off 状态——如果你发现它误显示为运行中回头检查 Power Sensor 和 Minimum Power。第二步建立你的第一个程序档案WashData不内置任何预置档案每台机器型号都不同你有两种方式教会它录制模式推荐数据最干净在 Overview 页使用Manual Recording Start Recording完整跑一次机器按 Stop然后在Profiles页从这段录制创建一个档案。事后标注直接用机器WashData 会记录一条 Unknown 循环在Cycles页打开它分配到新档案即可。对最常用的 2–3 个程序各建一个档案匹配就自动生效了。第三步查看检测结果点击任一循环进入详情页可以看到完整的功率曲线、起止时间、总能耗和匹配到的程序。四、常见坑点指南6 个高频问题速查以下问题均来自项目官方排查表README.md Troubleshooting 章节新手 90% 的调试需求在这里就能解决#症状原因解决方案1开始检测太早机器还没洗就显示运行插座在开机/待机时有短暂功率尖峰调高Start Energy Threshold如 2 Wh要求先消耗真实能量2结束检测太早机器还在浸泡/漂洗就显示完成机器存在长时间低功率区间调大Off Delay如 5 分钟3幽灵循环洗完后凭空多出一个循环结束瞬间的高功率防皱、排水泵被误判为新开始调大Minimum Off Gap如 120 s4一直匹配 Unknown不识别程序档案时长容差太严或循环波动大调大Duration Tolerance如 0.25 表示 ±25%5进度长时间不刷新插座上报间隔太长缩短插座的报告间隔Zigbee 用户见上文提示6通知太晚衣服都皱完了未设置提前量设置Notify Before End Minutes在结束前 N 分钟推送这些参数都在 WashData 面板Settings页调整每个字段都有 tooltip 说明而且系统会基于你自己的历史循环数据给出内联调参建议——照建议改通常比拍脑袋准。各参数的深入原理可参考 01-detection-core.md。⚠️用电安全提醒智能插座接大功率家电有真实风险。插座额定功率必须覆盖家电峰值功率往往 2500 W普通 10 A 插座可能不够建议 16 A 以上或硬装模块并定期检查硬件。五、写在最后回顾一下WashData 四字段配置的要点Name—— 起个能区分设备的好名字Device Type—— 如实选择它决定检测默认策略Power Sensor—— 选瞬时功率W实体这是全部检测的数据源Minimum Power—— 默认 2 W待机幽灵负载高的插座再上调填对这四个字段你的第一台洗衣机循环检测就已经跑起来了之后教它 2–3 个常用程序剩余时间估算、程序识别和结束通知就会全部自动工作。更细致的检测参数含义建议对照官方 Wiki 的 Settings Visual Guide 和 README.md 中的 Troubleshooting 表按需调整。赞分享【免费下载链接】ha_washdataHome Assistant integration for smart-plug appliance monitoring: detects cycles, matches programs, estimates time remaining. Supports washing machines, dryers, dishwashers and more.项目地址https://gitcode.com/gh_mirrors/ha/ha_washdata点击查看免费下载相关推荐NullClaw零基础上手教程从零配置你的第一个AI助手10个关键步骤常见报错NullClaw零基础上手教程从零配置你的第一个AI助手10个关键步骤常见报错 NullClaw 是一个用 Zig 语言编写的超小型、完全自主的本地 A人工智能AI Agent大模型自主智能体工具调用RAGAgent 记忆MCP ClientsAgent 沙箱多智能体语音如何编写你的第一个eBPF程序从零到一完整教程 eBPFExtended Berkeley Packet Filter 是现代Linux内核中的革命性技术它允许你在不修改内核源码的情况下安全地在内核中文档知识库《GitHub 漫游指南》实操教程如何提交你的第一个 Pull Request附 CLA 避坑指南《GitHub 漫游指南》实操教程如何提交你的第一个 Pull Request附 CLA 避坑指南 《GitHub 漫游指南》是一本用中文写的 GitHub文档教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考