Hi there! Welcome on board
Setup Guide

I. 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 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, click START to enable the "eWeLink Smart Home" add-on.

 

*Tip: You need to change the home_assistant_url if you are using docker or other versions of Home Assistant that are not Home Assistant OS.

 

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

II. Configuration

Control eWeLink DIY 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.

💡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.

---

Features

• Support Sonoff DIY Mode.
• 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.
• Supports Home Assistant installed through HassOS and Supervisor.

Got more ideas?
Fill in a short Product Survey to submit your feedback >

---

Compatible Devices 

The following list presents what eWeLink Support devices you can configure and control on Home Assistant.

Wi-Fi Smart Switch	Wi-Fi Smart Switch with DIY Mode	ZigBee DIY Smart Switch	Wi-Fi Smart Switch with RF Control
SONOFF BASICR2	SONOFF BASICR3	SONOFF BASICZBR3	SONOFF RFR2

Wi-Fi Smart Switch with DIY Mode & RF Control	Wi-Fi Smart Switch with DIY Mode	ZigBee Smart Switch	Wi-Fi Smart Switch
SONOFF RFR3	SONOFF MINIR2	SONOFF ZBMINI	SONOFF DUALR2

2-Gang Wi-Fi Smart Switch	Wi-Fi Smart Switch with Energy Monitoring	Wi-Fi Smart Switch with Temp. & Hum. Monitoring	4-gang Wi-Fi Smart Switch with RF Control
SONOFF DUALR3	SONOFF POWR2	SONOFF TH10/16	SONOFF 4CHR3/4CHPROR3

 

Zigbee USB Dongle	Wi-Fi Smart Lamp Holder with RF Control	USB Smart Adapter
SONOFF ZigBee CC2531 USB dongle	SONOFF SlampherR2	SONOFF Micro