Restoring Device Settings

Michael Ingraham 2019-09-27 09:39:17 -04:00
parent 13eb5f11f7
commit fa7c072d88
1 changed files with 17 additions and 0 deletions

@ -1,5 +1,9 @@
Easily upgrade Tasmota to a newer version or different build while keeping all your settings.
The first rule of upgrading: _**If it ain't broke, don't fix it!**_ In other words, ensure that there is a good reason to mess with a working installation (e.g., a need to use a new feature or address a found problem fixed in a more current version).
Any time you upgrade it is highly recommended that you make a configuration backup. This is found in the web UI under the `Configuration` menu.
# OTA upgrade
Most convenient way to upgrade. Open a web browser to you device's Web UI and select Firmware Upgrade.
@ -102,3 +106,16 @@ So to migrate from **Sonoff-MQTT-OTA-Arduino versions before 3.1.0** to **Sonoff
2. Migrate to **Sonoff-Tasmota 4.x**
3. Migrate to **Sonoff-Tasmota 5.14**
4. Migrate to **Sonoff-Tasmota 6.x**
# Device Settings
Tasmota uses SPIFFS (SPI Flash File System) memory to store many options and settings. Newer versions of Tasmota add features and use more and more of this area than earlier versions. These regions of flash were therefore not used by Tasmota before. If you did not erase flash when you originally flashed your device, a newer update may be accesssing areas with values left over from the original factory firmware. Therefore there could be unexpected behavior. It is best to address this before upgrading across major versions of Tasmota.
1. Make a configuration backup using one of these two methods:
- Use `decode-config.py` from the Tasmota `tools` code folder to create the backup in human readable form:
`decode-config.py -d <deviceIP> --backup-file Config-@H-@f-@v --backup-type json`
- If you have a `.dmp` backup already, you can create a JSON extract from that file:
`decode-config.py -f <dmpFile> --backup-file Config-@H-@f-@v --backup-type json`
2. Perform a `Reset 6` (erases SPIFFS area but retains Wi-Fi and MQTT settings)
3. Upgrade the firmware
4. Restore configuration
Particularly the older your current Tasmota versions is, it is probably best not to restore the backup directly since there may be some outdated settings in your configuration. There are often newer better alternatives, particularly since an upgrade is normally done to use new features. Configure the device manually refering to the [Commands article](Commands) and the settings (e.g., SetOptions, Rules, etc.) in the JSON file you created in step #1.