-
-# Tasmota I2C devices
+# I2C devices
Tasmota supports several I2C devices but to use them they mostly need to be enabled at compile time to solve possible address conflicts.
diff --git a/README.md b/README.md
index 30d8cd851..2cd0e172a 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ In addition to the [release webpage](https://github.com/arendst/Tasmota/releases
[](http://thehackbox.org/tasmota/)
[](https://travis-ci.org/arendst/Tasmota)
-See [tasmota/_changelog.ino](tasmota/_changelog.ino) for detailed change information.
+See [tasmota/CHANGELOG.md](tasmota/CHANGELOG.md) for detailed change information.
Unless your Tasmota powered device exhibits a problem or you need to make use of a feature that is not available in the Tasmota version currently installed on your device, leave your device alone - it works so don't make unnecessary changes! If the release version (i.e., the master branch) exhibits unexpected behaviour for your device and configuration, you should upgrade to the latest development version instead to see if your problem is resolved as some bugs in previous releases or development builds may already have been resolved.
@@ -42,10 +42,10 @@ We don't take any responsibility nor liability for using this software nor for t
## Note
-Please do not ask to add new devices unless it requires additional code for new features. If the device is not listed as a module, try using [Templates](https://github.com/arendst/Tasmota/wiki/Templates) first. If it is not listed in the [Tasmota Device Templates Repository](http://blakadder.github.io/templates) create your own [Template](https://github.com/arendst/Tasmota/wiki/Templates#creating-your-template-).
+Please do not ask to add new devices unless it requires additional code for new features. If the device is not listed as a module, try using [Templates](https://tasmota.github.io/docs/#/Templates) first. If it is not listed in the [Tasmota Device Templates Repository](http://blakadder.github.io/templates) create your own [Template](https://tasmota.github.io/docs/#/Templates?id=creating-your-template).
## Quick Install
-Download one of the released binaries from https://github.com/arendst/Tasmota/releases and flash it to your hardware as [documented in the wiki](https://github.com/arendst/Tasmota/wiki/Flashing).
+Download one of the released binaries from https://github.com/arendst/Tasmota/releases and flash it to your hardware [using our installation guide](https://tasmota.github.io/docs/#/installation/).
## Important User Compilation Information
If you want to compile Tasmota yourself keep in mind the following:
@@ -56,11 +56,11 @@ If you want to compile Tasmota yourself keep in mind the following:
## Configuration Information
-Please refer to the installation and configuration articles in the [wiki](https://github.com/arendst/Tasmota/wiki).
+Please refer to the installation and configuration articles in our [documentation](https://tasmota.github.io/docs).
## Migration Information
-See [wiki migration path](https://github.com/arendst/Tasmota/wiki/Upgrading#migration-path) for instructions how to migrate to a major version. Pay attention to the following version breaks due to dynamic settings updates:
+See [wiki migration path](https://tasmota.github.io/docs/#/Upgrading?id=migration-path) for instructions how to migrate to a major version. Pay attention to the following version breaks due to dynamic settings updates:
1. Migrate to **Sonoff-Tasmota 3.9.x**
2. Migrate to **Sonoff-Tasmota 4.x**
@@ -74,8 +74,8 @@ See [wiki migration path](https://github.com/arendst/Tasmota/wiki/Upgrading#migr
For a database of supported devices see [Tasmota Device Templates Repository](https://blakadder.github.io/templates)
-See [Wiki](https://github.com/arendst/Tasmota/wiki) for use instructions and how-to's.
+
# Support
@@ -6,10 +6,9 @@ If you're looking for support on **Tasmota** there are some options available:
## Documentation:
-* [Wiki Pages](https://github.com/arendst/Tasmota/wiki): For information on how to Flash Tasmota, configure and use it.
-* [FAQ](https://github.com/arendst/Tasmota/wiki/FAQ): For information on common problems and solutions.
-* [Troubleshooting Information](https://github.com/arendst/Tasmota/wiki/Troubleshooting): For ways to debug and troubleshoot.
-* [Commands Information](https://github.com/arendst/Tasmota/wiki/Commands): For information on all the commands supported by Tasmota.
+* [Documentation Site](https://tasmota.github.io/docs): For information on how to flash Tasmota, configure, use and expand it
+* [FAQ and Troubleshooting](https://tasmota.github.io/docs/#/faq/): For information on common problems and solutions.
+* [Commands Information](https://tasmota.github.io/docs/#/Commands): For information on all the commands supported by Tasmota.
## Support's Community:
diff --git a/tasmota/CHANGELOG.md b/tasmota/CHANGELOG.md
new file mode 100644
index 000000000..2c7e2578a
--- /dev/null
+++ b/tasmota/CHANGELOG.md
@@ -0,0 +1,1988 @@
+
+## Unreleased (development)
+
+### 7.0.0.6 20191122
+ * Add colorpicker to WebUI by Christian Staars (#6984)
+
+### 7.0.0.5 20191118
+ * Fix boot loop regression
+ * Add command TempOffset -12.6 .. 12.6 to set global temperature sensor offset (#6958)
+ * Fix check deepsleep for valid values in Settings (#6961)
+ * Fix Wifi instability when light is on, due to sleep=0 (#6961, #6608)
+ * Add hardware detection to be overruled with SetOption51 (#6969)
+
+### 7.0.0.4 20191108
+ * Add command WifiPower 0 .. 20.5 to set Wifi Output Power which will be default set to 17dBm
+ * Change supported PCF8574 I2C address range to 0x20 - 0x26 allowing other I2C devices with address 0x27 to be used at the same time
+ * Change supported PCF8574A I2C address range to 0x39 - 0x3F allowing other I2C devices with address 0x38 to be used at the same time
+ * Change supported MCP230xx I2C address range to 0x20 - 0x26 allowing other I2C devices with address 0x27 to be used at the same time
+ * Add Keep last channels values when Color command end with '=' (#6799)
+ * Add support for I2C sensor TLS2591 Light Intensity sensor (#6873)
+ * Change Kept only NEC/RC5/RC6/HASH IR protocols in standard Tasmota, all other protocols require Tasmota-IR, saving 4K
+ * Add command SetOption76 0/1 to enable incrementing bootcount when deepsleep is enabled (#6930)
+ * Change Reset erase end address from as seen by SDK (getFlashChipSize) to full flash size (getFlashChipRealSize)
+ * Change Zigbee log verbosity reduction
+
+### 7.0.0.3 20191103
+ * Add command I2cDriver for I2C driver runtime control using document I2CDEVICES.md
+ * Fix random crash caused by UPNP flood
+ * Add support for Honeywell HPMA115S0 particle concentration sensor by David Hunt (#6843)
+ * Remove driver xsns_12_ads1115_i2cdev replaced by xsns_12_ads1115
+
+### 7.0.0.2 20191102
+ * Add command WebColor19 to control color of Module and Name (#6811)
+ * Add support for Honeywell I2C HIH series Humidity and Temperetaure sensor (#6808)
+ * Fix wrong Dimmer behavior introduced with #6799 when SetOption37 < 128
+ * Change add DS18x20 support in Tasmota-IR
+ * Add Zigbee command support, considered as v1.0 for full Zigbee support
+ * Fix Reduce flash size after change to IRremoteESP8266 v2.7.0
+
+### 7.0.0.1 20191027
+ * Remove update support for versions before 6.0
+ * Change default GUI to dark theme
+ * Add command SetOption73 0/1 to re-enable HTTP Cross-Origin Resource Sharing (CORS) now default disabled (#6767)
+ * Add frequency to ADE7953 energy monitor as used in Shelly 2.5 by ljakob (#6778)
+ * Add command SetOption74 0/1 to enable DS18x20 internal pull-up and remove define DS18B20_INTERNAL_PULLUP (#6795)
+ * Fix better control of RGB/White when SetOption37 >128, added Dimmer1 and Dimmer2 commands (#6714)
+ * Add hide Alexa objects with friendlyname starting with '$' (#6722, #6762)
+ * Add command SetOption75 0/1 to switch between grouptopic (0) using fulltopic replacing %topic% or (1) is cmnd/decode-config.py is able to backup and restore Tasmota configuration.
-In comparison with the Tasmota build-in "Backup/Restore Configuration" function decode-config.py
-Comparing backup files created by decode-config.py and *.dmp files created by Tasmota "Backup/Restore Configuration":
-| - | decode-config.py *.json file |
-Tasmota *.dmp file |
-
|---|---|---|
| Encrypted | -No | -Yes | -
| Readable | -Yes | -No | -
| Simply editable | -Yes | -No | -
| Simply batch processing | -Yes | -No | -
decode-config.py is compatible with Tasmota version from v5.10.0 up to now.
-sudo apt-get install python python-pip libcurl4-openssl-dev libssl-dev
-pip install pycurl configargparse
-Install Python 2.7 then install dependencies. For PyCurl you need to download pycurl‑7.43.0.3‑cp27‑cp27m‑win_amd64.whl for Windows 10 64bit.
-pip install pycurl-7.43.0.3-cp27-cp27m-win_amd64.whl configargparse
-// run the command from the folder where you downloaded the file
-
-pip install configargparse
-#define USE_WEBSERVER and #define WEB_SERVER 2).decode-config.py can handle the following backup file types:
-Configuration data as used by Tasmota "Backup/Restore Configuration" web interface. -This format is binary and encrypted.
-Configuration data in JSON-format.
-This format is decrypted, human readable and editable and can also be used for the --restore-file parameter.
-This file will be created by decode-config.py using the --backup-file with --backup-type json parameter, this is the default.
Configuration data in binary format.
-This format is binary decryptet, editable (e.g. using a hex editor) and can also be used for --restore-file command.
-It will be created by decode-config.py using --backup-file with --backup-type bin.
-Note:
-The .bin file contains the same information as the original .dmp file from Tasmota "Backup/Restore Configuration" but it is decrpted and 4 byte longer than an original (it is a prefix header at the beginning). .bin file data starting at address 4 contains the same as the struct SYSCFG from Tasmota settings.h in decrypted format.
You don't need to append exensions for your file name as decode-config.py uses auto extension as default. The extension will be choose based on file contents and --backup-type parameter.
-If you do not want using auto extensions use the --no-extension parameter.
After download don't forget to set the executable flag under linux with chmod +x decode-config.py or call the program using python decode-config.py....
At least pass a source where you want to read the configuration data from using -f <filename> or -d <host>:
The source can be either
--d <host> parameter*.dmp configuration file using -f <filename> parameterExample:
-decode-config.py -d tasmota-4281
-will output a human readable configuration in JSON-format:
-{
- "altitude": 112,
- "baudrate": 115200,
- "blinkcount": 10,
- "blinktime": 10,
-...
- "ws_width": [
- 1,
- 3,
- 5
- ]
-}
-To save the output as backup file use --backup-file <filename>, you can use placeholder for Version, Friendlyname and Hostname:
decode-config.py -d tasmota-4281 --backup-file Config_@f_@v
-If you have setup a WebPassword within Tasmota, use
-decode-config.py -d tasmota-4281 -p <yourpassword> --backup-file Config_@f_@v
-will create a file like Config_Tasmota_6.4.0.json (the part Tasmota and 6.4.0 will choosen related to your device configuration). Because the default backup file format is JSON, you can read and change it with any raw text editor.
Reading back a saved (and possible changed) backup file use the --restore-file <filename> parameter. This will read the (changed) configuration data from this file and send it back to the source device or filename.
To restore the previously save backup file Config_Tasmota_6.2.1.json to device tasmota-4281 use:
decode-config.py -d tasmota-4281 --restore-file Config_Tasmota_6.2.1.json
-with password set by WebPassword:
-decode-config.py -d tasmota-4281 -p <yourpassword> --restore-file Config_Tasmota_6.2.1.json
-To force screen output use the --output parameter.
Output to screen is default enabled when calling the program with a source parameter (-f or -d) but without any backup or restore parameter.
-The default output format is JSON. You can force JSON output using the --output-format json parameter.
Example:
-decode-config.py -d tasmota-4281 -c my.conf -x Wifi --output-format json
-
-{
- ...
- "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
- ...
-}
-Note: JSON output always contains all configuration data like the backup file except you are using --group arg.
decode-config.py is able to translate the configuration data to (most all) Tasmota commands. To output your configuration as Tasmota commands use --output-format cmnd or --output-format command.
Example:
-decode-config.py -d tasmota-4281 -c my.conf -g 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 wlan.1
- WebPassword myPaszxwo!z
- WebServer 2
- WifiConfig 5
-Note: A few very specific module commands like MPC230xx, KNX and some Display commands are not supported. These are still available by JSON output.
-The huge number of Tasmota configuration data can be overstrained and confusing, so the most of the configuration data are grouped into categories.
-With decode-config.py the following categories are available: Display, Domoticz, Internal, KNX, Led, Logging, MCP230xx, MQTT, Main, Management, Pow, Sensor, Serial, SetOption, RF, System, Timers, Wifi
These are similary to the categories on https://github.com/arendst/Tasmota/wiki/Commands.
-To filter outputs to a subset of groups use the -g or --group arg concatenating the grooup you want, e. g.
decode-config.py -d tasmota-4281 -c my.conf --output-format cmnd --group Main MQTT Management Wifi
-Each argument that start with -- (eg. --file) 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://pypi.org/project/ConfigArgParse).
If an argument is specified in more than one place, then commandline values override config file values which override defaults. This is usefull if you always use the same argument or a basic set of arguments.
-The http authentication credentials --username and --password is predestinated to store it in a file instead using it on your command line as argument:
e.g. my.conf:
-[source]
-username = admin
-password = myPaszxwo!z
-To make a backup file from example above you can now pass the config file instead using the password on command line:
-decode-config.py -d tasmota-4281 -c my.conf --backup-file Config_@f_@v
-For better reading each short written arg (minus sign -) has a corresponding long version (two minus signs --), eg. --device for -d or --file for -f (note: not even all -- arg has a corresponding - one).
A short list of possible program args is displayed using -h or --help.
For advanced help use -H or --full-help:
usage: decode-config.py [-f <filename>] [-d <host>] [-P <port>]
- [-u <username>] [-p <password>] [-i <filename>]
- [-o <filename>] [-t json|bin|dmp] [-E] [-e] [-F]
- [--json-indent <indent>] [--json-compact]
- [--json-hide-pw] [--json-show-pw]
- [--cmnd-indent <indent>] [--cmnd-groups]
- [--cmnd-nogroups] [--cmnd-sort] [--cmnd-unsort]
- [-c <filename>] [-S] [-T json|cmnd|command]
- [-g {Control,Devices,Display,Domoticz,Internal,Knx,Light,Management,Mqtt,Power,Rf,Rules,Sensor,Serial,Setoption,Shutter,System,Timer,Wifi} [{Control,Devices,Display,Domoticz,Internal,Knx,Light,Management,Mqtt,Power,Rf,Rules,Sensor,Serial,Setoption,Shutter,System,Timer,Wifi} ...]]
- [--ignore-warnings] [-h] [-H] [-v] [-V]
-
-Backup/Restore Tasmota configuration data. Args that start with '--'
-(eg. -f) 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
-
- -f, --file, --tasmota-file <filename>
- file to retrieve/write Tasmota configuration from/to
- (default: None)'
- -d, --device, --host <host>
- hostname or IP address to retrieve/send Tasmota
- configuration from/to (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)
-
-Backup/Restore:
- Backup & restore specification
-
- -i, --restore-file <filename>
- file to restore configuration from (default: None).
- Replacements: @v=firmware version from config,
- @f=device friendly name from config, @h=device
- hostname from config, @H=device hostname from device
- (-d arg only)
- -o, --backup-file <filename>
- file to backup configuration to (default: None).
- Replacements: @v=firmware version from config,
- @f=device friendly name from config, @h=device
- hostname from config, @H=device hostname from device
- (-d arg only)
- -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
-
- --json-indent <indent>
- pretty-printed JSON output using indent level
- (default: 'None'). -1 disables indent.
- --json-compact compact JSON output by eliminate whitespace
- --json-hide-pw hide passwords
- --json-show-pw, --json-unhide-pw
- unhide passwords (default)
-
-Tasmota command output:
- Tasmota command output format specification
-
- --cmnd-indent <indent>
- Tasmota command grouping indent level (default: '2').
- 0 disables indent
- --cmnd-groups group Tasmota commands (default)
- --cmnd-nogroups leave Tasmota commands ungrouped
- --cmnd-sort sort Tasmota commands (default)
- --cmnd-unsort leave Tasmota commands unsorted
-
-Common:
- Optional arguments
-
- -c, --config <filename>
- program config file - can be used to set default
- command args (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 {Control,Devices,Display,Domoticz,Internal,Knx,Light,Management,Mqtt,Power,Rf,Rules,Sensor,Serial,Setoption,Shutter,System,Timer,Wifi}
- limit data processing to command groups (default no
- filter)
- --ignore-warnings do not exit on warnings. Not recommended, used by your
- own responsibility!
-
-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
-
-Either argument -d <host> or -f <filename> must be given.
-decode-config.py
-The most of the examples are for linux command line. Under Windows call the program using python decode-config.py ....
Note: The example contains .ini style sections [...]. Sections are always treated as comment and serves as clarity only.
-For further details of config file syntax see https://pypi.org/project/ConfigArgParse.
my.conf
-[Source]
-username = admin
-password = myPaszxwo!z
-
-[JSON]
-json-indent 2
-Restore a Tasmota configuration file
- decode-config.py -c my.conf -d tasmota --restore-file Config_Tasmota_6.2.1.dmp
Backup device using Tasmota configuration compatible format
-a) use file extension to choice the file format
- decode-config.py -c my.conf -d tasmota --backup-file Config_@f_@v.dmp
b) use args to choice the file format
- decode-config.py -c my.conf -d tasmota --backup-type dmp --backup-file Config_@f_@v
for device in tasmota1 tasmota2 tasmota3; do ./decode-config.py -c my.conf -d $device -o Config_@f_@v
-or under windows
-for device in (tasmota1 tasmota2 tasmota3) do python decode-config.py -c my.conf -d %device -o Config_@f_@v
-will produce JSON configuration files for host tasmota1, tasmota2 and tasmota3 using friendly name and Tasmota firmware version for backup filenames.
-Some general notes:
-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. --file <filename> as source).
-To prevent having a useless % in your filename, @h will not replaced by configuration data hostname if this contains '%' characters.-d, --device, --host); it will not work when using a file as source (-f, --file)