通过本篇教程，你将在 Home Assistant 中接入小米智能家居设备，并在安装配置 Home Bridge 插件后，实现 HomeKit 功能，即在 iOS 家庭 App 中控制这些设备。
智能家居是一个系统化的工程，设备之间的通信就是基础建设。消费级智能家居硬件设备的爆发，使得我们能够轻松的搭建个人智能家居系统，而平台与产品的多样性也带来了多种的通信方式，诸如 Zigbee、蓝牙、WiFi、LAN。
小米生态链企业绿米联创生产的米家智能家庭组合使用的就是网关+子设备的模式，网关通过 WiFi 连入家庭网络，子设备通过 Zigbee 与网关连接。这可能是目前最适入手的智能家居模式了，体积小、功耗低、无需布线、不干扰 WiFi 设备，这也是我选择小米平台的一个主要原因。
小米旗下生态链企业众多，不同的产品也需要不同的连接方式。一般采用 Zigbee 技术的设备需要网关支持，在 Home Assistant 中只需要接入网关，就可以控制网关下的所有设备，而其他独立入网的设备，如米家扫地机器人等，需要单独接入。0.50 之后版本的 Home Assistant 提供的原生组件，支持了部分小米平台的设备。
博主 cxlwill 独立整理了小米生态链设备在 Home Assistant 的支持列表（中英双语），表格使用 Google SpreadSheet 编辑，国内用户请通过 有道云笔记 访问。
一、小米设备接入 Home Assistant
小米多功能网关
小米设备众多，我仅选择官方原生支持接入的作为初级教程内容，PS：第一代小米多功能网关无法接入。
我们需要准备小米多功能网关的 mac 地址和局域网通信协议密码 key。
在米家 App 中打开小米多功能网关，按图示获得相关信息。
▲获取 mac & key
▲获取 mac & key
iOS 与 Android 显示或有不同。
在 configuration.yaml 文件中添加如下代码：
xiaomi:
gateways:
- mac: 你的网关mac，不含冒号
key: 你的局域网通信协议key（注意空格与缩进）
多个网关，格式如下：
xiaomi:
gateways:
- mac: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
- mac: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
重启 Home Assistant 服务后即可识别相关设备。
小米路由器
在 configuration.yaml 文件中添加如下代码：
device_tracker:
- platform: xiaomi
host: 路由器 IP
password: 路由器 密码
Yeelight
Home Assistant 支持 Yeelight 以下型号产品。
- YLDP01YL: LED Bulb (White)
- YLDP02YL: LED Bulb (Color)
- YLDP03YL: LED Bulb (Color) - E26
- YLDD02YL: Lightstrip (Color)
首先你需要 Yeelight App 中打开“极客模式”，在 configuration.yaml 文件中按以下模板添加代码：
如果你在
configuration.yaml中开启了discovery:功能，那么在开启极客模式后，重启 Home Assistant，系统会自动添加相关灯具。
light:
- platform: yeelight
devices:
192.168.1.25: #改为你的 Yeelight 相应IP地址。
name: Living Room
transition: 1000
use_music_mode: True #(音乐随动模式，默认关闭)
save_on_change: False #(记忆设置，默认开启)
192.168.1.13: #多个 Yeelight 接入。
name: Front Door
二、Home Bridge 插件
Home Bridge 是前苹果员工的作品，基于 NodeJS，模拟 iOS HomeKit API。有如其名，作为“桥”来连接 iOS 设备，使得本不支持 HomeKit 的设备能够接入。
在 Hass.io 中安装第三方插件 Home Bridge
- 打开侧边栏 Hass.io，点击进入插件商店
添加插件地址：https://github.com/hassio-addons/addon-homebridge 后保存。（换行后可添加多个地址）
在页面底部找到新的 Home Bridge 插件，进入安装。
配置 Home Bridge 插件
打开 \\HASSIO\config\homebridge\config.json 文件，按以下模板修改：
{
"bridge": {
"name": "Home Assistant",
"pin": "123-45-678", /*随意八位pin码*/
"port": 51826,
"username": "XX:XX:XX:XX:XX:XX" /*你的树莓派mac地址*/
},
"description": "Homebridge for Home Assistant",
"platforms": [
{
"platform": "HomeAssistant",
"name": "HomeAssistant",
"host": "http://192.168.1.11:8123", /*你的 Home Assistant 地址*/
"password": "raspberry", /*你的 Home Assistant 密码*/
"supported_types": ["fan", "binary_sensor", "sensor", "garage_door", "input_boolean", "light", "lock", "media_player", "rollershutter", "scene", "switch"],
"default_visibility": "visible",
"logging": true
},
{/*homebridge-config-ui*/
"platform": "config",
"name": "Config",
"port": 8124,
"log": "/var/log/daemon.log",
"restart": "sudo systemctl restart homebridge.service"
}
]
}
并在 configuration.yaml 添加如下代码：
# 在 Hass.io 侧边栏添加 homebridge-config-ui 的入口
panel_iframe:
homebridge:
title: Homebridge
icon: mdi:home-automation
url: http://192.168.1.11:8124 #你的 Home Assistant IP 地址
重启 Home Assistant，并在 Hass.io 中开启 Home Bridge 插件。
整体而言，除了网络的问题之外，Hass.io 的安装还是很方便的，如果你曾经折腾过 Home Bridge 的话，Hass.io 使你不用费心搭建环境、设置启动、手动调试，一切都在 Hass.io 页面中就可以完成了。
如果你有其他的 Home Bridge 插件需要安装，按以下格式在 Options 内添加。
{ "debug": false, "plugins": [ "homebridge-dummy --registry=https://registry.npm.taobao.org", "homebridge-mysmartlock --registry=https://registry.npm.taobao.org" ] }
三、设置 iOS 设备中的“家庭”App
此节 Android 用户可略过。
有了家庭 App，你就可以轻松安全地掌控各种 HomeKit 配件。比如通过 iPhone 让 Siri 帮你关灯，或者从 iPad 上看看门口是谁。家庭 App 能让你连接的各种设备，更高效、智能地为你工作。
家庭 App 会按照房间将配件分组，让你只需轻点一下，就可轻松控制家中任何角落的装置。你甚至可以对 Siri 说“关掉卧室的灯”或是“打开楼上的空调”。而通过 3D Touch，按住一个图标，就能执行调暗灯光或是调节恒温器之类更复杂的任务。
家庭 App 能让你设置多种场景，从而通过一个指令让多个配件联合工作。比如，你可以创建一个名为“我出门了”的场景，便可关闭灯光，锁好房门，以及调低恒温器的温度。
在家庭 App 中添加 “桥”
Home Assistant 结合 Home Bridge 插件，使得原本不支持 HomeKit 的设备也能够接入 iOS 的家庭 App，Home Bridge 插件启动后，打开家庭 App 进行以下操作：
手动输入 PIN 码，就是在配置文件中任意写入的那个，你就可以通过这个“桥”连接到 Home Assistant 内的设备了。然后按照官方设置教程进行进一步命名设备。
自动化和远程访问 HomeKit 配件
你可以将 iPad 或 Apple TV（第 4 代）设置为家居中枢，以便在 iOS 设备上实现对 HomeKit 配件的自动化和进行远程控制。设为家居中枢的设备必须留在家中、连接到家中 Wi-Fi 网络且处于开机状态。
将 iPad 设置为家居中枢
在“设置”>“iCloud” 中打开“iCloud 钥匙串”和“家庭”，前往“设置”>“家庭”并打开“将此 iPad 用作家庭中枢”
将 Apple TV 设置为家居中枢
在 iOS 设备或 Mac 上，为您的 Apple ID 设置双重认证。然后，前往 iCloud 并确保“iCloud 钥匙串”已开启。在 Apple TV 上，前往“设置”>“帐户”并确保已登录到 iCloud，且使用的 Apple ID 与 iOS 设备上的相同。登录到 iCloud 后，Apple TV 会自动被设置为家居中枢。要检查家居中枢的状态，请前往“设置”>“帐户”>“iCloud”，然后在“HomeKit”下查看家居中枢是否已连接。
四、下节预告
完成设备的接入，智能家居系统开始有点像样了。我想你们肯定还存在很多问题，“我的设备怎么在 Home Assistant 里重新命名？”“如何分组？”“有些设备我不想加入 HomeKit 里。”“我想要更炫酷的界面！”“这不就是个遥控器嘛，我不需要。”诸如此类。下节教程将对 Home Assistant 进行进一步配置，实现个性化布局，同时对 Home Assistant 的自动化（Automations）做入门讲解。
- Home Assistant 进阶设置
- Home Assistant 自动化
