Home Assistant 小米智能插座 Wi-Fi 指示灯控制xiaomi_miio.switch_set_wifi_led_on 动作详解【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南基于 home-assistant.io 文档站中的动作参考页 xiaomi_miio.switch_set_wifi_led_on完整讲解如何在 Home Assistant 中通过自动化automation或脚本script打开小米智能插座/插线板的 Wi-Fi 状态指示灯。读完本文你将掌握该动作在 UI 与 YAML 两种编写方式下的完整用法、entity_id参数的语义细节、支持的设备型号范围以及与其成对的关闭动作的配合技巧。动作是什么Switch set Wi-Fi LED onxiaomi_miio.switch_set_wifi_led_on是 Home Assistant 中Xiaomi Home集成域xiaomi_miio提供的一个动作action用于打开小米智能插座或智能插线板上的 Wi-Fi 状态指示灯。它有一个直接对应的姊妹动作xiaomi_miio.switch_set_wifi_led_on打开 Wi-Fi 指示灯xiaomi_miio.switch_set_wifi_led_off关闭 Wi-Fi 指示灯两个动作在原文档 front matter 中通过related_actions字段互相引用说明它们属于同一组功能当你在自动化中需要开灯或灭灯二选一时通常会成对出现例如夜晚熄灯、白天点灯。前置条件先接入 Xiaomi Home 集成该动作作用于具体的小米开关实体因此使用前需要先完成Xiaomi Home集成的配置。集成文档 xiaomi_miio.markdown 中明确集成支持通过 UI 配置流程ha_config_flow: true添加绝大多数设备配置时建议提供小米账号凭据以便自动连接设备并需要指定当初在小米之家 App 中使用的服务器区域共 6 个服务器cn、de、i2、ru、sg、us设备需通过Mi Home小米之家App完成初始化而不是厂商专用 App例如 Roborock App常见问题集中在跨子网/VLAN 通信、网络访问被拦截导致的间歇性掉线等相关排查指引见集成文档的 Troubleshooting 小节。该动作适用的设备范围根据集成文档中 Xiaomi Smart WiFi Socket and Smart Power Strip 一节Wi-Fi 指示灯的开/关功能主要面向以下设备设备类型支持的模型Xiaomi Smart WiFi Socket智能插座chuangmi.plug.m1、chuangmi.plug.m3、chuangmi.plug.v2、chuangmi.plug.hmi205、chuangmi.plug.hmi206Xiaomi Chuangmi Plug V1含 USBchuangmi.plug.v1、chuangmi.plug.v3、chuangmi.plug.hmi208Xiaomi Smart Power Strip智能插线板qmi.powerstrip.v1、zimi.powerstrip.v2其中智能插线板明确列出Wifi LEDon/off能力其属性中也包含Wifi LED状态字段此外插线板还支持 Power Price0…999与 Power Modegreen、normal仅 Power Strip V1。也就是说switch_set_wifi_led_on能否生效取决于具体设备是否暴露 Wi-Fi LED 控制能力插线板尤其是qmi.powerstrip.v1、zimi.powerstrip.v2是该动作的典型使用对象。在 UI 中创建自动化或脚本来使用该动作原文档明确说明该动作不支持 targets目标选择器因此在 UI 中需要通过Entity ID字段指定要操作的小米开关若留空则动作会作用于所有此类开关。按照文档 ui_header.md 所述UI 方式不需要任何 YAML 知识Home Assistant 会逐步引导你完成配置。完整步骤如下进入设置 自动化与场景对应文档中的{% my automations %}链接打开一个已有的自动化或脚本或选择创建自动化 创建新自动化如果是新自动化在何时When区域添加一个触发器脚本则不需要触发器它们在被其他内容调用时才运行在然后执行Then do区域选择添加动作Add action在搜索框中搜索并选择Xiaomi Home: Switch set Wi-Fi LED on点击保存Save。UI 中的选项选项说明Entity ID要操作的小米开关实体。留空则影响所有此类开关。在 YAML 中使用该动作按 yaml_header.md 的说明YAML 方式适合直接手写配置或需要精确了解 Home Assistant 底层行为的场景下面列出了字段名、类型与必填性。在 YAML 中动作的完整名称是xiaomi_miio.switch_set_wifi_led_on一个基本示例原文档 example 中的{% example %}块如下action: xiaomi_miio.switch_set_wifi_led_on data: entity_id: switch.power_strip该示例会打开switch.power_strip这个实体的 Wi-Fi 指示灯。YAML 中的选项字段说明必填类型entity_id要操作的小米开关实体留空则作用于所有此类开关否string 或 list注意entity_id类型同时支持字符串与字符串列表因此你既可以写单个实体action: xiaomi_miio.switch_set_wifi_led_on data: entity_id: switch.power_strip也可以一次批量操作多个实体action: xiaomi_miio.switch_set_wifi_led_on data: entity_id: - switch.power_strip - switch.plug_m1典型使用场景与关闭动作配对实现夜间熄灯由于 Wi-Fi 指示灯在夜晚可能造成光污染最常见的用法是将开/关两个动作配对配合日落/日出或时间条件使用。例如# 自动化晚上 23 点关闭插座 Wi-Fi 指示灯 alias: Turn off Wi-Fi LED at night triggers: - trigger: time at: 23:00:00 actions: - action: xiaomi_miio.switch_set_wifi_led_off data: entity_id: switch.power_strip# 自动化早上 7 点重新点亮 Wi-Fi 指示灯 alias: Turn on Wi-Fi LED in the morning triggers: - trigger: time at: 07:00:00 actions: - action: xiaomi_miio.switch_set_wifi_led_on data: entity_id: switch.power_strip两个动作的参数结构完全一致仅动作名不同便于在自动化模板中复用。动作的文档化机制与相关资源在 home-assistant.io 文档站中每个动作参考页都位于 source/_actions 目录以域名.动作名.markdown命名本动作即xiaomi_miio.switch_set_wifi_led_on.markdown。页面通过 front mattertitle、action、domain、description、related_actions声明元数据并通过 include 机制复用公共段落actions/ui_header.mdUI 操作入口的统一说明actions/yaml_header.mdYAML 技术参考的统一说明actions/try_it.md、actions/stuck.md、actions/related.md分别提供试运行、排障与相关动作跳转内容。这一结构说明任何集成不限于 xiaomi_miio的动作页都遵循同一套标准模板读者可以据此举一反三快速迁移到其他动作的编写上。排障提示若动作无法按预期生效建议按以下顺序排查确认设备型号检查是否属于上文列出的chuangmi.plug.*、qmi.powerstrip.v1、zimi.powerstrip.v2等支持 Wi-Fi LED 控制的型号依据集成文档 Smart WiFi Socket and Smart Power Strip 一节确认实体存在在设置 设备与服务中确认对应的 switch 实体已生成且状态为可用检查网络连通性Xiaomi Home 设备为本地轮询集成ha_iot_class: Local Polling跨子网/VLAN 或网络被拦截会导致间歇性失联相关解决方案见集成文档 Troubleshooting 小节验证动作调用可在开发者工具的动作Action页面直接试运行本动作对应 include 的try_it.md排除自动化触发条件的问题。小结xiaomi_miio.switch_set_wifi_led_on是 Xiaomi Home 集成为小米智能插座/插线板提供的 Wi-Fi 指示灯控制动作之一具有参数简单仅一个可选的entity_id、不支持 targets、可与switch_set_wifi_led_off配对使用的特点。通过本文的 UI 步骤与 YAML 示例你可以直接将其嵌入自动化或脚本实现对指示灯状态的精确控制。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考