相信大家通过之前的 安装篇 已经成功安装了 Home Assistant (HASS) 和 Homebridge，在这篇文章中，我将带领大家接入智能家居设备。

大多数人初接触 HASS 的时候经常一头雾水，原因是 HASS 的配置体系十分混乱，一个设备的完美接入需要涉及多个配置文件。实际上，系统架构不清晰也是 HASS 的最大缺点，因此，在开始配置教程前，我先帮助大家捋一捋 HASS 的配置框架。

HASS 配置框架

HASS 的核心配置围绕 configuration.yaml 文件展开, 在这里你可以进行时区、度量单位、开发者模式、主题选择等等基础配置。当然，最为重要的，你将在该文件内完成所有设备的接入。这也是本篇教程的重点。

HASS 的运行依赖于一个个相对独立的功能组件(Components），比如小米米家平台就可以视作一个组件。有些时候，部分设备或者功能仍未得到 HASS 的官方支持，你必须在主目录下新建自定义组件custom_components文件夹，添加相关的设备支持文件。

完成上述的文件修改，加上 HB 的配置，你就可以自如控制所有智能家居设备了。

然而，使用一段时间后，你可能会觉得设备太多显示凌乱，想给界面换个风格，或者configuration.yaml文件看起来要炸了。此时，你会考虑把部分配置剥离出去形成独立的文件，以满足你的强迫症。例如你开启了“设备追踪功能”（Device Tracker），那么 HASS 将在主文件下自动生成 known_devices.yaml文件，你将在这里配置需要追踪的设备。本篇教程也将涉及相关内容。至于主题设置、群组设置等其他非功能性设置，我将在之后的”个性化配置“中详细介绍。

主文件设置

上一篇教程中我们已经打开了树莓派的 SMB 服务，现在我们通过 SMB 打开 HASS 主目录。
（macOS 在 FInder 左侧栏“共享的”接入，Windows 在 计算机-地址栏 里直接输入 //树莓派地址 即可跳转)
打开configuration.yaml，文件默认包含如下内容，我们按需修改：

homeassistant:
  #经纬度
  latitude: 32.87336
  longitude: 117.22743
  #海拔
  elevation: 430
  #度量单位，默认米
  unit_system: metric
  #时区
  time_zone:Asia/Shanghai
  #系统昵称，显示在主界面顶部
  name: Home

正常情况下，剩下的部分便无须变动了。现在添加雅虎天气服务小试牛刀一下吧：

weather:
  - platform: yweather
    woeid:2151849

其中，woeid是城市代码，打开雅虎天气官网输入城市后搜索，url的最后几位数字便是

woeid
woeid

保存，重启 HASS。

恭喜你，接入了第一个 HASS 组件~ 现在你大概明白 HASS 是怎么个操作原理了，HASS 支持上千款智能家居设备，你可以到此寻找你的设备按上述方法接入。

如果你是果家用户，需要 Homekit 服务，那么我们还需要转到 Homebridge 进行相关设置。

Homebridge 设置

执行指令前，请先运行一次 Homebridge。注意：如果添加了开机自启任务，勿重复运行 Homebridge，否则会出现端口占用错误。
Homebridge - homeassistant 插件版本为 2.3.0 以上的，特别注意添加最后一行配置，否则家庭 app 内设备为空。

cd /home/pi/.homebridge
sudo nano config.json
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",     //树莓派 mac 地址
"port": 51826,     //运行端口
"pin": "123-45-678"    //连接密码，自行设定
},
"platforms": [
{
"platform": "HomeAssistant",
"name": "HomeAssistant",
"host": "http://127.0.0.1:8123",     //HA 运行的网址，可以是 ip 也可以是域名
"password": "raspberry",     //HA 的 api_password，及密码，如有设置请添加
"supported_types": ["automation", "binary_sensor", "climate", "cover", "device_tracker", "fan", "group", "input_boolean", "light", "lock", "media_player", "remote", "scene", "sensor", "switch"],
"default_visibility": "visible"    //特别注意此项
}
]
}

ctrl+x，y，回车。之后清除 Homebridge 的缓存：

sudo rm -rf /home/pi/.homebridge/persist/

请大家记住此步指令，今后若出现重新配置 HA、HB 导致 iOS 设备无法识别新设备或树莓派的，大部分情况均可以使用此指令解决。

这样我们就完成了 Homebridge 的设置，重启Homebridge：

sudo systemctl restart homebridge

经过上述设置，我相信你的智能家居设备已经在 HA 和 HB 里稳定运转了，现在不妨尝试使用 Siri 操控你的设备。

鹬蚌相争？

