首页 ▸ Integrations ▸

小米米家

小米米家 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 支持以下设备：

小米网关
小米设备追踪器（小米米WiFi扩展器2）
小米空气净化器、空气加湿器和落地风扇
小米空气质量监测器
小米红外遥控器
小米米机器人吸尘器
小米飞利浦灯
小米智能WiFi插座和智能排插

先决条件

大多数小米米家设备支持使用 Home Assistant UI 进行配置，除了小米设备追踪器和小米红外遥控器。有关这些设备的更多信息，请阅读链接的部分。

设备需要通过米家应用进行设置，而不是通过特定于供应商的应用（例如，Roborock）。

Note

对于更复杂的网络设置（例如 VLAN），请参考以下文档以获取更多信息。

配置

要将 小米米家 集成添加到您的 Home Assistant 实例中，请使用此 My 按钮：

小米米家可以被 Home Assistant 自动发现。如果发现了实例，它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个手动集成条目：

浏览到您的 Home Assistant 实例。
转到 设置 > 设备与服务。
在右下角，选择 Add Integration 按钮。
从列表中选择 小米米家。
按照屏幕上的说明完成设置。

建议您在配置过程中提供小米云凭据，以便自动连接到您的设备。您需要指定您在小米家居应用中使用的云服务器（您最初设置设备的地方）。共有 6 个服务器：cn、de、i2、ru、sg 和 us；有关每个国家使用哪个服务器，请参见此页面。

故障排除

最常见的问题是：

小米米家设备由于 UDP 数据包的源地址不属于设备本身的子网，因此无法跨子网/VLAN 通信。更多信息和解决方案。
Roborock 吸尘器需要连接到小米家居应用，而不是 Roborock 应用，更多信息。
阻止设备的网络访问已知会导致间歇性连接问题，因为设备的内部软件可能挂起，监视程序重新启动内部软件。更多信息。

小米网关

xiaomi_miio 网关 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您控制网关及其连接的子设备。

支持的小米网关型号

以下列表显示网关名称、型号、Zigbee ID，以及该型号在 Home Assistant 中是否受支持。

中国版
- 型号：DGNWG02LM
- Zigbee ID：lumi.gateway.v3
- 支持：是
欧洲版
- 型号：ZHWG11LM-763 / DGNWQ05LM
- Zigbee ID：lumi.gateway.mieu01
- 支持：是（需要云凭据）
Aqara 中心
- 型号：ZHWG11LM
- Zigbee ID：lumi.gateway.aqhm01
- 支持：是
米家 Zigbee 3.0
- 型号：ZNDMWG03LM
- Zigbee ID：lumi.gateway.mgl03
- 支持：是
Aqara AC 伴侣
- 型号：KTBL01LM
- Zigbee ID：lumi.acpartner.v1
- 支持：未测试
米 AC 伴侣
- 型号：KTBL02LM
- Zigbee ID：lumi.acpartner.v2
- 支持：未测试
Aqara AC 伴侣
- 型号：KTBL11LM
- Zigbee ID：lumi.acpartner.v3
- 支持：是

某些网关（lumi.gateway.mieu01）不支持本地获取连接的子设备。对于这些网关，可以在配置流程中指定云凭据，并且可以在选项流程中启用“使用云获取连接的子设备”（在设置 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 之后，在侧边栏单击配置，然后单击集成，最后点击已设置的小米米家网关 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 的选项）。然后，将从小米米家云（互联网）检索连接的子设备，控制和状态更新将在本地网络连接上进一步进行。当尚未提供云凭据且该网关型号需要时，可能会触发重新身份验证流程。

网关功能

网关警报控制（开启/关闭；查看状态 armed_away，disarmed，arming）
网关灯光控制（开启/关闭；改变亮度；改变颜色；查看状态）
网关光照传感器读数（以卢克斯表示的光照值）

尚未实施的功能（但可能）：

网关互联网广播（仅限中国站点）
网关铃声/声音

支持的子设备

这些子设备在 Home Assistant 中已完全实现：

