非集成或者hacs应用商店或者miot插件的小米设备接入方法

社区交流
, , ,
#1

前言

  • home-assistant接入设备主要通过【相应的插件】及【配置文件】来实现的；

  • 插件是python文件是设备控制协议和home-assistant控制规范对接；

  • 配置文件是设定特定设备的个体信息，例如ip、token、型号等，是个体对接插件，从而接入home-assistant

image
image1634×886 104 KB

一、小米miio设备插件集合–智趣盒子已经全部预装，不需单独下载了。

1. 小米风扇系列

支持设备：
zhimi.fan.v2 , zhimi.fan.v3 , zhimi.fan.sa1 , zhimi.fan.za1 , zhimi.fan.za3 , zhimi.fan.za4 and dmaker.fan.p5

2. 小米空调伴侣系列

支持设备：
acpartner.v1, acpartner.v2, acpartner.v3

3. 小米净化器系列

支持设备：
zhimi.airpurifier.v1；zhimi.airpurifier.v2；zhimi.airpurifier.v3；zhimi.airpurifier.v5；zhimi.airpurifier.v6；zhimi.airpurifier.v7；zhimi.airpurifier.m1；zhimi.airpurifier.m2；zhimi.airpurifier.ma1；zhimi.airpurifier.ma2；zhimi.airpurifier.mc1；zhimi.airpurifier.mc2；zhimi.airpurifier.sa1；zhimi.airpurifier.sa2；zhimi.airpurifier.mb3；zhimi.humidifier.v1；zhimi.humidifier.ca1；zhimi.humidifier.ca4；zhimi.humidifier.cb1；deerma.humidifier.mjjsq；deerma.humidifier.jsq；deerma.humidifier.jsq1；shuii.humidifier.jsq001；nwt.derh.wdh318efw1；zhimi.airfresh.va2；zhimi.airfresh.va4； dmaker.airfresh.t2017；dmaker.airfresh.a1；zhimi.fan.v2；himi.fan.v3；zhimi.fan.sa1；zhimi.fan.za1；zhimi.fan.za3；zhimi.fan.za4；dmaker.fan.p5；dmaker.fan.p9；dmaker.fan.p10；dmaker.fan.p11；leshow.fan.ss4

4. 小米插座系列


支持设备：
chuangmi.plug.m1；chuangmi.plug.m3；chuangmi.plug.v2；chuangmi.plug.hmi205；chuangmi.plug.hmi206；chuangmi.plug.v3；chuangmi.plug.v1；chuangmi.plug.hmi208；qmi.powerstrip.v1；zimi.powerstrip.v2；lumi.acpartner.v3

5. 小米电饭锅

支持设备：
chunmi.cooker.normal1;chunmi.cooker.normal2;chunmi.cooker.normal3;chunmi.cooker.normal4;chunmi.cooker.normal5;chunmi.cooker.press1;chunmi.cooker.press2

6. 小米飞利浦灯类

7. 小米空气检测系列

8. 小米空调伴侣系列

9. 小米净水器系列

10. 小米加热器系列

11. 小米空调系列

12. 小米新风系列

13.小米扫地机系列

14. 米家wifi窗帘机

15. 米家洗衣机


上面是我收集的目前已经写了插件相关信息，我会不断更新的。
米家设备对接home-assistant总教程（一定要完整看完正文及内置链接）
米家设备对接home-assistant总教程（一定要完整看完正文及内置链接）
米家设备对接home-assistant总教程（一定要完整看完正文及内置链接）
#2
#3
#4
#5
#6

二、找到目标设备插件

第一步：是在hacs商店、论坛、github找到目标设备插件

  1. 直接在hacs商店输入关键词搜索，通常使用" xiaomi fan"、"xiaomi airpurifier"等"品牌+产品系列"的英文词组搜索，从搜索结果选出目标插件，如果没有则使用另外的方法。
    image
    image2558×1124 211 KB

    image
    image2550×1136 247 KB
  2. 在github https://github.com 搜索，同样也使用关键字" xiaomi fan"、"xiaomi airpurifier"等"品牌+产品系列"的英文词组搜索，从搜索结果选出目标插件，同时下载目标插件。
    image
    image2550×1186 291 KB

    image
    image2554×1200 331 KB

    image
    image2556×1196 317 KB

    image
    image1514×864 115 KB
  3. 在论坛里面搜索，也是使用关键字，如果是中文论坛则使用例如：“小米 风扇”,“小米净化器”，"米家 空气净化器"等关键字。如果iobroker论坛没有相关插件，请移步到hassbian论坛搜索。
    image
    image2322×1158 709 KB

    image
    image2548×1138 612 KB

    image
    image1640×1194 247 KB
