Home Assistant 系列基础篇 - 小米特别篇

此教程正式停止更新,有关小米设备接入的完整攻略,请参考 Home Assistant 中文文档小米设备章节

更多精彩 Home Assistant 入门视频教程,欢迎前往 网易云课堂 学习。

欢迎加入 HA 技术讨论群:515348788

通过之前的『安装篇』『设备接入篇』,相信大家对 Home Assistant 有了一定程度的认识。

小米的智能家居设备物美价廉,博得了国内外不少用户的喜爱。不要不信,在 Home Assistant 官方论坛上,米家设备相关话题的热度一直居高不下。HA 在最新 50.0 版本中已经添加了对小米平台的官方支持。

From: https://home-assistant.io/blog/2017/07/29/release-50/

我们知道小米生态链挺复杂,紫米、绿米各种子公司。不管牌怎么换,对于集成平台来说,想要一统江湖,我们只需关心设备的传输协议即可。

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

类似的标准也适用于 Homeridge,homebridge-mi-aqara 插件正常情况下只支持 Zigbee 设备,其他设备需要另安装插件。

本篇教程将介绍将小米设备接入 HA 的方法,如果你打算通过 HB 直连,请参考 智能家居百科,本教程不再涉及。具体选择哪个方案,大家各取所需,有关平台选择和区别详见本系列之前的文章。

下图是我个人独立整理的小米生态链部分设备支持列表(中英双语):

支持列表 10.11

表格使用 Google SpreadSheet 编辑,将会不断更新。国内朋友可访问坚果云 获取。。

在此欢迎各位朋友向我提供支持信息或内容纠正,直接在表格内评论即可。

下面我们以传输协议为划分标准,分别介绍小米设备接入智能家居系统的方法:

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

Zigbee 设备(网关类设备)

本部分教程仅适用于『绿米网关局域网通信协议』 1.x 版本的环境,不保证未来『局域网通信协议』升级后的适用性。

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

要将网关接入 HA,我们需要先打开网关的通信协议,并获取通讯密码。

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

HA 0.50.0 及之后版本已经添加对米家平台的官方支持,我们只需要直接配置即可。如果之前有复制 custom_componets 文件夹的同学,升级后请删除该文件夹。 打开 configuration.yaml 文件,添加以下配置:

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

1
2
3
4
5
6
7
8
xiaomi_aqara:
gateways:
- mac: MAC 地址 (地址不带 "-" ":" ,行首的「-」必须保留)
key: 通讯密码

如果你有多个网关,则按以下格式设定:

1
2
3
4
5
6
7
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 中的控制。(Yeelight App 3.0 之前版本中,『局域网控制』为『极客模式』)

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

1
2
3
4
5
6
7
light:
- platform: yeelight
devices:
192.168.1.25: #Yeelight灯具ip
name: Living Room #昵称
transition: 1000
use_music_mode: True #音乐随动模式,默认关闭

WiFi 设备& Token 获取

所有的小米 WiFi 设备都必须先取得设备的 token 方可接入 HA,以下简要介绍获取 token 的方法之一,更多方法请参考 Home Assistant 中文文档

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

1
sudo npm install miio

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

1
miio --discover

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


米家扫地机器人

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

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

1
2
3
4
5
vacuum:
- platform: xiaomi_miio
name: '***' #昵称
host: 192.168.1.2 #ip
token: #token

空气净化器

HA 目前原生支持 2 代空净,暂不支持 Pro 版。

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

1
2
3
4
5
6
fan:
- platform: xiaomi_miio
name: Xiaomi Air Purifier 2
host: 192.168.130.66
token: YOUR_TOKEN

空调伴侣

米家和 Aqara 均发布了自己品牌的空调伴侣,除外观差异外,内核并无不同。小米已于近日固件更新中开放空调伴侣的『局域网通信协议』,空调控制和网关功能请分别使用各自插件接入。另,目前插件仅支持部分空调品牌的部分预设模式,详见插件说明页,未支持的型号请自行抓包空调码。

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

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

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

1
2
3
4
5
6
7
8
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 添加如下设置:

1
2
3
4
5
6
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 添加如下设置:

1
2
3
4
5
6
sensor:
- platform: mi_water_purifier
host: YOUR_SENSOR_IP
token: YOUR_SENSOR_TOKEN
name: YOUT_SENSOR_NAME

接入后自动会生成几项相关的传感器数值,如果需要集中查看,请使用群组:

1
2
3
4
5
6
7
8
9
10
11
12
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 添加如下设置:

1
2
3
4
5
sensor:
- platform: mi_air_quality_monitor
host: YOUR_SENSOR_IP
token: YOUR_SENSOR_TOKEN
name: YOUT_SENSOR_NAME

更新日志

  • 12.04 增加小米净水器、pm 2.5 监测仪,token 获取教程;

  • 11.21 增加空调伴侣网关支持;

  • 11.20 大幅更新,删除所有 Homebridge 有关内容;

  • 10.11 更新空气净化器及支持列表;

  • 09.28 小修正;

cxlwill wechat
欢迎扫码订阅“墨澜工作室”公众号,获取最新文章推送。