天气传感器（WSDCGQ01LM）
- Zigbee ID: lumi.sensor_ht
- 功能: 读数 temperature 和 humidity
天气传感器（WSDCGQ11LM）
- Zigbee ID: lumi.weather.v1
- 功能: 读数 temperature、humidity 和 pressure
单路墙壁开关（QBKG11LM）
- Zigbee ID: lumi.ctrl_ln1
- 功能: load_power, status, turn_on, turn_off, toggle
单路墙壁开关（QBKG11LM）
- Zigbee ID: lumi.ctrl_ln1.aq1
- 功能: load_power, status, turn_on, turn_off, toggle
无中性线墙壁开关（QBKG04LM）
- Zigbee ID: lumi.ctrl_neutral1.v1
- 功能: status, turn_on, turn_off, toggle
双路墙壁开关（QBKG12LM）
- Zigbee ID: lumi.ctrl_ln2
- 功能: load_power, status, turn_on, turn_off, toggle
双路墙壁开关（QBKG12LM）
- Zigbee ID: lumi.ctrl_ln2.aq1
- 功能: load_power, status, turn_on, turn_off, toggle
无中性线双路墙壁开关（QBKG03LM）
- Zigbee ID: lumi.ctrl_neutral2
- 功能: status, turn_on, turn_off, toggle
D1 三路墙壁开关（QBKG26LM）
- Zigbee ID: lumi.switch.n3acn3
- 功能: load_power, status, turn_on, turn_off, toggle
D1 三路开关无中性线（QBKG25LM）
- Zigbee ID: lumi.switch.l3acn3
- 功能: load_power, status, turn_on, turn_off, toggle
墙壁插座（QBCZ11LM）
- Zigbee ID: lumi.ctrl_86plug.v1
- 功能: status, turn_on, turn_off, toggle
墙壁插座（QBCZ11LM）
- Zigbee ID: lumi.ctrl_86plug.aq1
- 功能: load_power, status, turn_on, turn_off, toggle
插头（ZNCZ02LM）
- Zigbee ID: lumi.plug
- 功能: load_power, status, turn_on, turn_off, toggle
继电器（LLKZMK11LM）
- Zigbee ID: lumi.relay.c2acn01
- 功能: load_power, status, turn_on, turn_off, toggle
智能灯泡 E27（ZNLDP12LM）
- Zigbee ID: lumi.light.aqcn02
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 E27 白色（LED1545G12）
- Zigbee ID: ikea.light.led1545g12
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 E27 白色（LED1546G12）
- Zigbee ID: ikea.light.led1546g12
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 E12 白色（LED1536G5）
- Zigbee ID: ikea.light.led1536g5
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 GU10 白色（LED1537R6）
- Zigbee ID: ikea.light.led1537r6
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 E27 白色（LED1623G12）
- Zigbee ID: ikea.light.led1623g12
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 GU10 白色（LED1650R5）
- Zigbee ID: ikea.light.led1650r5
- 功能: on/off, brightness, color temperature
IKEA 智能灯泡 E12 白色（LED1649C5）
- Zigbee ID: ikea.light.led1649c5
- 功能: on/off, brightness, color temperature

识别的子设备（尚未实现）

这些子设备在 python-miio 代码中被识别，但仍在开发中（尚未实现）。

列表显示设备名称、型号和 Zigbee ID。

按钮（WXKG01LM）：lumi.sensor_switch
按钮（WXKG11LM 2015）：lumi.sensor_switch.aq2
按钮（WXKG12LM）：lumi.sensor_switch.aq3
按钮（WXKG11LM 2018）：lumi.remote.b1acn01
立方体（MFKZQ01LM）：lumi.sensor_cube.v1
立方体（MFKZQ01LM）：lumi.sensor_cube.aqgl01
运动传感器（RTCGQ01LM）：lumi.sensor_motion
运动传感器（RTCGQ11LM）：lumi.sensor_motion.aq2
门传感器（MCCGQ01LM）：lumi.sensor_magnet
门传感器（MCCGQ11LM）：lumi.sensor_magnet.aq2
震动传感器（DJT11LM）：lumi.vibration.aq1
霍尼韦尔烟雾探测器（JTYJ-GD-01LM/BW）：lumi.sensor_smoke
霍尼韦尔天然气探测器（JTQJ-BF-01LM/BW）：lumi.sensor_natgas
水漏传感器（SJCGQ11LM）：lumi.sensor_wleak.aq1
单路遥控开关（WXKG03LM 2016）：lumi.sensor_86sw1.v1
单路遥控开关（WXKG03LM 2018）：lumi.remote.b186acn01
D1 单路遥控开关（WXKG06LM）：lumi.remote.b186acn02
双路遥控开关（WXKG02LM 2016）：lumi.sensor_86sw2.v1
双路遥控开关（WXKG02LM 2018）：lumi.remote.b286acn01
D1 双路遥控开关（WXKG07LM）：lumi.remote.b286acn02
窗帘（ZNCLDJ11LM）：lumi.curtain
窗帘（ZNGZDJ11LM）：lumi.curtain.aq2
窗帘 B1（ZNCLDJ12LM）：lumi.curtain.hagl04
门锁 S1（ZNMS11LM）：lumi.lock.aq1
门锁 S2（ZNMS12LM）：lumi.lock.acn02
门锁 S2 pro（ZNMS13LM）：lumi.lock.acn03
维玛圆柱锁（A6121）：lumi.lock.v1
温控器 S2（KTWKQ03ES）：lumi.airrtc.tcpecn02

