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

[robot]

前言

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

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

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

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

1. 小米风扇系列

syssi/xiaomi_fan

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

2. 小米空调伴侣系列

syssi/xiaomi_airconditioningcompanion

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

3. 小米净化器系列

syssi/xiaomi_airpurifier

支持设备：
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. 小米插座系列

syssi/xiaomiplug

支持设备：
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. 小米电饭锅

syssi/xiaomi_cooker

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

6. 小米飞利浦灯类

syssi/philipslight

7. 小米空气检测系列

syssi/xiaomi_airqualitymonitor

8. 小米空调伴侣系列

mac-zhou/homeassistant-mi-acpartner

9. 小米净水器系列

bit3725/homeassistant-mi-water-purifier

10. 小米加热器系列

sunfang1cn/homeassistant-mi-heater

11. 小米空调系列

LT21/xiaomi_airconditioning_c1

vaughan-zeng/zhimi

12. 小米新风系列

mypal/mi-airfresh

13.小米扫地机系列

marcelrv/XiaomiRobotVacuumProtocol

14. 米家wifi窗帘机

tiandeyu/mijia_curtain

15. 米家洗衣机

tiandeyu/mijia_washer

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

[robot]

二、找到目标设备插件

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

1. 直接在hacs商店输入关键词搜索，通常使用" xiaomi fan"、"xiaomi airpurifier"等"品牌+产品系列"的英文词组搜索，从搜索结果选出目标插件，如果没有则使用另外的方法。
   
   
   
   
   
2. 在github https://github.com 搜索，同样也使用关键字" xiaomi fan"、"xiaomi airpurifier"等"品牌+产品系列"的英文词组搜索，从搜索结果选出目标插件，同时下载目标插件。
   
   
   
   
   
   
   
   
   
   
   
3. 在论坛里面搜索，也是使用关键字，如果是中文论坛则使用例如：“小米 风扇”,“小米净化器”，"米家 空气净化器"等关键字。如果iobroker论坛没有相关插件，请移步到hassbian论坛搜索。
   
   
   
   
   
   
   
   

[robot]

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

1. 通过hacs应用商店找到的目标插件，直接在hacs商店里面安装即可。
   
   
2. 如果是通过github下载的插件，则需要把对应的插件文件上传到home-assistant的自定义文件夹里面，即 /config/custom_components，以智趣盒子的home-assistant为例子：
   
   
   
   
   
   
   
   
3. 把插件文件复制到自定义插件文件夹处后，进行下一步，配置插件设置文件。

[robot]

四、 通过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，是配置生效
   
   

[robot]

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