Home Assistant OpenTherm Gateway Set LED Mode 动作详解LED 功能配置与 YAML 实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读opentherm_gw.set_led_mode是 Home Assistant 中用于修改 OpenTherm GatewayOTGWLED 指示灯功能的动作action。通过它你可以为网关的 LEDA至F六个指示灯分配不同的通信状态、加热状态或故障提示功能从而快速掌握家庭供暖系统的运行状况。读完本文你将完整掌握该动作的全部参数、LED 模式对照表、UI 可视化配置步骤与 YAML 自动化写法。动作概述这是什么OpenTherm Gateway 是一款用于桥接 Home Assistant 与 OpenTherm 供暖协议设备恒温器、锅炉的硬件网关。网关面板上带有一组 LED 指示灯用于显示通信与供热状态。Set LED mode动作的作用正是更改网关上 LED 的功能——即把某个 LED 重新指派给另一项状态指示。在 Home Assistant 文档体系中该动作归属于opentherm_gw集成domain完整的动作标识为opentherm_gw.set_led_mode。官方对它的定义是Changes the function of the LEDs of the gateway.动作说明文档位于 source/_actions/opentherm_gw.set_led_mode.markdown其所属集成的主文档为 source/_integrations/opentherm_gw.markdown。与 Select 实体的关系从集成文档看OpenTherm Gateway 集成会为每个配置的网关添加三个设备其中OpenTherm Gateway设备上带有多个select配置实体这些实体同样可以用于配置网关的 LED 和 GPIO 引脚见 source/_integrations/opentherm_gw.markdown。也就是说除了通过动作在自动化中动态设置 LED 模式你也可以在界面上直接操作 select 实体来配置。动作方式更适合按事件动态切换的场景实体方式更适合一次性静态配置。参数说明Options该动作共接受三个参数全部为必填项required: true且不支持 targets——在 UI 中不会被提示选择区域、设备、实体或标签。参数UI 字段类型必填说明gateway_idGateway IDstring是OpenTherm Gateway 的 ID与集成配置时指定的id一致idIDstring是要配置的 LED 编号取值为A到F之一modeModestring是要赋予该 LED 的功能取值含义见下方LED 模式对照表gateway_id 从哪来gateway_id对应集成配置阶段填写的id字段。根据集成文档source/_integrations/opentherm_gw.markdown该值用于在动作中标识特定网关并用于生成该网关相关实体的 entity ID输入值会被 slugify 处理——即所有空格和特殊字符转换为下划线并移除字符上的重音符号。例如配置时填写thermostat或living_room动作中的gateway_id就相应填写thermostat或living_room。LED 模式对照表mode参数的可选值及含义与集成文档 LED modes 章节完全一致。完整对照如下模式值含义R正在从恒温器或锅炉接收 OpenTherm 消息X正在向恒温器或锅炉发送 OpenTherm 消息T在恒温器接口上发送或接收消息B在锅炉接口上发送或接收消息O远程设定点覆盖setpoint override处于激活状态F火焰开启锅炉燃烧中H中央供暖开启W热水开启C舒适模式生活热水使能开启E检测到传输错误M锅炉需要维护P恒温器接口上的升压功率模式激活这些模式同时也是 OTGW 固件配置命令所支持的 LED 功能可参考 OpenTherm Gateway 固件的 configuration 文档理解底层实现本文不再展开外部链接。通过 UI 配置可视化操作如果你倾向于在界面中可视化地构建自动化或脚本可以按以下步骤操作进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本或者选择Create automationCreate new automation新建。如果是新建自动化在When何时部分添加触发器脚本则不需要触发器它们在被其他内容调用时运行。在Then do然后执行部分选择Add action添加动作。在搜索框中搜索并选择OpenTherm Gateway: Set LED mode。填写Gateway ID选择 LED 的ID并设置Mode。点击Save保存。需要再次强调的是该动作不支持 targets因此在 UI 中不会提示你选择区域、设备、实体或标签只需直接填写上述三个字段。通过 YAML 配置自动化/脚本写法在 YAML 中动作通过action: opentherm_gw.set_led_mode引用。官方文档给出的基础示例action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: A mode: F该示例将火焰开启Flame is on功能分配给选中网关的 LEDA。你可以根据实际需要把id换成B–F把mode换成上表中的任意模式值。YAML 参数速查字段类型必填说明gateway_idstring是网关 ID与配置时指定值一致idstring是LED 编号A至F之一modestring是要分配的功能见 LED 模式对照表自动化中的完整用法示例将 LEDB配置为中央供暖开启指示同时把 LEDE配置为传输错误指示alias: Configure OTGW LEDs at startup triggers: - trigger: homeassistant event: start actions: - action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: B mode: H - action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: E mode: E mode: single无需编写 YAML 的即时测试想在不写任何 YAML 的情况下先验证效果打开SettingsToolsActions工具 动作搜索opentherm_gw.set_led_mode填写字段后点击Perform action执行动作即可在你的真实实体上立即看到 LED 配置的变化。相关动作Set GPIO mode该动作在 front matter 中声明了关联动作opentherm_gw.set_gpio_mode见 opentherm_gw.set_gpio_mode.markdown。两者功能逻辑完全对称opentherm_gw.set_led_mode配置 LEDA–F的功能opentherm_gw.set_gpio_mode配置 GPIO 引脚A/B的功能取值0–6对两个引脚均有效7仅 GPIOB可用。例如set_gpio_mode的示例将 GPIOA设为5Home——拉低时恒温器切换至回退温度其 GPIO 模式完整含义Input、Ground、Vcc、LED E/F、Home、Away、DS1820 温度传感器数据线等同样收录在集成文档 GPIO modes 章节。如果你的自定义面板接入了额外 LED 或传感器这两个动作通常需要配合使用。注意事项协议轮询特性OpenTherm 协议基于轮询恒温器按固定间隔向锅炉发送请求因此 Home Assistant 与恒温器之间的变更传播可能存在延迟见集成文档 source/_integrations/opentherm_gw.markdown。配置 LED 后其生效同样遵循这一机制。单一连接请确保没有其他设备或应用同时连接 OpenTherm Gateway这是不受支持的场景可能导致意外结果。gateway_id必须精确匹配它与配置集成时填写的id一致slugify 后的值才是动作实际使用的标识。实现机制备忘文档站点侧该动作页面的 UI/YAML 参数区块由仓库 Jekyll 插件渲染options_ui标签由 plugins/options_ui.rb 实现用于生成带 Required/Optional 徽标的 UI 参数表options_yaml标签由 plugins/options_yaml.rb 实现复用共享的ConfigurationBlock渲染 YAML 参数表。页面中的操作步骤、测试入口与相关动作区块则来自 source/_includes/actions/ 下的一组 include 文件ui_header.md、yaml_header.md、try_it.md、stuck.md、related.md。对于想要为文档贡献类似动作页面的开发者这是一套可复用的标准模板。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant OpenTherm Gateway Set LED Mode 动作详解：LED 功能配置与 YAML 实战
Home Assistant OpenTherm Gateway Set LED Mode 动作详解LED 功能配置与 YAML 实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读opentherm_gw.set_led_mode是 Home Assistant 中用于修改 OpenTherm GatewayOTGWLED 指示灯功能的动作action。通过它你可以为网关的 LEDA至F六个指示灯分配不同的通信状态、加热状态或故障提示功能从而快速掌握家庭供暖系统的运行状况。读完本文你将完整掌握该动作的全部参数、LED 模式对照表、UI 可视化配置步骤与 YAML 自动化写法。动作概述这是什么OpenTherm Gateway 是一款用于桥接 Home Assistant 与 OpenTherm 供暖协议设备恒温器、锅炉的硬件网关。网关面板上带有一组 LED 指示灯用于显示通信与供热状态。Set LED mode动作的作用正是更改网关上 LED 的功能——即把某个 LED 重新指派给另一项状态指示。在 Home Assistant 文档体系中该动作归属于opentherm_gw集成domain完整的动作标识为opentherm_gw.set_led_mode。官方对它的定义是Changes the function of the LEDs of the gateway.动作说明文档位于 source/_actions/opentherm_gw.set_led_mode.markdown其所属集成的主文档为 source/_integrations/opentherm_gw.markdown。与 Select 实体的关系从集成文档看OpenTherm Gateway 集成会为每个配置的网关添加三个设备其中OpenTherm Gateway设备上带有多个select配置实体这些实体同样可以用于配置网关的 LED 和 GPIO 引脚见 source/_integrations/opentherm_gw.markdown。也就是说除了通过动作在自动化中动态设置 LED 模式你也可以在界面上直接操作 select 实体来配置。动作方式更适合按事件动态切换的场景实体方式更适合一次性静态配置。参数说明Options该动作共接受三个参数全部为必填项required: true且不支持 targets——在 UI 中不会被提示选择区域、设备、实体或标签。参数UI 字段类型必填说明gateway_idGateway IDstring是OpenTherm Gateway 的 ID与集成配置时指定的id一致idIDstring是要配置的 LED 编号取值为A到F之一modeModestring是要赋予该 LED 的功能取值含义见下方LED 模式对照表gateway_id 从哪来gateway_id对应集成配置阶段填写的id字段。根据集成文档source/_integrations/opentherm_gw.markdown该值用于在动作中标识特定网关并用于生成该网关相关实体的 entity ID输入值会被 slugify 处理——即所有空格和特殊字符转换为下划线并移除字符上的重音符号。例如配置时填写thermostat或living_room动作中的gateway_id就相应填写thermostat或living_room。LED 模式对照表mode参数的可选值及含义与集成文档 LED modes 章节完全一致。完整对照如下模式值含义R正在从恒温器或锅炉接收 OpenTherm 消息X正在向恒温器或锅炉发送 OpenTherm 消息T在恒温器接口上发送或接收消息B在锅炉接口上发送或接收消息O远程设定点覆盖setpoint override处于激活状态F火焰开启锅炉燃烧中H中央供暖开启W热水开启C舒适模式生活热水使能开启E检测到传输错误M锅炉需要维护P恒温器接口上的升压功率模式激活这些模式同时也是 OTGW 固件配置命令所支持的 LED 功能可参考 OpenTherm Gateway 固件的 configuration 文档理解底层实现本文不再展开外部链接。通过 UI 配置可视化操作如果你倾向于在界面中可视化地构建自动化或脚本可以按以下步骤操作进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本或者选择Create automationCreate new automation新建。如果是新建自动化在When何时部分添加触发器脚本则不需要触发器它们在被其他内容调用时运行。在Then do然后执行部分选择Add action添加动作。在搜索框中搜索并选择OpenTherm Gateway: Set LED mode。填写Gateway ID选择 LED 的ID并设置Mode。点击Save保存。需要再次强调的是该动作不支持 targets因此在 UI 中不会提示你选择区域、设备、实体或标签只需直接填写上述三个字段。通过 YAML 配置自动化/脚本写法在 YAML 中动作通过action: opentherm_gw.set_led_mode引用。官方文档给出的基础示例action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: A mode: F该示例将火焰开启Flame is on功能分配给选中网关的 LEDA。你可以根据实际需要把id换成B–F把mode换成上表中的任意模式值。YAML 参数速查字段类型必填说明gateway_idstring是网关 ID与配置时指定值一致idstring是LED 编号A至F之一modestring是要分配的功能见 LED 模式对照表自动化中的完整用法示例将 LEDB配置为中央供暖开启指示同时把 LEDE配置为传输错误指示alias: Configure OTGW LEDs at startup triggers: - trigger: homeassistant event: start actions: - action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: B mode: H - action: opentherm_gw.set_led_mode data: gateway_id: opentherm_gateway id: E mode: E mode: single无需编写 YAML 的即时测试想在不写任何 YAML 的情况下先验证效果打开SettingsToolsActions工具 动作搜索opentherm_gw.set_led_mode填写字段后点击Perform action执行动作即可在你的真实实体上立即看到 LED 配置的变化。相关动作Set GPIO mode该动作在 front matter 中声明了关联动作opentherm_gw.set_gpio_mode见 opentherm_gw.set_gpio_mode.markdown。两者功能逻辑完全对称opentherm_gw.set_led_mode配置 LEDA–F的功能opentherm_gw.set_gpio_mode配置 GPIO 引脚A/B的功能取值0–6对两个引脚均有效7仅 GPIOB可用。例如set_gpio_mode的示例将 GPIOA设为5Home——拉低时恒温器切换至回退温度其 GPIO 模式完整含义Input、Ground、Vcc、LED E/F、Home、Away、DS1820 温度传感器数据线等同样收录在集成文档 GPIO modes 章节。如果你的自定义面板接入了额外 LED 或传感器这两个动作通常需要配合使用。注意事项协议轮询特性OpenTherm 协议基于轮询恒温器按固定间隔向锅炉发送请求因此 Home Assistant 与恒温器之间的变更传播可能存在延迟见集成文档 source/_integrations/opentherm_gw.markdown。配置 LED 后其生效同样遵循这一机制。单一连接请确保没有其他设备或应用同时连接 OpenTherm Gateway这是不受支持的场景可能导致意外结果。gateway_id必须精确匹配它与配置集成时填写的id一致slugify 后的值才是动作实际使用的标识。实现机制备忘文档站点侧该动作页面的 UI/YAML 参数区块由仓库 Jekyll 插件渲染options_ui标签由 plugins/options_ui.rb 实现用于生成带 Required/Optional 徽标的 UI 参数表options_yaml标签由 plugins/options_yaml.rb 实现复用共享的ConfigurationBlock渲染 YAML 参数表。页面中的操作步骤、测试入口与相关动作区块则来自 source/_includes/actions/ 下的一组 include 文件ui_header.md、yaml_header.md、try_it.md、stuck.md、related.md。对于想要为文档贡献类似动作页面的开发者这是一套可复用的标准模板。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考