Home Assistant HomematicIP Cloud 集成set_home_cooling_mode 动作实现全屋采暖/制冷模式切换【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 官方文档仓库中homematicip_cloud.set_home_cooling_mode动作页为核心讲解如何在 HomematicIP Cloud 集成中通过自动化、脚本与 YAML 配置一键将整个 Homematic IP 家庭在采暖与制冷两种运行模式之间切换并结合集成文档与相关动作页面说明其参数语义、适用前提和排障入口。动作概述全屋级别的采暖/制冷开关homematicip_cloud.set_home_cooling_mode动作用于在 Home Assistant 中切换整个 Homematic IP 家庭的暖通运行方向将cooling设为true把全屋切换到制冷模式cooling mode将cooling设为false恢复为采暖模式heating mode。这个动作的粒度是整屋而非单个房间或单个气候实体适合在季节交替、室外温度变化等场景下由自动化统一调度所有房间的供暖/制冷策略。需要特别注意的适用前提有两个该动作仅对 Home Assistant 的管理员用户可用管理员权限限制来自动作文档本身HomematicIP Cloud 集成以云推送Cloud Push方式接入 Homematic IP 的云端服务器API 无官方文档、基于逆向工程实现因此实际行为以 Homematic IP 云端逻辑为准。在用户界面UI中配置该动作如果你倾向可视化地搭建自动化Home Assistant 会引导你逐步完成无需任何 YAML 知识。完整操作步骤继承自动作文档进入设置 自动化与场景Settings Automations scenes。打开一个现有自动化或脚本或者选择创建自动化 创建新自动化。如果是新建自动化在When部分添加触发条件脚本不需要触发条件它在被其他逻辑调用时执行。在Then do部分选择添加操作Add action。在搜索框中搜索并选择HomematicIP Cloud: Set home cooling mode。切换到制冷模式就把Cooling打开切换到采暖模式就关闭它。选择保存Save。此外该动作不支持 target 目标。在 UI 中你不会看到选择区域area、设备device、实体entity或标签label的提示——这是由动作本身的语义决定的它作用于整个家庭而非某个具体对象。UI 中的选项选项说明是否必填Cooling打开为制冷模式关闭为采暖模式否Access point IDHomematic IP 接入点的 ID即 SGTINSerialized Global Trade Item Number序列化全球贸易项目号码。如果只有一个接入点可以省略否在 YAML 中使用该动作如果直接编写 YAML或者想弄清 Home Assistant 底层实际下发的是什么内容YAML 中该动作的名称为homematicip_cloud.set_home_cooling_mode。文档给出的基础示例action: | action: homematicip_cloud.set_home_cooling_mode data: cooling: true这条调用会把整个家庭切换到制冷模式将cooling改为false或省略见下节默认值说明则恢复采暖。YAML 中的完整选项参考字段类型必填默认值说明coolingboolean否true打开为制冷模式关闭为采暖模式accesspoint_idstring否—Homematic IP 接入点的 IDSGTIN。若只有一个接入点可省略两个细节值得注意cooling的默认值是trueYAML 选项中明确标注default: true也就是说只写action: homematicip_cloud.set_home_cooling_mode而不带data时语义上等同于请求制冷模式多接入点部署时accesspoint_id的获取方式在集成文档中有说明可以在 HomematicIP Cloud 集成页面顶部找到或查看接入点背面印刷的编号。背景HomematicIP Cloud 集成是如何工作的理解该动作的前置条件需要简单了解其所属集成参见 HomematicIP Cloud 集成文档该集成自 Home Assistant 0.66 版本引入是一个hub 类型的集成ha_iot_class为Cloud Push——即 Home Assistant 与 Homematic IP 云端服务器通信设备事件经云端推送到 Home Assistant由于 Homematic IP 云 API 没有官方文档整个集成基于逆向工程完成集成文档也明确提示按自身风险使用集成支持的实体平台包括 alarm_control_panel、binary_sensor、button、climate、cover、diagnostics、event、light、lock、sensor、siren、switch、valve、weather 等其中climate平台是暖通类动作如本文的采暖/制冷切换的实体基础每个房间对应一个 Homematic IP 供暖组HmIP-HeatingGroup生成的 climate 实体由墙装/散热器温控器或温湿度传感器提供读数集成支持配置流config flow也保留了手动 YAML 配置方式accesspointauthtoken集成文档中有一条对所有作用于接入点的动作通用的备注所有此类动作都接受可选的accesspoint_id参数SGTIN单接入点部署可省略——本文动作的accesspoint_id选项正是这一通用约定的具体体现。从文档结构看set_home_cooling_mode属于 HomematicIP Cloud 域下少数直接操作整个接入点/家庭级别状态的云端动作之一而非操作某个具体设备实体这解释了它为什么没有 target、为什么只暴露cooling这一个核心参数。与其他 HomematicIP Cloud 暖通动作的配合动作文档的 front matter 中声明了三个相关动作related actions它们与set_home_cooling_mode共同构成 Homematic IP 暖通控制的动作族Set active climate profile切换某个 Homematic IP 气候实体的活动气候配置climate profile索引索引从 1 开始与 Homematic IP 应用中显示的 profile 顺序一致Activate eco mode with duration以分钟为单位定时激活接入点的节能模式eco mode时长结束后自动退出Activate vacation激活接入点的度假模式vacation mode保持目标温度直至指定日期时间自动退出。典型的季节切换场景可以这样组合先调用set_home_cooling_modecooling: true把全屋方向切到制冷再在夜间用activate_eco_mode_with_duration降低能耗返程时用deactivate_vacation之类的动作退出度假模式。这些动作大多同样遵循接入点级操作 可选accesspoint_id的参数约定。验证动作行为开发者工具中的 Actions 面板想在不写任何 YAML 的情况下立即验证该动作可以打开设置 工具 Actions即 Developer tools 的 Actions/Services 面板搜索set_home_cooling_mode填写cooling字段后选择Perform action即可在真实设备上观察全屋模式切换的实际效果。排障与注意事项小结权限该动作仅管理员可调用普通用户角色下可能无权限执行多接入点多接入点部署务必传accesspoint_idSGTIN否则会操作默认接入点ID 可在集成页面顶部或接入点背面查看依赖云端由于集成走 Cloud Push 通道若 Homematic IP 接入点的云连接异常可通过集成文档列出的HmIP-HAP云连接二进制传感器观察动作将无法生效设备支持范围Homematic IP 云端的能力受设备族支持程度限制若某些暖通行为不可用可先下载诊断文件集成页面 Download diagnostics已匿名化确认接入点上报的设备与状态遇到其他问题可参考文档给出的社区渠道Discord、社区论坛、/r/homeassistant求助提问时附上调用的动作与预期结果。小结homematicip_cloud.set_home_cooling_mode是一个参数极简、语义明确的家庭级动作——一个布尔值cooling决定全屋暖通方向一个可选的accesspoint_id定位接入点。掌握它之后配合气候 profile 切换、节能与度假模式动作就能在 Home Assistant 中构建完整的季节性暖通调度自动化。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考