Home Assistant Netatmo 清空调温设置指南：netatmo.clear_temperature_setting 使用详解
Home Assistant Netatmo 清空调温设置指南netatmo.clear_temperature_setting 使用详解【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读netatmo.clear_temperature_setting是 Home Assistant Netatmo 集成提供的清空调温设置动作action用于撤销此前通过netatmo.set_temperature_with_end_datetime、netatmo.set_temperature_with_time_period或netatmo.set_preset_mode_with_end_datetime设置的手动温度覆盖让 Netatmo 恒温器或智能阀门立即恢复执行当前预设preset与加热计划schedule。本指南将围绕该动作系统讲解其在自动化与脚本中的配置方式、YAML 语法、目标target选择规则并结合仓库中的动作文档与 Netatmo 集成文档给出可复制的实战示例帮助你掌握手动覆盖 — 到期恢复 — 主动清除这一完整闭环的温度控制策略。动作是什么该动作的官方定义见 动作文档为Clears a manual temperature setting on a Netatmo climate device.即清除 Netatmo 气候设备上的手动温度设置。执行后设备立即回退到它当前的预设或加热计划而不是继续维持手动温度。其 Front Matter 中声明的related_actions包括netatmo.set_temperature_with_end_datetime设置目标温度直到指定日期时间netatmo.set_temperature_with_time_period设置目标温度持续指定时长netatmo.set_preset_mode_with_end_datetime设置预设模式直到指定日期时间netatmo.set_schedule切换加热计划从源码结构看相关动作渲染模板 会遍历page.related_actions并在文章末尾自动生成相关动作区块因此这几个动作被官方明确视为与清空调温设置配合使用的姊妹动作。适用设备该动作作用于 Netatmo 集成下的climate实体。根据 Netatmo 集成文档 中的 Climate 一节netatmo气候平台消费以下设备的信息并允许查看当前温度、控制设定值setpointNetatmo Smart Thermostat智能恒温器Netatmo Smart Modulating Thermostat智能调节恒温器Netatmo Smart Radiator Valve智能暖气片阀门也就是说只要你的 Netatmo 账号下配置了上述任一种能源类设备在完成集成配置通过配置流程ha_config_flow: true引导后就会生成对应的climate.实体可被本动作作为目标。在 UI 中使用该动作对于不熟悉 YAML 的用户可以在自动化或脚本编辑器中通过图形界面完成配置对应文档中的actions/ui_header.md步骤指引进入Settings Automations scenes自动化与场景。打开一个已有的自动化或脚本或者选择Create automationCreate new automation新建。如果是新建自动化在When何时部分添加一个触发器脚本不需要触发器它由其他对象调用时执行。在Then do然后执行部分选择Add action添加动作。选择要控制的设备在By target按目标详见下文 目标选择下选择要控制的 Netatmo 气候设备。在针对该目标显示的动作列表中选择Clear temperature setting清空调温设置。点击Save保存。UI 中的选项该动作在 UI 中没有任何额外选项只需指定目标设备即可。这一点与设置温度类动作不同——例如netatmo.set_temperature_with_end_datetime在 UI 中还需要填写Target temperature7–30 度与End date time两个字段。也正因如此清除动作在 UI 里是最简洁的一类选好设备保存完事。YAML 中的使用方法基础示例在 YAML 中自动化、脚本或action调用中动作名称为netatmo.clear_temperature_setting。官方文档给出的基础示例为action: netatmo.clear_temperature_setting target: entity_id: climate.living_room该示例会清除climate.living_room上的任何手动温度设置使其立即回到当前预设或加热计划。在自动化中完整的写法如下automation: - alias: Clear manual temperature override at night triggers: - trigger: time at: 23:00:00 actions: - action: netatmo.clear_temperature_setting target: entity_id: climate.living_room目标选择Targets本动作必须指定目标target目标是动作的作用对象。根据 targets.md 的说明你可以将目标指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标下每一个匹配的netatmo实体执行动作目标类型含义示例Entity实体一个具体的climate实体climate.living_roomDevice设备属于某设备的所有climate实体选择 Netatmo 恒温器设备Area区域某个房间/区域内的所有climate实体选择客厅区域Floor楼层某一楼层上的所有climate实体选择一楼楼层Label标签共享某标签的所有climate实体选择radiators标签不同目标类型还可以在同一个动作里混合使用。例如可以同时添加一个具体实体和一个区域作为目标动作会对两者一次性执行action: netatmo.clear_temperature_setting target: entity_id: climate.living_room area_id: living_room这种实体 区域的组合非常实用例如自动化结束时既想清除客厅恒温器的覆盖又想顺带清除整个区域的覆盖。手动覆盖的完整闭环要真正用好清除动作需要理解 Netatmo 温度控制的三种手动状态及其与清除动作的关系1. 定时清除到期自动恢复以下三个动作都会创建带时限的手动覆盖到期后设备自动回到当前加热计划无需手动清除netatmo.set_temperature_with_end_datetime设置目标温度直到指定日期时间。参数target_temperaturefloat7–30 度、end_datetimedatetime。action: netatmo.set_temperature_with_end_datetime target: entity_id: climate.living_room data: target_temperature: 19.5 end_datetime: 2025-04-20 05:04:20netatmo.set_temperature_with_time_period设置目标温度持续指定时长默认 3 小时。参数target_temperaturefloat7–30 度、time_period时长如hours: 2。action: netatmo.set_temperature_with_time_period target: entity_id: climate.living_room data: target_temperature: 19.5 time_period: hours: 2netatmo.set_preset_mode_with_end_datetime设置预设模式away或frost_guard直到指定日期时间。参数preset_modestringaway/frost_guard、end_datetimedatetime。action: netatmo.set_preset_mode_with_end_datetime target: entity_id: climate.living_room data: preset_mode: away end_datetime: 2025-04-20 05:04:202. 主动清除立即恢复当手动覆盖尚未到期、但条件已经变化时就需要netatmo.clear_temperature_setting主动撤销。典型场景自动化早些时候设置了手动温度后续某个条件如有人回家、房间被占用触发希望立即恢复计划而非等待到期手动设置的时长或截止时间设置过长需要中途撤销切换预设/计划之前先清除可能冲突的手动温度覆盖。3. 状态触发清除设备级触发器除了主动调用动作Netatmo 集成还提供了设备触发器device triggers见 集成文档 的 Device triggers 一节其中与温度覆盖直接相关的事件有Target temperature set manually手动设置了目标温度Has resumed its schedule已恢复其加热计划Switched to {subtype}切换到某模式subtype 为 Schedule、Frost guard 或 Away你可以把这些触发器与清除动作组合。例如检测到手动静音覆盖被触发时发送通知或设备已恢复计划时更新某个输入布尔值。这使得覆盖状态的感知与清除动作形成完整的自动化闭环。完整实战示例示例 1客人到访时临时升温离开后立即恢复计划当有人进入客厅区域占用传感器触发时设置 21°C 并持续 2 小时当区域无人时无论覆盖是否到期立即清除并回到计划automation: - alias: Boost living room when occupied, restore when empty triggers: - trigger: state entity_id: binary_sensor.living_room_occupancy to: on actions: - action: netatmo.set_temperature_with_time_period target: entity_id: climate.living_room data: target_temperature: 21.0 time_period: hours: 2 - alias: Clear temperature override when room is empty triggers: - trigger: state entity_id: binary_sensor.living_room_occupancy to: off actions: - action: netatmo.clear_temperature_setting target: entity_id: climate.living_room示例 2离家时切到 Away 预设并带上撤销逻辑离家时切换到away预设并在指定时刻结束若中途有人返回立即清除覆盖以恢复正常计划automation: - alias: Away preset while out triggers: - trigger: state entity_id: person.owner to: not_home actions: - action: netatmo.set_preset_mode_with_end_datetime target: entity_id: climate.living_room data: preset_mode: away end_datetime: 2025-04-20 22:00:00 - alias: Back home, clear the away preset override triggers: - trigger: state entity_id: person.owner to: home actions: - action: netatmo.clear_temperature_setting target: entity_id: climate.living_room示例 3清除整个区域的所有覆盖使用区域目标一次清除所有 Netatmo 气候设备的覆盖action: netatmo.clear_temperature_setting target: area_id: living_room实际验证方式在开发者工具中直接测试根据 try_it.md 的指引你可以在不写任何 YAML 的情况下测试该动作打开Settings Tools Actions开发者工具中的动作/服务调用界面。搜索netatmo.clear_temperature_setting。填写目标实体点击Perform action执行动作。观察目标恒温器实体状态手动设定的温度应被清除设备回到当前预设或加热计划。这是验证动作是否生效、排查目标配置错误的最快方式。结合 Netatmo 事件监听验证如果你配置了 Netatmo 的 webhook 事件要求 Home Assistant 实例可通过 443 端口从公网访问集成文档建议在Settings Tools Events中监听netatmo_event可观察到设备恢复计划等事件类型。当手动覆盖被清除后设备恢复计划的动作会以事件形式推送到 Home Assistant可作为自动化触发源配合 device triggers 中的Has resumed its schedule。注意事项该动作不创建覆盖只清除覆盖它没有温度、时长、截止时间等参数只接受目标。清除后设备回退到当前预设或加热计划见 Good to know。预设与计划的名字来自 Netatmo 端set_schedule要求schedule_name与 Netatmo app 中配置的计划名完全一致因此在切换计划前清除覆盖时要确认目标设备对应的计划名。温度范围为 7–30 度这是 Netatmo 气候设备支持的目标温度区间设置覆盖温度时不要超出此范围。前提条件Netatmo 集成通过 Netatmo 云端服务通信需要有效的 Netatmo 账号、已在 Netatmo app 中配置好的设备以及可用的互联网连接见 集成文档 的 Prerequisites 一节。设备类型本动作仅对 Netatmo 的 climate 实体Smart Thermostat、Smart Modulating Thermostat、Smart Radiator Valve有意义对摄像头、气象站等非气候实体不适用。总结netatmo.clear_temperature_setting是 Netatmo 温度控制体系中负责撤销的关键动作。它与set_temperature_with_end_datetime、set_temperature_with_time_period、set_preset_mode_with_end_datetime三个设置动作以及set_schedule计划切换动作共同构成了完整的覆盖控制闭环设置覆盖 → 到期自动恢复 / 主动清除 → 回到预设或计划。通过实体、设备、区域、楼层、标签等多种目标选择方式你可以用一条动作批量管理多个恒温器的温度状态让智能温控既灵活又不失控。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考