All Collections
IoT Projects Tutorials
Control Your Electrical Appliances using SONOFF Dual and Ubidots
Control Your Electrical Appliances using SONOFF Dual and Ubidots

This $9 Wi-Fi relay can control two appliances at the same time. Learn how to connect it to Ubidots and unleash its full potential!

Sergio M avatar
Written by Sergio M
Updated over a week ago

In this guide you will learn how to control a couple of 110V appliances over Wi-Fi for $9, using Itead's SONOFF Dual, which can also measure energy consumption.
Compared with consumer-grade WiFi smart plugs in the market, the SONOFF is a great alternative for making smart home and even industrial IoT projects at a larger scale. Moreover, it is based on the popular ESP8266 Wi-Fi chip, making it compatible with the Arduino environment and other resources like our ESP libraries at Ubidots.


Hardware Setup

Disassemble the SONOFF Dual device, this is to access the SONOFF TTL pinout, which we'll need to program the onboard ESP8266. The SONOFF comes without two of its pin headers, so you will need to solder them before programming the unit.

After soldering, connect the board to the UartSBee following this table:

UartSBee ---> SONOFF Dual
VCC          ---> VCC
TX             ---> RX
RX             ---> TX
GND          ---> GND

UartSBEE Pinout

Also, you will need to make a connection between the GND pin of the pin header in the left (the one that contains Button 1 and 0 pins), and the EN_FW pin of the ESP8266 which is shown below:

SONOFF Pinout (front facing)

SONOFF Pinout (backward face)

Arduino IDE Setup

  • In the Arduino IDE, click on Files -> Preferences and enter this URL into the Additional Boards Manager URLs field, to be able to access ESP8266's libraries for Arduino:

      This field supports multiple URLs. Separate them with commas in case you already have other URLs typed.

  • Open the Boards Manager from Tools -> Board menu and install ESP8266 platform. 

  • After installation, go to the Tools > Board menu and select the board: Generic ESP8266 Module.

  • Download the UbidotsESPMQTT library as a ZIP file in  our GitHub account.

  • Back in your Arduino IDE, click on Sketch -> Include Library -> Add .ZIP Library.

  • Select the .ZIP file of UbidotsESPMQTT and then click on  “Accept” or “Choose”.

  • Close the Arduino IDE and open it again.

Coding your SONOFF Dual

This sample code will subscribe to a Ubidots variable that turns on or off both relays at the same time.

Before running the code, go to your Ubidots account, locate the "Devices" tab and create a Device called "SONOFF Dual" and a variable in it called "Relays". It should look like this:

Make sure the Device API label is "sonoff-dual" and the variable API label is "relays". These are the unique identifiers used by the SONOFF to know to which variable to subscribe in the MQTT broker. You can edit the labels if needed.

You're now ready to flash your device with the following code:

 * Include Libraries
#include "UbidotsESPMQTT.h"

 * Define Constants
#define TOKEN "p4uuxxxxxxxxncTVfoVqxxxxxRQW" // Your Ubidots TOKEN
#define WIFIPASS "clave123456789ubi" // Your Wifi Pass
#define MQTTCLIENTNAME "sonoff15345" // Your MQTT Client Name, it must be unique so we recommend to choose a random ASCCI name


 * Auxiliar Functions

void relays_on() {

void relays_off(){
void callback(char* topic, byte* payload, unsigned int length) {
  Serial.print("Message arrived [");
  Serial.print("] ");
  for (int i=0;i<length;i++) {
  if ((char)payload[0]=='1'){

 * Main Functions

void setup() {
  // put your setup code here, to run once:
  Serial.println("Connecting to WiFi...");
  client.wifiConnection(WIFINAME, WIFIPASS);
  pinMode(16, OUTPUT);
  client.ubidotsSubscribe("sonoff-dual","relays"); // Ubidots device and Variable's API Labels

void loop() {
  // put your main code here, to run repeatedly:
      client.ubidotsSubscribe("sonoff-dual","relays"); //Insert the dataSource and Variable's Labels

You can do more elaborate actions by tinkering with the SONOFF Dual internal commands. Here's a quick reference we found in their forums:



Bytes to be sent to the unit:





where 0xxx seems to be:

  0x00 both off

  0x01 relay one on

  0x02 relay two on
  0x03 both relays on

After flashing your devices, open up the serial monitor of the Arduino IDE, you should see something like this, meaning the WiFi connection and MQTT subscription were successful:


Now go to the "Dashboards" tab and add a new Widget of the type "Control"--> "Switch":

This switch will send a "1" or a "0" to the "Relays" variable, which is then read in the SONOFF's callback function to turn the relays on or off. You can now control your SONOFF Dual remotely from your dashboard!

Did this answer your question?