『瀚思彼岸』» 智能家居技术论坛

 找回密码
 立即注册
查看: 332385|回复: 284

[进阶教程] Xiaomi MIoT - 小米米家设备全自动通用接入插件,无需配置文件

  [复制链接]

32

主题

986

帖子

4233

积分

论坛元老

Rank: 8Rank: 8

积分
4233
金钱
3207
HASS币
110

教程狂人论坛风云人物

发表于 2021-1-23 20:21:30 | 显示全部楼层 |阅读模式
本帖最后由 27hh 于 2021-8-12 11:16 编辑

Xiaomi MIoT

可访问插件的 GitHub 首页 ( https://github.com/ha0y/xiaomi_miot_raw ),提问或了解更多信息。

介绍

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

通过本插件,已接入米家的智能设备均可快速高效地接入 Home Assistant,而无关设备的具体型号。本插件已全面支持图形界面配置,全程无需编辑配置文件。

本插件具有本地(局域网)和云端两种工作方式。两种方式结合,可以接入绝大多数米家智能设备(包括蓝牙、蓝牙 Mesh 和 ZigBee 设备)。

如果对您有帮助,欢迎给个 Star!
欢迎加入 MIoT 插件交流群,在这里您不仅可以快速地得到插件相关问题的解答,还可与大家交流智能家居心得,畅所欲言!
1 群: 982 100 289(已满)  2 群: 789 221 593

安装或升级

以下两种安装/升级方法,选择其中一种即可。
请不要使用一种方法安装然后用另一种方法升级,可能导致问题。

通过 HACS 自动安装

  1. 打开 Home Assistant 的 HACS 页面。
  2. 点击集成
  3. 点击右下角的浏览并添加存储库
  4. 在新打开的页面中找到Xiaomi MIoT,安装即可。
    注意:如果您刚刚安装好 HACS,或者网络不通畅,您可能看不到Xiaomi MIoT插件,而能看到带有其他后缀的插件。
    Xiaomi MIoT插件名称不带任何后缀,请注意识别。 如果在 HACS 中找不到此插件,可以使用下面的手动安装方法。
  5. 重新启动 Home Assistant。
  • 如需升级: 在您打开 HACS 页面时,会自动出现升级提示。按照提示操作即可。

手动安装

  1. 下载插件 zip 压缩包(该链接始终为最新版本)。
  2. 依次打开压缩包中的xiaomi_miot_raw-master/custom_components文件夹。
  3. 将该文件夹中的xiaomi_miot_raw文件夹拷贝至自己 HA 安装目录的custom_components文件夹。
  4. 重新启动 Home Assistant。

若不知道自己的 HA 安装目录:在 HA 中点击配置-底部信息,页面中的configuration.yaml 路径即为 HA 的安装目录。
若无custom_components文件夹,可自己新建。

  • 如需升级: 下载最新版插件压缩包后,按照上述方法,覆盖原有文件即可。

使用方法

本插件已实现全面 UI 化,所有配置均可通过 UI(网页端)完成,无需您编辑配置文件。
对本插件进行配置有以下两种途径:

  1. 点击集成页面右下角的添加集成,然后选择Xiaomi MIoT。如果您想要登录账号、添加设备,请使用此途径。
  2. 在集成页面找到已添加的设备/账号,然后点击选项。如果您想要修改账号地区、修改已添加设备的选项,请使用此途径。

首次使用建议您先登录小米账号。



                               
登录/注册后可看大图



                               
登录/注册后可看大图



                               
登录/注册后可看大图



                               
登录/注册后可看大图

登录账号后,即可立即选择要添加的设备。

后续如需添加更多设备,再次通过途径 1进入插件,即可选择要添加的设备。



                               
登录/注册后可看大图



                               
登录/注册后可看大图

如需添加多个传感器设备,使用此方法会更加快捷:




                               
登录/注册后可看大图



                               
登录/注册后可看大图



                               
登录/注册后可看大图

特色功能

对设备进行细微调整,使之更适合您的实际情况:

  1. 对于所有类型的设备,指示灯和童锁的开关默认是隐藏的。您可以通过途径 2启用它们。
  2. 对于空调类实体,可以指定一个温度传感器作为该空调实体的温度来源。您可以通过途径 2来设置。
  3. 对于卷帘类实体,如果出现上/下位置颠倒的情况,您可以通过途径 2来反转位置。注:此功能只改变 HA 的显示,不会反转电机方向。
  4. 设备的部分选项(如模式)支持删除或修改名称,例如将风扇的模式修改为中文。您可以在途径 1添加设备时,修改“配置参数”来实现。

技术支持

如果在插件使用上遇到问题,可加入 QQ 群,大多数问题并非插件本身的问题,在 QQ 群中能更快地得到解答。若是插件存在 Bug,可通过 GitHub 的 Issue 功能提交问题,这样便于跟踪。

您可以先看看 Issue 列表,找找这个问题是否已经有人提出或者已经有办法解决了?
如果没有的话,可点击绿色的New Issue按钮提交新问题。

在某些情况下,插件作者可能需要您提供更为详细的调试日志。启用详细日志的方法是:

# configuration.yaml

logger:
  default: warn
  logs:
    custom_components.xiaomi_miot_raw: debug
    miio: debug

评分

参与人数 18金钱 +126 HASS币 +20 收起 理由
king.jin + 2 感谢楼主分享!
xyzh007 + 2 赠人玫瑰,手留余香!
dkef730 + 5 感谢楼主分享!
w569231348 + 2 感谢楼主分享!
gzroc + 10 厉害了word楼主!
tutianle + 1 感谢大佬!
jyz19880823 + 1 感谢楼主分享!
1457964 + 1 厉害了word楼主!
gsdv + 2 膜拜大神!
louis_lee + 5 大佬太牛了!跑去star
nnssz + 5 以后会用得上,感谢!!
XCray + 20 膜拜大神!
Lengran + 5 感谢楼主分享!
jyz_0501 + 20 大大NewB~~
ybcswz + 10
kleinsoul + 5 感谢楼主分享!
令狐鸣 + 10 膜拜大神!
+ 20 + 20 厉害了word楼主!

查看全部评分

回复

使用道具 举报

27

主题

220

帖子

939

积分

高级会员

Rank: 4

积分
939
金钱
719
HASS币
0
发表于 2024-10-3 12:25:18 | 显示全部楼层
请问下,如何在米家添加虚拟设备呢?
回复

使用道具 举报

0

主题

26

帖子

70

积分

注册会员

Rank: 2

积分
70
金钱
44
HASS币
0
发表于 2024-7-26 09:45:30 | 显示全部楼层
感谢楼主分享
回复

使用道具 举报

0

主题

3

帖子

36

积分

新手上路

Rank: 1

积分
36
金钱
33
HASS币
0
发表于 2024-7-25 22:12:27 | 显示全部楼层
用PVE装haos的怎么手动安装集成?
回复

使用道具 举报

0

主题

16

帖子

62

积分

注册会员

Rank: 2

积分
62
金钱
46
HASS币
0
发表于 2023-10-12 09:52:55 | 显示全部楼层
感谢分享
回复

使用道具 举报

0

主题

5

帖子

44

积分

新手上路

Rank: 1

积分
44
金钱
39
HASS币
0
发表于 2023-9-25 11:23:58 | 显示全部楼层
用HA 2023.9
回复

使用道具 举报

0

主题

6

帖子

47

积分

新手上路

Rank: 1

积分
47
金钱
41
HASS币
0
发表于 2023-9-9 01:14:17 | 显示全部楼层
膜拜大神!
回复

使用道具 举报

2

主题

4

帖子

28

积分

新手上路

Rank: 1

积分
28
金钱
24
HASS币
0
发表于 2023-8-5 14:03:29 | 显示全部楼层
好贴,学习了
回复

使用道具 举报

0

主题

51

帖子

619

积分

高级会员

Rank: 4

积分
619
金钱
568
HASS币
0
发表于 2023-5-29 12:03:59 | 显示全部楼层
膜拜大神!
回复

使用道具 举报

0

主题

4

帖子

178

积分

注册会员

Rank: 2

积分
178
金钱
174
HASS币
0
发表于 2023-5-22 17:22:33 | 显示全部楼层
成了,可以控制第三方的米家WIIF通断器了。
回复

使用道具 举报

0

主题

28

帖子

126

积分

注册会员

Rank: 2

积分
126
金钱
98
HASS币
0
发表于 2023-3-13 08:42:18 | 显示全部楼层
zhouyuan9291 发表于 2022-4-27 13:13
添加了电视  但是无法控制 请问怎么处理啊

大佬   现在解决了吗
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|Hassbian

GMT+8, 2024-11-23 16:07 , Processed in 0.115601 second(s), 37 queries .

Powered by Discuz! X3.4

Copyright © 2001-2021, Tencent Cloud.

快速回复 返回顶部 返回列表