Home Assistant 中的 Rachio 暂停浇水动作rachio.pause_watering 使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读rachio.pause_watering是 Home Assistant 中 Rachio 集成 提供的一个动作Action用于暂停账户下所有当前正在运行的喷灌区zone或浇水计划schedule。本文基于官方文档 source/_actions/rachio.pause_watering.markdown 编写详细介绍该动作的适用场景、UI 操作路径、YAML 配置方式、参数含义与限制并补充 Rachio 集成在控制器代际、API 速率限制等方面的背景知识帮助你安全、高效地将暂停浇水能力接入自动化与脚本。动作概览暂停浇水到底做了什么rachio.pause_watering用于暂停任何正在运行的喷灌区或浇水计划。它不会取消计划而是将当前浇水过程临时挂起之后可以通过配套动作恢复。该动作与同一域下的另外三个动作共同构成完整的浇水控制闭环动作作用rachio.pause_watering暂停当前正在运行的喷灌区或计划rachio.resume_watering恢复被暂停的喷灌区或计划rachio.stop_watering彻底停止当前正在运行的喷灌区或计划rachio.start_watering手动启动指定的喷灌区或计划其中rachio.resume_watering与rachio.stop_watering的用法与本文高度相似均通过devices参数指定控制器默认作用于账户下全部控制器可参考 resume 动作文档 与 stop 动作文档。重要限制第一代控制器不支持暂停根据文档说明如果账户下只有第一代Generation 1控制器则该动作不可用因为第一代控制器本身不支持暂停/恢复功能。使用前请先确认你的 Rachio 控制器型号。从 UI 使用该动作如果你更喜欢可视化地构建自动化和脚本Home Assistant 会逐步引导你完成动作配置选择目标、调整选项、保存全程无需编写 YAML。具体步骤如下进入设置自动化与场景{% my automations %}。打开现有的自动化或脚本也可以选择创建自动化创建新自动化。如果新建的是自动化请在何时When部分添加触发器脚本不需要触发器脚本由其他流程调用时运行。在然后执行Then do部分选择添加动作。在搜索框中搜索并选择Rachio: Pause watering。可选填写Devices要暂停的设备和Duration暂停时长。选择保存。不支持 Targets该动作不支持 Targets目标选择器。在 UI 中你不会被提示选择区域、设备、实体或标签。也就是说你无法用选择某个区域的所有设备这类目标方式指定作用范围只能通过Devices字段按控制器名称指定或留空作用于全部控制器。从 YAML 使用该动作在 YAML 中动作名称为rachio.pause_watering。文档给出的基础示例action: rachio.pause_watering data: devices: Main House duration: 30这段配置的作用是暂停名为 Main House 的控制器暂停时长为 30 分钟。在自动化或脚本中完整写法示例alias: Pause irrigation when rain detected triggers: - trigger: state entity_id: binary_sensor.rain_detected to: on actions: - action: rachio.pause_watering data: duration: 60当雨水传感器触发时暂停账户下所有控制器devices留空60 分钟。YAML 参数参考参数类型必填默认值说明devicesstring否账户下全部控制器要暂停的控制器名称留空时默认作用于账户下全部控制器durationinteger否60暂停时长分钟取值范围 160注意duration的取值范围约束必须在 1 到 60 之间超出该范围将无法生效。在界面上手动测试如果你不想写 YAML可以直接在 UI 中试运行打开设置工具动作{% my developer_services %}搜索rachio.pause_watering填写字段后点击执行动作即可在实际实体上观察效果无需编写任何 YAML。结合 Rachio 集成的背景知识要安全地使用该动作建议理解以下集成层面的背景信息详见 Rachio 集成文档控制器代际与功能差异第一代Generation 1控制器不支持暂停/恢复因此pause_watering、resume_watering仅在有支持暂停的控制器如第二代及以上时可用。Rachio 智能水管定时器smart hose timers依赖轮询获取状态而不是实时推送使用一个基站时每 2 分钟轮询一次每增加一个基站轮询间隔额外增加 1 分钟以保持在 API 速率限制之内每个基站最多可配对 4 个阀门。因此从计划或物理按钮启动的阀门状态不会立即反映到 Home Assistant 中暂停操作的效果也可能存在延迟。API 速率限制与安全建议Rachio API 的速率限制为每天 1700 次调用。集成文档给出了一条节水安全建议在配置集成选项时可将通过脚本控制喷灌区的开关动作的最大运行时长设置为一个保险值failsafe。这样即使脚本、Home Assistant 出错或触发 API 速率限制控制器也会在该时长后自动关闭喷灌区避免水资源浪费。集成提供的能力Rachio 集成ha_integration_type: hub通过 Config Flow 配置在 Home Assistant 中提供以下实体平台Binary sensor查看 Rachio 灌溉系统的状态Switch切换账户下每个控制器启用的每个喷灌区、智能水管定时器阀门、计划启停以及控制器的待机模式和 24 小时雨延Calendar为每个智能水管定时器基站生成日历实体显示所有已启用计划的过去与未来事件删除即将发生的事件会触发跳过该事件。配置集成后这些实体会被自动添加。也正因如此rachio.pause_watering这类动作实际作用于账户层面的控制器与计划而非单个实体——这正是它不支持 Targets 的根本原因。典型使用场景天气联动检测到降雨或大风时暂停全部或指定控制器的浇水计划雨停后由rachio.resume_watering恢复。外出保护离家时暂停整个庭院灌溉配合rachio.resume_watering在回家前恢复。手动临时中断正在后院活动时通过仪表盘按钮暂停指定控制器 30 分钟结束后自动恢复原计划duration到时会自动结束暂停。总结rachio.pause_watering是控制 Rachio 灌溉系统的重要动作支持 UI 与 YAML 两种使用方式核心参数为devices目标控制器默认为全部和duration160 分钟默认 60。使用时需注意第一代控制器不支持暂停、动作不支持 Targets、以及 API 每日 1700 次调用的速率限制。将它与rachio.resume_watering组合使用即可在自动化中实现完整的暂停—恢复浇水控制闭环。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考