小米设备追踪器（小米米WiFi扩展器2）

xiaomi_miio 设备追踪器平台正在监视您的小米米 WiFi 扩展器2，并报告所有相关的 WiFi 客户端。

请按照获取访问令牌中的说明获取用于小米米家中的 API 令牌。

要将小米米 WiFi 扩展器设备追踪器添加到您的安装中，请在您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中添加以下内容：

device_tracker:
  - platform: xiaomi_miio
    host: 192.168.130.73
    token: YOUR_TOKEN

Configuration Variables

Looking for your configuration file?

host string Required

您的 miio 设备的 IP 地址。

token string Required

您的 miio 设备的 API 令牌。

小米空气净化器、空气加湿器和落地风扇

空气净化器、空气加湿器和落地风扇使用多个平台来允许您设置设备的控制模式和设置。

支持的设备：

列表包括设备名称、型号（如果可用）和型号。

空气净化器：zhimi.airpurifier.v1
空气净化器2（FJY4006CN）：zhimi.airpurifier.v2
空气净化器 V3：zhimi.airpurifier.v3
空气净化器 V5：zhimi.airpurifier.v5
空气净化器 Pro：zhimi.airpurifier.v6
空气净化器 Pro V7：zhimi.airpurifier.v7
空气净化器2（迷你）：zhimi.airpurifier.m1
空气净化器（迷你）：zhimi.airpurifier.m2
空气净化器 MA1：zhimi.airpurifier.ma1
空气净化器 MA2：zhimi.airpurifier.ma2
空气净化器 2S：zhimi.airpurifier.mc1
空气净化器超级版：zhimi.airpurifier.sa1
空气净化器超级版2：zhimi.airpurifier.sa2
空气净化器3（2019）（AC-M6-SC）：zhimi.airpurifier.ma4
空气净化器3H（2019）：zhimi.airpurifier.mb3
空气净化器 Pro H：zhimi.airpurifier.va1
空气净化器 Pro H EU：zhimi.airpurifier.vb2
空气净化器3C：zhimi.airpurifier.mb4
空气净化器3C：zhimi.airp.mb4a
空气净化器 ZA1：zhimi.airpurifier.za1
空气净化器4（AC-M16-SC）：zhimi.airp.mb5
空气净化器4 PRO（AC-M15-SC）：zhimi.airp.vb4
空气清新剂 A1（MJXFJ-150-A1）：dmaker.airfresh.a1
空气清新剂 VA2：zhimi.airfresh.va2
空气清新剂 VA4：zhimi.airfresh.va4
空气清新剂 T2017（MJXFJ-300-G1）：dmaker.airfresh.t2017
空气加湿器：zhimi.humidifier.v1
空气加湿器 CA1：zhimi.humidifier.ca1
空气加湿器 CA4：zhimi.humidifier.ca4
空气加湿器 CB1：zhimi.humidifier.cb1
空气加湿器 JSQ：deerma.humidifier.jsq
空气加湿器 JSQ1：deerma.humidifier.jsq1
空气加湿器 MJJSQ：deerma.humidifier.mjjsq
落地风扇 1X：dmaker.fan.p5
变频落地风扇：zhimi.fan.za1
落地风扇 2：zhimi.fan.za3
落地风扇 2S：zhimi.fan.za4
落地风扇：zhimi.fan.sa1
直流落地风扇：zhimi.fan.v2
直流落地风扇：zhimi.fan.v3
落地风扇 1C：dmaker.fan.1c
塔式风扇：dmaker.fan.p9
落地风扇 2：dmaker.fan.p10
落地风扇 Pro：dmaker.fan.p11
落地风扇 2：dmaker.fan.p18
落地风扇 3：zhimi.fan.za5
电源（打开、关闭）
操作模式（自动、静音、喜爱、闲置）
属性（风扇平台）
- model
- mode
- sleep_time
- sleep_mode_learn_count
- extra_features
- turbo_mode_supported
- use_time
- button_pressed
- sleep_mode
数字实体

