Backup/restore and decode configuration tool for Tasmota

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for curzon01 from gravatar.com curzon01

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: GNU Lesser General Public License v3 (LGPLv3)
  • Author: Norbert Richter
  • Requires: Python >=3.7
Classifiers

Project description

decode-config

Convert, backup and restore configuration data of devices flashed with Tasmota firmware.

Overview

master GitHub download License

If you like decode-config give it a star or fork it and contribute:

GitHub stars GitHub forks donate

In comparison with the Tasmota build-in "Backup Configuration" / "Restore Configuration" function the decode-config tool:

  • uses a human readable and editable JSON-format for backup/restore
  • can restore previously backed up and modified JSON-format files
  • is able to process any subsets of configuration data
  • can convert data from older Tasmota versions (from version v5.10.0) to a newer one and vice versa
  • is able to create Tasmota compatible command list for the most available commands

Comparing backup files created by decode-config and .dmp files created by Tasmota "Backup Configuration" / "Restore Configuration":

Configuration decode-config JSON file Tasmota *.dmp file
encrypted No Yes
readable Yes No
editable Yes No
batch processing Yes No
Backup/Restore subsets Yes No

decode-config is compatible with Tasmota starting from v5.10.0 up to now.

Content

This is the developer branch which contains decode-config matching the latest Tasmota developer version.

This branch does not contain any binaries. If you want to use a precompiled decode-config binary you can use binaries from latest Release.

Note
If you want to run the development decode-config.py from this branch, you need an installed Python environment. See Running as Python script for more details.

Files

File Description
build-executables contains files to build executables
decode-config.py Python source file running under your local Python environment
README.md This content

Table of contents

Running the program

The program does not have a graphical user interface (GUI), you have to run it from your OS command line using program arguments.

Prerequisite

Tasmota WebServer

