Tasmota Versions Save

Alternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at

v13.4.0

2 months ago
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.6 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.6 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.6.

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

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.4.0 Quinta

Added

  • Command TimedPower<index> <milliseconds>[,ON|OFF|TOGGLE|BLINK] executes Power<index> [ON|OFF|TOGGLE|BLINK] and after executes Power<index> [OFF|ON|TOGGLE|OFF]
  • Command SetOption158 1 to disable publish of ModbusReceived MQTT messages #20678
  • Command SetOption159 1 to enable counting on both rising and falling edge #20712
  • Display of active drivers using command status 4
  • GPIO Viewer to see realtime GPIO states using assets from https://ota.tasmota.com/tasmota/gpioviewer/gpio_viewer_13_4_0/ v2.0.8
  • Support for CST816S touch interface #20213
  • Support for Sonoff Basic R4 Magic Switch #20247
  • Support negative power on BL0942 using index 5..8 #20322
  • Support for pipsolar inverter #20408
  • Support for HardwareSerial invert #15461
  • NeoPool hydrolysis FL1 and Redox flag #20258
  • SML support for IM350 #20474
  • GUI sensor separators #20495
  • ESP32 used UART information
  • ESP32 support GPIOViewer when define USE_ESP32_GPIO_VIEWER is enabled
  • ESP32 MI BLE support for Xiaomi LYWSD02MMC #20381
  • ESP32 support for Shelly Plus Add-On using DS18x20 or DHT11/AM2301/DHT21/DHT22/AM2302/AM2321/SI7021 on GPIO0/1 #20580
  • ESP32 MI32 Legacy initial support for sensors using BTHOME packet format #20625
  • ESP32 Core3 support for SPI ethernet on DM9051, W5500 and KSZ8851
  • ESP32-C3 support for GPIO11 #18350
  • Berry GPIO viewer initial version using async webserver #20416
  • Berry introspect.set() for class attributes #20339
  • Berry support for tcpclientasync in tcpserver #20401
  • Berry tasmota.urlbecload(url:string) -> bool #20412
  • Berry gpio.read_pwm and gpio.read_pwm_resolution #20414
  • Berry gpio.get_pin_type and gpio.ger_pin_type_index #20415
  • Berry string to bytes() #20420
  • Berry button to dynamically load GPIO Viewer with Berry backend #20424
  • Berry debug_panel.tapp to display real-time heap and wifi rssi #20436
  • Berry webserver.header to read browser sent headers #20447
  • Berry provide lightweight options for tasmota.wifi/eth/memory/rtc #20448
  • Berry tasmota.webcolor #20454
  • Berry debug.caller #20470
  • Berry solidification of strings longer than 255 bytes #20529
  • Berry syntax coloring for Notepad++ by FransO #20541
  • Berry/Zigbee web hook per device for customized status display #20542
  • Berry introspect.contains and bytes.addfloat #20635
  • Zigbee ZbEmulation to selectively exclude some devices from Hue/Alexa emulation #20552
  • LVGL lv.str_arr #20480
  • LVGL option to add lv.keyboard extra widget #20496
  • HASPmota haspmota.page_show() to change page #20333
  • HASPmota type chart #20372
  • HASPmota support for min and max attribute in slider #20582
  • Matter support for password for remote Tasmota devices #20296
  • Matter add human readable names for TimeSync cluster #20666

Breaking Changed

  • ESP32 LVGL library from v8.3.11 to v9.0.0, some small breaking changes in C, none in HASPmota #20659
  • Refactoring of Berry animate module for WS2812 Leds #20236
  • Matter aggregator relocated to endpoint 1 for Google compatibility, may break existing associations #20654

