小米MIoT设备接入HomeAssistant通用插件教程

小米IoT设备协议规范：MIoT Specification，简称：MIoT-Spec，是小米IoT平台根据硬件产品的联网方式、产品功能的特点、用户使用场景的特征和用户对硬件产品使用体验的要求，设计的描述硬件产品功能定义的标准规范。了解更多

而hass-xiaomi-miot插件利用了MIoT-Spec的规范，可将小米设备自动接入HomeAssistant，目前已支持大部分小米MIoT设备。且该插件支持HA后台界面集成，无需配置yaml即可轻松将小米设备接入HA。

目前支持的设备类型有：

• sensor - 净水器/电饭煲/压力锅/电磁炉/烤箱/微波炉/养生壶/咖啡机/滤芯寿命/路由器/温湿度计/可视门

• binary_sensor - 马桶/马桶盖

• switch - 开关/插座/洗衣机/宠物饮水机

• light - 吸顶灯/夜灯

• fan - 风扇/凉霸/油烟机

• climate - 空调(伴侣)/空气净化器/新风机/取暖器/浴霸/电热毯/水暖垫/洗碗机/饮水机

• vacuum - 扫地机(暂不支持定点/划区清扫)

• cover - 窗帘电机/晾衣机/开窗器

• humidifier - 加湿器/除湿机

• water_heater - 热水器

• air_quality - 空气检测仪

• camera - 摄像头

• media_player - 小爱同学(支持TTS及语音命令控制设备)

• device_tracker - 后视镜

安装方法：

• 通过HACS安装，搜索“Xiaomi Miot Auto”，请认准“Xiaomi Miot Auto”

• 手动安装

• 进入Releases下载最新版本

• 解压后复制`custom_components/xiaomi_miot`至HA目录下的`custom_components`中

• 重启HomeAssistant

集成方法：

• 登陆HA > ⚙️配置 > 🧩集成 > ➕添加集成 > 搜索“Xiaomi Miot Auto” (如果搜索不到请清除你的浏览器缓存)

• 填入你的设备IP、Token等信息 (如何获取Token)

• 该方式适合在局域网环境中支持miot协议的设备

由于部分设备不支持在局域网环境下通过MIoT协议读写数据，比如小爱音响、摄像头，需要开启云端模式才可以正常使用。如果你集成后该设备下的所有实体都不可用，则可能需要开启云端模式。

开启云端模式：

• 在configuration.yaml中配置你的小米账号密码

xiaomi_miot:

username: xiaomi_username
password: xiaomi_password

• 点击集成下面的“选项”，勾选“☑️ 开启云端模式” (开启后需等待一两分钟)

• 另一种方式是通过小米账号自动添加符合条件的设备，该方式适合miio协议设备或者蓝牙、ZigBee设备