Home Assistant ecobee 动作详解ecobee.set_sensors_used_in_climate设置参与气候程序的传感器【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioecobee.set_sensors_used_in_climate是 Home Assistant 为 ecobee 恒温器集成提供的动作用于设定哪些传感器参与某个气候程序climate program的温度判定。本文将基于 source/_actions/ecobee.set_sensors_used_in_climate.markdown 文档完整介绍该动作的 UI 操作步骤、YAML 参数、target 用法并结合 ecobee 集成文档 中关于 climate、preset、hold 等概念说明其底层原理与实战场景。读完本文你将掌握如何让不同房间的传感器按程序如 Sleep 用卧室、Home 用客厅分别影响恒温器温度决策。动作概述为什么需要按程序选择传感器ecobee 恒温器允许在同一台设备上配置多个温度传感器分布在不同的房间。默认情况下恒温器会综合所有启用传感器来决策目标温度但有些场景下你希望只有特定房间的传感器参与特定气候程序的温度判定——例如Sleep 程序只让卧室传感器参与避免客厅的温度拉高卧室的制冷/制热需求Home 程序只让客厅等公共区域传感器参与让有人活动的空间主导温度Away 程序按离家场景选择传感器组合。ecobee.set_sensors_used_in_climate动作正是为此设计它设置哪些传感器参与某个气候程序。该动作自 Home Assistant Core 2024.11 起随 ecobee 集成提供见 source/changelogs/core-2024.11.markdown。从文档的 front matter 可以确认该动作的完整定义动作名ecobee.set_sensors_used_in_climate所属域domainecobee官方描述设置哪些传感器参与 ecobee 恒温器上的某个气候程序从用户界面UI使用该动作如果你习惯可视化地构建自动化或脚本Home Assistant 会引导你逐步完成该动作的配置无需编写 YAML。参照文档中的步骤进入设置 自动化与场景Settings Automations scenes打开现有自动化或脚本或选择创建自动化创建新自动化若创建新自动化需在When触发条件部分添加触发器脚本则无需触发器脚本由其他动作调用时运行在Then do执行部分选择添加动作Add action选择要控制的设备在目标By target下详见后文 动作的目标选择要修改的 ecobee 恒温器从该目标可用的动作中选择ecobee: Set sensors used in climate选择要参与的传感器Sensors可选设置气候程序Climate program点击保存。UI 中的选项选项说明是否必填Sensors传感器设置为参与该气候程序的传感器是Climate program气候程序要设置传感器生效的气候程序名称默认为当前激活的程序否在 YAML 中使用该动作在 YAML 中该动作以ecobee.set_sensors_used_in_climate引用。文档给出的基本示例如下action: ecobee.set_sensors_used_in_climate target: entity_id: climate.living_room data: preset_mode: Home device_ids: - 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d该示例将device_ids指定的传感器设置为参与climate.living_room恒温器上Home程序的传感器。YAML 选项详解参数类型说明是否必填device_idslist字符串列表要设置为参与该气候程序的传感器的设备 ID列表是preset_modestring要设置传感器生效的气候程序名称默认为当前激活的程序否关于preset_mode的补充说明参数名虽为preset_mode但它对应的是 ecobee 的气候程序comfort setting名称。ecobee 恒温器内置 Home、Away、Sleep 三个预定义气候用户也可以自定义更多气候详见 source/_integrations/ecobee.markdown。因此该字段可填入诸如Home、Away、Sleep或自定义气候名称若省略则作用于当前正在激活的气候程序。device_ids从哪里获取这里的 ID 是 ecobee 传感器的设备标识而不是 Home Assistant 的实体 ID。你可以在 Home Assistant 的设置 设备与服务 ecobee下查看每个已发现的传感器设备的 ID或通过开发者工具中的实体/设备信息确认。与其他动作搭配的典型用法该动作通常与下面两个动作协同工作均收录于 source/_actions/ecobee.set_occupancy_modes启用或禁用 Smart Home/Away智能离家/在家与 Follow Me跟随我模式ecobee.resume_program恢复恒温器的程序调度清除 hold。例如一个完整的工作流可以是在切换到 Sleep 程序时先调用ecobee.set_sensors_used_in_climate让卧室传感器生效再调用ecobee.set_occupancy_modes关闭 Follow Me从而让睡眠场景完全由卧室传感器主导。动作的目标Targets该动作必须指定目标target。目标是动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标下所有匹配的climate实体执行动作规则定义见 source/_includes/actions/targets.md实体Entity单个 climate 实体例如climate.living_room设备Device属于某设备的所有 climate 实体区域Area某个房间/区域内所有 climate 实体楼层Floor某个楼层上所有 climate 实体标签Label共享某标签的所有 climate 实体。同一个动作中可以混合多种目标类型例如同时指定一个具体实体和一个区域让动作一次作用于两者。底层原理climate、preset 与 hold要正确使用本动作需要理解 ecobee 集成中的几个核心概念来源source/_integrations/ecobee.markdownClimate气候程序恒温器目标设定值的预定义或自定义集合。ecobee 提供三个预定义气候Home、Away、Sleepecobee 官方称之为 comfort settings用户可定义更多气候Preset预设/覆盖对当前激活气候中目标温度的临时覆盖。预设可能是显式设定的温度、派生自某个参考气候如 home/away/sleep或派生自恒温器定义的 vacation假期。所有 hold 都是临时的——温度和气候 hold 会在恒温器切换到程序中下一个气候时到期传感器参与恒温器依据参与气候程序判定的传感器读数来决定目标温度是否达到。ecobee.set_sensors_used_in_climate本质上是把哪些传感器参与哪个气候程序的决策权交给自动化从而实现按时间/场景动态切换温度感知来源。这正是文档开篇所述让不同房间影响温度取决于程序能力的技术基础。快速验证在开发者工具中试运行想在不写 YAML 的情况下验证效果按 source/_includes/actions/try_it.md 的说明进入设置 工具 操作Actions搜索ecobee.set_sensors_used_in_climate填写字段后点击执行操作Perform action即可在真实实体上立即看到效果。这非常适合在编写自动化前先验证传感器设备 ID 与气候程序名称填写是否正确。常见问题与注意事项气候程序名称大小写preset_mode使用 ecobee 气候名称如Home请与 ecobee 应用/设备中显示的名称保持一致设备 ID 而非实体 IDdevice_ids必须使用传感器设备 ID误填 climate 实体 ID如sensor.bedroom将导致动作失败默认行为省略preset_mode时作用于当前激活的气候程序适合在自动化触发时就地调整当前程序参与的传感器适用前提该动作需要 ecobee 集成已正确配置支持 API key 或账号密码登录见 ecobee 集成配置且目标恒温器与待设置的传感器已连接到 ecobee 账号。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考