Alternative firmware for the ITEAD Sonoff Wi-Fi Remote Control Smart Switch
This firmware is based on Mongoose OS and includes an embedded web server with an HTTP API and web page for toggling the switch off and on.
- REMOVE POWER SOURCE FROM THE DEVICE! Do not attempt to open the device or flash the firmware while it is connected to a power source.
- Open the device and remove the PCB from inside
- Solder a 5x1 (5 GPIO model) or 4x1 (4 GPIO model) pin header to the device's GPIO.
- Connect a 3.3V FTDI module to the pin header using the following table and image for the pin mapping. Do not use a 5V FTDI as this could damage the ESP8266 on the device!
Note: it is also possible to connect the FTDI to the GPIO with carefully positioned jumper cables if you prefer not to solder the pin header. Just insert the jumper cables into the GPIO holes at an angle to ensure they maintain contact with the copper.
| Position (from power button) | Sonoff | FTDI |
|---|---|---|
| 1 | 3.3V | VCC |
| 2 | RX | TX |
| 3 | TX | RX |
| 4 | GND | GND |
| 5 | GPIO 14 |
- Download and install the
mostoolchain from https://mongoose-os.com/software.html - Build the firmware with
mos build - Disconnect the FTDI so the device is off and reconnect while holding down the power button to boot into flash mode
- Flash the firmware onto the device with
mos flash - Configure Wi-Fi settings with
mos wifi <ssid> <password>where<ssid>is the network SSID and<password>is the Wi-Fi password - Reboot the device to take it out of flash mode
Check your router for connected clients to obtain the LAN IP address of the Sonoff device which should be connected to your Wi-Fi network. Open a web browser and navigate to http://<address>/index.html - you will see a web page with a toggle switch that allows you to toggle the device off and on!
The firmware supports the following HTTP methods to retrieve and set the device state:
Retrieve the device state. Returns 200 OK on success with the response body containing either 0 for off or 1 for
on.
Curl example: curl http://<address>/sonoff
Set the device state. The raw request body should contain either 0 for off or 1 for on. Returns 200 OK on success.
Curl example: curl -X POST -H "Content-Type: text/plain" -d <power> http://<address>/sonoff