小米MIoT设备接入HomeAssistant通用插件教程
al-one/hass-xiaomi-miotgithub.com/al-one/hass-xiaomi-miot
小米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
- Shell自动安装
wget -q -O – https://cdn.jsdelivr.net/gh/al-one/hass-xiaomi-miot/install.sh | bash –
集成方法:
该方式适合在局域网环境中支持miot协议的设备

Xiaomi Miot Auto
由于部分设备不支持在局域网环境下通过MIoT协议读写数据,比如小爱音响、摄像头,需要开启云端模式才可以正常使用。如果你集成后该设备下的所有实体都不可用,则可能需要开启云端模式。
开启云端模式:
- 在configuration.yaml中配置你的小米账号密码
xiaomi_miot:
username: xiaomi_username
password: xiaomi_password
- 点击集成下面的“选项”,勾选“☑️ 开启云端模式” (开启后需等待一两分钟)

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

通过小米账号自动添加符合条件的设备