数字	描述
喜爱级别	设置喜爱级别

传感器实体
过滤器剩余寿命：过滤器的剩余寿命。默认启用。
过滤器使用：过滤器使用时间（小时）。默认启用。
湿度：当前测量的湿度。默认启用。
电机速度：当前测量的电机速度（转/分钟）。默认启用。
PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
净化体积：以立方米计算的净化空气体积。默认禁用。
温度：当前测量的温度。默认启用。
使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
学习模式	打开/关闭学习模式
LED	打开/关闭 LED

空气净化器 Pro（zhimi.airpurifier.v6）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
属性（风扇平台）
- sleep_time
- sleep_mode_learn_count
- extra_features
- turbo_mode_supported
- auto_detect
- use_time
- button_pressed
数字实体

数字	描述
喜爱级别	设置喜爱级别
音量	设置音量

传感器实体
- 过滤器寿命剩余：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 光照：当前测量的光照。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 净化体积：以立方米计算的净化空气体积。默认禁用。
- 第二电机速度：当前测量的第二电机速度（转/分钟）。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
儿童锁	打开/关闭儿童锁
学习模式	打开/关闭学习模式
LED	打开/关闭 LED

空气净化器 Pro V7（zhimi.airpurifier.v7）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
属性（风扇平台）
- extra_features
- turbo_mode_supported
- button_pressed
数字实体

数字	描述
喜爱级别	设置喜爱级别
音量	设置音量

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 光照：当前测量的光照。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 第二电机速度：当前测量的第二电机速度（转/分钟）。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
儿童锁	打开/关闭儿童锁
学习模式	打开/关闭学习模式
LED	打开/关闭 LED

空气净化器 MA2（zhimi.airpurifier.ma2）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
属性（风扇平台）
- extra_features
- turbo_mode_supported
- button_pressed
- preset_modes
- preset_mode
- sleep_time
- sleep_mode_learn_count
- use_time
- sleep_mode
- friendly_name
- supported_features

数字	描述
喜爱级别	设置喜爱级别

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 温度：当前测量的温度。默认启用。
- 光照：当前测量的光照。在设备顶部测量（0-200 lux）。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
学习模式	打开/关闭学习模式
LED	打开/关闭 LED

空气净化器2S（zhimi.airpurifier.mc1）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
属性（风扇平台）
- extra_features
- turbo_mode_supported
- button_pressed
数字实体

数字	描述
喜爱级别	设置喜爱级别

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
学习模式	打开/关闭学习模式
LED	打开/关闭 LED

空气净化器3/3H（2019）（zhimi.airpurifier.ma4, zhimi.airpurifier.mb3）

该型号使用新版本的 MiOT 通信协议。

电源（打开、关闭）
操作模式（自动、静音、喜爱、风扇）
属性（风扇平台）
- use_time
数字实体

数字	描述
风扇级别	设置风扇级别
喜爱级别	设置喜爱级别

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 净化体积：以立方米计算的净化空气体积。默认禁用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

空气净化器 Pro H, Pro H EU（zhimi.airpurifier.va1, zhimi.airpurifier.vb2）

电源（打开、关闭）
操作模式（自动、静音、喜爱、风扇）
属性（风扇平台）
- use_time
数字实体

数字	描述
风扇级别	设置风扇级别
喜爱级别	设置喜爱级别

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 净化体积：以立方米计算的净化空气体积。默认禁用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

空气净化器3C（zhimi.airpurifier.mb4, zhimi.airp.mb4a）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
数字实体

数字	描述
喜爱电机速度	设置喜爱的电机速度
LED 亮度	设置 LED 亮度

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

空气净化器 ZA1（zhimi.airpurifier.za1）

电源（打开、关闭）
操作模式（自动、静音、喜爱）
数字实体

