Tasmota/RELEASENOTES.md

12 KiB

Logo

RELEASE NOTES

Migration Information

This version removes support for direct migration from versions before v8.1.0 (Doris)

See migration path for instructions how to migrate to a major version.

Do not upgrade from minimal to minimal version. It will most likely fail at some point and will require flashing via serial. If you do have to use minimal versions, always OTA to a full version of the same release before applying next minimal 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
  3. Migrate to Sonoff-Tasmota 5.14 (http://ota.tasmota.com/tasmota/release_5.14.0/sonoff.bin) - NOTICE underscore as a dash is not supported in older versions
  4. Migrate to Sonoff-Tasmota 6.7.1 (http://ota.tasmota.com/tasmota/release_6.7.1/sonoff.bin) - NOTICE underscore as a dash is not supported in older versions
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/tasmota.bin)

--- Major change in parameter storage layout ---

  1. Migrate to Tasmota 8.5.1 (http://ota.tasmota.com/tasmota/release-8.5.1/tasmota.bin)

--- Major change in internal GPIO function representation ---

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/tasmota.bin.gz)
  2. Upgrade to latest release (http://ota.tasmota.com/tasmota/release/tasmota.bin.gz)

While fallback or downgrading is common practice it was never supported due to Settings additions or changes in newer releases. Starting with release v9.1.0 Imogen the internal GPIO function representation has changed in such a way that fallback is only possible to the latest GPIO configuration before installing v9.1.0.

Supported Core versions

This release will be supported from ESP8266/Arduino library Core version 2.7.4.9 due to reported security and stability issues on previous Core version. This will also support gzipped binaries.

This release will be supported from ESP32/Arduino library Core version 2.0.11.

Support of ESP8266 Core versions before 2.7.4.9 and ESP32 Core versions before 2.0.11 have been removed.

Support of TLS

In addition to TLS using fingerprints now also user supplied CA certs, AWS IoT and Azure IoT is supported. Read full documentation

Initial configuration tools

For initial configuration this release supports Webserver based WifiManager or Serial based command interface.

Initial installation

Easy initial installation of Tasmota can be performed using the Tasmota WebInstaller.

Provided Binary Downloads

ESP8266 or ESP8285 based

The following binary downloads have been compiled with ESP8266/Arduino library core version 2.7.4.9.

  • tasmota.bin = The Tasmota version with most drivers for 1M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota-4M.bin = The Tasmota version with most drivers and filesystem for 4M+ flash.
  • tasmota-AD.bin to tasmota-VN.bin = The Tasmota version in different languages for 1M+ flash.
  • tasmota-lite.bin = The Lite version without most drivers and sensors for 1M+ flash.
  • tasmota-knx.bin = The Knx version without some features but adds KNX support for 1M+ flash.
  • tasmota-sensors.bin = The Sensors version adds more useful sensors for 1M+ flash.
  • tasmota-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features for 1M+ flash.
  • tasmota-display.bin = The Display version without Energy Monitoring but adds display support for 1M+ flash.
  • tasmota-zbbridge.bin = The dedicated Sonoff Zigbee Bridge version for 2M+ flash.
  • tasmota-zigbee.bin = The dedicated cc25xx Zigbee Bridge version for 4M+ flash.

Above binaries are also available as gzipped version allowing faster uploads.

Latest released binaries can be downloaded from

Historical binaries can be downloaded from

The latter links can be used for OTA upgrades too like OtaUrl http://ota.tasmota.com/tasmota/release/tasmota.bin.gz

ESP32, ESP32-C3, ESP32-S2 and ESP32-S3 based

The following binary downloads have been compiled with ESP32/Arduino library core version 2.0.11.

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32xy.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3/S2/S3 and 4M+ flash.
  • tasmota32xycdc.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3/S2/S3 with serial over embedded USB CDC only and 4M+ flash.
  • tasmota32solo1.bin = The Tasmota version with most drivers including additional sensors and KNX for single core ESP32 and 4M+ flash.
  • tasmota32-AD.bin to tasmota32-VN.bin = The Tasmota version in different languages for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 4M+ flash.
  • tasmota32-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features for 4M+ flash.
  • tasmota32-lvgl.bin = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
  • tasmota32-nspanel.bin = The Sonoff NSPanel Smart Scene Wall Switch version with HASPmota display support.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-zbbridgepro.bin - The Sonoff Zigbee Bridge Pro version with CC2652P firmware load support.

Latest released binaries can be downloaded from

Historical binaries can be downloaded from

The latter links can be used for OTA upgrades too like OtaUrl https://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v13.0.0.4

Added

  • Command BrRestart to restart the Berry VM (experimental) #19003
  • Command Delay -1 to wait until next second #18984
  • Command Restart 9 to save all changes and go into deepsleep waiting for a reset #19024
  • Support for MAX17043 fuel-gauge systems Lipo batteries #18788
  • Support for multiple PCA9685 with extended functionality #18805
  • Support for SGP41 TVOC/NOx Sensor #18880
  • Support for DeepSleep battery level percentage #19134
  • Zigbee decode Aqara 0000/FF01 attribute 03 as Temperature #19210
  • ESP32 prepare for Arduino Core v3 and esp-idf v5 #19264
  • Berry getgbl performance counter to debug.counters() #19070
  • Berry _class can be used in static var initialization code #19088
  • Berry energy.update_total() to call EnergyUpdateTotal() from energy driver #19117
  • Berry tasmota.loglevel() and tasmota.rtc_utc() for faster performance #19152
  • Berry metrics for memory allocation/deallocation/reallocation #19150
  • Berry AES CCM decrypting in a single call to avoid any object allocation #19153
  • Berry bytes get and set work for 3 bytes values #19225
  • Partition Wizard is now able to convert to safeboot from Shelly partition layout #19034
  • Matter option to disable bridge mode #18992
  • Matter mini-profiler #19075
  • Matter support for fabric_filtered request (for Google compatibility) #19249

Breaking Changed

  • Berry bool( [] ) and bool( {} ) now evaluate as false #18986
  • Berry import strict now detects useless expression without side effects #18997

Changed

  • IRremoteESP8266 library from v2.8.5 to v2.8.6
  • ESP32 Framework (Arduino Core) from v2.0.10 to v2.0.11
  • ESP32 LVGL library from v8.3.7 to v8.3.8 (no functional change)
  • Initial DisplayMode from 1 to 0 and DisplayDimmmer from 10% to 50% #19138
  • Configuration backup and restore now supports .xdrvsetXXX files too #18295
  • Reduced log level for TeleInfo #19216
  • Console height from default 318 pixels to viewport #19241
  • Shutter button hold behaviour with grouptopic #19263
  • Thermostat improvements #19279
  • PID controller improvements #19285
  • HDC1080 detect device offline #19298
  • ADE7953 lowered no load threshold #19302
  • ESP32 shutter driver support up to 16 shutters #18295
  • ESP32 autodetect flashsize and adjust filesystem #19215
  • Berry extend range(lower, upper, incr) to arbitrary increment #19120
  • Berry updated syntax highlighting plugin for VSCode #19123
  • Berry mqtt.publish now distinguishes between string and bytes #19196
  • Matter support for temperature in Fahrenheit (SetOption8 1) #18987
  • Matter improve responsiveness #19002
  • Matter improve latency for remote commands #19072
  • Matter improve latency for single attribute reads and single commands #19158
  • Matter increased polling frequency for local switches/occupancy #19242

Fixed

  • Berry Walrus Operator #18982
  • MiElHVAC power commands regression from v12.4.0.1 #18923
  • Zero cross dimmer minimum interrupt time #19211
  • Fade would fail when the difference between start and target would be too small #19248
  • Inverted shutter #19243
  • ESP8266 SPI initialization for scripter, filesystem and MFRC522 #19209
  • Matter support for large atribute responses #19252
  • Matter auto-configuration Relay indices #19255

Removed

  • Support for ESP32-C3 with chip revision below 3 (old development boards)