Tasmota provides its configuration data by http request only. To receive and send configuration data from Tasmota devices directly the http WebServer in Tasmota must be enabled:

  • enable web-server admin mode (Tasmota web command WebServer 2)
  • for self-compiled firmware enable web-server with (#define USE_WEBSERVER and #define WEB_SERVER 2).

Note
Using MQTT for exchanging Tasmota configuration data is supported by Tasmota since v9.4.0.3; decode-config will be able using MQTT in future supporting configuration data exchange this way too.

Python

decode-config.py needs an installed Python environment.

Note
Due to the Python 2.7 EOL in Jan 2020 Python 2.x is no longer supported.

Linux

Install Python 3.x, Pip and follow library installation for all OS below.

sudo apt-get install python3 python3-pip
Windows 10

Install Python 3.x as described and follow library installation for all OS below.

MacOS

Install Python 3.x as described and follow library installation for all OS below.

All OS

After python and pip is installed, install dependencies:

python -m pip install requests configargparse

Usage

For an overview start the program without any parameter and you will get a short help:

decode-config

Note
Replace decode-config by the program name your are using:
decode-config.py when running as Python executable.

This prints a short help:

usage: decode-config.py [-s <filename|host|url>] [-i <restorefile>]
                        [-o <backupfile>] [-t json|bin|dmp] [-E] [-e] [-F]
                        [--json-indent <indent>] [--json-compact]
                        [--json-show-pw] [--cmnd-indent <indent>]
                        [--cmnd-groups] [--cmnd-sort] [--cmnd-use-rule-concat]
                        [--cmnd-use-backlog] [-c <configfile>] [-S]
                        [-T json|cmnd|command]
                        [-g <groupname> [<groupname> ...]] [-w] [--dry-run]
                        [-h] [-H] [-v] [-V]

For advanced help run decode-config with parameter --full--help or -H. This will print a Program parameter list.

Note
If you miss parameters here that are already in use, don't worry, they are still there.
For details see Obsolete parameters

Basics

To get a result, at least pass a Tasmota source where you want to read the configuration from.

Source can be either

  • a device hostname, IP or http-url available and online within your network:
    use --source <host|url> or -s <host|url> parameter
  • a Tasmota configuration file (having extension .dmp):
    use --source <filename> or -s <filename> parameter

The http-url variant also allows <user>, <password> and <port> number to be specified:

  • --source http://admin:myPaszxwo!z@tasmota-4281
  • --source http://tasmota-4281:80
  • --source http://admin:myPaszxwo!z@tasmota-4281:80

Basic example

Access an online device
decode-config --source tasmota-4281
decode-config -s 192.168.10.92
decode-config --source http://tasmota-4281
decode-config --source http://admin:myPaszxwo!z@tasmota-4281
Access a config file
decode-config --source tasmota-4281.dmp
decode-config -s tasmota-4281.dmp

will output a readable configuration in JSON-format, e.g.:

{"altitude": 112, "baudrate": 115200, "blinkcount": 10, "blinktime": 10,...
"ws_width": [1, 3, 5]}

Note
The json names (like "altitude" or "blinktime" are internal names from Tasmotas settings.h STRUCT Settings and are not the same as known from Tasmota web-console commands. However, since most variable names are self-describing, the functional meaning should be given in most cases.

Password protected device

If you try to access data from a device and you get an error like ERROR 401: Error on http GET request for http://.../dl - Unauthorized you need to pass your WebPassword for this device:

decode-config --source tasmota-4281 --password "myPaszxwo!z"

Hint
decode-config username default is admin. For self-compiled binaries using a non-standard web username, use -u <user> or --username <user>.

Format JSON output

The default JSON output can be formatted for better reading using the --json-indent <n> parameter:

decode-config --source tasmota-4281 --password "myPaszxwo!z" --json-indent 2

This will print a pretty better readable format and the example above becomes:

{
  "altitude": 112,
  "baudrate": 115200,
  "blinkcount": 10,
  "blinktime": 10,
  ...
  "ws_width": [
    1,
    3,
    5
  ]
}

Parameter file

Because the number of parameters are growing, it would be difficult to enter all these parameters again and again. In that case it is best to use a configuration file that contains your standard parameters and which we then have to specify as the only additional parameter.
Program parameter starting with -- (eg. --username) can be set into such a configuration file. Simply write each neccessary parameter including possible value without dashes into a text file. For a better identification of this file, extension .conf is recommended:

Writing all the previous used device parameter in a file, create the text file my.conf and insert:

[source]
username = admin
password = myPaszxwo!z

[JSON]
json-indent 2

Hint
Group names enclosed in square brackets [ ], like [source] in the example, are optional and ignored - you can use them to increase readability.

Now we can use it with -c parameter:

decode-config -c my.conf -s tasmota-4281

Note
For further of parameter file syntax see https://pypi.org/project/ConfigArgParse).

If parameters are specified in more than one place (parameter file and command line), the commandline parameters will overrule the file parameters. This is usefull if you use a basic set of parameters and want to change parameter once without the need to edit your configuration file:

decode-config -c my.conf -s tasmota-4281 --json-indent 4

Here JSON will be output with indent of 4 spaces instead of the 2 set from my.conf-

Save backup

To save data from a device or *.dmp file into a backup file, use --backup-file <filename>.

Backup filename macros

You can use the following placeholders within backup/restore filenames:

  • @v is replaced by Tasmota Version
  • @d is replaced by Devicename
  • @f is replaced by first Friendlyname1
  • @h is replaced by the Hostname from configuration data (note: this is the static hostname which is configured by the command Hostname, for real hostname from a device use macro the @H)
  • @H is replaced by the live device hostname note: this can be different to the configured hostname as this can contain also macros). Only valid when using real devices as source

Example:

decode-config -c my.conf -s tasmota-4281 --backup-file Config_@d_@v

This will create a file like Config_Tasmota_10.1.0.json (the part Tasmota and 10.1.0 will choosen related to your device configuration).

Save multiple backup at once

Since decode-config v8.2.0.5 the --backup-file parameter can be specified multiple times. With that it's easy to create different backup with different names and/or different formats at once:

decode-config -c my.conf -s tasmota-4281 -o Config_@d_@v -o Backup_@H.json -o Backup_@H.dmp

creates three backup files:

  • Config_Tasmota_10.1.0.json using JSON format
  • Backup_tasmota-4281.json using JSON format
  • Backup_tasmota-4281.dmp using Tasmota configuration file format

Restore backup

Reading back a previously saved backup file, use the --restore-file <filename> parameter.

To restore the previously save backup file Config_Tasmota_10.1.0.json to device tasmota-4281 use:

decode-config -c my.conf -s tasmota-4281 --restore-file Config_Tasmota_10.1.0

Restore operation also allows placeholders @v, @d, @f, @h or @H like in backup filenames so we can use the same naming as for the backup process:

decode-config -c my.conf -s tasmota-4281 --restore-file Config_@d_@v

Note
Placeholders used in restore filenames only work as long as the underlying data of the device has not changed between backup and restore, since decode-config first read them from the config file or the device to replace it.

Restore subset of data

If you use the default JSON format for backup files you can also use files containing a subset of configuration data only.

Example: You want to change the data for location (altitude, latitude, longitude) only, create a JSON file location.json with the content

{
  "altitude": 0,
  "latitude": 48.85836,
  "longitude": 2.294442
}

Set this location for a device:

decode-config -c my.conf -s tasmota-4281 -i location

Hint
Keep the JSON-format valid e.g. when cutting unnecessary content from a given JSON backup file, consider to remove the last comma on same indent level:
Invalid JSON (useless comma in line 3: ...2.294442,):

{
"latitude": 48.85836,
"longitude": 2.294442,
}
valid JSON:
{
"latitude": 48.85836,
"longitude": 2.294442
}

Using subsets of data JSON files are powerfull possibilitiy to create various personal standard configuration files that are identical for all your Tasmota devices and that you can then reuse for newly configure Tasmotas.

Auto file extensions

File extensions are selected based on the file content and / or the --backup-type parameter. You don't need to add extensions to your file:

  • If you omit the file extensions, one of .dmp, .bin or .json is used depending on the selected backup type
  • If you omit the --backup-type parameter and the selected file name has one of the standard extensions .dmp, .bin or .json, the backup type is set based on the extension.

If you use your own extensions, deactivate the automatic extension using the --no-extension parameter and use the optional --backup-type parameter if neccessary.

Examples:

  • decode-config --source tasmota-4281 --backup-file tasmota-4281.bin
    is identical with
    decode-config --source tasmota-4281 --backup-type bin --backup-file tasmota-4281
    In both cases the backup file tasmota-4281.bin is created.
  • decode-config --source tasmota-4281 --restore-file tasmota-4281.json
    is identical with
    decode-config --source tasmota-4281 --restore-file tasmota-4281
    In both cases the backup file tasmota-4281.json will tried to restore (remember --backup-type json is the default)
  • whereas
    decode-config --source tasmota-4281 --no-extension --restore-file tasmota-4281
    will fail if tasmota-4281 does not exist and
    decode-config --source tasmota-4281 --no-extension --backup-file tasmota-4281
    will create a json backup file named tasmota-4281 (without the extension).

Test your parameter

To test your parameter append --dry-run:

decode-config -s tasmota-4281 -i backupfile --dry-run

This runs the complete process but prevent writing any changes to a device or file.

Console outputs

Output to the console screen is the default when calling the program without any backup or restore parameter.
Screen output is suppressed when using backup or restore parameter. In that case you can force screen output with --output.

The console screen output supports two formats:

JSON format

The default console output format is JSON (optional you can force JSON backup format using --output-format json).

Example:

decode-config -c my.conf -s tasmota-4281 --group Wifi

will output data like

{
  ...
  "hostname": "%s-%04d",
  "ip_address": [
    "0.0.0.0",
    "192.168.12.1",
    "255.255.255.0",
    "192.168.12.1"
  ],
  "ntp_server": [
    "ntp.localnet.home",
    "ntp2.localnet.home",
    "192.168.12.1"
  ],
  "sta_active": 0,
  "sta_config": 5,
  "sta_pwd": [
    "myWlAnPaszxwo!z",
    "myWlAnPaszxwo!z2"
  ],
  "sta_ssid": [
    "wlan.1",
    "my-wlan"
  ],
  "web_password": "myPaszxwo!z",
  "webserver": 2
  ...
}

This also allows direct processing on the command line, e.g. to display all ntp_server only

decode-config -c my.conf -s tasmota-4281 | jq '.ntp_server'

outputs

[
  "ntp.localnet.home",
  "ntp2.localnet.home",
  "192.168.12.1"
]

Hint
JSON output contains all configuration data as default. To filter the JSON output by functional groups, use the -g or --group parameter.

Tasmota web command format

decode-config is able to translate the configuration data to (most all) Tasmota web commands. To output your configuration as Tasmota commands use --output-format command (or the short form -T cmnd).

Example:

decode-config -c my.conf -s tasmota-4281 --group Wifi --output-format cmnd

# Wifi:
  AP 0
  Hostname %s-%04d
  IPAddress1 0.0.0.0
  IPAddress2 192.168.12.1
  IPAddress3 255.255.255.0
  IPAddress4 192.168.12.1
  NtpServer1 ntp.localnet.home
  NtpServer2 ntp2.localnet.home
  NtpServer3 192.168.12.1
  Password1 myWlAnPaszxwo!z
  Password2 myWlAnPaszxwo!z2
  SSId1 wlan.1
  SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

Note
A very few specific commands are unsupported. These are commands from device-specific groups which are very dependent on the Tasmota program code whose implementation is very complex to keep in sync on Tasmota code changes - see also Generated Tasmota commands.

Use of 'Backlog' for Tasmota commands

Because individual Tasmota commands such as SetOption, WebColor etc. are often repeat themselves and might want to be used together, commands of the same name can be summarized using the Tasmota Backlog command. The decode-config parameter --cmnd-use-backlog enables the use of Tasmota Backlog.

With the use of --cmnd-use-backlog our example configuration

# Wifi:
  AP 0
  Hostname %s-%04d
  IPAddress1 0.0.0.0
  IPAddress2 192.168.12.1
  IPAddress3 255.255.255.0
  IPAddress4 192.168.12.1
  NtpServer1 ntp.localnet.home
  NtpServer2 ntp2.localnet.home
  NtpServer3 192.168.12.1
  Password1 myWlAnPaszxwo!z
  Password2 myWlAnPaszxwo!z2
  SSId1 wlan.1
  SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

becomes to

# Wifi:
  AP 0
  Hostname %s-%04d
  Backlog IPAddress1 0.0.0.0;IPAddress2 192.168.12.1;IPAddress3 255.255.255.0;IPAddress4 192.168.12.1
  Backlog NtpServer1 ntp.localnet.home;NtpServer2 ntp2.localnet.home;NtpServer3 192.168.12.1
  Backlog Password1 myWlAnPaszxwo!z;Password2 myWlAnPaszxwo!z2
  Backlog SSId1 wlan.1;SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

--cmnd-use-backlog gets really interesting for SetOptionxx, WebSensorxx, Sensorxx, Memxx, Gpioxx and more...

Filter by groups

The huge number of Tasmota configuration data can be overstrained and confusing, so the most of the configuration data are grouped into categories.

The following groups are available: Control, Display, Domoticz, Internal, Knx, Light, Management, Mqtt, Power, Rf, Rules, Sensor, Serial, Setoption, Shutter, System, Timer, Wifi, Zigbee

These are similary to the categories on Tasmota Command Documentation.

To filter outputs to a subset of groups, use the -g or --group parameter, concatenating the groups you want, e. g.

decode-config -s tasmota-4281 -c my.conf --output-format cmnd --group Main MQTT Management Wifi

Filtering by groups affects the entire output, regardless of whether screen output or backup file.

Usage examples

Using Tasmota binary configuration files

  1. Restore a Tasmota configuration file
decode-config -c my.conf -s tasmota --restore-file Config_Tasmota_6.2.1.dmp

  1. Backup device using Tasmota configuration compatible format

    a) use file extension to choice the file format