Changed

  • ESP8266 platform update from 2023.04.00 to 2024.01.01 #20539
  • ESP8266 Framework (Arduino Core) from v2.7.4.9 to v2.7.6 #20539
  • ESP32 Core2 platform update from 2023.11.01 to 2024.01.01 #20473
  • ESP32 Core3 platform update from 2024.01.11 to 2024.01.12 #20576
  • Library OneWire-Stickbreaker by TasmotaOneWire supporting Shelly Plus Add-On #20580
  • Renamed button "Consoles" to "Tools"
  • Refactored rule Subscribe using LList allowing full message size and enabled by default
  • Refactored rules USE_EXPRESSION and SUPPORT_IF_STATEMENT replacing LinkedList with arrays and enabled by default
  • Support syslog updates every sleep or every second if #define SYSLOG_UPDATE_SECOND #20260
  • Web file upload response on upload error #20340
  • Header Host is now collected by Webserver #20446
  • Utouch optimizations, rgb i2c init #20596
  • Miel HVAC lower the minimum temperature to 10C #20628
  • Webcam tweaks #20451
  • IP stack compatible with new Core3 IPv6 implementation #20509
  • Refactored Pio filesystem download script #20544
  • Matter improve MtrInfo #20686
  • Matter redirects for Advanced Matter configuration UI #20690
  • Matter implement auto-attributes #20694

Fixed

  • CVE-2021-36603 Cross Site Scripting (XSS) vulnerability #12221
  • Syslog server warning caused by lack of <PRI> field and hostname starting with 'z' #14689
  • Support for Domoticz floor/room topics. Regression from v12.0.1 #20299
  • Scripter memory leak in >w x #20473
  • Zigbee ramdom crash in main page #20481
  • ESP8266 IPv6 support #20539
  • ESP32 piezo ceramic buzzer doesn't buzz #20118
  • ESP32 shutter exception 6 (divide by zero) on ShutterMode 4 #20524
  • ESP32 Zigbee Aqara attributes #20452
  • ESP32 Audio for Core3, MP3Stream and Shine #20540
  • ESP32 Core3 reset GPIOs 16/17 when PSRAM is not used #20547
  • LVGL fix type for lv_imgbtn #20354
  • Berry claiming UART0 if needed #20324
  • Berry assigment to list with negative index #20537
  • Berry C mapping, raise an error if too many arguments are sent #20604
  • Matter Contact sensor was not triggering any update #20232
  • Matter support for Alexa #20545
  • Matter error when removing device from Google Home #20665
  • Matter exception when fabrics is not initialized #20667

Removed

  • Max number of 30 backlog entries

v13.3.0

4 months ago
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.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

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

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

v13.2.0

6 months ago
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.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

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.

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.2.0 Quincy

Added

  • Experimental support for ESP32-C2 and ESP32-C6 using Arduino core v3
  • Commands to allow setting of timeprop parameters #19310
  • Command Mi32Name #19619
  • Variables %power<1..28>% and %switch<1..28>% to rules #19331
  • Support different baudrates on BL0942 energy monitor
  • Support for Shelly PlusPMMini, Plus1Mini and Plus1PMMini
  • Support for HDMI CEC protocol #19434
  • Support for ENS16x (air quality) and ENS210 (temp & RH) sensors #19479
  • Support for HC8 CO2 sensor #19714
  • Support for non-persistent WebButton17 to WebButton32 #19580
  • ESP32 commands Ds18Rescan and Ds18RetryRead #19700
  • ESP32 support for influxdb access using https #19582
  • Berry read and write Counters #19558
  • Matter support for Virtual Devices controllable via Rules or Berry #19520

Breaking Changed

  • Sendmail upgraded to ESP-Mail-Client v3.4.9 from v1.2.0, using BearSSL instead of MbedTLS #19460
  • Removed support for Homekit in favour of Matter #19738

Changed

  • ESP32 Framework (Arduino Core) from v2.0.11 to v2.0.14
  • ESP32 LVGL library from v8.3.8 to v8.3.10 (no functional change)
  • Display invert setting after tasmota start in uDisplay driver #19337
  • Consolidate SGP40 and SGP41 into SGP4x driver #19560
  • MAX31855/MAX6675 sensors driver support up to 6 #19329
  • Teleinfo use Apparent Power as Active Power approximation #19756
  • ESP32 LittleFS updated to version with grow option #19635
  • ESP32 I2S audio preparation for Arduino Core v3 #19637
  • ESP32 analog from analogRead() to calibrated analogReadMilliVolts() #19732

