⚠ Unfortunately, due to missing time, I will no longer be able to maintain this repository. If you are interested, I encourage you to fork the project and continue development.
A minimal firmware for OTA (over the air) flashing Mongoose OS from Tasmota or compatible firmware types.
This is a first working draft for an intermediate firmware, which can be used to wirelessly restore Mongoose OS on esp8266 based IoT devices initially shipped with a Mongoose OS based firmware. This firmware will install a minimal version of Mongoose OS, and you can continue from there to your favourite target release, such as e.g. the Shelly stock firmware.
Any esp8266 device with a physical flash size of 2 or 4 MB, which was initially shipped with a Mongoose OS based firmware.
⚠ Overwriting a device's boot loader via OTA update is a risky operation. If something unexpected fails, your device may be bricked, unless you know how to flash a new firmware over a wired connection.
⚠ Specifically, you currently should't use this for Shelly PlugS (due to this known issue).
There are two versions with different bootloader configuration locations. The
default location in Mongoose OS is 0x7000, but some devices use 0x1000
instead. Be careful to pick the appropriate version, or the device will be
bricked during the first boot of the target firmware!
For Shelly 1, Shelly 1L, Shelly 1PM, Shelly 2, Shelly 2.5, Shelly Uni, Shelly i3, and Shelly EM use 0x1000, for Shelly Plug S, Shelly RGBW2, Shelly Dimmer 1, Shelly Dimmer 2, Shelly Bulb, Shelly Vintage, Shelly Plug US, Shelly H&T, Shelly Duo, Shelly Plug 2 use 0x7000.
Available versions:
Step 1: Use your current firmware's update mechanism to apply that intermediate firmware as you would for any other update. If the process succeeds, the device will reboot and you will see a new WiFi network labeled mg-????. Be patient, this process can take up to two minutes.
Step 2: Obtain a target firmware file. If you own a Shelly device and want to revert to stock firmware, you can find the matching files here.
Step 3: As soon as you have joined the device's new WiFi network, you can install the desired version of a Mongoose OS based firmware by issuing this command from your computer:
curl -i -F filedata=@./fw.zip http://10.42.42.44/update
Replace ./fw.zip with the path to the target firmware ZIP-file you obtained previously.
If you cannot upload the intermediate firmware to Tasmota due to a not
compatible error, run Setoption78 1 in the Tasmota console to disable
the compatibility check and allow for the update to be applied. See
this github issue.
There is not enough space for Tasmota to save the update file. Switch to tasmota-minimal.bin before trying again.
You can compile a binary version of this firmware using mos tools. Once installed, git clone this repository and
run
mos build --build-var BOOT_CONFIG_ADDR=0x7000 --local
to copy all necessary libraries to deps/.... It does not matter if the initial
build fails, as long as the libraries have been installed. Now patch some files
with those included in this repository:
cp patch/Makefile.build deps/modules/mongoose-os/platforms/esp8266/Makefile.build
cp patch/rboot/rboot.c deps/modules/mongoose-os/platforms/esp8266/rboot/rboot/rboot.c
cp patch/rboot/rboot.h deps/modules/mongoose-os/platforms/esp8266/rboot/rboot/rboot.h
cp patch/core/mos.yml deps/core/mos.yml
and build again with
mos build --build-var BOOT_CONFIG_ADDR=0x7000 --local
for the Mongoose OS bootloader config default location. Alternatively, you may
build using BOOT_CONFIG_ADDR=0x1000.
The generated firmware can be found in build/fw.zip and flashed using the
command mos flash --esp-erase-chip --esp-flash-params 'dout,4m,80m'.
If you want to read it back without it changing anything, pull pin 14 low during boot.
Thanks to rojer for helping me with the debugging of the initial code.
This firmware is build using a fork of Mongoose OS docker action which can be found here.
Copyright (C) 2020, Mark Dornbach
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.