decode-config -c my.conf -s tasmota --backup-file Config_@d_@v.dmp

b) use args to choice the file format

  decode-config -c my.conf -s tasmota --backup-type dmp --backup-file Config_@d_@v

Use batch processing

Linux

for device in tasmota1 tasmota2 tasmota3; do ./decode-config -c my.conf -s $device -o Config_@d_@v

under Windows

for device in (tasmota1 tasmota2 tasmota3) do decode-config -c my.conf -s %device -o Config_@d_@v

will produce JSON configuration files for host tasmota1, tasmota2 and tasmota3 using friendly name and Tasmota firmware version for backup filenames.

File Formats

decode-config handles the following three file formats for backup and restore:

.dmp format

This is the original format used by Tasmota (created via the Tasmota web interface "Configuration" / "Backup Configuration" and can be read in with "Configuration" / "Restore Configuration". The format is binary encrypted.

This file format can be created by decode-config using the backup function (--backup-file <filename>) with the additional parameter --backup-type dmp.

.json format

This format uses the JSON notation and contains the complete configuration data in plain text, human readable and editable.

The .json format can be created by decode-config using the backup function (--backup-file <filename>) (for better identification you can append the optional parameter --backup-type json, but that's optional as json is the default backup format).

In contrast to the other two binary formats .dmp and .bin, this type of format also allows the partial modification of configurations.

Note
The keys used within the JSON file are based on the variable names of Tasmota source code in settings.h so they do not have the same naming as known for Tasmota web commands. However, since the variable names are self-explanatory, there should be no difficulties in assigning the functionality of the variables.

.bin format

This format is binary with the same structure as the .dmp format. The differences to .dmp are:

  • .bin is decrypted
  • .bin has 4 additional bytes at the end of the file

The .bin format can be created by decode-config using the backup function (--backup-file <filename>) with the additional parameter --backup-type bin.

This format is actually only used to view the configuration data directly in binary form without conversion.
It is hardly possible to change the binary data, since a checksum is formed over the data and this would have to be calculated and adjusted in case of any change.

Program parameter list

For better reading each short written parameter using a single dash - has a corresponding long version with two dashes --, eg. --source for -s.
Note: Not even all double dash -- parameter has a corresponding single dash one - but each single dash variant has a double dash equivalent.

A short list of possible program args is displayed using -h or --help.

--full-help

For advanced help use parameter -H or --full-help:

usage: decode-config.py [-s <filename|host|url>] [-i <restorefile>]
                        [-o <backupfile>] [-t json|bin|dmp] [-E] [-e] [-F]
                        [--json-indent <indent>] [--json-compact]
                        [--json-show-pw] [--cmnd-indent <indent>]
                        [--cmnd-groups] [--cmnd-sort] [--cmnd-use-rule-concat]
                        [--cmnd-use-backlog] [-c <configfile>] [-S]
                        [-T json|cmnd|command]
                        [-g <groupname> [<groupname> ...]] [-w] [--dry-run]
                        [-h] [-H] [-v] [-V]

Backup/Restore Tasmota configuration data. Args that start with '--' (eg. -s)
can also be set in a config file (specified via -c). Config file syntax
allows: key=value, flag=true, stuff=[a,b,c] (for details, see syntax at
https://goo.gl/R74nmi). If an arg is specified in more than one place, then
commandline values override config file values which override defaults.

Source:
  Read/Write Tasmota configuration from/to

  -s, --source <filename|host|url>
                        source used for the Tasmota configuration (default:
                        None). The argument can be a <filename> containing
                        Tasmota .dmp configuation data or a <hostname>,
                        <ip>-address, <url> which means an online tasmota
                        device is used. A url can also contain web login and
                        port data in the format
                        http://<user>:<password>@tasmota:<port>, e. g,
                        http://admin:mypw@mytasmota:8090

Backup/Restore:
  Backup & restore specification

  -i, --restore-file <restorefile>
                        file to restore configuration from (default: None).
                        Replacements: @v=firmware version from config,
                        @d=devicename, @f=friendlyname1, @h=hostname from
                        config, @H=device hostname (invalid if using a file as
                        source)
  -o, --backup-file <backupfile>
                        file to backup configuration to, can be specified
                        multiple times (default: None). Replacements:
                        @v=firmware version from config, @d=devicename,
                        @f=friendlyname1, @h=hostname from config, @H=device
                        hostname (invalid if using a file as source)
  -t, --backup-type json|bin|dmp
                        backup filetype (default: 'json')
  -E, --extension       append filetype extension for -i and -o filename
                        (default)
  -e, --no-extension    do not append filetype extension, use -i and -o
                        filename as passed
  -F, --force-restore   force restore even configuration is identical

JSON output:
  JSON format specification. To revert an option, insert "dont" or "no"
  after "json", e.g. --json-no-indent, --json-dont-show-pw

  --json-indent <indent>
                        pretty-printed JSON output using indent level
                        (default: 'None'). -1 disables indent.
  --json-compact        compact JSON output by eliminate whitespace
  --json-show-pw        unhide passwords (default)

Tasmota command output:
  Tasmota command output format specification. To revert an option, insert
  "dont" or "no" after "cmnd", e.g. --cmnd-no-indent, --cmnd-dont-sort

  --cmnd-indent <indent>
                        Tasmota command grouping indent level (default: '2').
                        0 disables indent
  --cmnd-groups         group Tasmota commands (default)
  --cmnd-sort           sort Tasmota commands (default)
  --cmnd-use-rule-concat
                        use rule concatenation with + for Tasmota 'Rule'
                        command
  --cmnd-use-backlog    use 'Backlog' for Tasmota commands as much as possible

Common:
  Optional arguments

  -c, --config <configfile>
                        program config file - can be used to set default
                        command parameters (default: None)
  -S, --output          display output regardsless of backup/restore usage
                        (default do not output on backup or restore usage)
  -T, --output-format json|cmnd|command
                        display output format (default: 'json')
  -g, --group <groupname>
                        limit data processing to command groups (default no
                        filter)
  -w, --ignore-warnings
                        do not exit on warnings. Not recommended, used by your
                        own responsibility!
  --dry-run             test program without changing configuration data on
                        device or file

Info:
  Extra information

  -h, --help            show usage help message and exit
  -H, --full-help       show full help message and exit
  -v, --verbose         produce more output about what the program does
  -V, --version         show program's version number and exit

The arguments -s <filename|host|url> must be given.

Note
If you miss parameters here that are already in use, don't worry, they are still there.
For details see Obsolete parameters

Parameter notes

  • Filename replacement macros @h and @H:
    • @h The @h replacement macro uses the hostname configured with the Tasomta Wifi Hostname <host> command (defaults to %s-%04d). It will not use the network hostname of your device because this is not available when working with files only (e.g. --source <filename> as source). To prevent having a useless % in your filename, @h will not replaced by hostname if this contains '%' characters.
    • @H If you want to use the network hostname within your filename, use the @H replacement macro instead - but be aware this will only replaced if you are using a network device as source (<hostname>, <ip>, <url>); it will not work when using a file as source (<filename>)

Obsolete parameters

The parameters listed here continue to work and are supported, but are no longer listed in the parameter list:

Obsolete source parameters

The following source selection parameters are completely replaced by a single used -s or --source parameter; use -s or --source with a http-url:

  • -f, --file, --tasmota-file, tasmotafile <filename>
    file used for the Tasmota configuration (default: None)'
  • -d, --device, --host <host|url>
    hostname, IP-address or url used for the Tasmota configuration (default: None)
  • -P, --port <port>
    TCP/IP port number to use for the host connection (default: 80)
  • -u, --username <username>
    host HTTP access username (default: admin)
  • -p, --password <password>
    host HTTP access password (default: None)

Obsolete JSON formating parameters

  • --json-unhide-pw same as --json-show-pw
  • --json-hide-pw same as --json-dont-show-pw
  • --json-sort sorts JSON output (this is the default)
  • --json-unsort prevents JSON sorting

Generated Tasmota commands

The following table shows the Tasmota command generated by decode-config:

  • Supported
    These commands will be generated using parameter --output-format cmnd.
  • Ad hoc
    These Tasmota commands are used for immediate action and do not change settings - so these cannot be created.
  • Unsupported
    These Tasmota commands are unsupported and not implemented in decode-config
Group Supported Ad hoc Unsupported
Control BlinkCount Backlog
BlinkTime Buzzer
ButtonDebounce FanSpeed
DevGroupName LedPower
DevGroupShare
DevGroupTie
Interlock
LedMask
LedPwmMode<x>
LedPwmOn
LedPwmOff
LedState
Power<x>
PowerOnState
PulseTime<x>
SwitchDebounce
SwitchMode<x>
Webbutton<x>
WCStream2
WCMirror2
WCFlip2
WCRtsp2
WCBrightness2
WCContrast2
WCSaturation2
WCResolution2
Management DeepSleepTime Delay
DeviceName Gpios
Emulation I2Cscan
FriendlyName<x> Modules
Gpio<x> Reset
I2CDriver<x> Restart
Ifx State
IfxBucket Status
IfxHost Upgrade
IfxPassword Upload
IfxPort SSPMLog2
IfxUser SSPEnergy2
IfxPeriod SSPHistory2
L1MusicSync SSPScan2
LogHost SSPIamHere2
LogPort
Module
Module2
MqttLog
NtpServer<x>
OtaUrl
Pwm<x>
PwmFrequency
PwmRange
SaveData
SerialLog
Sleep
SSPMDisplay2
SysLog
Template
Time
TimeSTD
TimeDST
Timezone
TuyaMCU
TuyaTempSetRes
WebLog
WiFi CORS AP
Ethernet2 Ping<x>
EthAddress2 WebSend
EthClockMode2 Publish
EthType2 Publish2
Hostname
IPAddress<x>
Password<x>
RgxAddress
RgxNAPT
RgxPassword
RgxSsid
RgxState
RgxSubnet
Ssid<x>
WebColor<x>
WebPassword
WebRefresh
WebSensor<x>
WebServer
Wifi
WifiConfig
WifiPower
MQTT ButtonRetain Subscribe
ButtonTopic Unsubscribe
FullTopic
GroupTopic<x>
InfoRetain
MqttClient
MqttFingerprint
MqttHost
MqttKeepAlive
MqttPassword
MqttPort
MqttRetry
MqttUser
MqttTimeout
MqttWifiTimeout
PowerRetain
Prefix<x>
SensorRetain
StateRetain
StateText<x>
SwitchRetain
SwitchTopic
TelePeriod
Topic
Rules CalcRes Add<x>
Mem<x> Event
Rule<x> Mult<x>
Script RuleTimer<x>
Scale<x>
Sub<x>
Var<x>
Telegram TmState
Timer Latitude
Longitude
Timers
Timer<x>
Sensor Altitude Bh1750MTime<x> AdcParam
AmpRes GlobalHum
AS3935AutoNF GlobalTemp
AS3935AutoDisturber Sensor27
AS3935AutoNFMax Sensor50
AS3935MQTTEvent Sensor52
AS3935NFTime Sensor53
AS3935NoIrqEvent Sensor601
AS3935DistTime
AS3935SetMinStage
Bh1750Resolution<x>
Counter<x>
CounterDebounce
CounterDebounceLow
CounterDebounceHigh
CounterType<x>
HumOffset
HumRes
PressRes
OT_Flags
OT_Save_Setpoints
OT_TBoiler
OT_TWater
Sensor13
Sensor15
Sensor18
Sensor20
Sensor29
Sensor34
Sensor54
Sensor68
Shift595DeviceCount
SpeedUnit
TempRes
TempOffset
VoltRes
WattRes
WeightRes
Power AmpRes CurrentSet
CurrentCal FrequencySet EnergyReset
CurrentHigh ModuleAddress
CurrentLow PowerSet
EnergyRes Status8
EnergyToday Status9
EnergyTotal VoltageSet
EnergyYesterday
FreqRes
MaxPower
MaxPowerHold
MaxPowerWindow
PowerCal
PowerDelta
PowerHigh
PowerLow
Tariff<x>
VoltageCal
VoltageHigh
VoltageLow
VoltRes
WattRes
Light DimmerRange Channel<x> Color<x>
DimmerStep CT Dimmer
Fade CTRange
LedTable HsbColor
Pixels Led<x>
PWMDimmerPWMs Palette
RGBWWTable White
Rotation VirtualCT
Scheme
ShdLeadingEdge
ShdWarmupBrightness
ShdWarmupTime
Speed
StepPixels
Wakeup
WakeupDuration
RF RfProtocol RfRaw RfCode
RfHigh
RfHost
RfKey<x>
RfLow
RfSync
IR IRsend<x>
IRhvac
SetOption SetOption<x>
Serial Baudrate SerialSend<x>
SBaudrate SSerialSend<x>
SerialConfig TCPStart
SerialDelimiter TuyaSend<x>
TCPBaudrate
TCPConfig
Domoticz DomoticzIdx<x>
DomoticzKeyIdx<x>
DomoticzSensorIdx<x>
DomoticzSwitchIdx<x>
DomoticzUpdateTimer
KNX KNX_ENABLED KnxTx_Cmnd<x> KNX_PA
KNX_ENHANCED KnxTx_Val<x> KNX_GA<x>
KNX_CB<x>
Display DisplayAddress Display
DisplayDimmer DisplayText
DisplayILIMode
DisplayInvert
DisplayMode
DisplayModel
DisplayRefresh
DisplaySize
DisplayType
DisplayRotate
DisplayCols
DisplayRows
DisplayFont
DisplayWidth
DisplayHeight
Shutter ShutterButton<x> ShutterClose<x>
ShutterCalibration<x> ShutterFrequency<x>
ShutterCloseDuration<x> ShutterOpen<x>
ShutterEnableEndStopTime<x> ShutterSetClose<x>
ShutterInvert<x> ShutterStop<x>
ShutterInvertWebButtons<x> ShutterStopClose<x>
ShutterLock<x> ShutterStopOpen<x>
ShutterMode<x> ShutterStopPosition<x>
ShutterMotorDelay<x> ShutterStopToggle<x>
ShutterOpenDuration<x> ShutterStopToggleDir<x>
ShutterPosition<x> ShutterToggle<x>
ShutterPWMRange<x> ShutterToggleDir<x>
ShutterRelay<x>
ShutterSetHalfway<x>
ShutterTiltConfig<x>
Telegram TmChatId TmPoll
TmState TmSend
TmToken
Zigbee ZbConfig ZbBind
ZbForget
ZbLight
ZbName
ZbPermitJoin
ZbPing
ZbSend
ZbStatus<x>
ZbUnbind
Bluetooth - all -
Stepper Motors - all -
MP3 Player - all -

Notes
1 Sensor60 13 sets the latitude/longitude, use Latitude and Logitude command instead.
2 ESP32 only

Program return codes

decode-config returns the following codes:

  • 0 - successful:
    The process has successful finished

  • 1 = restore skipped:
    Unchanged data, restore not executed

  • 2 = program argument error:
    Wrong program parameter used (data source missing)

  • 3 = file not found

  • 4 = data size mismatch:
    The data size read from source does not match the excpected size

  • 5 = data CRC error:
    The read data contains wrong CRC

  • 6 = unsupported configuration version:
    The source data contains data from an unsupported (Sonoff-)Tasmota version

  • 7 = configuration file read error:
    There was an error during read of configuration source file

  • 8 = JSON file decoding error:
    There was an error within the read JSON file

  • 9 = restore file data error:
    Error occured by writing new binary data

  • 10 = device data download error:
    Source device connected but configuration data could not be downloaded (WebServer missing, disabled)

  • 11 = device data upload error:
    Source device connected but configuration data could not be uploaded (WebServer missing, disabled, connection lost...)

  • 12 = invalid configuration data:
    The configuration data source contains invalid basic data (wrong platform id...)

  • 20 = python module missing:
    A neccessary python library module is missing

  • 21 = internal error:
    An unexpected internal error occured

  • 22 = HTTP connection error:
    Source device HTTP connection lost or unavailable

  • 23... = python library exit code:
    An unexpected internal library error occured

  • 4xx/5xx = HTTP errors

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for curzon01 from gravatar.com curzon01

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: GNU Lesser General Public License v3 (LGPLv3)
  • Author: Norbert Richter
  • Requires: Python >=3.7
Classifiers

Release history Release notifications | RSS feed

2022.1 yanked

Reason this release was yanked:

no official release

14.3.0.0

14.2.0.0

14.1.0.0

14.0.0.0

13.4.0.0

13.3.0.0

13.2.0.0

13.1.0.4

13.1.0.2

13.1.0.0

13.0.0.0

12.5.0.0

12.4.0.0

12.3.1.0

12.3.0.0

12.2.0.0

12.1.1.0

12.1.0.0

12.0.2.0

11.1.0.0

11.0.0.1

11.0

This version

10.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

decode-config-10.1.0.tar.gz (100.5 kB view hashes)

Uploaded Source

Built Distribution

decode_config-10.1.0-py3-none-any.whl (75.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page