简体中文 | English
灯
、电视
、空调
品类虚拟设备,接入 HA 后直接显示为对应类型设备并可以控制!欢迎试用,如有问题可讨论>>MIoT 协议是小米智能家居从 2018 年起推行的智能设备通信协议规范,此后凡是已接入米家的设备均可通过此协议进行通信。此插件按照 MIoT 协议规范与米家设备或小米服务器通信,实现对设备的状态读取及控制。
通过本插件,已接入米家的智能设备均可快速高效地接入 Home Assistant,而无关设备的具体型号。本插件已全面支持图形界面配置,全程无需编辑配置文件。
本插件具有本地(局域网)和云端两种工作方式。两种方式结合,可以接入绝大多数米家智能设备(包括蓝牙、蓝牙 Mesh 和 ZigBee 设备)。
如果对您有帮助,欢迎给个 Star!🌟
欢迎加入 MIoT 插件交流群,在这里您不仅可以快速地得到插件相关问题的解答,还可与大家交流智能家居心得,畅所欲言!
1 群: 982 100 289(已满) 2 群: 789 221 593
以下两种安装/升级方法,选择其中一种即可。
请不要使用一种方法安装然后用另一种方法升级,可能导致问题。
集成
。浏览并添加存储库
。Xiaomi MIoT
,安装即可。Xiaomi MIoT
插件,而能看到带有其他后缀的插件。Xiaomi MIoT
插件名称不带任何后缀,请注意识别。 如果在 HACS 中找不到此插件,可以使用下面的手动安装方法。xiaomi_miot_raw-master
/custom_components
文件夹。xiaomi_miot_raw
文件夹拷贝至自己 HA 安装目录的custom_components
文件夹。若不知道自己的 HA 安装目录:在 HA 中点击
配置
-底部信息
,页面中的configuration.yaml 路径
即为 HA 的安装目录。
若无custom_components
文件夹,可自己新建。
本插件已实现全面 UI 化,所有配置均可通过 UI(网页端)完成,无需您编辑配置文件。
对于您可能遇到的细节问题,例如空调没有温度传感器、晾衣架显示方向是反的、需要指示灯童锁开关等,作者都已经考虑到了,别忘了看特色功能部分!
对本插件进行配置有以下两种途径:
途径 1:点击集成页面右下角的添加集成
,然后选择Xiaomi MIoT
。
如果您想要登录账号、添加设备,请使用此途径。
途径 2:在集成页面找到已添加的设备/账号,然后点击选项
。
如果您想要修改账号地区、修改已添加设备的选项,请使用此途径。
首次使用建议您先登录小米账号。
登录账号后,即可立即选择要添加的设备。
后续如需添加更多设备,再次通过途径 1
进入插件,即可选择要添加的设备。
如需添加多个传感器设备,使用此方法会更加快捷:
对设备进行细微调整,使之更适合您的实际情况:
途径 2
启用它们。途径 2
来设置。途径 2
来反转位置。注:此功能只改变 HA 的显示,不会反转电机方向。途径 1
添加设备时,修改“配置参数”来实现。如果在插件使用上遇到问题,可加入 QQ 群,大多数问题并非插件本身的问题,在 QQ 群中能更快地得到解答。若是插件存在 Bug,可通过 GitHub 的 Issue 功能提交问题,这样便于跟踪。
这里有一个常见问题列表,汇总了许多常见的或具有共性的问题。
您可以先看看 Issue 列表,找找您的问题是否已经有人提出或者已经有办法解决了?
如果没有的话,可点击绿色的New Issue
按钮提交新问题。
在某些情况下,插件作者可能需要您提供更为详细的调试日志。启用详细日志的方法是:
# configuration.yaml
logger:
default: warn
logs:
custom_components.xiaomi_miot_raw: debug
miio: debug