Home Assistant Tado 集成实战set_water_heater_timer 动作的配置与自动化【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 官方文档仓库中的 Tado 热水器计时动作 为核心完整讲解tado.set_water_heater_timer动作的作用机制、UI 与 YAML 两种配置方式、参数取值与默认值并结合 Tado 集成文档 与同域的tado.set_climate_timer动作给出“地暖 热水同时 boost”等可直接复用的自动化实战方案。读完本文你能够独立完成该动作的创建、验证并将其嵌入自动化或脚本中定时触发热水加热。动作定位什么是 Tado 的热水加热计时Set water heater timer动作会将一台 Tado 热水器开启一段固定时间效果等价于在 Tado 官方 App 中手动执行一次“热水 boost”热水器按你设定的时长运行结束后自动回到原有日程schedule。该动作还可以可选地设定 boost 期间热水器需要达到的目标温度。在 Home Assistant 的实体模型中Tado 集成为每个带热水功能的 Tado 区域创建一个water_heater实体见 Tado 集成文档 中的平台列表其中ha_platforms明确包含water_heater。因此该动作的 target 类型是water_heater实体例如water_heater.hot_water。理解这一点后动作的语义就很清晰time_period必需boost 持续时长如01:30:00表示加热 1 小时 30 分钟temperature可选boost 期间要达到的目标温度浮点数。使用前提Tado 集成与速率限制该动作属于 Tado 域前提是本机已正确配置 Tado 集成。有两点来自官方文档的事实值得注意详见 Tado 集成文档认证方式自 2025 年 3 月 21 日起Tado 改用设备码Device Code认证流程——集成会给出一个 Tado 认证服务器的 URL需要你在浏览器中确认设备码并完成登录然后回到 Home Assistant 等待同步完成。如果集成提示重新认证按同样流程操作即可。速率限制自 2026 年 1 月 1 日起Tado 对 API 施加了基于每日配额的严格速率限制配额因订阅类型而异每日 12:00 CET 重置。若受影响集成可能出现认证失败或无法获取新数据。文档建议通过自定义轮询间隔custom polling interval来降低 API 调用频率——同理频繁触发热水计时这类写操作也会消耗配额编写自动化时应避免不必要的重复调用。设备支持范围新版 Tado X 设备不受该集成支持需通过 Matter 集成使用因此这些新设备也无法通过本动作控制。UI 方式配置可视化创建热水计时动作如果你习惯可视化编排Home Assistant 会以向导形式带完成整条配置对应原文档中的 UI 操作章节即 actions/ui_header.md 所描述的“无需 YAML 知识”的交互流程进入SettingsAutomations scenes打开一个已有自动化或脚本或选择Create automationCreate new automation若是新建自动化先在When部分添加触发器脚本不需要触发器由别的实体调用时执行在Then do部分选择Add action在搜索框中搜索并选择Tado: Set water heater timer在Targets下选择要控制的water_heater实体输入Time period并可选输入Temperature点击Save。UI 中的选项选项说明是否必填Time periodboost 的持续时长例如01:30:00必填Temperatureboost 期间热水器要设定的目标温度可选目标Targets说明该动作要求指定 target即动作作用的对象。根据 actions/targets.md 的定义可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该 target 背后的每一个匹配的water_heater实体执行动作Entity某一个具体的water_heater实体如water_heater.hot_waterDevice属于某台设备的每一个water_heater实体Area某个房间/区域内的每一个water_heater实体Floor某个楼层上的每一个water_heater实体Label共享同一标签的每一个water_heater实体。同一条动作里还可以混用不同类型的 target例如同时指定一个具体实体和一个区域动作会同时对两者生效。YAML 方式配置字段、类型与默认值如果你直接在 YAML 中编写或想明确底层实际发出的字段动作名写作tado.set_water_heater_timer。一个基础示例如下继承自原文档action: action: tado.set_water_heater_timer target: entity_id: water_heater.hot_water data: time_period: 01:30:00YAML 字段参考字段类型必填默认值说明time_periodstring是01:00:00boost 持续时长格式为HH:MM:SS例如01:30:00temperaturefloat否无热水器要设定的目标温度两个实战细节time_period是字符串而非数字YAML 中建议加引号01:30:00避免被解析器误解temperature为浮点数文档示例中的温度值与设备单位一致使用时直接填写摄氏度数值即可。实战场景与地暖一起 boost 的脚本Tado 的另一个动作 tado.set_climate_timer 负责把采暖设备如 radiator valve在一段时间内加热到目标温度。它与本动作配合可以组成“早上一键升温”的脚本——原文档中给出了现成的组合示例script: alias: Boost heating and hot water sequence: - action: tado.set_climate_timer target: entity_id: climate.heating data: temperature: 25 time_period: 01:30:00 - action: tado.set_water_heater_timer target: entity_id: water_heater.hot_water data: time_period: 01:30:00该脚本先让采暖区域在 1.5 小时内升到 25°再让热水器同时 boost 1.5 小时适合作为仪表盘上的一个按钮在寒冷早晨一键触发“全屋 热水”预热。验证动作用 Actions 工具直接试跑不必先写自动化就能验证动作效果打开SettingsToolsActions对应原文档 actions/try_it.md 中的 “Try it yourself” 章节搜索该动作填入字段后点击Perform action即可在真实实体上观察 boost 是否生效无需编写任何 YAML。这是排查“动作到底执行了没有”的第一步。相关动作以下同域动作与本动作配合使用来自原文档 front matter 中的related_actionsSet climate timer把 Tado 采暖实体在设定时长内开启到目标温度同样等价于手动 boost与热水计时组合即可实现“采暖 热水”双 boostSet climate temperature offset为 Tado 采暖设备设置温度偏移用于校准偏差Add meter reading向 Tado Energy IQ 提交燃气/电表读数适合与每日定时自动化搭配。四个动作覆盖了 Tado 集成的主要控制面采暖计时、热水计时、温度校准与能耗记录。小结tado.set_water_heater_timer是 Tado 集成中唯一面向water_heater实体的控制动作以time_period为必填参数默认01:00:00、temperature为可选浮点参数可在 UI 向导或 YAML 中等价配置并可借助 Targets 机制批量作用于设备、区域、楼层或标签。结合tado.set_climate_timer的采暖计时与 Actions 工具的手动试跑能力你可以在 Home Assistant 中完整复刻并自动化 Tado App 的手动 boost 体验。需要注意的约束来自 Tado 侧设备码认证流程与自 2026 年 1 月起的每日 API 配额限制建议为写操作类自动化控制触发频率。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考