instructables

Flashing SONOFF Tasmota Firmware on NodeMCU

by Sarath341

Sonoff is a WiFi controlled switch which is embedded
with ESP8266 IC and has relays to control the device
via the Internet. This IC can be flashed and
reprogrammed by Arduino IDE. The makers of Sonoff
published the libraries and Arduino files on their
GitHub page. Initially, it has only for Sonoff made
boards only, after that it supports many ESP8266
boards and Development boards like NodeMCU. In
this tutorial, we will see how to flash the Sonoff
Tasmota Firmware into the NodeMCU development
boards. In the new updated firmware, you can easily
choose the different ESP8266 Boards easily.

Step 1: Components Needed - Prerequisites

NodeMCU Development Board

microUSB Cable
Sonoff Tasmota Firmware – GitHub Link
Advanced IP Scanner
Arduino IDE

Download the Sonoff Tasmota Firmware from this link.

Make sure you have the ESP8266 Library installed on your Arduino IDE. If you want to know how to install
ESP8266 library properly visit this complete blog of Flashing SONOFF Tasmota Firmware on NodeMCU.

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 1

Step 2: Include Sonoff Libraries to Arduino IDE

Once the SONOFF Tasmota Firmware is downloaded from GitHub. Open the Sonoff Tasmota folder. Navigate to
‘lib’ folder and copy all the contents, then paste it into Arduino ‘libraries’ folder on your computer.

Now we included the necessary library files into Arduino IDE Library. Let's configure our code.

Step 3: Sonoff Main File and User Config

Inside the downloaded file, Open the sonoff.ino file. It will open all the necessary files in next tabs in Arduino IDE.
Now open the userconfig.h tab to enter our Wi-Fi Credentials.

Step 4: Configure SSID, Password and Project Name

Now edit the SSID and Password fields with your WiFi network SSID and Password. Also, give a unique project
name by your choice in #define PROJECT “sonoff” line.

Eg. #define PROJECT “nodefactory”

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 2

Step 5: Choose the Correct NodeMCU Board

Now connect your NodeMCU and choose the correct COM Port and Board Version. Make sure the settings are
like this for NodeMCU 1.0 Board.

Board: NodeMCU 1.0 (ESP12-E Module)

Flash Size: “4M(1M SPIFFS)

CPU Frequency: 80 MHZ

Upload Speed: “115200”

Then Flash the Firmware by clicking Upload.

Step 6: FInd NodeMCU IP Address on Your Network

Once Flashing is done Open Advanced IP Scanner . Note down the IP Address you found and paste it into
And search for the IP address inside your network IP. your browser URL and click enter. It will show the
In my case, My IP will range from 192.168.255.0-255 Sonoff Tasmota page to configure your module.
(Means the IP will be range from 0-255). Click scan
and you can see the project name you given in the
userconfig.h file as device name here.

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 3

Step 7: Configuration for ESP8266 Boards

By default, it will be in Sonoff Basic. So you need to change it to ‘Generic’ in ‘Configuration’ menu. Click
‘Configuration’ and inside that choose ‘Configure Module’.

Step 8: Save the Configuration

Select the board as Generic and Save. The device will restart. This option is for all ESP8266 boards.

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 4

Step 9: New GPIO Options According to the ESP8266 Board Types

Now if you click the configuration, then you can able to see more GPIO options. Using that you can select the
GPIO Functions.

Depending on the GPIO setting the option will appear on the Homepage like DHT, Relay, Switch and Many more.

For more tutorials, visit our blog - Factory Forward Blog

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 5

Great tutorial. Very well written. Thanks for sharing.

Thank You :)

Flashing SONOFF Tasmota Firmware on NodeMCU: Page 6