Overview

The Sonoff device is a cheap $5 ESP8266 wifi enabled switch.

Pinout

Wiki > Sonoff Basic > image2018-2-19_13-26-33.png

GPIO	Description
0	Button
1	Serial Rx and Optional Sensor
3	Serial Rx and Optional Sensor
4	Optional Sensor (no pad, available at esp8266 chip)
12	Relay and Red LED
13	Green LED
14	Optional Sensor

Wiki > Sonoff Basic > image2018-2-19_13-24-17.png

The Arduino project is located in Sonoff-Tasmota/sonoff/sonoff.ino.

> cd Sonoff-Tasmota/lib

> cp -R * ~/Documents/Arduino/libraries/.

Startup the Arduino IDE
Open sonoff.ino
Update parameters in user_config.h. These will be the default values for SSID, etc.

Wiki > Sonoff Basic > image2018-2-19_13-12-49.png

Connect the Sonoff device to a USB port while holding down the button. This will put it in flash mode.

http://HOST/cm?user=USER&password=PASSWORD&cmnd=Power%20TOGGLE

Command	Description	Output
Power%20TOGGLE	Toggle Power	{"POWER":"OFF"} {"POWER":"ON"}
Power%20On	Power On	{"POWER":"ON"}
Power%20Off	Power Off	{"POWER":"OFF"}
Power	Power status	{"POWER":"ON"}
FriendlyName	Display Friendly name	{"FriendlyName1":"Sonoff"}
Status	Display Status	{"Status":{"Module":1,"FriendlyName":"Sonoff","Topic":"sonoff" ,"ButtonTopic":"0","Power":0,"PowerOnState":3,"LedState":1 ,"SaveData":1,"SaveState":1,"ButtonRetain":0,"PowerRetain":0}}

Reference	URL
Sonoff Manufacturer's Page	http://sonoff.itead.cc/en/
Flashing Sonoff using Arduino	https://github.com/arendst/Sonoff-Tasmota/wiki/Arduino-IDE
Sonoff-Tasmota Commands	https://github.com/arendst/Sonoff-Tasmota/wiki/Commands