十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Home Assistant 中 Eurotronic Comet Blue「Get schedule」动作实战:读取采暖温控器每周日程

Home Assistant 中 Eurotronic Comet Blue「Get schedule」动作实战:读取采暖温控器每周日程 Home Assistant 中 Eurotronic Comet Blue「Get schedule」动作实战读取采暖温控器每周日程【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文基于 Home Assistant 官方文档仓库中的 Get schedule 动作文档讲解eurotronic_cometblue.get_schedule这一动作的用途、YAML 与 UI 两种调用方式、响应数据的完整结构以及如何将其与 Set schedule 动作 和 Eurotronic Comet Blue 集成 配合在自动化、脚本或开发者工具中读取并核查蓝牙温控器上的采暖日程配置。动作概述eurotronic_cometblue.get_schedule用于从 Eurotronic Comet Blue及兼容机型温控器中检索当前已配置的采暖日程。该动作自 Home Assistant2026.7版本起提供见文档 front matter 中的since字段属于eurotronic_cometblue集成下的设备动作action可以在自动化、脚本中调用也可以在「设置 工具 动作」的开发者界面中手动触发以检查当前日程。理解这一动作的关键背景是 Comet Blue 设备的日程工作机制日程激活时段温控器会自动尝试达到Comfort舒适预设对应的温度即“高日程温度”日程未激活时段温控器使用Eco节能预设对应的温度即“低日程温度”。因此get_schedule返回的本质上就是设备内部那张“哪天、哪些时段按 Comfort 温度运行”的时间表。根据 Eurotronic Comet Blue 集成文档集成明确写道“You can read and adjust the schedule from Home Assistant via the provided actions”——读取与调整日程都通过配套动作完成而读取由get_schedule负责。该集成的设备前提是通过蓝牙Bluetooth连接ha_iot_class: Local Polling默认每 5 分钟轮询一次支持的机型包括Eurotronic Comet BlueSygonix HT100 BTXavax HamaLidl Silvercrest RT2000BTUI 中调用 Get schedule 动作在图形界面中检索设备日程的操作步骤如下继承自原文档进入「设置 自动化与场景」Automations scenes打开一个已有的自动化或脚本或选择Create automationCreate new automation如果是新建自动化在When部分添加触发器脚本不需要触发器脚本由其他东西调用时运行在Then do部分选择Add action在搜索框中搜索并选择Eurotronic Comet Blue: Get schedule选择控制对象在By target见下文“动作的目标”下选择一个或多个温控器输入一个响应变量response variable的名称用于在后续步骤中使用日程数据选择Save保存。其中第 7 步的响应变量是这一动作区别于普通“无返回值”动作的核心它把日程数据存进一个命名变量供后续步骤条件判断、通知、日志等直接引用。YAML 中调用 Get schedule 动作在 YAML 中该动作写作eurotronic_cometblue.get_schedule。原文档给出的基础示例如下action: | action: eurotronic_cometblue.get_schedule target: entity_id: climate.kitchen response_variable: my_schedule这个示例从climate.kitchen实体读取当前日程并将其存入响应变量my_schedule。参数说明该动作只有两个可选参数均不是必填参数类型说明target对象动作作用目标。可以是单个 climate 实体如climate.kitchen、设备、区域、楼层或标签Home Assistant 会对该目标下的每个匹配的eurotronic_cometblue实体执行动作response_variable字符串任意自定义名称用于承载动作返回的日程数据供后续步骤引用关于response_variable的机制官方脚本文档脚本动作执行说明response_variable就是“包含响应数据的变量”名称可以自定义脚本执行后该变量即可被后续步骤读取。动作的目标Targets该动作要求提供 target。根据仓库中通用的 targets 说明支持五种目标类型且可以在同一个动作中混合使用多种目标类型Entity实体一个具体的 climate 实体如climate.living_roomDevice设备属于某设备的所有 climate 实体Area区域某房间/区域内的所有 climate 实体Floor楼层某楼层上的所有 climate 实体Label标签共享某标签的所有 climate 实体。例如可以在同一动作中同时添加一个具体实体和一个区域让动作一次作用于两者。响应数据结构重点这是原文档Good to know部分的核心内容理解它才能正确编写后续逻辑响应数据为每个被指定的 climate 实体各包含一个顶层字段即实体 ID 作为键每个实体下有7 个字段分别对应一周七天键名为小写英文monday到sunday每一天的值是一个时间区间列表未配置任何采暖日程的天返回空列表[]。原文档给出的完整示例响应如下climate.kitchen: monday: - from: 07:00:00 to: 09:00:00 - from: 17:00:00 to: 22:00:00 tuesday: [] wednesday: [] thursday: - from: 07:00:00 to: 09:00:00 friday: - from: 07:00:00 to: 09:00:00 saturday: - from: 09:00:00 to: 12:00:00 sunday: []结合示例可以读出几个实战要点时间格式响应中的时间统一为HH:MM:SS字符串带秒与 Set schedule 动作 写入时常用的HH:MM不同。如果你在自动化里把读回的日程再回写给设备注意做格式归一空天是[]而非缺省判断“某天是否有日程”应检查列表长度而不是判断键是否存在——七天键始终都在多目标时按实体分键如果target命中多个 climate 实体例如整个区域响应顶层会有多个实体 ID 键各自独立携带 7 天的日程。结合仓库文档的纵深说明日程与预设的联动关系集成文档中 climate 平台支持的预设与get_schedule返回的数据直接对应Eco温度设为“低日程温度”schedule off 时使用的温度Comfort温度设为“高日程温度”schedule on 时使用的温度Boost阀门全开Away假期模式激活仅显示None温度不在上述情况内仅显示。也就是说get_schedule读到的每个from/to区间就是设备将自动切换为 Comfort 目标温度的时段。集成文档同时强调设备按内部日程运行可以临时手动控制一旦手动修改目标温度或使用预设温控器会在下一次日程切换点恢复到程序化日程。与 Set schedule 动作配对使用get_schedule的姊妹动作是 Set scheduleeurotronic_cometblue.set_schedule两者构成“读—改—写”日程的完整工具链。Set schedule 的规则对理解 get_schedule 的返回数据同样重要每天最多4 个时间区间省略某天该天日程保持不变某天传空列表清空该天日程此时 get_schedule 读回该天即为[]时间区间不能重叠设备支持10 分钟时间粒度其他时间会向下取整到前一个 10 分钟刻度。一个典型的“读取当前日程→修改后回写”脚本骨架如下示意基于两个动作文档的字段格式alias: 调整厨房温控器周一日程 sequence: - action: eurotronic_cometblue.get_schedule target: entity_id: climate.kitchen response_variable: current_schedule - action: eurotronic_cometblue.set_schedule target: entity_id: climate.kitchen data: monday: - from: 05:00 to: 07:00 - from: 16:00 to: 23:30第一步先把现有日程读入current_schedule可用于日志、条件判断或备份第二步只更新周一其余天按 set_schedule 的规则保持不变。设备侧限制对日程数据的约束集成文档的Known limitations一节列出了影响日程数据的硬件级限制设备仅支持0.5°C 温度步长和10 分钟时间步长手动改温或使用预设后温控器在下一个日程切换点恢复程序化日程若温控器处于假期模式holiday mode无法从 Home Assistant 复位需按压设备上的MENU键直到复位。此外集成还为每台设备提供一个Sync time按钮同步设备内部时钟与 Home Assistant 当前时间。日程依赖设备内部时钟驱动若怀疑日程“没按时生效”先确认设备时钟是否正确是该排障路径的第一步。动手试一试按照原文档Try it yourself的建议打开「设置 工具 动作」developer_services搜索get_schedule填入目标实体并选择Perform action即可在真实实体上执行并直接看到响应数据无需编写任何 YAML。若遇到问题原文档的Still stuck?部分建议社区论坛、Discord、/r/homeassistant 子版都是提问渠道也可以把动作调用内容和你期望的行为描述给 AI 助手辅助分析。小结eurotronic_cometblue.get_schedule自 2026.7 起提供用于读取 Comet Blue 系列蓝牙温控器内的每周采暖日程调用只需target实体/设备/区域/楼层/标签和response_variable两个可选字段YAML 与 UI 均可配置响应按“实体 ID → 七天小写键 → 时间区间列表”三层组织空日程天为[]时间格式为HH:MM:SS与set_schedule配对可实现日程的读、改、写闭环同时注意设备 10 分钟粒度、每天最多 4 段、区间不可重叠等硬限制排查日程异常时优先核对设备时钟Sync time 按钮与假期模式状态。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表