Home Assistant
公式eWeLink Smart Homeアドオンを使用して、eWeLinkデバイスをHome Assistantに接続する方法をご案内します。
I. 機能
- 現在、公式アドオンはeWeLinkスイッチおよびソケットに対応しています。より多くのeWeLink対応デバイスが今後のバージョンでサポートされる予定です。
- Sonoff DIYモードに対応しています。
- LAN上のデバイス制御を優先します。デバイスがLANモードに対応していない場合やLAN上にない場合は、クラウド経由でデバイスを制御できます。
- デバイスの状態と設定情報がリアルタイムで同期されます。デバイス名と設定は後から変更可能です。
- HassOSおよびSupervisorを通じてインストールされたHome Assistantのみに対応しています。
II. 前提条件
長期アクセストークンの作成
eWeLinkアドオンは、Home AssistantのREST APIおよびWebSocket APIを呼び出してeWeLink対応デバイスを接続します。長期アクセストークンが必要です。
Home Assistant Lovelaceコンソールにログインします(通常、URLはhttp://homeassistant.local:8123/)。サイドバー最下部のユーザー名をクリックしてUser Profileに移動し、ページ下部のLong-Lived Access Tokenオプションを見つけてCREATE TOKENをクリックします。Give the token a nameモーダルにトークン名を入力し(eWeLink_HA_AddOnを推奨)、OKをクリックします。生成されたトークンをコピーして安全な場所に保存します。



III. インストール
Home Assistant Lovelaceコンソールにログインします(通常、URLはhttp://homeassistant.local:8123/)。サイドバーのSupervisorをクリックしてHassOSダッシュボードを開き、Add-on Storeタブに切り替えます。右上の縦三点をクリックし、ポップアップメニューからRepositoriesを選択します。Manage add-on 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を変更する必要があります。


IV. 設定
eWeLink DIYデバイスの制御
LAN上で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で検出されたLAN上のすべてのDIYデバイスが表示されます。左上のLoginボタンをクリックしてeWeLinkアカウントにログインし、すべてのeWeLink対応デバイスを接続することもできます。
現在、ベータ版はスイッチとソケットのみに対応しており、より多くのデバイスタイプが近日中にサポートされる予定です。


シーンとオートメーションの設定
Home Assistant REST APIおよびWebSocket APIを通じて接続されたデバイスは、デバイスではなくエンティティとしてのみマッピングされるため、Home Assistantのシーンやオートメーションから直接デバイスを制御することはできません。
この問題を解決するには、Advanced Modeを有効にする必要があります(Lovelaceコンソール > Profile > Advanced Mode)。
eWeLink対応デバイスをオートメーションで使用するには、まずデバイスを含むシーンを作成し、オートメーションのAction > Action TypeでActivate Scenarioを選択します。

eWeLink ドキュメント