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 支援的裝置。

目前測試版僅支援開關和插座，更多裝置類型即將支援。