Home Assistant 恒温器运行模式设置nexia.set_hvac_run_mode动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读nexia.set_hvac_run_mode是 Home Assistant 中 Nexia/American Standard/Trane 恒温器集成提供的核心动作用于一键设置温控器的**运行模式run mode**与HVAC 模式hvac mode——即决定温控器是遵循既定日程schedule还是锁定当前设定hold以及具体执行制热heat、制冷cool还是自动auto。阅读本文后你将掌握如何在自动化与脚本中以可视化 UI 或纯 YAML 两种方式调用该动作理解其参数语义、目标定位targeting机制与调用限制并知晓它在本仓库文档体系中的实现与佐证位置。一、动作概览run mode 与 HVAC mode 分别控制什么该动作的官方定位见 动作文档 的 frontmatter是Sets the run mode and HVAC mode on a Nexia thermostat.它适用于Nexia、American Standard、Trane三个品牌系的恒温器。动作一次调用可以只设置运行模式、只设置 HVAC 模式或两者同时设置两个参数在语义上互不干扰参数维度控制的内容可选值Run mode运行模式温控器是遵循内置日程还是锁定当前设定值permanent_hold永久锁定当前设定、run_schedule遵循日程HVAC mode暖通模式温控器执行制热、制冷还是自动切换auto、cool、heatRun mode 决定要不要跟日程run_schedule让温控器回到日程表按预定时间点自动切换目标温度permanent_hold则绕过日程永久保持当前设定值直到再次被切换回日程模式。HVAC mode 决定干什么活heat只制热、cool只制冷、auto让温控器按需在制热/制冷之间自动切换。这两个概念与 Nexia 集成的设备能力直接对应。根据 Nexia/American Standard/Trane 集成文档该集成为每个温控器区zone提供Hold mode保持模式开关——开启即对应 permanent hold关闭即恢复遵循日程同时为支持紧急加热的设备提供Emergency heat紧急加热开关。本动作相当于用程序化的方式把这类保持/日程与制热/制冷操作合并到一个原子调用中。二、在 UI 中使用该动作自动化与脚本的可视化配置如果你习惯可视化构建自动化Home Assistant 会在界面上逐步引导完成配置对应通用说明 actions/ui_header.md无需任何 YAML 知识。官方步骤如下进入Settings设置 Automations scenes自动化与场景。打开现有的自动化或脚本若没有选择Create automationCreate new automation创建自动化 创建新自动化。若是新建自动化在When当……时区域添加一个触发条件。脚本不需要触发条件——它们由其他内容在需要时调用。在Then do然后执行区域选择Add action添加动作。选择你要控制的对象。在By target按目标详见下文目标定位下选择要控制的温控器。在针对该目标展示的动作列表中选择Nexia: Set HVAC run modeNexia设置 HVAC 运行模式。设置Run mode、HVAC mode或两者都设置。点击Save保存。UI 中的选项字段在可视化界面中动作暴露两个可选字段由 options_ui 插件 渲染为表单字段是否必填说明Run mode否温控器如何遵循日程permanent_hold表示保持当前设定run_schedule表示遵循日程。HVAC mode否要设置的 HVAC 模式auto、cool或heat。三、在 YAML 中使用该动作完整配置示例如果你直接编写 YAML或希望精确了解 Home Assistant 在底层执行了什么对应通用说明 actions/yaml_header.md请按以下技术参考配置。动作在 YAML 中引用名称为nexia.set_hvac_run_mode。基础示例官方示例见 动作文档 的{% example %}块action: nexia.set_hvac_run_mode target: entity_id: climate.downstairs data: run_mode: permanent_hold hvac_mode: cool该示例的效果是将climate.downstairs锁定在制冷模式permanent hold cool。结合上文概念可理解为——先让温控器进入保持当前设定的状态再把 HVAC 模式设为制冷两步合并在一次动作调用中完成。YAML 字段参考表YAML 字段与 UI 字段一一对应由 options_yaml 插件 渲染为标准配置变量表含类型标注与必填徽章字段类型必填说明run_modestring否温控器如何遵循日程permanent_hold表示保持当前设定run_schedule表示遵循日程。hvac_modestring否要设置的 HVAC 模式auto、cool或heat。目标定位Targets该动作必须指定目标target。目标即动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的climate实体执行该动作通用说明 actions/targets.mdEntity实体一个具体的climate实体例如climate.downstairs。Device设备属于某设备的所有climate实体。Area区域某个房间/区域内的所有climate实体。Floor楼层某个楼层上的所有climate实体。Label标签共享某一标签的所有climate实体。你还可以在同一动作中混合不同目标类型例如同时添加一个具体实体和一个区域作为目标一次调用同时作用于两者。由于动作的 domain 是climate只有类型为climate的实体即本集成暴露的温控器实体才会被命中。四、注意事项参数组合约束官方在Good to know一节明确了一个重要的调用约束两个选项都是可选的但Run mode与HVAC mode至少必须提供其中一个。也就是说只传run_mode合法例如仅把温控器切回日程模式不改变制热/制冷设置只传hvac_mode合法例如仅切换到制冷不改变日程/保持状态两者都传合法即前文示例的保持 制冷组合两者都不传非法——空调用没有任何意义会被拒绝。五、快速试验开发者工具中的 Actions想在写自动化之前先验证动作效果打开Settings设置 Tools工具 Actions动作搜索nexia.set_hvac_run_mode填入字段后点击Perform action执行动作通用说明 actions/try_it.md。你可以在不写一行 YAML 的情况下在真实实体上立即看到效果例如观察温控器是否从遵循日程切换为永久保持 制冷。六、相关动作同一集成下的兄弟动作该动作在文档 frontmatter 中声明了三个相关动作见 nexia.set_hvac_run_mode.markdown 的related_actions字段由 actions/related.md 渲染为相关动作列表它们共同构成 Nexia 恒温器的程序化控制能力动作作用nexia.set_aircleaner_mode设置 Nexia 恒温器的空气净化器模式。nexia.set_humidify_setpoint设置加湿设定点。nexia.set_dehumidify_setpoint设置除湿设定点。配合使用时你可以在一套自动化中同时管理温控器的运行/HVAC 模式、空气净化与湿度设定。七、仓库佐证从源码看文档机制与集成背景1. 动作文档的渲染机制本仓库中每份动作文档都通过一组 Liquid 插件与 include 片段来保证 UI 与 YAML 两套说明的一致渲染plugins/options_yaml.rbOptionsYamlBlock继承自ConfigurationBlock通过SafeYAML.load解析 YAML 选项映射并复用render_config_vars渲染标准配置变量表含类型链接与 Required/Optional 徽章——这正是前文YAML 字段参考表在站点上的实际呈现方式。plugins/options_ui.rb渲染 UI 表单侧的选项说明与 options_yaml 保持同一份字段语义。plugins/example.rbExampleBlock支持action输入类型标签为Action语言高亮为yaml图标mdi:play-circle-outline将文档中的{% example %}代码块转为带语法高亮的可复制示例——即前文的基础 YAML 示例。通用步骤片段统一存放于 source/_includes/actions/ui_header.md、yaml_header.md、targets.md、try_it.md、related.md等确保所有动作页面遵循同一套交互逻辑与术语。2. 动作背后的集成背景nexia域对应的是 Nexia/American Standard/Trane 集成它通过云端轮询ha_iot_class: Cloud Polling方式接入 mynexia.com / asairhome.com 的温控器自 Home Assistant 0.108 起提供支持climate、sensor、switch、scene、number、binary_sensor等平台且通过 DHCP 自动发现。文档明确列出的受支持机型包括TraneXL1050、XL850、XL824American StandardAZONE1050、AZONE850、ACONT824明确不支持XL624、XL950、AZONE950、AZEMT500、AZEMT400B其他机型可能可用但未经测试。从集成文档可以推断run_mode: permanent_hold与集成提供的每个温控器区zone的Hold mode开关逻辑一致开启即保持设定关闭即遵循日程hvac_mode则直接映射 climate 平台的标准 HVAC 模式。如果你使用的是支持本地直连的机型还可关注同域的对偶方案 Trane Local 集成通过 mTLS 本地控制、状态实时推送无需云端但需注意nexia.set_hvac_run_mode属于云端 Nexia 集成的动作其目标实体由 Nexia 集成创建。八、遇到问题怎么办若动作未按预期生效官方建议见 actions/stuck.md在社区论坛发帖时附上你正在调用的动作与期望行为便于他人定位问题也可以向 AI 助手用自然语言描述你的诉求让其推荐或解释合适的动作。排查时可优先确认目标实体是否属于 Nexia 集成创建的climate实体、设备机型是否在支持列表内以及是否至少提供了run_mode与hvac_mode中的一个参数。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考