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:

Migrate to Sonoff-Tasmota 3.9.x
Migrate to Sonoff-Tasmota 4.x
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
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
Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/tasmota.bin)

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

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

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

Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/tasmota.bin.gz)
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.14.

Support of ESP8266 Core versions before 2.7.4.9 and ESP32 Core versions before 2.0.14 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

http://ota.tasmota.com/tasmota/release-13.3.0

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.14.

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.

ESP32-C2 and ESP32-C6 based

The following binary downloads have been compiled with ESP32/Arduino library core version 3.0.0-alpha3.

tasmota32c2-arduino30.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C2 and 4M+ flash.
tasmota32c6cdc-arduino30.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C6 with serial over embedded USB CDC or hardware USB and 4M+ flash.

Latest released binaries can be downloaded from

Historical binaries can be downloaded from

https://ota.tasmota.com/tasmota32/release-13.3.0

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.3.0 Quinlan

Added

Support for ESP32-C2 and ESP32-C6 using Arduino Core3
Command GpioRead to show input state #19810
Command WebCanvas linear-gradient(#F02 7%,#F93,#FF4,#082,#00F,#708 93%) to set GUI canvas
I2C bus2 support to iAQ core sensor #19799
I2C bus2 support to HTU temperature and humidity sensor
I2C bus2 support to BH1750 ambient light sensor
I2C bus2 support to ADS1115 A/D Converter
I2C bus2 support to SHTxX temperature and humidity sensor
I2C bus2 support to HYTxxx temperature and humidity sensor
I2C bus2 support to SI1145/6/7 Ultra violet index and light sensor
I2C bus2 support to LM75AD temperature sensor
Support for Winsen XH03x dust particle sensors using USE_PMS5003 and PMS_MODEL_ZH03X #19850
ST7735S display.ini for 1.44 inch 128x128 red SPI display #19862
Scripter TCP client #19914
NeoPool hydrolysis setpoint and max
NeoPool command NPFiltrationSpeed to set non-standard filtration type speed #19857
NeoPool command SetOption157 to enable output of sensitive data #19857
NeoPool command NPBoost #19973
NeoPool sensor delta trigger (command NPTelePeriod) #19973
NeoPool enhancements for HomeAssistant #19857
NeoPool store settings on unified file system #19973
DeepSleep support through TIMERS #20117
ESP32 auto TasConsole USB or Serial connection for Core3 by @Staars
ESP32 Partition Wizard can be loaded dynamically #19980
ESP32 support for Avago Tech Bluetooth Buttons #20088
Berry debug.gcdebug() to enable GC debugging #19936
Berry AES_CBC to crypto module #19964
Berry scale_int, equivalent of scale_uint for signed integers #20090
HASPmota add styling properties #19912
Matter flow sensor support #19852

Breaking Changed

NeoPool SENSOR topic Power renamed to Powerunit #19857
Remove Berry every_200ms event which didn't work anyways #20205

Changed

ESP32 Framework (Arduino Core3) from v3.0.0-alpha1 to v3.0.0-alpha3
ESP32 LVGL library from v8.3.10 to v8.3.11 (no functional change)
Increase MAX_HUE_DEVICES to 32 #19820
NeoPool NPHydrolysis percent and unit #19924
Thermostat JSON index from 0 to 1 #20011
MI32 updates #19893
ESP32 keep FileSystem intact when over flashing with VSC #19816
Berry leds animation refactoring stage 1 #20197
Berry ULP API changes for Core3/IDF5 #20198
Matter Light0 now accept a Relay number #19809
Matter update hierarchy of plugins #19915

Fixed

Compile USE_PID #19890
Scripter timer issue #19914
NeoPool filtration mode display #19801
changeUIntScale for linearity when expanding range #20089
TUYA state machine (in TUYA v1) #20110
WebQuery response buffer corruption and format character % #20111
ESP32 I2C allow bus2 support when bus1 is not enabled
ESP32 remove restart energy logging if no energy monitoring is selected
ESP32 IR receive with Arduino Core3 #19904
ESP32 Zero-Cross Dimmer for Core3 #19929
ESP32-C3 ledlink functionality regression from v13.1.0.2
ESP32 Neopixel flicker for Core3/IDF5 #20196
Berry parser error in specific cases #20059
Berry gpio.dac_voltage() regression from v13.1.0.1 #19997
HASPmota bar fixed val attribute #20208

arendst/Tasmota v13.3.0 Tasmota v13.3.0 Quinlan on GitHub