数字	描述
喜爱级别	设置喜爱级别

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 温度：当前测量的温度。默认启用。
- TVOC：当前挥发性有机物的浓度。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

选择实体

选择	描述
LED 亮度	控制显示器的亮度（亮、暗、关闭）

空气净化器 V3（zhimi.airpurifier.v3）

电源（打开、关闭）
操作模式（自动、静音、喜爱、闲置、中档、高档、强力）
属性（风扇平台）
- sleep_time
- sleep_mode_learn_count
- extra_features
- use_time
- button_pressed
传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 光照：当前测量的光照。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 净化体积：以立方米计算的净化空气体积。默认禁用。
- 第二电机速度：当前测量的第二电机速度（转/分钟）。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED

空气净化器4/4 PRO（zhimi.airp.mb5, zhimi.airp.vb4）

这些型号使用新版本的 MiOT 通信协议。

电源（打开、关闭）
操作模式（自动、静音、喜爱、风扇）
属性（风扇平台）
数字实体

数字	描述
风扇级别	设置风扇级别
喜爱级别	设置喜爱级别

选择实体

选择	描述
LED 亮度	控制显示器的亮度（亮、暗、关闭）

传感器实体
- 过滤器剩余寿命：过滤器的剩余寿命（以 % 表示）。默认启用。
- 过滤器剩余时间：过滤器的剩余时间（以天为单位）。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 电机速度：当前测量的电机速度（转/分钟）。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- PM10：当前测量的 10 微米颗粒物（仅适用于 PRO 型号）。默认启用。
- 净化体积：以立方米计算的净化空气体积。默认禁用。
- 温度：当前测量的温度。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
离子发生器	打开/关闭负离子发生器

空气清新剂 A1（dmaker.airfresh.a1）

电源（打开、关闭）
操作模式（自动、睡眠、喜爱）
二进制传感器实体

二进制传感器	描述
辅助加热状态	指示加热器是否处于开启状态

按钮实体

按钮	描述
重置灰尘过滤器	重置灰尘过滤器的使用寿命和使用状态

传感器实体

传感器	描述
二氧化碳	当前二氧化碳浓度（ppm）
灰尘过滤器剩余寿命	过滤器的剩余寿命
灰尘过滤器剩余使用天数	过滤器的剩余使用时间（以天为单位）
PM2.5	当前测量的 2.5 微米颗粒物
温度	当前外部温度
控制速度	当前电动机速度（转/分钟）
喜爱速度	当前喜爱的电动机速度（转/分钟）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
显示器	打开/关闭显示器
辅助加热	打开/关闭加热器

空气清新剂 VA2

电源（打开、关闭）
操作模式（自动、静音、间隔、低档、中档、高档）
属性（风扇平台）
- use_time
- extra_features
传感器实体|
- 二氧化碳：当前测量的二氧化碳浓度（ppm）。默认启用。
- 过滤器剩余寿命：过滤器的剩余寿命。默认启用。
- 过滤器使用：过滤器使用时间（小时）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- PM2.5：当前测量的 2.5 微米颗粒物。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED

空气清新剂 VA4

电源（打开、关闭）
操作模式（自动、静音、间隔、低档、中档、高档）
属性（风扇平台）
- use_time
- extra_features
传感器实体

传感器	描述	默认启用
二氧化碳	当前测量的二氧化碳浓度（ppm）	是
过滤器剩余寿命	过滤器的剩余寿命	是
过滤器使用	过滤器使用时间（小时）	是
湿度	当前测量的湿度	是
PM2.5	当前测量的 2.5 微米颗粒物	是
温度	当前测量的温度	是
使用时间	设备使用的累计秒数	否

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED
辅助加热	打开/关闭加热器

空气清新剂 T2017（dmaker.airfresh.t2017）

电源（打开、关闭）
操作模式（自动、睡眠、喜爱）
二进制传感器实体
- 辅助加热状态：指示加热器是否实际开启
按钮实体
- 重置灰尘过滤器：重置灰尘过滤器的使用寿命和使用状态
- 重置上方过滤器：重置上方过滤器的使用寿命和使用状态
选择实体
- 辅助加热级别：控制加热器的级别（低、中、高）
- 显示方向：控制显示方向（前、左、右）
传感器实体
- 二氧化碳：当前测量的二氧化碳浓度（ppm）
- 灰尘过滤器剩余寿命：灰尘过滤器的剩余寿命
- 灰尘过滤器剩余使用天数：灰尘过滤器的剩余使用天数
- 上方过滤器剩余寿命：上方过滤器的剩余寿命
- 上方过滤器剩余使用天数：上方过滤器的剩余使用天数
- PM2.5：当前测量的 2.5 微米颗粒物
- 温度：当前外部温度
- 控制速度：当前电动机速度（转/分钟）
- 喜爱速度：当前喜爱的电动机速度（转/分钟）
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
显示器	打开/关闭显示器
辅助加热	打开/关闭加热器