Fixed

  • Shutter invert #19341 and #19374
  • Teleinfo power #19381
  • Exception 3 in IRHVAC #19389
  • PCF8574 mode 1 with base relays exception 3/28 regression from v12.4.0.4 #19408
  • ModbusBridge write memory leak #19758
  • Zigbee timezone when device reads LocalTime attribute #19772
  • ESP32 DS18x20 driver support extended over GPIO33
  • ESP32 Support for IPv6 link-local zones for esp-idf 5.1 (necessary for Matter)
  • ESP32 Shutter migration #19454
  • ESP32 Shutter multi press button events #19465
  • ESP32 Shutter button quad press #19589
  • ESP32 shutter frequency #19717
  • ESP32 Arduino Core v2 wifi client flush #19642
  • ESP32 Partition Wizard grow filesystem support #19645
  • ESP32-C3 relay click on restart
  • Matter support for Virtual Devices controllable via Rules or Berry #19520

Removed

  • Support for Homekit in favour of Matter #19738

v13.1.0

8 months ago
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.1.0 Quentin

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)

v13.0.0

10 months ago
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.10.

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

  • 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 Qasim

Added

  • Command SetOption152 0/1 to select two (0 = default) pin bistable or one (1) pin latching relay control #18386
  • Command I2cScan0 to scan both busses on ESP32 with one command
  • Command WifiPower 0 to enable dynamic wifi power based on RSSI by @TD-er #15443
  • Command WifiPower 1 to restore default wifi power
  • Support for TC74 temperature sensor by Michael Loftis #18042
  • Support for GM861 1D and 2D bar code reader #18399
  • Support for PCA9557 8-bit I/O expander #18632
  • Display descriptor for ST7735 128x160 display #18741
  • Zigbee support for air sensors #18665
  • Zigbee firmware for Sonoff-ZB-Pro v20230507 #18968
  • ESP32 command Shuttersetup for "Shelly 2.5 pro" automatic calibration and setup (experimental)
  • ESP32 Enhanced Shutterbuttons functionality to control tilt position, additionally incr/decr possible to position and tilt.
  • Berry RS256 crypto algorithm (RSASSA-MCKS1_v1-5 with SHA256) used for JWT #18763
  • Berry tcpclientasync class for non-blocking TCP client
  • Berry set_lsb_justified(bool) to AudioOutputI2S #18774
  • Berry string.format() now automatically converts type according to format #18890
  • Berry global function format as a simpler syntax to string.format #18925
  • Berry f-strings as an alternative to string formatting #18937
  • Berry Walrus operator ':=' #18963
  • HASPmota meta attribute and improved berry_run #18685
  • Matter sensors Humidity, Pressure, Illuminance #18441
  • Matter allow Matter#Initialized rule once the device is configured #18451
  • Matter UI to change endpoints configuration #18498
  • Matter support for Shutters with Tilt #18509
  • Matter support for async HTTP used for bridged devices and remote relays #18656
  • Matter bridge for ESP8266 remote endpoints (experimental) #18734
  • Matter support for Occupancy via Switch (experimental) #18742
  • Matter ability to add or remove endpoint in bridge mode (code only) #18790
  • Matter controller's Vendor Name to logs and UI #18794
  • Matter redesigned UI #18855
  • Matter support for Contact Sensor #18882
  • Matter friendly-name (NodeLabel) to each endpoint #18897
  • Matter display the remote Device Name instead of IP address #18961

Breaking Changed

  • Change command FileUpload index binary data detection from >199 to >299
  • Matter relay number starts at 1 instead of 0 to match Tasmota numbering

