Home Assistant 小米智能插座 Wi-Fi 指示灯控制：xiaomi_miio.switch_set_wifi_led

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 on（xiaomi_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.hmi206`
Xiaomi Chuangmi Plug V1（含 USB）	`chuangmi.plug.v1`、`chuangmi.plug.v3`、`chuangmi.plug.hmi208`
Xiaomi Smart Power Strip（智能插线板）	`qmi.powerstrip.v1`、`zimi.powerstrip.v2`

其中智能插线板明确列出Wifi LED（on/off）能力，其属性中也包含Wifi LED状态字段；此外插线板还支持 Power Price（0…999）与 Power Mode（green、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 matter（title、action、domain、description、related_actions）声明元数据，并通过 include 机制复用公共段落：

actions/ui_header.md：UI 操作入口的统一说明；
actions/yaml_header.md：YAML 技术参考的统一说明；
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），仅供参考

企业官网建设流程全解析