Home Assistant OSO Energy 集成 water_heater 加热开启操作osoenergy.turn_on实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 文档仓库中 OSO Energy 集成的osoenergy.turn_on操作action展开讲解如何通过可视化界面与 YAML 两种方式开启热水器加热并深入解析until_temp_limit参数、目标target选择机制以及与osoenergy.turn_off、osoenergy.set_v40_min、osoenergy.set_profile等关联操作的协同用法。读完本文你将能够在自动化与脚本中精准控制 OSO Energy 热水器的加热行为实现按需加热与节能管理。操作概述何时使用 osoenergy.turn_onosoenergy.turn_on是 OSO Energy 集成 为water_heater平台提供的核心操作之一其作用是为 OSO Energy 热水器开启加热。根据官方文档定义该操作支持两种加热模式持续加热直到达到最高温度适合需要大量热水的场景仅加热一小时适合临时补充热量、避免长时间满负荷运行。此操作对应文档 source/_actions/osoenergy.turn_on.markdown其related_actions字段明确关联了osoenergy.turn_off关闭加热二者构成开启/关闭的完整控制闭环。从集成整体能力看OSO Energy 集成属于 Cloud Polling 物联网类型的 hub 集成见 source/_integrations/osoenergy.markdown 的 front matterha_iot_class: Cloud Polling、ha_integration_type: hub通过用户在 OSO Energy 官网创建的订阅密钥完成配置后Home Assistant 会自动发现并添加所有 OSO Energy 设备。集成提供binary_sensor额外能量、节能模式、加热状态、sensor加热器模式、优化模式、功率负载、40°C 混合水容量、V40 Min 阈值、多段水温等以及water_heater平台实体。方式一通过可视化界面开启加热对于习惯在界面中构建自动化的用户Home Assistant 会在操作配置界面中逐步引导无需编写 YAML见 source/_includes/actions/ui_header.md。在自动化或脚本中添加osoenergy.turn_on操作的完整步骤如下进入设置自动化与场景Automations scenes。打开现有的自动化或脚本若新建则选择创建自动化创建新自动化。新建自动化时需要在When何时执行部分添加触发器脚本Script不需要触发器它由其他自动化或操作调用时运行。在Then do然后执行部分选择添加操作Add action。在目标Target见下文操作的目标中选择要开启加热的热水器。从该目标对应的操作列表中选择OSO Energy: Turn on heating。设置Until temp limit直到温度上限选择开启加热直至达到最高温度或仅加热一小时。点击保存。界面中的选项说明界面选项是否必填说明Until temp limit是required: true启用true时加热持续到达到最高温度禁用false时仅加热一小时方式二通过 YAML 配置开启加热对于直接编写 YAML 或希望了解底层字段结构的用户YAML 方式提供了精确的字段名、类型与必填约束见 source/_includes/actions/yaml_header.md。在 YAML 中该操作以osoenergy.turn_on作为action字段值引用。官方文档给出的基础示例见 source/_actions/osoenergy.turn_on.markdown 的example块如下action: osoenergy.turn_on target: entity_id: water_heater.heater data: until_temp_limit: true这段配置的含义是对water_heater.heater这个热水器实体开启加热并持续加热直到达到最高温度。YAML 参数详解YAML 字段类型是否必填取值说明until_temp_limitboolean是required: true设为true时加热直到达到最高温度设为false时仅加热一小时until_temp_limit是该操作唯一的附加参数直接决定了加热的终止条件。在实际使用中你可以将其与传感器数据或时间条件组合实现精细化的加热策略例如在电价低谷时段将加热拉满until_temp_limit: true在电价高峰时段仅做一小时短时加热until_temp_limit: false以控制用电成本——这与集成中优化模式Optimization Mode传感器所反映的按外部因素如电价管理加热的理念一致见 source/_integrations/osoenergy.markdown 的传感器章节。操作的目标Targets机制osoenergy.turn_on操作需要指定目标目标即操作的作用对象。根据 source/_includes/actions/targets.md 的说明操作作用于water_heater域domain支持以下目标类型实体Entity单个water_heater实体例如water_heater.living_room设备Device属于某设备的所有water_heater实体区域Area某个房间/区域内的所有water_heater实体楼层Floor某个楼层上的所有water_heater实体标签Label共享某标签的所有water_heater实体。一个操作还可以同时指定多种目标类型例如将某个具体实体与某个区域同时作为目标一次性对两者生效。借助这一机制你可以用一个osoenergy.turn_on操作批量开启多个热水器的加热而无需逐台重复配置。进阶实践与关联操作组合的加热控制方案osoenergy.turn_on并非孤立存在OSO Energy 集成还提供了一系列与之紧密配合的操作均位于 source/_actions/ 目录下。这里给出几个基于官方文档的组合方案1. 关闭加热osoenergy.turn_offosoenergy.turn_off文档见 source/_actions/osoenergy.turn_off.markdown与osoenergy.turn_on互为镜像关闭加热时until_temp_limit设为true表示关闭加热直到达到最低温度设为false表示仅关闭一小时。二者共享同一个参数名便于记忆。action: osoenergy.turn_off target: entity_id: water_heater.heater data: until_temp_limit: true2. 设置 V40 Min 防冷水保护阈值osoenergy.set_v40_minosoenergy.set_v40_min文档见 source/_actions/osoenergy.set_v40_min.markdown用于设置 40°C 混合水的最低容量升。当当前可用容量低于该值时热水器会自动开启加热以防冷水用尽。参数v40_min类型为 float取值范围 200550必填。示例action: osoenergy.set_v40_min target: entity_id: water_heater.heater data: v40_min: 240这一操作与turn_on结合可形成双保险既可按需主动加热又可通过 V40 Min 阈值触发被动保护加热。3. 按小时设定目标温度曲线osoenergy.set_profileosoenergy.set_profile文档见 source/_actions/osoenergy.set_profile.markdown允许为一天中每个小时本地时间设置目标温度温度范围为 1075°C字段名为hour_00至hour_23均为可选的 integer 类型——只需提供要修改的小时未提供的小时保持原值。例如action: osoenergy.set_profile target: entity_id: water_heater.heater data: hour_06: 75 hour_07: 75 hour_18: 60上述配置在早晨时段06:00、07:00抬高目标温度傍晚18:00降低目标温度可结合turn_on的短时加热实现更精细的舒适度与能耗平衡。4. 度假离家osoenergy.turn_away_mode_onosoenergy.turn_away_mode_on文档见 source/_actions/osoenergy.turn_away_mode_on.markdown用于按指定天数开启离家模式激活热水器的 Holiday Mode参数duration_days为 integer 类型取值范围 1365必填。度假前开启该模式可避免热水器在无人使用时持续耗能。action: osoenergy.turn_away_mode_on target: entity_id: water_heater.heater data: duration_days: 7在自动化与脚本中的完整落地示例将以上能力组合起来可以构建一个典型的按电价分时加热自动化在低谷时段通过turn_on将热水器加热至最高温度在高峰时段用set_profile下调目标温度并结合set_v40_min保证基础热水供给。alias: 热水器分时加热策略 triggers: - trigger: time at: 22:30:00 conditions: [] actions: # 低谷电价时段加热直到最高温度 - action: osoenergy.turn_on target: entity_id: water_heater.heater data: until_temp_limit: true # 设定 V40 Min 保护阈值防止热水耗尽 - action: osoenergy.set_v40_min target: entity_id: water_heater.heater data: v40_min: 240 mode: single疑难排查与进一步学习如果在配置osoenergy.turn_on时遇到问题可以从以下方向排查对应 source/_actions/osoenergy.turn_on.markdown 中的标准排障指引确认集成已完成配置OSO Energy 集成需要先通过订阅密钥完成 config flow 配置设备被自动发现后才会出现对应的water_heater实体确认目标选择正确目标必须指向water_heater域的实体错误的域或无效的实体 ID 会导致操作无法执行确认until_temp_limit已设置该参数为必填项遗漏会导致操作校验失败检查网络与云服务状态该集成基于云轮询Cloud Polling离线或订阅密钥失效时操作将无法到达设备。如需进一步深入可继续阅读以下仓库文档OSO Energy 集成总览了解二进制传感器、传感器与热水器实体的完整能力清单osoenergy.turn_off关闭加热的镜像操作osoenergy.set_v40_min设置 40°C 混合水最低容量osoenergy.set_profile按小时设置目标温度曲线osoenergy.get_profile读取当前 24 小时温度曲线osoenergy.turn_away_mode_on按天数开启离家模式。通过osoenergy.turn_on及其配套操作你可以在 Home Assistant 中完整掌控 OSO Energy 热水器的加热行为实现按需加热、防冷水保护和假期节能的自动化管理。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考