Changed

  • AdafruitFingerprint library from v2.0.4 to v2.1.0
  • IRremoteESP8266 library from v2.8.4 to v2.8.5
  • ESP32 Framework (Core) from v2.0.7 to v2.0.10
  • ESP32 Binaries size increase of 300k due to Matter support may need Partition Wizard
  • InfluxDb resolves DNS name before request #18015
  • Refactored Zero Cross Dimmer #18481
  • Energy power delta report delayed by two seconds allowing hardware to stabilize #17751
  • Shutter sliders in WEBGUI automatically appear and disappear during configuration and update during movement #18701
  • Berry webclient.url_encode() is now a static class method, no change required to existing code #18775

Fixed

  • ESP8266 no update on Energy Export Active regression from v12.3.1.3
  • NovaSDS GUI values #18444
  • LED PWM ac_dimmer curve was wrongly applied instead of Gamma regression from v12.2.0.5 #18666
  • Shutter bootloop using more than 4 shutters #18673
  • Inverted shutter now reflect status also in WEBGUI and several minor fixes to make "inverted" consistant #18701
  • Interaction of SetOption92, VirtualCT, and RGBWWTable #18768
  • Freeze BMP readings before deepsleep #18720
  • NeoPool NPFiltration switch result #18871
  • ESP32 Partition_Manager.tapp
  • ESP32 InfluxDb initial connection delays using HTTPClient #18015
  • ESP32 AIThinker webcam issues #18652
  • ESP32 SPI initialization for MFRC522 #18711
  • ESP32 Neopixel busy time adjustment #18723
  • HASPmota event when value is non-integer #18229
  • Berry a rare condition when a GC causes a memory corruption
  • Berry rules for string comparisons #18464
  • Berry parser error with upvals in closures #18902
  • Zigbee attributes handling in Berry mapping #18747
  • Zigbee regression with SetOption101 #18884
  • Matter fabric provisioning from CASE session for iOS 16.5 #18709

v12.5.0

1 year ago
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.7.

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

  • 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 v12.5.0 Peyton

Added

  • Command SwitchMode0 to show or set all SwitchModes
  • Support for multiple MCP23008/MCP23017/MCP23S17 as switch/button/relay if enabled with #define USE_MCP23XXX_DRV
  • Support for multiple PCF8574 as switch/button/relay if enabled with #define USE_PCF8574 and #define USE_PCF8574_MODE2
  • Support for PMSA003I Air Quality Sensor by Jean-Pierre Deschamps #18214
  • Support for DingTian virtual switch/button/relay #18223
  • Support for GDK101 gamma radiation sensor by Petr Novacek #18390
  • NTP time request from gateway #17984
  • Extended Tariff command for forced tariff #18080
  • Display TM1650 commands like TM1637 #18109
  • VSC Pio menu bar extensions by @Jason2866 #18233
  • Zigbee send Tuya 'magic spell' to unlock devices when pairing #18144
  • ESP32 WIP support for 16 shutters using #define USE_SHUTTER_ESP32 in addition to USE_SHUTTER by Stefan Bode #18295
  • Berry support for Tensorflow Lite (TFL) by Christiaan Baars #18119
  • Berry webclient features
  • Berry instrospect.name() to get names of functions, modules and classes #18422
  • Berry add searchall() and matchall() to re module and pre-compiled patterns #18429
  • Matter support for Light and Relays by Stephan Hadinger #18320
  • Matter automatically exposes all detected Temperature sensors #18430

Breaking Changed

  • Shelly Pro 4PM using standard MCP23xxx driver and needs one time Auto-Configuration

Changed

  • ESP32 Framework (Core) from v2.0.6 to v2.0.7
  • ESP32 LVGL library from v8.3.3 to v8.3.6 (no functional change)
  • LibTeleinfo from v1.1.3 to v1.1.5 #18050
  • Increase number of (virtual)relays and (virtual)buttons to 32
  • ADC Range oversample from 2 to 32 #17975
  • Move #define OTA_URL from user_config.h to board files for better inital support #18008
  • Removed absolute url from filesystem #18148