#7

三、把找到的对应插件安装或者上传到home-assistant系统

  1. 通过hacs应用商店找到的目标插件，直接在hacs商店里面安装即可。
    image
    image2550×1136 247 KB
  2. 如果是通过github下载的插件，则需要把对应的插件文件上传到home-assistant的自定义文件夹里面，即 /config/custom_components，以智趣盒子的home-assistant为例子：
    image
    image2416×1352 318 KB

    image
    image2372×1162 375 KB

    image
    image2348×1172 424 KB
  3. 把插件文件复制到自定义插件文件夹处后，进行下一步，配置插件设置文件。
#8

四、 通过file editor在packages文件夹里面，根据相应的规则，撰写配置文件。

米家的设备一般通过miio协议或者miot协议对接home-assistant。miot已经有专门的插件了，所以不能通过集成接入的设备一般都是老的miio设备。因为都是用同一套协议接入，所以配置文件的规范就大同小异了。

我们先看看小米风扇、净化器、插座的配置文件有什么特点：

image
image1112×258 24 KB

image
image804×270 27.5 KB

image
image1038×222 26.5 KB

不难看出，配置文件的信息包含了一下信息：

  • 设备类目：fan或者switch–一般是home-assistant规定好的；

  • platform（插件信息）：xiaomi_miio_fan或者xiaomi_miio_airpurifier、 xiaomi_miio_plug–根据插件提供的规范填写；

  • name（名字）: 接入设备的名称–这个可以自定义，一般在配置文件里面用英文字母表达，不能用汉字，这里也会根据name生成设备id，所以起名的时候，要注意好记好分辨。

  • host（设备）：一般用设备的ip定义不同的设备–这个信息，可以根据盒子集成的插件获取，下文详细介绍。

  • token（控制码）：机器连接了wifi之后，就会生成控制码–这个信息，也可以根据盒子集成的插件或者，下文有详细的介绍。
    model（型号）: 这个是小米给每个设备定义了一个机器型号，通常用英文标识–这个信息，也可以根据盒子集成的插件或者，下文有详细的介绍。
    综上所述，所以设备的接入的配置文件信息，除了规范好的（不能改的：设备类目）或者可以自定义的name（名称）之外，最重要的是如何获取设备的：ip+token+model。
    下面我们就以小米风扇为例子，看看具体的操作步骤

  1. 通过智趣盒子预制的配置文件编辑器file-editor找到config文件夹里面packages文件夹，在packages文件夹里面新建一个以英文字母自定义命名的yaml文件。
    命名规则最好以“区域的英文字母”+“设备类目英文字母”的组合，方便管理packages里面的文件。比如：zhuwofan.yaml或者cufangfan.yaml
    image
    image2550×1266 222 KB

    image
    image2554×1284 278 KB

    image
    image2554×1286 200 KB

    image
    image2546×1342 262 KB
  2. 到github对应插件的地址，找到相应配置文件的规范实例，把配置文件示例复制，然后黏贴到上面新建的yaml文件编辑区域。
    image
    image1532×1208 159 KB

    image
    image2538×1286 267 KB

    3.通过智趣盒子内置的小米多模网关插件工具，获取设备自己的ip、token等相关信息
    image
    image2558×1438 348 KB

    image
    image2550×1322 375 KB

    image
    image2542×1276 362 KB

    image
    image2544×1280 335 KB

    image
    image2512×1288 270 KB

    image
    image2556×1286 278 KB

    image
    image2558×1298 340 KB

    image
    image2558×1278 288 KB

    image
    image2556×1328 346 KB
  3. 把上面获取到的相关信息，到设备的配置文件里面修改成对应的。
    image
    image2558×1290 311 KB
  4. 重启home-assistant，是配置生效
    image
    image2552×1268 343 KB
智趣盒子问题反馈集中帖
#9

五、确认设备接入生效，并把设备添加到lovelace显示界面

image
image2558×1300 294 KB

image
image2558×1276 236 KB

image
image2552×1276 296 KB

image
image2556×1268 234 KB

image
image2558×1278 223 KB

image
image2558×1296 252 KB

2 个赞