zigbee连接到智能网关的设备,在网关添加成功之后都会自动添加到HA平台,除此之外还有一些其他设备,比如本文提到的yeelight全系列照明类产品、石头扫地机、直流变频落地扇、红外万能遥控、空气净化器等,不过我只能介绍我有的产品,有些没有的东西就不讨论了,各位大大可以自行研究官方文档及论坛。
yeelight灯具
先讲最简单的,yeelight只需要IP就可以了,其他的所有东西都要花大力气获取token,或者刷入hack固件之类的,所以先讲简单的吧。
官网一样有相关文档
获取IP
在路由器中找到yeelight开头的设备,或者在yeelight app中找到相关设备的IP地址,记录下来备用
添加到HA
在configuration.yaml中加入代码
yeelight: !include yeelight.yaml
在yeelight.yaml中添加
1 | devices: |
devices后面另起一行空两格,输入yeelight灯具的IP地址,后面再另起一行空两格输入名字,就可以了。
保存后重启HA,yeelight灯具就添加成功了。

在ha的web界面中看到,还可以兼容色温、亮度、效果的调整。
具体的控制方式,功能的调用,可以参考官方文档,我在后文也会提到。
token获取
除了网关设备和yeelight灯具以外,大部分设备都需要token来添加到HA,获取token是个比较麻烦的事情,而且每次修改wifi密码,token全部都要重新获取一次,关于token的获取,网络上也有很多办法,我个人比较喜欢通过安卓模拟器和墨澜大神制作的token提取工具。
设置米家app
在常用的手机中设置好米家各个设备的名称,以便后面识别,如果平时就是米家app的重度用户,这一步直接跳过就行了
安装Android模拟器
这个用什么的都可以,我个人推荐网易mumu安卓模拟器,下载安装就行了。
打开后,在windows的“文档”文件夹中找到mumu共享文件夹,把ES模拟器和5.0.19版本以前的米家app的apk拖进去,在模拟器中通过文件管理器就可以找到了。两个都安装好之后,登录米家app,这时候你所有的设备都会加载出来,实际上当你登录的时候所有设备的token也都记录完成。
打开模拟器的root权限
找找看模拟器的设置,打开root权限,然后打开ES模拟器>根目录,然后打开路径data/data/com.xiaomi.smarthome/databases/,复制粘贴 miio2.db 至有权限的文件夹,比如刚才的mumu共享文件夹。
然后将文件导出到电脑,上传至网页http://miio2.yinhh.com/ 直接获取。
扫地机
我用的是初代的石头扫地机器人,吸拖一体的,非常好用,但是米家app里的自动化不能兼容复杂的设定,所以我把扫地机添加到HA中。
同样,上官方文档
获取token及IP
token前面已经讲过了,IP同样也要记录,这里就不再赘述了
添加进HA
1 | vaccum.yaml |
专有指令
除了 HA 中所有扫地机器人所能使用的通用指令 (turn_on, turn_off, start_pause, stop, return_to_home, locate, set_fanspeed 和 send_command)外,小米的扫地机器人另支持一些特殊的远程操控指令,包括: xiaomi_remote_control_start, xiaomi_remote_control_stop, xiaomi_remote_control_move 和 xiaomi_remote_control_move_step。
空调伴侣
以下表格节选自gayhub
空调伴侣还没有官方支持,目前需要添加第三方插件。
| Model ID | Model number | Product name | Shape |
|---|---|---|---|
acpartner.v1 |
KTBL01LM | Aqara Air Conditioning Companion | square |
acaprtner.v2 |
KTBL02LM | Xiaomi Mi Air Conditioner Companion | round |
acpartner.v3 |
KTBL11LM | Aqara Air Conditioning Companion | square |
软件准备
把gayhub中的文件下载到电脑上,然后把custom_components整个文件夹拖到HA的根目录下。
另外同样需要记录IP和token。
添加进HA
和前面一样,用自己的IP和token替换掉
1 | # configuration.yaml |
添加完成后,得益于新的lovelace界面,空调伴侣显示出来效果挺不错

我自己用的这台,型号是KTBL02LM圆形的那款。实测KTBL03LM用不了,就是六七十块的那款方形的。
米家/智米电风扇
我家有两台小米生态的电风扇,一台是比较早买的米家直流变频落地扇,另一台是自带电池的智米2S,很幸运这两台都能接入HA,而且小米的风扇,真的很好看,而且都很轻很小,风力却又很足。
有位叫syssi的大神,把自制的组件发布在gayhub上了。
软件准备
从gayhub上下载文件,将custom_components文件夹拷贝到HA根目录下。
添加到HA
1 | # configuration.yaml |
这个是我亲测可用的,两款风扇都能兼容。

功能还挺多,但是这个界面好像不太友好。
此外还有空气净化器、红外万能遥控、插线板、PM2.5检测仪等设备都可以通过token的方式添加到HA,但是这里我没有需求或者没设备,就不写了,有兴趣的大大们可以参考官方文档。