Fixed

  • TuyaMcu v1 sequence fix #17625
  • SEN5X floats and units #17961
  • Energytotals cannot be set to negative values #17965
  • SR04 driver single pin ultrasonic sensor detection #17966
  • IR panasonic protocol regression from v12.0.2.4 #18013
  • EnergyTotal divided twice during minimal upgrade step regression from v12.3.1.3 #18024
  • TuyaMcu v1 timer integer overflow #18048
  • PZEM energy monitor stabilize period on larger configs #18103
  • Rule topic comparison #18144
  • Refactor energy monitoring reducing stack usage and solve inherent exceptions and watchdogs #18164
  • ESP32 Upload, Upgrade, WebGetConfig, WebQuery and WebSend random HTTP(S) connection timeout set to 5 sec (commit 542eca3)
  • ESP32 energy period shows kWh value instead of Wh regression from v12.3.1.5 #15856
  • ESP32 energy monitoring set StartTotalTime regression from v12.3.1.5 #18385

v12.4.0

1 year ago
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.6.

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

  • 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 v12.4.0 Peter

Added

  • Command DhtDelay<sensor> <high_delay>,<low_delay> to allow user control over high and low delay in microseconds #17944
  • Support for up to 3 (ESP8266) or 8 (ESP32) phase modbus energy monitoring device using generic Energy Modbus driver
  • Support for RGB displays #17414
  • Support for IPv6 DNS records (AAAA) and IPv6 Ping for ESP32 and ESP8266 #17417
  • Support for IPv6 only networks on Ethernet (not yet Wifi)
  • Support for TM1650 display as used in some clocks by Stefan Oskamp #17594
  • Support for PCA9632 4-channel 8-bit PWM driver as light driver by Pascal Heinrich #17557
  • support for SEN5X gas and air quality sensor by Tyeth Gundry #17736
  • Basic support for Shelly Pro 4PM
  • Berry support for crypto.SHA256 #17430
  • Berry crypto add EC_P256 and PBKDF2_HMAC_SHA256 algorithms required by Matter protocol #17473
  • Berry crypto add random to generate series of random bytes
  • Berry crypto add HKDF_HMAC_SHA256
  • Berry crypto add SPAKE2P_Matter for Matter support
  • Berry add mdns advanced features and query
  • Berry int64.fromstring() to convert a string to an int64 #17953
  • ESP32 command EnergyCols 1..8 to change number of GUI columns
  • ESP32 command EnergyDisplay 1..3 to change GUI column presentation
  • ESP32 support for eigth energy phases/channels
  • ESP32 support for BMPxxx sensors on two I2C busses #17643
  • ESP32 support for Biomine BioPDU 625x12 #17857
  • ESP32 preliminary support for Matter protocol, milestone 1 (commissioning) by Stephan Hadinger

Breaking Changed

  • TM1638 button and led support are handled as virtual switches and relays #11031

Changed

  • Dht driver from v6 to v7
  • ESP32 Framework (Core) from v2.0.5.3 to v2.0.6 (IPv6 support)
  • Energy totals max supported value from +/-21474.83647 to +/-2147483.647 kWh
  • Removed delays in TasmotaSerial and TasmotaModbus Tx enable switching
  • Keep webserver enabled on command upload
  • Better support for virtual buttons and switches up to a total of 28
  • TuyaMcu support of virtual switches
  • Increase rule event buffer from 100 to 256 characters #16943
  • Tasmota OTA scripts now support both unzipped and gzipped file uploads #17378
  • LVGL allow access to lv.LAYOUT_GRID and lv.LAYOUT_FLEX #17948

Fixed

  • Modbus transmit enable GPIO enabled once during write buffer
  • Energy dummy switched voltage and power regression from v12.2.0.2
  • Shutter default motorstop set to 0 #17403
  • Shutter default tilt configuration #17484
  • Orno WE517 modbus serial config 8E1 setting #17545
  • Rename tasmota4M.bin to tasmota-4M.bin to solve use of tasmota-minimal.bin #17674
  • ESP8266 set GPIO's to input on power on fixing relay spikes #17531
  • ESP8266 TLS SNI which would prevent AWS IoT connection #17936
  • EnergyTotal divided twice during minimal upgrade step regression from v12.3.1.3 #18024

