Universal Xiaomi MIoT integration for Home Assistant

简体中文 | English

MIoT 协议是小米智能家居从 2018 年起推行的智能设备通信协议规范,此后凡是可接入米家的设备均通过此协议进行通信。此插件按照 MIoT 协议规范与设备通信,实现对设备的状态读取及控制。

由于 MIoT 协议具有极强的通用性,已接入米家的智能设备均可通过此插件快速高效地接入 Home Assistant,而无关设备的具体型号。

本插件运行方式默认为本地接入(局域网读取/控制),延迟极低。对于不支持本地读取的设备,支持 2 种云端接入(云端读取本地控制/云端读取云端控制)。

目前此插件已支持以下设备类型:

  • sensor (传感器)
  • switch (开关)
  • cover (卷帘/晾衣架/升降帘/窗帘)
  • light (灯,可以开关、调亮度、调色、设置灯效)
  • fan (风扇,可以开关、设置风速、设置摇头)
  • humidifier (加湿器/除湿器,可以开关、设置湿度、选择模式)
  • media player (小爱音箱,可以播放/暂停/调音量,TTS/执行自定义指令二选一)(需要通过文件配置)

如果对您有帮助,欢迎给个 Star!
?

如果插件工作不正常,请先参考调试部分,打开调试日志,通过日志排查问题。

如果您认为插件有 bug,或者有新功能的想法,您可以提交 Issue。 使用上的问题,请在论坛咨询,或加入 QQ 群: 982 100 289

2 月 3 日 Breaking Changes

  1. 支持了一个设备多种类型的自动配置,现在像风扇灯、晾衣架这类具有子设备的设备,可以自动识别一次性接入
  2. 由于 1 的原因,插件内部数据存储方式发生较大变化,部分设备需要删除重新配置,需要重新配置的设备已在通知栏中写明;文件配置的设备不受影响。
  3. 大幅提高了自动识别的准确性。

安装

  • 将 custom_component 文件夹中的内容拷贝至自己的相应目录

或者

配置

UI 配置法

HACS中不支持显示图片,请在浏览器中打开查看

2

3

文件配置法

请参考 config_example 文件夹 内的相关文件

各个设备类型公用的配置参数: