How to Add Your SONOFF Devices On Home Assistant

by zoe66zheng | May 11, 2021 | Product Review, Tutorial

I.Features

Currently, the official add-on supports SONOFF switches & sockets. More SONOFF devices will be supported in later versions.
Support SONOFF DIY Mode devices.
Priority to control devices on LAN. If the device does not support LAN mode or is not on LAN, you can control the device through the cloud.
Real-time synchronization of device status and configuration information. Device name and configuration can be modified later on.
Only supports Home Assistant installed through HassOS and Supervisor.

II.Precondition

Create Long-Lived Access Tokens

eWeLink Add-On connects eWeLink Support devices by calling Home Assistant’s REST API and WebSocket API. A long-lived access token is required.

Log in to the Home Assistant Lovelace console (usually the URL is http://homeassistant.local:8123/), click the user name at the very bottom of the sidebar to enter User Profile, find the Long-Lived Access Token option at the bottom of the page and click CREATE TOKEN. Enter a token name in the Give the token a name modal box (eWeLink_HA_AddOn is recommended) and click OK. Copy the token you just generated and paste it somewhere secure.

III.Installation

Log in to the Home Assistant Lovelace console (usually the URL is http://homeassistant.local:8123/), click Supervisor at the sidebar to open the HassOS dashboard, switch to the Add-on Store tab. Click the vertical ellipsis (three vertical dots) in the upper right corner, select Repositories in the pop-up menu, enter the official add-on address of eWeLink: https://github.com/CoolKit-Technologies/ha-addon in the Manage add-on repositories modal box, click ADD. After closing the modal box, you can see the newly added eWeLink add-on on the Add-on Store page.

Click the eWeLink Smart Home card to open the add-on information page, click INSTALL and wait for the installation to complete. Once it is done, do not click the START right away, instead, switch to Configuration, fill in the long-lived access token and click Save. Then go back to the Information tab and click START to enable the “eWeLink Smart Home” add-on.

Note: To facilitate quick access to the eWeLink Smart Home add-on, you can enable the Show in sidebar option.

IV.Configuration

Control SONOFF DIY Mode devices on LAN or log in to eWeLink account to control all eWeLink Support devices

Log in to the Home Assistant Lovelace console (usually the URL is http://homeassistant.local:8123/ ), click Supervisor at the sidebar to open the HassOS dashboard, then click the eWeLink Smart Home card to enter the add-on information page. Click OPEN WEB UI, the eWeLink Smart Home Web UI page will list all DIY devices on LAN searched by mDNS. You can also click the Login button in the upper left corner and log in to the eWeLink account to connect all eWeLink Support devices.

Note: Currently, the beta version only supports switches and sockets, more device types will be supported soon.

Setup Scene, Automation to control eWeLink Support devices

Devices connected through Home Assistant REST API and WebSocket API can only be mapped as entities instead of devices, which makes it impossible to directly control devices via Home Assistant’s Scene and Automation.

To solve this problem, you need to enable the Advanced Mode (Lovelace Console > Profile > Advanced Mode).

To use eWeLink Support devices in Automation, you need to first create a Scene that contains your devices, and then select Activate Scenario in Action > Action Type of Automation.