Home Assistant OpenTherm Gatewayset_setback_temperature 动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文聚焦 Home Assistant 中opentherm_gw集成提供的Set setback temperature动作讲解如何通过 UI 与 YAML 为 OpenTherm Gateway 配置回退温度setback temperature。该温度配合 GPIO 的Home与Away模式使用是实现离家/回家自动降温和升温的关键参数。读完本文你将掌握该动作的完整调用方式、参数约束温度 030℃、底层 GPIO 模式语义以及它与set_gpio_mode、set_outside_temperature等动作的协作关系。动作概述setback temperature 是什么Set setback temperature动作用于在 OpenTherm Gateway 上配置回退温度setback temperature。该值本身不会直接改变温控器设定点而是作为 GPIOHome5与Away6模式下的目标温度使用——即当 GPIO 引脚被拉低Home或拉高Away时温控器被切换到回退温度。该动作来自 Home Assistant 官方文档库动作域为opentherm_gw完整动作名为opentherm_gw.set_setback_temperature定义于 source/_actions/opentherm_gw.set_setback_temperature.markdown。其官方描述为Configures the setback temperature used with the GPIO home and away modes.使用前提在通过此动作设置回退温度前通常需要先将 GPIO 引脚配置为 Home 或 Away 模式否则该温度没有实际作用对象。GPIO 模式通过opentherm_gw.set_gpio_mode动作或集成页面中的select实体配置。GPIO 模式与回退温度的底层关系根据 OpenTherm Gateway 集成文档GPIO 引脚A 与 B支持以下模式其中与回退温度直接相关的有两个模式值名称说明0Input默认模式新烧录芯片上两个端口均为输入1Ground永久低电平输出0V可用于电源指示灯2Vcc永久高电平输出5V可短接保护供电3LED E附加 LED用于展示 4 种以上 LED 功能4LED F附加 LED用于展示 5 种以上 LED 功能5Home引脚被拉低时将温控器设为回退温度6Away引脚被拉高时将温控器设为回退温度7DS1820仅 GPIO BDS18S20/DS18B20 温度传感器数据线用于测量室外温度GPIO B 与 Vcc 之间需接 4k7 电阻从源码结构看set_setback_temperature动作写入的正是 GPIO Home/Away 模式所引用的回退温度值。典型场景是在门口开关或智能锁联动下当外出GPIO 拉高时温控器自动切到 Away 回退温度回家GPIO 拉低时切到 Home 回退温度。Home 与 Away 模式共用同一个回退温度值。从 UI 使用该动作若偏好可视化方式构建自动化或脚本可按照以下步骤操作打开设置自动化与场景Settings Automations scenes。打开现有自动化或脚本或选择创建自动化创建新自动化。新建自动化时在当...时When区域添加触发器脚本无需触发器由其他对象调用时直接运行。在然后执行Then do区域选择添加动作。在搜索框中搜索并选择OpenTherm Gateway: Set setback temperature。填写Gateway ID与Temperature。点击保存。UI 中的选项字段描述必填Gateway ID配置时指定的 OpenTherm Gateway ID是Temperature要在网关上配置的回退温度0 到 30是注意该动作不支持目标targets。在 UI 中不会提示选择区域、设备、实体或标签因为它作用于整个网关节点的配置而非某个实体。在 YAML 中使用该动作在 YAMLautomation 或 script中动作以opentherm_gw.set_setback_temperature引用。基本示例action: opentherm_gw.set_setback_temperature data: gateway_id: opentherm_gateway temperature: 16该示例在指定网关上将回退温度设为 16 度。YAML 字段参考字段类型必填说明gateway_idstring是OpenTherm Gateway 的 ID与配置时指定的值一致temperaturefloat是要在网关上配置的回退温度取值范围 0 到 30gateway_id 的由来gateway_id来自集成配置时的id字段。根据 opentherm_gw 集成配置说明该值用于在动作中标识具体网关并用于生成该网关相关实体的实体 ID。输入值会被 slugify所有空格和特殊字符转换为下划线重音字符被移除。例如thermostat、living_room。因此 YAML 中必须填写与你实例中配置一致且已 slugify的 ID。temperature 的取值范围temperature为float类型仅接受0 到 30之间的值。超出此范围的值会触发校验错误动作不会下发到网关。与室外温度动作不同回退温度没有清除已配置值的特殊约定室外温度为大于 64.0 时清除详见下文相关动作。结合其他动作实现完整场景该动作通常与以下动作搭配使用官方文档将其列为相关动作related actionsopentherm_gw.set_gpio_modeSet GPIO mode 用于更改网关 GPIO 引脚的功能。参数为gateway_id、idA或B与mode06 两脚均接受7 仅 GPIO B 接受。典型配置示例action: opentherm_gw.set_gpio_mode data: gateway_id: opentherm_gateway id: A mode: 5 # Home 模式拉低时切换回退温度先设置 GPIO 模式为 Home/Away再通过set_setback_temperature写入回退温度即可让引脚电平变化时自动切换温度。opentherm_gw.set_outside_temperatureSet outside temperature 用于向温控器提供室外温度-40.0 到 64.0 之间用于室外温度补偿OTC任何大于 64.0 的值建议 99会清除之前配置的值。它不直接作用于回退温度但同属网关配置类动作常在同一个自动化或脚本中一起调用。使用注意事项无目标支持该动作作用于网关本身不支持 targetsUI 中不会出现选择区域/设备/实体/标签的步骤。轮询协议延迟OpenTherm 协议基于轮询——温控器按固定间隔向锅炉发送请求。因此 Home Assistant 与温控器之间的变更传播可能存在延迟切换回退温度不会立即生效见 opentherm_gw 集成文档 中的说明。单实例独占请确保没有其他设备或应用程序同时连接 OpenTherm Gateway这不是受支持的场景可能导致意外结果。区分取消房间设定点覆盖集成还提供Cancel Room Setpoint Override按钮用于取消激活中的房间设定点覆盖但它不会改变目标温度仅将控制权交还温控器与回退温度动作是两个不同的概念。测试与验证配置完成后可在开发者工具操作Developer Tools Actions中选择opentherm_gw.set_setback_temperature填入gateway_id与temperature后执行观察是否返回成功。随后可将 GPIO 引脚按对应模式拉低/拉高验证温控器是否切换到回退温度也可以在网关上查看当前配置的回退温度值予以确认。小结opentherm_gw.set_setback_temperature是 Home Assistant 控制 OpenTherm Gateway 回退温度的核心动作参数简洁gateway_idtemperature030但只有与 GPIO Home/Away 模式配合时才有实际意义。理解 GPIO 模式表、正确获取 slugify 后的gateway_id、并留意 OpenTherm 轮询协议的延迟特性是正确使用该动作的关键。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考