Sonoff HomeBridge User Guide

Overview

HomeBridge allows your eWeLink connected devices being controlled on the Home app or by Siri on the iOS devices like iPhone, iPad and Apple Watch. After linking the Homekit accessory “sonoff_switch”, you can control your devices by tapping on the accessory on the Home app, or by saying”Hey Siri, turn on bedroom light.”

Specifications:

Model: Sonoff Homebridge
Input: Micro USB 5V/1A DC

About HomeBridge

If your HomeBridge device works normally, you can

    1. Use Home app to control your own eWeLink devices, those shared by others are excluded.
    2. Home app will sync the eWeLink devices’ status.
    3. Use your voice  to turn on or off the eWeLink device. If the eWeLink device is offline or cannot respond due to some reason, Home app will sync the eWeLink device status after 5s.
    4. When eWeLink app notes you there’s new firmware for HomeBridge, please quickly press 3 times on the pairing button of HomeBridge to update the firmware. If updated failed, please repeat the operation.

Notes:

  1. The next time you press and hold the pairing button of HomeBridge for 7s, all the HomeBridge’s recorded data will be cleared, so all devices on Home app will be disappeared and the HomeBridge will enter into pairing status.
  2. Currently, Home app can only add socket/switch devices, and totally 7 gangs are supported. For example, you can control totally seven 1-gang Sonoff S20. Or, you can control one 4-gang Sonoff 4CH and three 1-gang Sonoff Basic.
  3. Home app will not display the eWeLink devices shared by other accounts. That means you can NOT ask Siri to control those devices being shared by other accounts.
  4. Home app will not update the newly added eWeLink devices. So next time you have added any new eWeLink device, you must re-add the HomeBridge device to Home app.
  5. And if you have modified the eWeLink device’s name, to get it appear on Home app, you must re-add the HomeBridge device to Home app.

Getting started

  1. Firstly, you should connect your iPhone or iPad to a WiFi with Internet access.
  2. Secondly, you should set the HomeBridge to pairing mode and add it eWeLink.
  3. Thirdly, you should add the HomeBridge related accessory on Home app.
  4. Once done, you can ask Siri to control your eWeLink device on Home app.

Checklist:

  1. The system version of your iOS devices like iPhone, iPad and Apple Watch should be iOS 8.0 and higher.
  2. Your iPhone/iPad/Apple Watch has connected to 2.4G WiFi with Internet access. And you will use the same WiFi for HomeBridge.
  3. You can download the apple Home app from app store and install on your device.
  4. If you are using a 5G WiFi, please switch to a 2.4G WiFi.
  5. If your wireless router has set MAC filtering, please turn it off.

Add HomeBridge to eWeLink App

  • Search “eWeLink” on app store or Google Play. Register a new account and log in. If you already have one, please log in directly.
  • Allow all the permissions for eWeLink app.
  • Power up HomeBridge with a USB cable. Use a screwdriver or pen to press and hold the pairing button for 7s until the operation led fast blinking.
  • Open eWeLink, tap on “+”.
  • Select HomeBridge, tap NEXT.

  • Enter the correct WiFi password, tap NEXT.
  • When the device is being successfully added, enter the new name for it. Tap Complete. The WiFi status led will light up.

Add HomeBridge’s Accessory to Home App

  • Quickly press twice on the pairing button of HomeBridge. HomeBridge will enter into pairing status.
  • Launch Home app.

  • Tap Add Accessory.

  • Select”Don’t Have a Code or Can’t Scan? ”.

  • Select the “NearbyAccessories”. Wait for a few seconds. If your network is not good, you may need to wait for a few minutes. You’ll see the “sonoff_switch”. Tap on it.

  • Once entering the accessory page, it pops up “Add accessory to network”, tap allow, enter “12345678”.

  • If added failed, but the led shows normal. You can restart from step 1.
  • Once successfully adding the accessory, keep tapping on Next. The app will display the smart devices of your eWeLink account.

  • This is how it looks like. Now you can tap on the accessory or ask Siri to control the devices.

 

Voice Commands

Currently, we only support simple turn on/off the devices. Other commands like dim/brighten the light, change color is only supported by Sonoff B1.

Basic commands:

  • “Hey Siri, turn on/off my *device* “
  • “Hey Siri, shut off my *device*”
  • “Hey Siri, can you make sure all the lights are off?”

If you have specified your lights in different rooms:

  • “Hey Siri, turn on/off my *room* lights”
  • “Hey Siri, turn on/off the lights in *room* “
  • “Hey Siri, can you make sure all the basement lights are off?”

Commands for Sonoff B1(HomeBridge device need latest firmware):

  • “Hey Siri, turn on/off *device name*”
  • “Hey Siri, set/change/make/switch/turn/activate B1 to *color*” (Note: B1 doesn’t support yellow)
  • “Hey Siri, dim/brighten  *device name* by *number* percent”