v12.3.1

1 year ago
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.5.3.

Support of ESP8266 Core versions before 2.7.4.9 and ESP32 Core versions before 2.0.5.3 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
  • tasmota4M.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.5.3.

  • 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 v12.3.1 Percy

Added

  • Command SetOption35 0..255 to skip number of received messages in Serial Bridge (default 0) #17140
  • Command SetOption47 1..255 to delay power on relay state in seconds reducing power surge. SO47 1 delays until network connected. SO47 2 delays until mqtt connected
  • Command RgxClients for range extender clients list #17048
  • Command RgxPort [tcp|udp], gateway_port, client_mac, client_port for range extender port forwardings #17092
  • Command SSerialBuffer 256..SERIAL_BRIDGE_BUFFER_SIZE to change serial bridge rx buffer size #17120
  • Command SwitchMode 16 sending only MQTT message on inverted switch change #17028
  • Command NeoPool NPFiltration 2 toggle #16859
  • Optional define SERIAL_BRIDGE_BUFFER_SIZE to set Serial Bridge internal buffer size (Default ESP8266 = 256, ESP32 = 800)
  • Support for two phase power calibration using commands PowerSet2, VoltageSet2 and CurrentSet2
  • Support for HLK-LD2410 24GHz smart wave motion sensor
  • Support for Shelly Pro 1/1PM and 2/2PM #16773
  • Support for up to four DS18x20 GPIOs by md5sum-as #16833
  • Support for Digital Addressable Lighting Interface (DALI) by Andrei Kazmirtsuk #16938
  • Support for NTAG2xx tags read and write on PN532 NFC reader #16939
  • Support for Plantower PMSx003T AQI models with temperature and humidity #16971
  • Support for BP1658CJ RGBCW led bulbs like Orein OS0100411267 by Cossid #17011
  • Support for Dingtian x595 shift register based relay boards by Barbudor #17032
  • Support for HMC5883L 3-Axis Digital Compass sensor by Andreas Achtzehn #17069
  • Support for ME007-ULS narrow FoV ultrasonic distance sensor by Mathias Buder #17376
  • WS2812 and Light ArtNet DMX control over UDP port 6454 #17059
  • Teleinfo TEMPO (BBR) contract #17160
  • Serial Modbus transmit enable GPIOs to all modbus energy drivers and modbus bridge #17247
  • Berry bytes().setbytes() method #16892
  • Berry bytes().reverse() method #16977
  • Berry mdns module #17202
  • Zigbee router firmware for Sonoff ZBBridgePro #16900
  • ESP32 Support for DMX ArtNet Led matrix animations #16984
  • ESP32 DS18x20 parasitic power usage when defining W1_PARASITE_POWER #17112

Breaking Changed

  • Redesign distance sensors VL53LXX, TOF10120, HRXL and DYP to use cm instead of mm #17021