空气加湿器（zhimi.humidifier.v1）

打开、关闭
操作模式（静音、中档、高档、强力）
目标湿度（30、40、50、60、70、80）
属性（加湿器平台）

属性	描述
`可用模式`	可用操作模式的列表
`湿度`	当前目标湿度
`最大湿度`	最大可设定目标湿度
`最小湿度`	最小可设定目标湿度
`模式`	当前选择的操作模式

二进制传感器实体

二进制传感器	描述
水箱	指示水箱是否连接

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 湿度：当前测量的湿度。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
- 水位：当前水位百分比。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

空气加湿器 CA（zhimi.humidifier.ca1）

打开、关闭
操作模式（静音、中档、高档、自动）
目标湿度（30、40、50、60、70、80）
属性（加湿器平台）

属性	描述
`可用模式`	可用操作模式的列表
`湿度`	当前目标湿度
`最大湿度`	最大可设定目标湿度
`最小湿度`	最小可设定目标湿度
`模式`	当前选择的操作模式

二进制传感器实体

二进制传感器	描述
水箱	指示水箱是否连接

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 湿度：当前测量的湿度。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
- 水位：当前水位百分比。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
干燥模式	打开/关闭干燥模式

空气加湿器 CA（zhimi.humidifier.ca4）

打开、关闭
操作模式（自动、低档、中档、高档）
目标湿度（30 - 80）
属性（加湿器平台）

属性	描述
`可用模式`	可用操作模式的列表
`湿度`	当前目标湿度
`最大湿度`	最大可设定目标湿度
`最小湿度`	最小可设定目标湿度
`模式`	当前选择的操作模式

二进制传感器实体

二进制传感器	描述
水箱	指示水箱是否连接

数字实体

数字	描述
电机速度	设置电机速度

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 实际速度：当前电机速度（转/分钟）。默认启用。
- 湿度：当前测量的湿度。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
- 水位：当前水位百分比。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
清洁模式	打开/关闭清洁模式
干燥模式	打开/关闭干燥模式

Note

清洁模式和电机速度只能在设备打开时设置。

空气加湿器 CB（zhimi.humidifier.cb1）

打开、关闭
操作模式（静音、中档、高档、自动）
目标湿度（30、40、50、60、70、80）
属性（加湿器平台）

属性	描述
`可用模式`	可用操作模式的列表
`湿度`	当前目标湿度
`最大湿度`	最大可设定目标湿度
`最小湿度`	最小可设定目标湿度
`模式`	当前选择的操作模式

二进制传感器实体

二进制传感器	描述
水箱	指示水箱是否连接

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体
- 湿度：当前测量的湿度。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
- 水位：当前水位百分比。默认启用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
干燥模式	打开/关闭干燥模式

空气加湿器 JSQ/JSQ1/MJJSQ（deerma.humidifier.jsq，deerma.humidifier.jsq1，deerma.humidifier.mjjsq）

打开、关闭
操作模式（低、中、高、湿度）
目标湿度（30、40、50、60、70、80）
属性（加湿器平台）

属性	描述
`可用模式`	可用操作模式的列表
`湿度`	当前目标湿度
`最大湿度`	最大可设定目标湿度
`最小湿度`	最小可设定目标湿度
`模式`	当前选择的操作模式

二进制传感器实体

二进制传感器	描述
水箱	指示水箱是否连接
水箱空	指示水箱是否为空

传感器实体|
- 湿度：当前测量的湿度。默认启用。
- 温度：当前测量的温度。默认启用。
- 使用时间：设备使用的累计秒数。默认禁用。
开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
LED	打开/关闭 LED

落地风扇 1X（dmaker.fan.p5）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）
摇头角度	设置摇头角度（度）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED

