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

前言

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

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

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

一、小米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.v1zhimi.airpurifier.v2zhimi.airpurifier.v3zhimi.airpurifier.v5zhimi.airpurifier.v6zhimi.airpurifier.v7zhimi.airpurifier.m1zhimi.airpurifier.m2zhimi.airpurifier.ma1zhimi.airpurifier.ma2zhimi.airpurifier.mc1zhimi.airpurifier.mc2zhimi.airpurifier.sa1zhimi.airpurifier.sa2zhimi.airpurifier.mb3zhimi.humidifier.v1zhimi.humidifier.ca1zhimi.humidifier.ca4zhimi.humidifier.cb1deerma.humidifier.mjjsqdeerma.humidifier.jsqdeerma.humidifier.jsq1shuii.humidifier.jsq001nwt.derh.wdh318efw1zhimi.airfresh.va2zhimi.airfresh.va4dmaker.airfresh.t2017dmaker.airfresh.a1zhimi.fan.v2himi.fan.v3zhimi.fan.sa1zhimi.fan.za1zhimi.fan.za3zhimi.fan.za4dmaker.fan.p5dmaker.fan.p9dmaker.fan.p10dmaker.fan.p11leshow.fan.ss4

4. 小米插座系列


支持设备:
chuangmi.plug.m1chuangmi.plug.m3chuangmi.plug.v2chuangmi.plug.hmi205chuangmi.plug.hmi206chuangmi.plug.v3chuangmi.plug.v1chuangmi.plug.hmi208qmi.powerstrip.v1zimi.powerstrip.v2lumi.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. 米家洗衣机


上面是我收集的目前已经写了插件相关信息,我会不断更新的。

二、找到目标设备插件

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

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

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



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


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

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


  3. 把插件文件复制到自定义插件文件夹处后,进行下一步,配置插件设置文件。

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

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

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




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

  • 设备类目: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



  2. 到github对应插件的地址,找到相应配置文件的规范实例,把配置文件示例复制,然后黏贴到上面新建的yaml文件编辑区域。


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








  3. 把上面获取到的相关信息,到设备的配置文件里面修改成对应的。
  4. 重启home-assistant,是配置生效

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