Home Assistant

了解如何使用官方 eWeLink Smart Home 插件将 eWeLink 设备连接到 Home Assistant。

一、功能特点

目前官方插件支持 eWeLink 开关和插座。更多 eWeLink 支持的设备将在后续版本中陆续支持。
支持 Sonoff DIY 模式。
优先通过局域网控制设备。如果设备不支持局域网模式或不在局域网中，可以通过云端控制设备。
实时同步设备状态和配置信息。设备名称和配置可以在后续修改。
仅支持通过 HassOS 和 Supervisor 安装的 Home Assistant。

二、前提条件

创建长期访问令牌

eWeLink 插件通过调用 Home Assistant 的 REST API 和 WebSocket API 来连接 eWeLink 支持的设备，因此需要一个长期访问令牌。

登录 Home Assistant Lovelace 控制台（通常 URL 为 http://homeassistant.local:8123/），点击侧边栏最底部的用户名进入用户资料页面，在页面底部找到「长期访问令牌」选项，点击 创建令牌。在弹出的对话框中输入令牌名称（建议使用 eWeLink_HA_AddOn），然后点击确定。复制生成的令牌并妥善保存。

登录 Home Assistant Lovelace 控制台（通常 URL 为 http://homeassistant.local:8123/），点击侧边栏的 Supervisor 打开 HassOS 控制面板，切换到 Add-on Store 标签页。点击右上角的竖排省略号（三个竖排圆点），在弹出菜单中选择 Repositories，在「管理插件仓库」对话框中输入 eWeLink 的官方插件地址：https://github.com/CoolKit-Technologies/ha-addon，点击 ADD。关闭对话框后，即可在 Add-on Store 页面看到新添加的 eWeLink 插件。

点击 eWeLink Smart Home 卡片打开插件信息页面，点击 INSTALL 等待安装完成。安装完成后，不要立即点击 START，而是切换到 Configuration 标签页，填入长期访问令牌并点击 Save。然后返回 Information 标签页，点击 START 启用「eWeLink Smart Home」插件。

为了方便快速访问 eWeLink Smart Home 插件，可以启用 Show in sidebar（在侧边栏显示）选项。

如果您使用的是 Docker 或其他非 Home Assistant OS 版本的 Home Assistant，需要修改 home_assistant_url。

四、配置

控制 eWeLink DIY 设备

在局域网上控制 eWeLink DIY 设备，或登录 eWeLink 账户以控制所有 eWeLink 支持的设备。

登录 Home Assistant Lovelace 控制台（通常 URL 为 http://homeassistant.local:8123/），点击侧边栏的 Supervisor 打开 HassOS 控制面板，然后点击 eWeLink Smart Home 卡片进入插件信息页面。点击 OPEN WEB UI，eWeLink Smart Home Web UI 页面将列出局域网中通过 mDNS 搜索到的所有 DIY 设备。您也可以点击左上角的 Login 按钮，登录 eWeLink 账户以连接所有 eWeLink 支持的设备。

目前测试版仅支持开关和插座，更多设备类型即将支持。