Repository files navigation

A minimal firmware for OTA (over the air) flashing various target firmwaresstarting from Mongoose OS.

This is an intermediate firmware that can be used to installTasmota,Home Accessory Architect, orESPurnaon various Shelly models. It will install the latest stable release of thetarget firmware.

⚠ This application should generally be safe to use for all supporteddevices. Still, overwriting a device's boot loader via OTA update is a riskyoperation. If something unexpected fails, your device may be bricked, unless youknow how to flash a new firmware over a wired connection.

ℹ You can go back to Mongoose OS via OTA as well, usingthis firmware,but be aware that if something fails, your device may be bricked, if you don'tknow how to flash a new firmware over a wired connection.

Instead of flashing the device manually (see below), you may try the new automagicflashing script. The script requires Python 3 to be installed on your computer. After downloading the script, runpython3 flash-shelly.py -a from the download location. All Shelly devices with stock firmware, which are connected to the same WIFI network, will be found. For each device that is found, you will be asked if you like to convert it.

Usepython3 flash-shelly.py -a -t haa orpython3 flash-shelly.py -a -t espurna to install alternate targets.

⚠ The script is still in an early testing stage, and I would appreciate your feedback. If you want to give feedback, please open an issue.

Before flashing this firmware, connect your device to a WIFI network withinternet access. From your browser, open the update URL for your device from thetable below. Replaceshellyip with the IP address of your Shelly. The devicewill restart one or two times and attempt to download the traget firmware. Ifthis download succeeds, the device will restart again, and you will see a newWIFI network labeledtasmota-????,HAA-????, orESPURNA-????.This process should take no longer than 4 - 5 minutes, depending on your networkconnection.

If you replacemg2tasmota bymg2haa in the update URLs, your device willinstall the Home Accessory Architect firmware instead of Tasmota. Formg2espurna instead ofmg2tasmota, ESPurna Firmware will be installed.

There is avideo tutorial on how to flash thisfirmware. Thank you,digiblur!

If the download fails, or your internet connection is disrupted, simply turn thedevice off and on again, the intermediate firmware will retry until it succeeds.

In the unlikely event that the WIFI credentials are wrong, the device will tryto connect to a backup WIFI with SSIDmgos-recover and passwordRJoPuKC3u5,which you can use for recovery.

For your convenience, the table above also lists the matching Tasmota devicetemplates fromtemplates.blakadder.com whichyou can use to configure Tasmota after installation.

Home Accessory Architect will boot in setup mode, which is explained in theHAA Wiki.

For ESPurna, the device will boot into the ESPurna base image. You can theneither switch to a devices specific version, if your device is supported, orstart configurationfrom the base image.

If device fails to convert, especially the RGBW2, please update to the lateststock firmware and try again.

If your device is not listed, please open a new issue so we can try to make itwork. Please mention which of the manyShelly firmware filesis the right one for your device.

You can compile a binary version of this firmware usingmos tools. Once installed, clone this repository and runmos build --build-var MODEL=Shelly1 --build-var TARGETFW=tasmota --platform esp8266to create a binary for e.g. a Shelly1 switch located inbuild/fw.zip.

Thanks torojer for helping me with the debugging ofthe initial code.

This firmware is build using a fork ofMongoose OS docker actionwhich can be foundhere.

The flash-script is a modified version frommongoose-os-apps/shelly-homekit,originally written byandyblac androjer.

Copyright (C) 2020, Mark Dornbach

This program is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe 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 ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.

You should have received a copy of the GNU General Public Licensealong with this program. If not, seehttps://www.gnu.org/licenses/.