在之前的 安装篇 中我们知道 Homebridge 本身可以通过安装插件的方式将智能设备接入 Apple Home 平台，有的时候设备同时支持 HA 和 Apple Homekit 2 个平台，这时我们就面临平台选择。

首先，这个问题只存在 iOS 以及未来的 macOS 用户身上，因为只有你们可以使用 Siri，才可以痛并快乐着。 对于其他终端系统的用户而言，要么和设备厂家的 app 斗智斗勇，要么享受 HA 网页操控的快感，至于语音控制，就还需等待了。

其次，以米家设备为例，同是网关，HA 可以控制夜灯功能，获取光感数据，Homekit 则不能；而针对扫地机器人，HASS 的接入方法十分复杂，且现阶段只能实现开关功能，HB 的插件安装配置更为容易，且可以控制吸力……可以说两个平台之间没有绝对的胜者，都需要具体情况具体分析。个人认为大多数情况下，HA 对设备的支持更好，并且基于社群支持，跟进速度也更快。

在这里再次提醒初学者：二者必取其一，同一设备请通过一个平台接入，否则未经『自定义设置』将产生冲突。

对于已经将设备通过 HB 接入，但想转入 HA 平台的派友，这里提供如下兼容方案：

  1. 在 HA 接入相关设备，详见上文。
  2. 在 HA 主页面侧边栏，点击下方 “<>”，获取设备的 entity ID：
    States 面板
    States 面板
  3. 在 HA configuration.yaml 配置文件中添加如下设置：
    设备个性化
    设备个性化

    则该设备将在 Homebridge 中被隐藏，重启后不会被 家庭 App 重复识别添加。
    此时，你可以通过 Apple Homekit 和 Hass 平台同时控制该设备。

设备追踪设置

HA 可以追踪同一路由器内网设备联网状态，我们转换一下思路，便可以利用这个系统判断家人是否在家等，非常方便。

家人追踪
家人追踪

我的路由器是 ASUS AC66U-B1，HASS 原生支持大部分品牌的路由器，包括小米路由器、TP-LINK 等。不同的路由器对应配置方法不同，具体请大家前往 官网 查询。设置前需要打开路由器的 SSH 模式，请大家设置好密码等，保护数据安全。建议设置仅限 LAN 用户拥有 SSH 权限。

打开configuration.yaml文件，末尾添加：

device_tracker:
  - platform: asuswrt （按需填写，小米为“xiaomi”，Netgear为“netgear”，TP-LINK为“tplink”）
    host: 192.168.xx.1 #路由器Ip
    username: ***** #管理员账号
    password: ****** #管理员密码
    track_new_devices: no #是否自动添加新设备

不出意外，重启 HASS 后，主文件夹下便会自动生成 known_devices.yaml 文件，打开之后你会发现，系统已经自动为嗅探到的连接到路由器的设备添加了默认配置：

devicename: 
  name: Friendly Name #昵称
  mac: EA:AA:55:E7:C6:94 #mac地址
  picture: https://home-assistant.io/images/favicon-192x192.png #图片icon: mdi:human-female #图标，和图片取一个设置
  track: yes #是否追踪
  hide_if_away: no #离开后是否自动隐藏

在接下来的教程中，我将指导大家如何进行自动化配置，真正实现人工智能，摆脱遥控的束缚、更换主题，展现个性、设置简洁大方的控制面板等等等等

HADashboard
HADashboard

敬请期待~

欢迎继续阅读系列其他文章：

小米设备特别篇：

个性化配置篇：

更新日志

  • 09.28 修改 HB 配置；
  • 08.27 发布『答疑篇』，开放 Q&A，HA 最新版本为 0.52.0；
  • 08.22 配合 homebridge-homeassistant v2.3.0，修改配置；
  • 08.08 关闭评论区；
  • 08.05 更改 config.json 设置路径，增加删除 HB 缓存方法。

作者的话

距离我发布本系列首篇文章至今已经快半年了，系列至今已有 10 篇教程。无独有偶，JailbreakHum在 《少数派季度作者颁奖礼开场发言》所阐述的『内容调整』的观点恰恰与我的初衷十分契合。可以说从一开始，我就在整个系列中尽量保证内容的入门性，也在现实中帮助了很多派友成功搭建系统。

在和派友的互动中我意识到碍于英文水平的局限，很多人无法进一步地享受 Home Assistant 带来的便利。鉴于此，我个人独立制作了一份更接地气的 中文文档 ，目前仍处于雏形阶段，还在快马加鞭中，希望可以帮助到更多的人，欢迎大家阅读+收藏。

良好的体验需要良性的互动维持，为了保持版面的整洁，请大家不要在系列所有文章下方评论区 PO 整段的错误代码。遇到问题请至『维护答疑篇』集中评论。