落地风扇（zhimi.fan.za1, zhimi.fan.za3, zhimi.fan.za4, zhimi.fan.sa1）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）
摇头角度	设置摇头角度（度）

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

直流落地风扇（zhimi.fan.v2, zhimi.fan.v3）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）
摇头角度	设置摇头角度（度）

选择实体

选择	描述
LED 亮度	控制 LED 的亮度（亮、暗、关闭）

传感器实体

传感器	描述
电池	当前电池电量百分比
湿度	当前测量的湿度
温度	当前测量的温度

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁

落地风扇 1C（dmaker.fan.1c）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED

塔式风扇/落地风扇2/落地风扇Pro（dmaker.fan.p9, dmaker.fan.p10, dmaker.fan.p11, dmaker.fan.p18）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）
摇头角度	设置摇头角度（度）

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
LED	打开/关闭 LED

落地风扇3（zhimi.fan.za5）

电源（打开、关闭）
操作模式（正常，自然）
摇头（打开、关闭）
二进制传感器实体

二进制传感器	描述
电源供应	指示电源供应是否已连接

数字实体

数字	描述
延迟关机倒计时	设置延迟关机倒计时（分钟）
LED 亮度	设置 LED 亮度
摇头角度	设置摇头角度（度）

传感器实体

传感器	描述
湿度	当前测量的湿度
温度	当前测量的温度

开关实体

开关	描述
蜂鸣器	打开/关闭蜂鸣器
儿童锁	打开/关闭儿童锁
离子发生器	打开/关闭离子发生器

动作

动作 humidifier.set_humidity

设置目标湿度。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家加湿器实体执行操作。
`humidity`	否	目标湿度

动作 humidifier.set_mode

设置加湿器操作模式。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家加湿器实体执行操作。
`mode`	否	小米米家操作模式

动作 fan.set_percentage

设置风扇速度百分比。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家风扇实体执行操作。
`percentage`	否	风扇速度。百分比速度设置

动作 fan.set_preset_mode

设置风扇操作模式。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家风扇实体执行操作。
`preset_mode`	否	小米米家操作模式

动作 xiaomi_miio.fan_reset_filter (仅适用于空气净化器2)

重置过滤器的寿命和使用。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家风扇实体执行操作。

动作 xiaomi_miio.fan_set_extra_features（仅适用于空气净化器）

设置额外功能。

数据属性	可选	描述
`entity_id`	否	仅对特定的小米米家风扇实体执行操作。
`features`	否	整数，已知值为 0 和 1。

小米空气质量监测器

xiaomi_miio 空气质量监测器正在监视您的小米米空气质量监测器（PM2.5）并报告空气质量指数和其他值。

当前支持的功能包括：

空气质量指数（AQI）
颗粒物 2.5
属性
- 电源
- 充电
- 电池
- time_stat
- 二氧化碳当量
- 总挥发性有机化合物
- 温度
- 湿度

小米红外遥控器

xiaomi miio 遥控器平台允许您从小米红外遥控器（ChuangmiIr）发送红外命令。

设置

请按照获取访问令牌中的说明获取用于小米米家中的 API 令牌。

配置平台

要将小米红外遥控器添加到您的安装中，请在您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中添加以下内容：

remote:
  - platform: xiaomi_miio
    host: 192.168.42.42
    token: YOUR_TOKEN

Configuration Variables

Looking for your configuration file?

host string Required

您的遥控器的 IP 地址。

token string Required

您的遥控器的 API 令牌。

name string (Optional)

您的遥控器的名称。

slot integer (Optional, default: 1)

用于保存学习命令的插槽。

timeout integer (Optional, default: 30)

学习新命令的超时时间。

commands map (Optional)

命令列表

command list Required

一列表作为原始命令（学习命令）或 pronto 六角代码。

完整配置

remote:
  - platform: xiaomi_miio
    name: "浴室遥控器"
    host: 192.168.42.42
    token: YOUR_TOKEN
    slot: 1
    timeout: 30
    commands:
      activate_towel_heater:
        command:
          - raw:base64:[optional_frequency]
      read_bad_poem:
        command:
          - raw:base64:[optional_frequency]
          - pronto:pronto_hex:[optional_repeat]

将命令作为实体按钮添加到仪表板

type: entity-button
tap_action:
  action: call-service
  action: remote.send_command
  data:
    command: activate_towel_heater
    entity_id: remote.xiaomi_miio_ir