Changed

  • TasmotaSerial library from v3.5.0 to v3.6.0
  • ESP32 Framework (Core) from v2.0.5 to v2.0.5.3
  • ESP32 LVGL library from v8.3.2 to v8.3.3 (no functional change)
  • ESP32 NimBLE library from v1.4.0 to v1.4.1 #16775
  • Serial Bridge default internal serial rx buffer size from 64 to 256 #17120
  • DS18x20 DS18Alias to DS18Sens #16833
  • Compiling with reduced boards manifests in favour of Autoconfig #16848
  • ADE7953 monitoring from instant power to accumulated energy #16941
  • WS2812 sends signal to only Pixels leds instead of sending to 512 leds #17055
  • AC PWM dimmer lineair power distribution #17177
  • Zigbee improved Aqara plug support and completed cluster 0x0702 #17073
  • Removed leading spaces on commands (S)SerialSend1 to 6 but keep on duplicate commands (S)SerialSend11 to 16 [#16723](https://github.com/arendst/Tasmota/issues/16723
  • Shutter bug fixes and functionality upgrade [#17380](https://github.com/arendst/Tasmota/issues/17380
  • MQTT now uses Tasmota's DNS resolver instead of LWIP [#17387](https://github.com/arendst/Tasmota/issues/17387
  • ESP32 initial otaurl from http to https

Fixed

  • TasmotaSerial read(buffer, size) regression from v9.3.0
  • Serial bridge default serial configuration from 5N1 to 8N1 regression from v10.1.0.3
  • BP5758D red channel corruption regression from v12.1.1.6 #16850
  • Deduplicate code and fix %timer n% rule regression from v12.2.0 #16914
  • Serial initialization for baudrate and config #16970
  • ModbusBridge buffer overflow #16979
  • ModbusBridge baudrates over 76500 baud #17106
  • SenseAir S8 module detection #17033
  • Analog MQ exception 28 on restart #17271
  • RCSwitch exception 0/6 on some protocols #17285
  • ESP32 exception 28 when RtcNtpServer is enabled on restart #17338
  • ESP8266 zigbee exception 3 regression from v12.3.0 #17397

Removed

  • Define USE_PN532_DATA_RAW from NFC reader #16939

v12.2.0

1 year ago
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.5.

Support of ESP8266 Core versions before 2.7.4.9 and ESP32 Core versions before 2.0.5 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
  • tasmota4M.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.5.

  • 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v12.2.0 Patrick

Added

  • Command SetOption46 0..255 to add 0..255 * 10 milliseconds power on delay before initializing I/O #15438
  • Command SetOption146 1 to enable display of ESP32 internal temperature
  • Command DspSpeed 2..127 to control message rotation speed on display of POWR3xxD and THR3xxD
  • Command DspLine<1|2> <index>,<unit>,<index>,<unit>,... to select message(s) on display of POWR3xxD and THR3xxD
  • Command SspmPowerOnState<relay> 0|1|2 to set Sonoff SPM 4Relay module v1.2.0 power on state overruling tasmota global power on state. 0 = Off, 1 = On, 2 = Saved state #13447
  • Command StatusRetain 0|1 #11109
  • Command Sunrise 0..3 to select sunrise dawn angle between Normal, Civil, Nautical or Astronomical #16795
  • Command UrlFetch <url> to download a file to filesystem
  • Command WcClock 10..200 set webcam clock in MHz. Default is 20
  • Support for Shelly Plus 2PM
  • Support for SGP40 gas and air quality sensor #16341
  • Support for Modbus writing using ModbusBridge by JeroenSt #16351
  • Support for DFRobot SEN0390 V30B ambient light sensor #16105
  • Support for QMC5883L magnetic induction sensor by Helge Scheunemann #16714
  • Support for Modbus Energy Monitoring devices using a rule file. See xnrg_29_modbus.ino for more information
  • Support for flowrate meter flow amount/duration, show values in table format #16385
  • Support of optional file calib.dat on ADE7953 based energy monitors like Shelly EM #16486
  • Zigbee device plugin mechanism with commands ZbLoad, ZbUnload and ZbLoadDump #16252
  • Zigbee basic support for Green Power #16407
  • Zigbee friendly names per endpoint
  • Zigbee Alexa/Hue emulation, support multiple switches on separate endpoints #16718
  • Support for Ethernet in ESP32 safeboot firmware #16388
  • ESP32-S3 support for internal temperature sensor
  • ESP32-S2 and ESP32-S3 touch button support
  • ESP32 Automatically resize FS to max flash size at initial boot #16838
  • Berry has persistent MQTT subscriptions: auto-subscribe at (re)connection
  • Berry automated solidification of code
  • LVGL/HASPmota add tiny "pixel perfect" fonts for small screens #16758
  • HASPmota support for TTF fonts #16759

Changed

  • IRremoteESP8266 library from v2.8.2 to v2.8.4
  • TasmotaModbus library from v3.5.0 to v3.6.0 #16351
  • ESP32 NimBLE library from v1.3.6 to v1.4.0
  • ESP32 LVGL library from v8.3.0 to v8.3.2
  • ESP32 Tasmota Core32 from 2.0.4.1 to 2.0.5
  • Command SerialBuffer raise max allowed buffer size to 2048 characters #16374
  • Increase serial console input buffer size from 520 to 800
  • Button debouncing V3 by adopting switch debounce code #16339
  • Thermostat max allowed temperature from 100 to 200C #16363
  • Shelly EM swap internal channels A and B to match P1 and P2 #16486
  • Shelly EM phase calibration set to 200 (from 0) #16486
  • Zigbee report unprocessed attributes
  • ESP32 Increase number of button GPIOs from 8 to 28 #16518
  • ESP32 Platformio one Platform for all Tasmota frameworks Core32 2.0.5 #16644

Fixed

  • RTC not detected when lights are present #16242
  • DNS lookup for .local domains #16273
  • Button response delay regression from v12.0.2.4 #16319
  • Lost module name in GUI regression from v12.0.2.4 - 20220803 #16324
  • Removed whitespace from JSON values with no decimals #16365
  • ESP32 touch button multi-press and hold detection #16596

v12.1.1

1 year ago
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
  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.4.1.

Support of ESP8266 Core versions before 2.7.4.9 and ESP32 Core versions before 2.0.4.1 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
  • tasmota4M.bin = The Tasmota version with most drivers and filesystem for 4M+ flash.
  • tasmota-AF.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.4.1.

  • 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-AF.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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v12.1.1 Patricia

Added

  • Command SetOption45 1..250 to change default bistable latching relay pulse length of 40 milliseconds
  • Command SetOption144 1 includes a timestamp in zigbee ZbReceived messages
  • Command GlobalTemp2 1..250 to select Global Temperature source indexed from teleperiod occurance data #15834
  • Command GlobalHum2 1..250 to select Global Humidity source indexed from teleperiod occurance data #15834
  • Command GlobalPress2 1..250 to select Global Pressure source indexed from teleperiod occurance data #15834
  • Command Sleep2 ! to cancel pending one-shot speed setting #15954
  • Commands WifiScan and WifiTest #16141
  • Support for 5-channel light dimmer driver SM2335 used in SwitchBot Color Bulbs #15839
  • Support for Sonoff POWR3xxD and THR3xxD #15856
  • Support for bistable (latching) relays mixed with monostable relays using GPIO Relay_b or Relay_bi as used by Sonoff POWR320D and THR320D
  • Support for Modbus bridge adding commands ModbusSend, ModbusBaudrate and ModbusSerialConfig #16013
  • Support for multiple IRsend GPIOs #16138
  • Support for Catalan language translations by Albert Gonzalez #16145
  • Zigbee added recording of when the battery was last reported #16146
  • Zigbee add Battery auto-probe (can be disabled with SetOption143 1) #16148
  • ESP32 Support for Ultra Low Power (ULP) coprocessor via Berry by Christian Staars #15916

Breaking Changed

Changed

  • TasmotaModbus library from v3.4.0 to v3.5.0 #16245
  • ESP32 Arduino core from v2.0.3 to v2.0.4.1 #15940
  • ESP32 LVGL library from v8.2.0 to v8.3.0 #16019
  • Driver DHT v6 consolidation for both ESP8266 and ESP32 to support SI7021, THS01 and MS01 on ESP32 #15856

Fixed

  • Restore EnergyToday after using command restart 2 and power cycle #16118
  • ESP32 SendMail not working over ethernet #15794
  • RTC not detected when lights are present #16242
  • DNS lookup for .local domains #16273
  • Button response delay regression from v12.0.2.4 #16319
  • Lost module name in GUI regression from v12.0.2.4 - 20220803 #16324

Removed

  • Arduino IDE support