Home Assistant 智能水疗SmartTub集成使用 smarttub.set_secondary_filtration 动作管理热水浴缸次级过滤模式【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文围绕 Home Assistant 官方文档仓库中的smarttub.set_secondary_filtration动作Action展开讲解如何通过该动作在自动化与脚本中更新 SmartTub 热水浴缸的次级过滤模式。读完本文你将掌握该动作的 UI 可视化配置步骤、完整 YAML 语法与参数取值范围、目标Target选择机制以及一个离家自动降低过滤强度的实战自动化范例让浴缸在你离家时自动进入省电的 away 模式。背景SmartTub 集成与次级过滤SmartTub 是 Home Assistant 官方支持的云轮询Cloud Polling集成用于查看和控制使用 SmartTub 系统该集成通过配置流Config Flow完成账户接入属于 hub 类型集成提供以下实体平台binary_sensor二进制传感器climate气候用于水温控制light灯光sensor传感器含过滤循环状态传感器switch开关过滤系统是热水浴缸保持水质清洁的核心环节。SmartTub 通常区分主过滤primary filtration与次级过滤secondary filtration主过滤循环可设置运行时长与起始时间对应smarttub.set_primary_filtration动作详见 source/_actions/smarttub.set_primary_filtration.markdown次级过滤则是按模式frequent / infrequent / away切换的补充过滤周期即本文主角smarttub.set_secondary_filtration。每次过滤循环的状态由一个sensor实体暴露例如sensor.jacuzzi_j_335_secondary_filtration_cycle它既是动作的目标target也是你观察过滤状态的入口。动作总览smarttub.set_secondary_filtration该动作在 Home Assistant 中的标识为smarttub.set_secondary_filtration功能一句话概括Updates the secondary filtration mode on a hot tub.更新热水浴缸上的次级过滤模式。它只有一个必填参数mode用于指定次级过滤模式。因此它非常适合放进离家回家睡眠等场景型自动化中实现过滤强度的动态调节。在 UI 中配置该动作如果你习惯可视化搭建自动化无需接触 YAML。官方文档给出了完整的分步指引见 source/_actions/smarttub.set_secondary_filtration.markdown进入设置 自动化与场景Settings Automations scenes。打开一个已有的自动化或脚本或选择创建自动化 创建新的自动化。如果是新建自动化在何时When部分添加一个触发条件脚本无需触发器——脚本由其他自动化或调用方显式触发运行。在然后执行Then do部分选择添加动作Add action。在搜索框中搜索并选择SmartTub: Update secondary filtration settingsSmartTub更新次级过滤设置。在目标By target下选择你的热水浴缸次级过滤循环传感器详见下文动作的目标一节。选择模式Mode。点击保存。整个流程由 UI 逐步引导你只需选择目标、调整选项并保存无需掌握 YAML 语法。UI 中的选项选项说明是否必填模式Mode次级过滤模式frequent、infrequent或away必填mode的三种取值含义如下frequent频繁过滤周期更密集适合浴缸使用频繁、需要持续保持水质的场景infrequent不频繁过滤周期较稀疏适合使用率不高的时段away离家最小化过滤运行适合家中无人、浴缸长时间无人使用的场景可显著节省电力与水处理成本。在 YAML 中使用该动作对于直接编写 YAML 或希望精确控制底层行为的用户文档提供了技术参考见 source/_includes/actions/yaml_header.md列出了字段名、类型与必填性。基础示例action: smarttub.set_secondary_filtration target: entity_id: sensor.jacuzzi_j_335_secondary_filtration_cycle data: mode: away上述配置将次级过滤循环切换为away离家模式。YAML 参数表字段说明必填类型取值mode次级过滤模式是string字符串frequent、infrequent或away从源码结构看参考 source/_actions/smarttub.set_secondary_filtration.markdown 的options_yaml定义mode是唯一参数且为必填项因此调用该动作时必须提供mode否则动作将无法执行。动作的目标Targets机制该动作必须指定目标。目标即动作的作用对象你可以将动作指向单个实体entity、设备device、区域area、楼层floor或标签labelHome Assistant 会自动对该目标下所有匹配的sensor实体执行动作参见 source/_includes/actions/targets.md实体单个指定的 sensor 实体如sensor.jacuzzi_j_335_secondary_filtration_cycle设备属于某设备的全部 sensor 实体区域某个房间/区域内的全部 sensor 实体楼层某个楼层上的全部 sensor 实体标签共享某个标签的全部 sensor 实体。你还可以在同一次动作中混合多种目标类型例如同时指定一个具体实体和一个区域动作会一并作用于两者。对于本动作的典型用法直接以次级过滤循环传感器实体为目标即可若你有多个浴缸也可以把它们归入同一个区域或标签一次动作批量切换。实战示例离家时自动降低过滤强度官方文档提供了一个开箱即用的自动化场景见 source/_actions/smarttub.set_secondary_filtration.markdown 中的details折叠块场景当你离家时将次级过滤切换为 away 模式让浴缸在无人使用期间减少过滤节省能耗。触发器你离家person.sam状态变为not_home动作SmartTub: Update secondary filtration settings完整 YAML 如下automation: alias: Hot tub away filtration when not home triggers: - trigger: state entity_id: person.sam to: not_home actions: - action: smarttub.set_secondary_filtration target: entity_id: sensor.jacuzzi_j_335_secondary_filtration_cycle data: mode: away将该自动化复制到你的automations.yaml中并把person.sam换成你自己的家庭成员 person 实体、把sensor.jacuzzi_j_335_secondary_filtration_cycle换成你浴缸实际的次级过滤传感器实体即可生效。延伸思路基于同一套机制你还可以自然扩展出更多组合回家恢复过滤以person.sam状态变为home为触发器调用同一动作并将mode设为frequent让浴缸在你到家前恢复高强度过滤与主过滤联动结合 smarttub.set_primary_filtration可设置主过滤的duration时长与start_hour起始小时编排昼夜过滤策略例如夜间执行主过滤、白天按次级过滤模式动态调整脚本封装把常用过滤策略封装为脚本供多个自动化复用。立即测试使用执行动作面板如果你想在写任何 YAML 之前先在真实实体上验证效果可以打开设置 工具 动作Settings Tools Actions参见 source/_includes/actions/try_it.md搜索smarttub.set_secondary_filtration填写字段并点击执行动作Perform action。你会在实际实体上立即看到变化无需编写一行 YAML。常见问题与排障如果动作未按预期生效官方文档建议从以下几个方面入手参见 source/_includes/actions/stuck.md确认实体存在且可写先在设置 工具 动作面板中执行一次动作确认目标传感器实体状态真实存在且浴缸在线SmartTub 为云轮询集成离线设备无法接收指令检查mode取值该参数必填且必须严格为frequent、infrequent或away三者之一拼写错误或缺失都会导致调用失败核对目标语法确认target.entity_id与实际生成的传感器实体 ID 完全一致可在设置 实体中查看检查自动化是否被触发对于离家类自动化确认 person 实体状态确实发生了not_home转变。若仍有问题可以前往 Home Assistant 社区论坛求助发布时附上你正在调用的动作、预期结果与实际现象便于他人快速定位。小结smarttub.set_secondary_filtration是 SmartTub 集成中最轻量、最实用的动作之一——它只有一个必填参数mode却能让热水浴缸的过滤策略随你的生活方式自动调整。无论是通过 UI 可视化搭建还是直接编写 YAML你都可以快速实现离家减滤、在家增滤的节能自动化。结合同系列动作 smarttub.set_primary_filtration、smarttub.reset_reminder 与 smarttub.snooze_reminder你可以构建出一套完整的浴缸维护自动化体系。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考