20221220-HomeAssistant树莓派-小米篇

想要一统江湖，我们只需关心设备的传输协议即可

目前有一个简单粗暴的标准，即如果一个设备需要小米多功能网关才可以使用，一般来说它采用的是zigbee协议，那么只要网关接入了HA 就可以完美适配，而如果一个设备是独立接入网络的，比如米家的wifi 插座，扫地机器人，yeelight 灯具等等，我们则需要单独在hass 里接入它们

本篇教程将介绍将小米接入HA 的方法，如果你打算通过HB直连，请参考渣渣米大大的教程

表格使用 Google SpreadSheet 编辑，将会不断更新。国内朋友可访问『坚果云』获取。在此欢迎各位派友向我提供支持信息或内容纠正，直接在表格内评论即可。

下面我们以传输协议为划分标准，分别介绍小米设备接入智能家居系统的方法，详细完整的全系接入方法
Home Assistant 中文文档。

需要提点的是，今后只要是Wifi的设备，都将通过 xiaomi_miio接入，Zigbee 设备则统一是 xiaomi_aqara。

ZigBee 设备 网关类设备

以小米多功能网关第二代 为代表的网关类设备是大部分 米家 及 绿米 aqara zigbee 设备的联动基础，也是整个米家智能家居系统的核心，除多功能网关外，空调伴侣和Aqara 监控摄像头都具备网关功能

打开米家 app，连接设置多功能网关，点击进入网关页面，点击右上角「…」，进入「设置」。点击第二行「关于」，狂点空白处，便会跳出「局域网通信协议」以及「网关信息」。进入「局域网通信协议」，打开开关，记录下密码，这就是之后待填的「key」。回到上级页面，进入「网关信息」，记录下 mac 地址，这就是之后待填的「sid 或 mac」。

HA 0.50.0 及之后版本已经添加对米家平台的官方支持，我们只需要直接配置即可，如果之前有复制 custom_components 文件夹的同学，升级后请删除该文件夹

此设置适用于 HA 0.54.0版及之后

xiaomi_aqara:
gateways:
- mac: MAC 地址 （地址不带 “-“ 或 “:” ，行首的「-」必须保留）
key: 通讯密码
如果你有多个网关，则按以下格式设定：

xiaomi_aqara:
gateways:
- mac: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
- mac: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
重启后，HA 主界面将会自动识别网关及捆绑的所有设备。

Yeelight 灯具

yeelight 目前已经从小米独立出来，运作良好，原生支持google assistant 等平台， yeelight 在ha 中支持色温，色彩、亮度等控制，基本实现全品支持

配置前请先在yeelight app 中打开 局域网控制 LAN Control 服务器选择中国大陆，新加坡皆可，注意如果所选服务器与米家app 中不同，则设备无法接入米家app，但不影响在yeelight app 及ha 中的控制

之后重启HA 重启前请打开灯具，稍等积分中，确认一下设备是否已经被HA 自动识别添加，如果是的话，皆大欢喜，什么都无需再做了；如果没有，请打开configuration.yaml文件，在合适位置添加如下字段：

light:

• platform: yeelight
  devices:
  192.168.1.25: #Yeelight灯具ip
  name: Living Room #昵称
  transition: 1000
  use_music_mode: True #音乐随动模式，默认关闭
  以上 2 个是最常见的具有统一平台的设备适配，下面是使用 WiFi 传输协议设备的具体配置方法：

获取 token

所有的小米wifi 设备都必须先取得设备的token 方可接入HA ，以下简要介绍获取token 的方法之一，

首先在安装有node js 的电脑上安装miio 库

sudo npm install miio

之后，重置 待连小米设备的网络，使其产生wifi 热点，将电脑连接至该热点上，之后输入

miio –discover

即获取设备的token， 请集中保存，获取token 后，如需绑定米家 app 请直接在qpp 中添加设备，切勿继续重置设备，否则token 将重新生成，原有token 将失效

米家扫地机器人

HA 原生支持米家 和石头扫地机器人2nd 使用专门的类vacuum

按照上方教程获取扫地机的 token，之后在 configuration.yaml 中填入以下配置：

vacuum:

• platform: xiaomi_miio
  name: ‘***’ #昵称
  host: 192.168.1.2 #ip
  token: R@#RT$TFEW #token

空气净化器

HA 目前原生支持2代空气净化器，暂不支持pro 版

按照上方教程获取空气净化器的 token，之后在 configuration.yaml 中填入以下配置：

fan:

• platform: xiaomi_miio
  name: Xiaomi Air Purifier 2
  host: 192.168.130.66
  token: YOUR_TOKEN

空调伴侣

米家和aqarq 均发布了自己品牌的空调伴侣，除外观差异外，内核并无不同，，小米已于今日固件更新中开发空调伴侣的 局域网通信协议，空调控制和网关功能请分别使用各自插件接入，

另，目前插件仅支持部分空调品牌的部分预设模式，详见插件说明页，未支持的型号请自行抓包空调码。

Home Assistant 中空调伴侣以自定义组件的方式加入，此组件为爱好者 Mac_zhou 制作，欢迎大家前往 项目地址 点赞。

插件使用前需获取设备的 token：进入『米家』应用，点击空调伴侣，选择右上角『•••』—— 『关于』—— 狂点空白区域 —— 网关信息 “token=xxxxxxx”即是 。

将 Github 中的对应文件放入文件夹，层级与 Github 中展示一致，之后在配置文件中增加以下配置：

climate:
- platform: mi_acpartner
name: mi_acpartner
host: 10.0.0.234 #ip地址
token: ****** #token
target_sensor: sensor.temperature_158d00015aefc4 #温度传感器 ID
target_temp: 26 #目标温度

组件由国人制作，readme 文件以中文书写，这里我就不再作变量说明了

wifi 插座及智能插线板

0.56.0的更新带来了插座的支持，接入前先获取设备的token
具体方法见前文。之后，在 configuraiton.yaml 添加如下设置：

switch:

• platform: xiaomi_miio
  name: Original Xiaomi Mi Smart WiFi Socket
  host: 192.168.130.59
  token: YOUR_TOKEN
  这英文简单得不能再简单了，我就不做变量说明了。

净水器

小米净水器插件由 bit3725 制作，欢迎前往 项目 点赞~
使用方法：从 Github 下载 mi_water_purifier.py，放入 custom_components/sensor/ 文件夹内（文件层级项目本身已经很清晰地给出了），在 configuration.yaml 添加如下设置：

sensor:

• platform: mi_water_purifier
  host: YOUR_SENSOR_IP
  token: YOUR_SENSOR_TOKEN
  name: YOUT_SENSOR_NAME
  接入后自动会生成几项相关的传感器数值，如果需要集中查看，请使用群组：

group:

• xiaomi_water_purifier:
  name: Xiaomi Water Purifier
  icon: mdi:water
  entities:
  • sensor.tap_water
  • sensor.filtered_water
  • sensor.pp_cotton_filter
  • sensor.front_active_carbon_filter
  • sensor.ro_filter
  • sensor.rear_active_carbon_filter
    PM 2.5 监测仪
    PM 2.5 监测仪插件由 bit3725 制作，欢迎前往 项目 点赞~

使用方法：从 Github 下载 mi_air_quality_monitor.py，放入 custom_components/sensor/ 文件夹内（文件层级项目本身已经很清晰地给出了），在 configuration.yaml 添加如下设置：

sensor:

• platform: mi_air_quality_monitor
  host: YOUR_SENSOR_IP
  token: YOUR_SENSOR_TOKEN
  name: YOUT_SENSOR_NAME