` parameter.
-To restore the previously save backup file `Config_Tasmota_14.1.json` to device `tasmota-4281` use:
+To restore the previously save backup file `Config_Tasmota_14.2.json` to device `tasmota-4281` use:
```bash
-decode-config -c my.conf -s tasmota-4281 --restore-file Config_Tasmota_14.1
+decode-config -c my.conf -s tasmota-4281 --restore-file Config_Tasmota_14.2
```
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:
@@ -393,6 +393,9 @@ Set this location for a device:
decode-config -c my.conf -s tasmota-4281 -i location
```
+> **Note**
+When using JSON subsets on ESP32 chip types, always keep the key `config_version` in the JSON data, otherwise an error will occur stating that the file is for ESP82xx.
+
> **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,`):{
@@ -594,18 +597,17 @@ becomes to
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`
+Filtering by groups affects the entire output, regardless of whether this is the screen or a json backup file. The output of a dmp or bin file cannot be filtered. These binary file types must always contain the entire configuration.
+
+The following groups are available: `Control`, `Display`, `Domoticz`, `Hdmi`, `Internal`, `Knx`, `Light`, `Management`, `Mqtt`, `Power`, `Rf`, `Rules`, `Sensor`, `Serial`, `Setoption`, `Settings`, `Shutter`, `System`, `Telegram`, `Timer`, `Usf`, `Wifi`, `Zigbee`
These are similary to the categories on [Tasmota Command Documentation](https://tasmota.github.io/docs/Commands/).
To filter outputs to a subset of groups, use the `-g` or `--group` parameter, concatenating the groups you want, e. g.
```bash
-decode-config -s tasmota-4281 -c my.conf --output-format cmnd --group Main MQTT Management Wifi
+decode-config -s tasmota-4281 -c my.conf --output-format cmnd --group Control Management MQTT Wifi
```
-
-Filtering by groups affects the entire output, regardless of whether screen output or backup file.
-
## Usage examples
### Using Tasmota binary configuration files
@@ -924,6 +926,7 @@ These Tasmota commands are unsupported and not implemented in **decode-config**
| | LedPwmOff | | |
| | LedState | | |
| | Power | | |
+ | | PowerLock | | |
| | PowerOnState | | |
| | PulseTime | | |
| | SwitchDebounce | | |
@@ -1019,8 +1022,9 @@ These Tasmota commands are unsupported and not implemented in **decode-config**
| | RgxState | | |
| | RgxSubnet | | |
| | Ssid | | |
- | | WebColor | | |
| | WebPassword | | |
+ | | WebCanvas | | |
+ | | WebColor | | |
| | WebRefresh | | |
| | WebSensor | | |
| | WebServer | | |
@@ -1167,7 +1171,7 @@ These Tasmota commands are unsupported and not implemented in **decode-config**
| | SerialConfig | | |
| | SerialDelimiter | | |
| | SSerialConfig | | |
- | | SSerialSend9 | | |
+ | | SSerialMode | | |
| | TCPBaudrate | | |
| | TCPConfig | | |
| **Domoticz** | DomoticzIdx | | |
diff --git a/decode-config.py b/decode-config.py
index e8a2b1a..c5a276a 100755
--- a/decode-config.py
+++ b/decode-config.py
@@ -2,7 +2,7 @@
# -*- coding: utf-8 -*-
from __future__ import print_function
METADATA = {
- 'VERSION': '14.1.0.0',
+ 'VERSION': '14.2.0.0',
'DESCRIPTION': 'Backup/restore and decode configuration tool for Tasmota',
'CLASSIFIER': 'Development Status :: 5 - Production/Stable',
'URL': 'https://github.com/tasmota/decode-config',
@@ -2366,7 +2366,7 @@ def match(self, setting_hardware, config_version):
'B', 0x450, (None, '0 <= $ <= 31', ('Wifi', '"EthAddress {}".format($)')) ),
'eth_address_esp32s3': (HARDWARE.ESP32S3,
'B', 0x45E, (None, '0 <= $ <= 31', ('Wifi', '"EthAddress {}".format($)')) ),
- 'module': (HARDWARE.ESP32 ^ HARDWARE.ESP32S3,
+ 'module_esp32': (HARDWARE.ESP32 ^ HARDWARE.ESP32S3,
'B', 0x474, (None, None, ('Management', '"Module {}".format($+1 & 0xff)')) ),
'module_esp32s3': (HARDWARE.ESP32S3,
'B', 0x45F, (None, None, ('Management', '"Module {}".format($+1 & 0xff)')) ),
@@ -2834,7 +2834,7 @@ def match(self, setting_hardware, config_version):
# ======================================================================
SETTING_13_4_0_4 = copy.copy(SETTING_13_3_0_5)
SETTING_13_4_0_4.update ({
- 'power_lock': (HARDWARE.ESP, '>i & 1) ) for i in range(0, 32))')) ),
+ 'power_lock': (HARDWARE.ESP, '>i & 1) ) for i in range(0, 32))')) ),
})
# ======================================================================
SETTING_14_0_0_2 = copy.copy(SETTING_13_4_0_4)
@@ -2847,10 +2847,28 @@ def match(self, setting_hardware, config_version):
'tcp_baudrate': (HARDWARE.ESP, ' 0 and file_size > 0 and file_type > 0 and file_name:
+ if ARGS.debug:
+ print("{}: on_message - use_base64={}, file_id={}, rcv_id={}, file_type={}, file_size={}, file_md5={}, in_hash_md5={}".format(datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f"), use_base64, file_id, rcv_id, file_type, file_size, file_md5, in_hash_md5.hexdigest()))
+
+ if dobj is None and file_id == 0 and rcv_id > 0 and file_size > 0 and file_type > 0 and file_name:
file_id = rcv_id
dobj = bytearray()
else:
- if use_base64 and file_id > 0 and file_id != rcv_id:
+ if use_base64 and file_id > 0 and file_id != rcv_id and "Id" in rcv_code:
+ err_str = "FileID mismatch ({}!={})".format(file_id, rcv_id)
err_flag = True
return
@@ -4338,6 +4360,7 @@ def on_message(client, userdata, msg):
def wait_for_ack():
nonlocal err_flag
+ nonlocal err_str
timeout = MQTT_TIMEOUT/10
while ack_flag and not err_flag and timeout > 0:
@@ -4404,19 +4427,27 @@ def wait_for_connect():
in_hash_md5 = hashlib.md5()
data = {"Password":tasmota_mqtt_password, "Type":MQTT_FILETYPE}
+ if ARGS.debug:
+ data_dbg = {"Password":HIDDEN_PASSWORD, "Type":MQTT_FILETYPE}
if not use_base64:
data["Binary"] = 1
client.publish(topic_publish, json.dumps(data))
+ if ARGS.debug:
+ print("{}: client.publish({}, {})".format(datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f"), topic_publish, json.dumps(data_dbg)))
ack_flag = True
run_flag = True
while run_flag:
if wait_for_ack(): # We use Ack here
client.publish(topic_publish, "0") # Abort any failed download
+ if ARGS.debug:
+ print('{}: client.publish({}, "0")'.format(datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f"), topic_publish))
run_flag = False
else:
if file_md5 == "": # Request chunk
client.publish(topic_publish, "?")
+ if ARGS.debug:
+ print('{}: client.publish({}, "?")'.format(datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f"), topic_publish))
ack_flag = True
else:
run_flag = False
@@ -4502,8 +4533,6 @@ def on_message(client, userdata, msg):
err_str ="Receive code "+rcv_code
err_flag = True
return
- if "Done" in rcv_code:
- time.sleep(0.1)
if "Command" in root:
rcv_code = root["Command"]
if rcv_code == "Error":
-[](https://github.com/tasmota/decode-config/tree/master)
+[](https://github.com/tasmota/decode-config/tree/master)
[](https://github.com/tasmota/decode-config/releases/latest)
[](https://badge.fury.io/py/decode-config)
@@ -23,8 +23,8 @@ In comparison with the [Tasmota](https://github.com/arendst/Tasmota) build-in "*
* uses a human readable and editable [JSON](http://www.json.org/)-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
+* can convert data from older Tasmota versions (starting with early v5.10.0) to a newer and current one and vice versa
+* is able to create Tasmota command list for the most available configuration data related commands
Comparing backup files created by **decode-config** and [.dmp](#dmp-format) files created by Tasmota "*Backup Configuration*" / "*Restore Configuration*":
@@ -43,7 +43,7 @@ Comparing backup files created by **decode-config** and [.dmp](#dmp-format) file
Using the latest development version of decode-config is only necessary if you also use the latest development version of Tasmota.
-[](https://github.com/tasmota/decode-config/tree/development)
+[](https://github.com/tasmota/decode-config/tree/development)
## Table of contents