hold_action:
  action: more-info
show_icon: true
show_name: true
entity: remote.xiaomi_miio_ir
icon: "mdi:radiator"
name: 激活毛巾加热器

使用命名命令创建 UI 按钮

script:
  towel_heater:
    sequence:
      - action: remote.send_command
        target:
          entity_id: "remote.bathroom_remote"
        data:
          command:
            - "activate_towel_heater"
  please_cover_your_ears:
    sequence:
      - action: remote.send_command
        target:
          entity_id: "remote.bathroom_remote"
        data:
          command:
            - "read_bad_poem"

命令类型

小米红外遥控器平台当前支持两种不同的红外代码格式。

原始

原始命令是通过 xiaomi_miio.remote_learn_command 学习的命令。

原始命令的定义如下所示的示例：

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=

并带有一个可选的最后参数频率：

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=:38400

Pronto 六角代码

Pronto 六角代码是设备制造商通常提供的六角代码。

Pronto 六角代码的定义如下所示的示例：

pronto:0000 006C 0022 0002 015B 00AD 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0623 015B 0057 0016 0E6E

并带有一个可选的最后参数重复（某些设备需要）：

pronto:0000 006C 0022 0002 015B 00AD 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0623 015B 0057 0016 0E6E:2

注意当前有至少 4 个版本的小米红外遥控器（ChuangmiIr），可以通过其默认主机名进行识别：

chuangmi.ir.v2
chuangmi.remote.h102a03
chuangmi.remote.v2
chuangmi.remote.h102c01

目前，pronto 六角代码仅适用于第一个版本（chuangmi.ir.v2）。

动作

小米红外遥控器平台注册了四个动作。

remote.send_command

允许使用标识符发送命名命令，或作为命令类型中定义的两种类型之一发送命令。

xiaomi_miio.remote_learn_command

用于学习新命令。

使用小米红外遥控器的 entity_id 开始学习过程。

可以指定 slot 和 timeout，但多个命令学习到同一个插槽仍然可以使用 remote.send_command 发送，即使它们被覆盖。

学习命令后，基本的 base64 字符串可以在概述中的通知中找到，可以通过左键单击字符串并选择复制选项来复制字符串。

xiaomi_miio.remote_set_led_on

用于打开遥控器的蓝色 LED。

xiaomi_miio.remote_set_led_off

用于关闭遥控器的蓝色 LED。

小米米机器人吸尘器

xiaomi_miio 吸尘器平台允许您控制小米米机器人吸尘器的状态。

当前支持的操作有：

start
pause
stop
return_to_base
locate
clean_spot
set_fan_speed 风扇速度：静音、标准、中档、涡轮 和 轻柔（专为擦地而设）。
xiaomi_clean_zone
xiaomi_clean_segment
xiaomi_goto
remote_control_*（控制您的机器人）

动作

除了 vacuum integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 提供的所有操作（start、pause、stop、return_to_base、locate、set_fan_speed 和 send_command），xiaomi_miio 平台还引入了特定操作以访问机器人的遥控模式。这些是：

xiaomi_miio.vacuum_clean_zone
xiaomi_miio.vacuum_clean_segment
xiaomi_miio.vacuum_goto
xiaomi_miio.vacuum_remote_control_start
xiaomi_miio.vacuum_remote_control_stop
xiaomi_miio.vacuum_remote_control_move
xiaomi_miio.vacuum_remote_control_move_step

动作 xiaomi_miio.vacuum_clean_zone

在选定区域启动清洁操作，重复指定的次数。

数据属性：entity_id
- 描述：仅对特定机器人有效。
- 可选：否。
数据属性：zone
- 描述：区域列表。每个区域是四个整数值的数组。这些值表示描述清洁区域开始和结束点的两个 x 轴和 y 轴坐标集。例如，[[23510,25311,25110,26361]] 创建一个框，从一个角的 23510, 25311（x 轴和 y 轴）坐标开始，并沿斜对角扩展到 25110, 26361 坐标以创建矩形清洁区。
- 可选：否。
数据属性：repeats
- 描述：每个区域重复清洁的次数，范围为 1 到 3。
- 可选：否。

xiaomi_miio.vacuum_clean_zone 使用示例：

内

帮助我们改进翻译

建议编辑此页面，或提供/查看此页面的反馈。

编辑提供反馈查看待处理的反馈