Home Assistant 中设置 Modern Forms 风扇睡眠定时器action 详解与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读modern_forms.set_fan_sleep_timer是 Home Assistant 官方 Modern Forms 集成提供的一个 action动作/服务用于给 Modern Forms 智能 Wi-Fi 风扇设置独立的睡眠定时器定时器到期后风扇自动关闭。本文以该 action 的官方文档为主体结合仓库中的集成文档与动作模板源码完整讲解在 UI 与 YAML 两种方式下如何使用该 action、全部参数细节、目标target选择机制并给出睡前让卧室风扇运行一小时的完整自动化示例最后补充 NTP 依赖这一关键使用前提。一、动作概述它做什么modern_forms.set_fan_sleep_timer用于在 Modern Forms 风扇上设置一个睡眠定时器。当定时器到期时风扇会自动关闭。这一动作有两个显著特点与灯光定时器相互独立Modern Forms 风扇和灯拥有各自独立的睡眠定时器可分别设置、分别清除。本动作只作用于风扇配套的清除动作如果定时器已设置但想取消应使用配套的 modern_forms.clear_fan_sleep_timer 动作——清除定时器不会关闭风扇只是取消尚未到期的定时任务。关联动作文档 frontmatter 中声明了related_actions即 modern_forms.clear_fan_sleep_timer 与 modern_forms.set_light_sleep_timer它们共同构成了 Modern Forms 睡眠定时器动作家族。从集成文档可知Modern Forms 集成ha_domain: modern_forms自 2021.7 版本加入 Home Assistant采用Local Polling的 IoT 类别支持通过Zeroconf自动发现提供fan、light、binary_sensor、number、sensor、switch等多种平台实体。二、从 UI 设置风扇睡眠定时器如果你更习惯可视化构建自动化或脚本Home Assistant 的 UI 会逐步引导你完成配置仓库中的 ui_header.md 对此流程做了统一说明选择目标、微调选项、保存无需编写 YAML。操作步骤如下进入SettingsAutomations scenes设置 自动化与场景打开一个已有的自动化或脚本或选择Create automationCreate new automation新建自动化 创建新自动化如果是新建自动化在When何时部分添加一个触发器。脚本则不需要触发器——脚本在别的对象调用它们时才运行在Then do然后执行部分选择Add action添加动作选择你要控制的对象。在By target按目标见下文动作的目标一节下选择你的 Modern Forms 风扇从该目标展示出的动作列表中选择Modern Forms: Set fan sleep timerModern Forms设置风扇睡眠定时器输入Sleep time睡眠时间单位为分钟选择Save保存。UI 中的选项选项说明Sleep time睡眠时间定时器设置的分钟数取值范围1 到 1440即最多一天。必填。该动作在 UI 中仅此一个选项sleep_time为必填项。三、在 YAML 中使用该动作3.1 基础 YAML 示例在 YAML 中该动作以modern_forms.set_fan_sleep_timer引用。一个基础示例如下action: modern_forms.set_fan_sleep_timer target: entity_id: fan.bedroom data: sleep_time: 60上面这段配置的含义是为卧室风扇设置一个 60 分钟的睡眠定时器一小时后风扇自动关闭。3.2 YAML 参数参考参数类型必填说明sleep_timeinteger是定时器设置的分钟数取值范围1 到 1440一天。3.3 动作的目标Targets该动作必须指定目标target。目标就是动作作用的对象可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的fan实体执行该动作对应模板源码 targets.mdEntity实体某个具体的fan实体例如fan.living_roomDevice设备属于某台设备的所有fan实体Area区域某个房间或区域内的所有fan实体Floor楼层某个楼层上的所有fan实体Label标签共享某个标签的所有fan实体。你还可以在同一个动作中混合不同类型的目标例如同时添加一个具体实体和一个区域让该动作同时作用于它们。3.4 在开发者工具中试运行无需写任何 YAML你也可以直接测试该动作打开SettingsToolsActions设置 工具 动作搜索modern_forms.set_fan_sleep_timer填写字段后选择Perform action执行动作即可在真实实体上立即看到效果见 try_it.md。四、实战自动化睡前让卧室风扇运行一小时官方文档给出了一个完整的自动化场景每天睡前设置一小时的睡眠定时器让风扇在你入睡期间运转之后自动关闭。触发器Trigger定时时间动作ActionModern Forms设置风扇睡眠定时器完整 YAML 如下automation: alias: Bedroom fan sleep timer triggers: - trigger: time at: 22:30:00 actions: - action: modern_forms.set_fan_sleep_timer target: entity_id: fan.bedroom data: sleep_time: 60该自动化每天晚上 22:30 触发为fan.bedroom设置 60 分钟睡眠定时器风扇在 23:30 自动关闭正好覆盖入睡阶段。五、与配套动作协同清除与灯光定时器5.1 清除风扇睡眠定时器modern_forms.clear_fan_sleep_timer 用于清除风扇上的睡眠定时器。清除定时器不会关闭风扇它只是取消尚未到期的定时任务。其 YAML 用法同样需要 target且没有额外参数action: modern_forms.clear_fan_sleep_timer target: entity_id: fan.bedroom5.2 灯光睡眠定时器Modern Forms 的灯光也有独立的睡眠定时器modern_forms.set_light_sleep_timer/modern_forms.clear_light_sleep_timer可独立于风扇定时器设置与清除。注意集成文档的提示如果风扇没有安装灯单元Light 实体与相关动作不会出现。六、关键前提NTP 依赖与网络限制使用睡眠定时器前必须了解一个关键的硬件行为详见集成文档末尾的 noteModern Forms 风扇通过 NTPpool.ntp.org设置内部时钟并据此检查睡眠定时器是否到期。睡眠定时器只有在风扇能访问互联网上的 NTP 服务器时才有效。你可以阻断风扇的云访问、仅放行出站 NTPUDP 123 端口睡眠定时器依然能正常工作。这一约束决定了实际部署策略如果你希望本地化控制、限制风扇的云端连接务必保留 UDP 123 端口的出站 NTP 流量否则睡眠定时器将无法按时到期触发关风扇。此外结合集成文档可知集成还会提供以下与定时器状态相关的实体可用于自动化联动Binary sensorsfan sleep timer active status风扇睡眠定时器激活状态、light sleep timer active status灯光睡眠定时器激活状态Sensorsfan sleep timer time expiring风扇睡眠定时器剩余时间、light sleep timer time expiring灯光睡眠定时器剩余时间。例如你可以用风扇睡眠定时器激活状态作为条件避免重复设置定时器或用剩余时间传感器在定时器快到期前触发提醒。七、故障排查与社区支持检查实体是否存在若你的风扇没有安装灯单元灯光相关动作不会出现在目标动作列表中检查网络确认风扇能访问 NTP 服务器UDP 123 端口出站这是定时器正常工作的前提检查目标确认target.entity_id指向真实的fan实体 ID检查取值范围sleep_time必须在 1–1440 之间超出范围会被拒绝。如果仍然无法工作Home Assistant 社区提供了多个求助渠道见 stuck.md可以加入 Discord 实时交流、在社区论坛发帖附上你调用的动作与预期结果或在 subreddit 上分享问题也可以让 AI 助手用自然语言描述需求让它为你解释动作或推荐正确的动作。八、小结modern_forms.set_fan_sleep_timer是一个参数极简仅一个必填的sleep_time但实用性很高的动作UI 路径Automations scenes → Add action → Modern Forms: Set fan sleep timerYAML 路径action: modern_forms.set_fan_sleep_timertargetdata.sleep_time1–1440 分钟配套动作clear_fan_sleep_timer清除定时器、set_light_sleep_timer灯光定时器关键前提风扇需能访问 NTP 服务器UDP 123定时器才能正常到期生效。配合集成自带的定时器状态 binary sensor 与剩余时间 sensor你可以构建出睡前自动运行、到点自动关闭、状态可视化的完整智能风扇体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant 中设置 Modern Forms 风扇睡眠定时器action 详解与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读modern_forms.set_fan_sleep_timer是 Home Assistant 官方 Modern Forms 集成提供的一个 action动作/服务用于给 Modern Forms 智能 Wi-Fi 风扇设置独立的睡眠定时器定时器到期后风扇自动关闭。本文以该 action 的官方文档为主体结合仓库中的集成文档与动作模板源码完整讲解在 UI 与 YAML 两种方式下如何使用该 action、全部参数细节、目标target选择机制并给出睡前让卧室风扇运行一小时的完整自动化示例最后补充 NTP 依赖这一关键使用前提。一、动作概述它做什么modern_forms.set_fan_sleep_timer用于在 Modern Forms 风扇上设置一个睡眠定时器。当定时器到期时风扇会自动关闭。这一动作有两个显著特点与灯光定时器相互独立Modern Forms 风扇和灯拥有各自独立的睡眠定时器可分别设置、分别清除。本动作只作用于风扇配套的清除动作如果定时器已设置但想取消应使用配套的 modern_forms.clear_fan_sleep_timer 动作——清除定时器不会关闭风扇只是取消尚未到期的定时任务。关联动作文档 frontmatter 中声明了related_actions即 modern_forms.clear_fan_sleep_timer 与 modern_forms.set_light_sleep_timer它们共同构成了 Modern Forms 睡眠定时器动作家族。从集成文档可知Modern Forms 集成ha_domain: modern_forms自 2021.7 版本加入 Home Assistant采用Local Polling的 IoT 类别支持通过Zeroconf自动发现提供fan、light、binary_sensor、number、sensor、switch等多种平台实体。二、从 UI 设置风扇睡眠定时器如果你更习惯可视化构建自动化或脚本Home Assistant 的 UI 会逐步引导你完成配置仓库中的 ui_header.md 对此流程做了统一说明选择目标、微调选项、保存无需编写 YAML。操作步骤如下进入SettingsAutomations scenes设置 自动化与场景打开一个已有的自动化或脚本或选择Create automationCreate new automation新建自动化 创建新自动化如果是新建自动化在When何时部分添加一个触发器。脚本则不需要触发器——脚本在别的对象调用它们时才运行在Then do然后执行部分选择Add action添加动作选择你要控制的对象。在By target按目标见下文动作的目标一节下选择你的 Modern Forms 风扇从该目标展示出的动作列表中选择Modern Forms: Set fan sleep timerModern Forms设置风扇睡眠定时器输入Sleep time睡眠时间单位为分钟选择Save保存。UI 中的选项选项说明Sleep time睡眠时间定时器设置的分钟数取值范围1 到 1440即最多一天。必填。该动作在 UI 中仅此一个选项sleep_time为必填项。三、在 YAML 中使用该动作3.1 基础 YAML 示例在 YAML 中该动作以modern_forms.set_fan_sleep_timer引用。一个基础示例如下action: modern_forms.set_fan_sleep_timer target: entity_id: fan.bedroom data: sleep_time: 60上面这段配置的含义是为卧室风扇设置一个 60 分钟的睡眠定时器一小时后风扇自动关闭。3.2 YAML 参数参考参数类型必填说明sleep_timeinteger是定时器设置的分钟数取值范围1 到 1440一天。3.3 动作的目标Targets该动作必须指定目标target。目标就是动作作用的对象可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的fan实体执行该动作对应模板源码 targets.mdEntity实体某个具体的fan实体例如fan.living_roomDevice设备属于某台设备的所有fan实体Area区域某个房间或区域内的所有fan实体Floor楼层某个楼层上的所有fan实体Label标签共享某个标签的所有fan实体。你还可以在同一个动作中混合不同类型的目标例如同时添加一个具体实体和一个区域让该动作同时作用于它们。3.4 在开发者工具中试运行无需写任何 YAML你也可以直接测试该动作打开SettingsToolsActions设置 工具 动作搜索modern_forms.set_fan_sleep_timer填写字段后选择Perform action执行动作即可在真实实体上立即看到效果见 try_it.md。四、实战自动化睡前让卧室风扇运行一小时官方文档给出了一个完整的自动化场景每天睡前设置一小时的睡眠定时器让风扇在你入睡期间运转之后自动关闭。触发器Trigger定时时间动作ActionModern Forms设置风扇睡眠定时器完整 YAML 如下automation: alias: Bedroom fan sleep timer triggers: - trigger: time at: 22:30:00 actions: - action: modern_forms.set_fan_sleep_timer target: entity_id: fan.bedroom data: sleep_time: 60该自动化每天晚上 22:30 触发为fan.bedroom设置 60 分钟睡眠定时器风扇在 23:30 自动关闭正好覆盖入睡阶段。五、与配套动作协同清除与灯光定时器5.1 清除风扇睡眠定时器modern_forms.clear_fan_sleep_timer 用于清除风扇上的睡眠定时器。清除定时器不会关闭风扇它只是取消尚未到期的定时任务。其 YAML 用法同样需要 target且没有额外参数action: modern_forms.clear_fan_sleep_timer target: entity_id: fan.bedroom5.2 灯光睡眠定时器Modern Forms 的灯光也有独立的睡眠定时器modern_forms.set_light_sleep_timer/modern_forms.clear_light_sleep_timer可独立于风扇定时器设置与清除。注意集成文档的提示如果风扇没有安装灯单元Light 实体与相关动作不会出现。六、关键前提NTP 依赖与网络限制使用睡眠定时器前必须了解一个关键的硬件行为详见集成文档末尾的 noteModern Forms 风扇通过 NTPpool.ntp.org设置内部时钟并据此检查睡眠定时器是否到期。睡眠定时器只有在风扇能访问互联网上的 NTP 服务器时才有效。你可以阻断风扇的云访问、仅放行出站 NTPUDP 123 端口睡眠定时器依然能正常工作。这一约束决定了实际部署策略如果你希望本地化控制、限制风扇的云端连接务必保留 UDP 123 端口的出站 NTP 流量否则睡眠定时器将无法按时到期触发关风扇。此外结合集成文档可知集成还会提供以下与定时器状态相关的实体可用于自动化联动Binary sensorsfan sleep timer active status风扇睡眠定时器激活状态、light sleep timer active status灯光睡眠定时器激活状态Sensorsfan sleep timer time expiring风扇睡眠定时器剩余时间、light sleep timer time expiring灯光睡眠定时器剩余时间。例如你可以用风扇睡眠定时器激活状态作为条件避免重复设置定时器或用剩余时间传感器在定时器快到期前触发提醒。七、故障排查与社区支持检查实体是否存在若你的风扇没有安装灯单元灯光相关动作不会出现在目标动作列表中检查网络确认风扇能访问 NTP 服务器UDP 123 端口出站这是定时器正常工作的前提检查目标确认target.entity_id指向真实的fan实体 ID检查取值范围sleep_time必须在 1–1440 之间超出范围会被拒绝。如果仍然无法工作Home Assistant 社区提供了多个求助渠道见 stuck.md可以加入 Discord 实时交流、在社区论坛发帖附上你调用的动作与预期结果或在 subreddit 上分享问题也可以让 AI 助手用自然语言描述需求让它为你解释动作或推荐正确的动作。八、小结modern_forms.set_fan_sleep_timer是一个参数极简仅一个必填的sleep_time但实用性很高的动作UI 路径Automations scenes → Add action → Modern Forms: Set fan sleep timerYAML 路径action: modern_forms.set_fan_sleep_timertargetdata.sleep_time1–1440 分钟配套动作clear_fan_sleep_timer清除定时器、set_light_sleep_timer灯光定时器关键前提风扇需能访问 NTP 服务器UDP 123定时器才能正常到期生效。配合集成自带的定时器状态 binary sensor 与剩余时间 sensor你可以构建出睡前自动运行、到点自动关闭、状态可视化的完整智能风扇体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
