0.1.3 • Published 1 year ago

@blackstarzes/homebridge-sonoff-basicr3 v0.1.3

Weekly downloads
Last release
1 year ago

Sonoff BasicR3



  1. Install Homebridge on your hub

    For example, Raspberry Pi:

    1. Install Raspberry Pi OS

      • Setup headless (ssh, network)
      • ssh into the Pi and change password, hostname using sudo raspi-config
    2. Install Homebridge

  2. Install the @blackstarzes/homebridge-sonoff-basicr3 plugin in Homebridge

  3. Add the Sonoff BasicR3 platform to the configuration:

      "bridge": {
        "name": "Homebridge"
      "accessories": [],
      "platforms": [
          "platform": "SonoffBasicR3"
  4. Add the Homebridge accessory to HomeKit


Once ssh-ed into the Pi:

# Update
sudo apt-get update -y
sudo apt-get upgrade -y
sudo apt dist-upgrade -y

# Install Node.js
curl -sL https://deb.nodesource.com/setup_12.x | sudo bash -
sudo apt-get install -y nodejs gcc g++ make python
node -v
sudo npm install -g npm

# Install Homebridge
sudo npm install -g --unsafe-perm homebridge homebridge-config-ui-x
sudo hb-service install --user homebridge

# Install mDNS
sudo apt-get install libavahi-compat-libdnssd-dev -y

Prepare your hardware for DIY mode

  1. Download the eWeLink app on iOS or Android, connect and and upgrade to the latest firmware

    This can be quite tricky the first time.

    1. Without the DIY jumper installed, power on the device. The blue LED should flash ..-.
    2. Press and hold the button until the blue LED flashes . continuously.
    3. Open the eWeLink app and add the device (requires adding it to your network - only 2.4GHz).
      • For firmware >=3.5, use quick pairing mode
      • For firmware <3.5, use compatibility mode
    4. Go into the device settings and upgrade to the latest firmware.
  2. Supply mains power to the Sonoff BasicR3's input - the device should power up.

  3. Press and hold the button until the blue LED flashes ..-.

  4. Press and hold the button until the blue LED flashes . continuously.

  5. Connect to the ITEAD-XXX access point (password is 12345678) and navigate to and configure this with your SSID and password.


Install homebridge

  1. Follow the instructions at the GitHub Homebridge repository

    sudo npm install -g --unsafe-perm homebridge
  2. In the root directory of this repository, run:

    npm run watch
  3. Add the hub to your home (preferably in a development home), and develop away

  4. Pull requests are welcome!


1 year ago


1 year ago


1 year ago


1 year ago