Home Assistant OpenTherm Gateway 中央供暖覆盖ch_override动作实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文讲解 Home Assistant 中 OpenTherm Gateway 集成的opentherm_gw.set_central_heating_ovrd动作它的作用、与set_control_setpoint的联动机制、UI 与 YAML 两种配置方式、以及自研软件恒温器场景下的注意事项。读完本文你将能准确理解中央供暖覆盖central heating override的语义并能在自动化与脚本中正确使用该动作控制锅炉供暖回路。动作概览中央供暖覆盖是什么opentherm_gw.set_central_heating_ovrd用于在 OpenTherm Gateway 上设置中央供暖覆盖选项。其核心语义是开启后网关要求锅炉激活中央供暖回路。它与set_control_setpoint配合工作当你使用opentherm_gw.set_control_setpoint将控制设定点control setpoint设置为非 0 值时网关会自动启用中央供暖覆盖以开始供暖参见 set_central_heating_ovrd.markdown而本动作set_central_heating_ovrd的作用就是独立地控制中央供暖覆盖的开/关状态若要把中央供暖的控制权交还给恒温器应使用opentherm_gw.set_control_setpoint并将温度值设为0。⚠️适用范围官方文档明确指出只有在你编写自己的软件恒温器时才需要此动作。在使用之前务必阅读 OpenTherm Gateway 设计者关于独立模式standalone的说明理解在软件层面接管供暖控制的全部后果。从集成文档 opentherm_gw.markdown 可知OpenTherm 协议基于轮询机制恒温器按特定间隔向锅炉发送请求因此 Home Assistant 与恒温器之间的变更传播可能存在一定延迟这是使用覆盖类动作时需要留意的时序特性。何时真正需要它软件恒温器场景集成文档将switch类配置实体默认禁用描述为高级供暖控制并警告不当使用可能导致供暖系统持续运行、显著增加能耗。中央供暖覆盖同理属于旁路恒温器自主决策的高级能力典型使用场景包括编写软件恒温器由 Home Assistant 直接计算并向锅炉下达供暖指令在特定时间段强制锅炉开启供暖回路如临时手动升温与其他动作组合实现自定义供暖策略如配合set_max_modulation限制锅炉最大输出功率。请务必遵守集成文档中的硬性约束确保没有其他设备或应用程序同时连接 OpenTherm Gateway否则可能导致意外结果。从用户界面UI使用该动作该动作不支持 targets因此在 UI 中不会提示你选择区域、设备、实体或标签只需填写动作专属参数。UI 操作步骤如下进入SettingsAutomations scenes打开现有自动化或脚本或选择Create automationCreate new automation若是新建自动化在When区域添加触发器脚本无需触发器由其他对象调用时运行在Then do区域选择Add action在搜索框中搜索并选择OpenTherm Gateway: Set central heating override填写Gateway ID并设置Central heating override选择Save。UI 中可配置的两个选项如下选项说明必填Gateway IDOpenTherm Gateway 的 ID即配置该网关时指定的 ID是Central heating override启用或禁用中央供暖覆盖是在 YAML 中使用该动作在 YAML 中动作名为opentherm_gw.set_central_heating_ovrd。基本示例来自原文档action: opentherm_gw.set_central_heating_ovrd data: gateway_id: opentherm_gateway ch_override: true上述示例会在指定网关上启用中央供暖覆盖。YAML 参数详解参数类型必填默认值说明gateway_idstring是—OpenTherm Gateway 的 ID即配置网关时指定的 IDch_overrideboolean是false是否启用中央供暖覆盖说明gateway_id是集成配置时指定的标识符。根据 opentherm_gw.markdown 的说明该值会被 slugify 处理空格和特殊字符转为下划线、去除重音字符并用于生成该网关相关实体的实体 ID。集成文档给出的示例包括thermostat、living_room。ch_override是布尔值true启用覆盖false禁用覆盖文档给出的默认值为false。在自动化中组合使用set_central_heating_ovrd的典型搭档是opentherm_gw.set_control_setpoint控制设定点覆盖与opentherm_gw.set_max_modulation最大调制率覆盖三者共同构成软件恒温器的三个基本控制维度。相关动作的官方关联关系同样记录了这一点见本文关联动作一节。一个更完整的软件恒温器示例先设置控制设定点再显式打开中央供暖覆盖action: opentherm_gw.set_control_setpoint data: gateway_id: opentherm_gateway temperature: 60action: opentherm_gw.set_central_heating_ovrd data: gateway_id: opentherm_gateway ch_override: true而将控制权交还恒温器则是将控制设定点设回 0action: opentherm_gw.set_control_setpoint data: gateway_id: opentherm_gateway temperature: 0与覆盖相关的关键行为与边界结合set_control_setpoint与set_max_modulation两个关联动作文档以下行为边界对安全使用本动作至关重要覆盖自动启用将控制设定点设为非 0 值时网关自动启用中央供暖覆盖即本动作的ch_override: true状态开始请求锅炉供暖以 0 值归还控制权将控制设定点设为 0 会禁用覆盖把中央供暖控制权交还给恒温器重启即失效set_control_setpoint文档明确说明——由于长期启用该设置可能带来严重后果当 Home Assistant 关闭或重启时覆盖会被自动禁用。这一安全机制同样适用于中央供暖覆盖状态设定点范围控制设定点取值范围为 090摄氏度但并非所有锅炉都支持整个范围可通过slave_ch_max_setp与slave_ch_min_setp传感器查询锅炉支持的实际设定点范围安全警告set_control_setpoint文档特别警告不当使用可能导致中央供暖系统持续运行造成室内过热以及燃气或电力消耗显著增加。在 UI 中快速验证Try it yourself无需编写 YAML 即可验证该动作的实际效果打开SettingsToolsActions搜索该动作填写字段并选择Perform action即可在真实实体上观察行为。常见问题排查方向如果动作没有达到预期效果可以从以下方向排查确认 Gateway ID 正确必须与集成配置时指定的 ID 完全一致且注意 slugify 规则确认没有其他设备同时连接网关集成文档明确表示这不属于受支持的场景理解轮询延迟OpenTherm 协议基于轮询变更传播需要时间观察结果时留出缓冲检查覆盖状态是否被重置Home Assistant 关闭或重启后覆盖会被自动禁用属于预期行为而非故障。相关动作以下动作与本动作配合良好依据原文档related_actions元数据opentherm_gw.set_control_setpoint在网关上设置中央供暖控制设定点覆盖opentherm_gw.set_max_modulation覆盖网关上锅炉的最大相对调制率。此外集成文档 opentherm_gw.markdown 还提到LED 模式中的O表示远程设定点覆盖激活Remote setpoint override is active可用于在实体状态上确认覆盖是否生效网关设备上另有Cancel Room Setpoint Override按钮可取消活动中的房间设定点覆盖注意它不会改变目标温度只是把控制权交还给恒温器。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考