Home Assistant 中 Matter 热水器 Boost 动作matter.water_heater_boost完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文聚焦 Home Assistant 的matter.water_heater_boost动作Action讲解如何通过该动作在设定的时间段内为 Matter 热水器启用boost快速加热模式典型的应用场景是提前加热水量例如在家人起床淋浴之前把热水备足。读完本文后你将掌握该动作在自动化与脚本中的完整用法包括 UI 可视化配置、YAML 参数详解、目标Target选择机制以及一个可直接复制的晨间热水预热自动化示例。Matter 热水器与 boost 动作matter.water_heater_boost是 Matter 集成source/_integrations/matter.markdown提供的水加热器water_heater平台动作之一。Matter 集成允许 Home Assistant 作为 Matter 生态中的控制器controller通过本地 Wi-Fi 或 Thread 网络控制 Matter 设备。集成内部运行一个独立的 Matter Server 应用负责维护 Matter 网络 Fabric 与控制逻辑Home Assistant 通过 WebSocket 连接与之通信。在 Matter 水加热器设备类型中boost升压/快速加热模式用于在有限时间内以更激进的方式加热储水常用于家人起床前提前把热水加足临时增加热水用量如客人来访、泡澡恢复因长时间低功率运行而下降的水温。该动作的核心特点是定时生效、自动停止boost 模式会持续你设定的时长时间一到自动关闭无需手动关闭。在 UI 中配置该动作在自动化或脚本的可视化编辑器中配置该动作的步骤如下对应 source/_includes/actions/ui_header.md 描述的UI 分步引导模式进入设置 自动化与场景Settings Automations scenes。打开一个已有的自动化或脚本或选择创建自动化创建新自动化。如果是新建自动化在当……时When部分添加一个触发器。脚本不需要触发器——脚本由其他自动化或事件调用时运行。在然后执行Then do部分选择添加动作Add action。选择你要控制的设备在按目标By target下参见下方 目标Targets 一节选择要 boost 的热水器。在针对该目标列出的动作中选择Boost a Matter water heater。设置Duration持续时间即 boost 运行的时长。可选打开Emergency boost紧急加热或为 boost 期间设置Temporary setpoint临时设定温度。选择保存。UI 中的选项选项说明DurationBoost 持续运行的时间单位为秒。例如输入3600表示 1 小时。Emergency boost在 boost 持续期间尽可能快地加热水。默认关闭可选。Temporary setpointBoost 期间使用的目标温度单位为摄氏度。取值范围必须在30 到 65 之间可选。在 YAML 中使用该动作YAML 基础示例在 YAML 中该动作的调用名为matter.water_heater_boost。最小可用的示例对应 source/_includes/actions/yaml_header.md 所述的字段名、类型与必填性技术参考action: matter.water_heater_boost target: entity_id: water_heater.hot_water data: duration: 3600YAML 参数详解参数必填类型默认值说明duration✅ 是integer—Boost 运行时长单位为秒。例如3600表示 1 小时。emergency_boost否booleanfalse是否在 boost 期间尽可能快地加热水。temporary_setpoint否integer—Boost 期间使用的目标温度摄氏度取值范围30–65。参数说明与注意事项duration是唯一必填参数直接决定 boost 何时自动结束。由于 boost 结束后不会自动恢复常规模式切换逻辑之外的任何状态时长设得太短可能无法把水加热到位设得太长则浪费能源建议结合热水器容积与加热功率估算。temporary_setpoint的 30–65 ℃ 边界是文档明确规定的硬约束。同时可以借鉴同仓库中water_heater.set_temperature动作source/_actions/water_heater.set_temperature.markdown的说明为降低军团菌滋生风险储水建议保持在 60 ℃ 及以上25–45 ℃ 区间适合细菌繁殖。因此临时设定温度过低反而可能带来卫生风险应谨慎使用。关于具体热水器支持的实际温度范围Matter 标准中设备会声明其能力范围Home Assistant 侧若传入超出设备支持范围的数值调用会失败。上述 30–65 ℃ 是 Home Assistant 文档层的通用限制具体设备可能更窄。完整自动化早晨淋浴前预热热水文档中给出了一个可直接套用的场景每天早上 06:00 触发提前加热热水确保家人起床时热水充足。触发器每天 06:00动作Boost a Matter water heateralias: Boost hot water in the morning triggers: - trigger: time at: 06:00:00 actions: - action: matter.water_heater_boost target: entity_id: water_heater.hot_water data: duration: 3600这个示例展示了 boost 动作最典型的用法与时间触发器组合在用水高峰来临之前运行一小时。目标Targets该动作需要一个目标Target目标即动作的作用对象。你可以将目标指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后每一个匹配的 water_heater 实体执行动作详见 source/_includes/actions/targets.md实体Entity某一个具体的water_heater实体如water_heater.hot_water设备Device属于某台设备的所有water_heater实体区域Area某个房间/区域内所有water_heater实体楼层Floor某个楼层上所有water_heater实体标签Label共享某个标签的所有water_heater实体。你还可以在一次动作中混合多种目标类型例如同时指定一个具体实体加一个区域一次调用即可作用于两者。与其他 water_heater 动作配合Matter 热水器不仅支持 boost还提供完整的温度与模式控制动作。从 Home Assistant 的 water_heater 域来看source/_actions/water_heater.set_temperature.markdown 等可与之配合的动作包括water_heater.set_temperature设置目标温度water_heater.set_operation_mode设置运行模式water_heater.set_away_mode设置离家模式water_heater.turn_on/water_heater.turn_off开关热水器。典型组合思路日常用water_heater.set_temperature维持一个节能的基础温度用水高峰前用matter.water_heater_boost做短时快速加热两者配合既保证舒适度又控制能耗。使用须知与排查建议Good to knowBoost 模式运行到设定的时长后会自动停止无需手动关闭也不会一直保持快速加热状态因此作为定时任务放入自动化是安全的。前置条件matter.water_heater_boost只对Matter 热水器实体有效使用前需满足已安装并配置 Matter 集成推荐在 Home Assistant OS 上运行官方 Matter Server 应用其他安装方式不受官方支持已通过 Companion 应用Android/iOS完成 Matter 热水器的配网commissioning网络环境满足 Matter 的要求——本地 IPv6 与 mDNS 组播流量畅通Wi-Fi 设备与 Home Assistant 位于同一 VLAN。若动作调用不生效可以优先检查设备是否为 Matter 水加热器设备类型、duration是否已填写、temporary_setpoint是否落在 30–65 ℃ 区间。更深入的问题排查可以参考 Matter 集成文档中的诊断与疑难解答部分source/_integrations/matter.markdown。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考