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

v12.1.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
  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-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.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-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.1.0 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

Removed

  • Arduino IDE support

v12.0.2

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

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

Added

  • Command SetOption139 0/1 to switch between pressure unit "mmHg" (0) or "inHg" (1) when SO24 1 #15350
  • Command SetOption140 0/1 to switch between MQTT Clean Session (0) or Persistent Session (1) #15530
  • Command SetOption141 1 to disable display of module name in GUI header
  • Command SetOption142 1 to wait 1 second for wifi connection solving some FRITZ!Box modem issues #14985
  • Command DnsTimeout 100..20000 to change default DNS timeout from 1000 msec blocking if no DNS server found
  • Command EnergyExportActive<phase> to (p)reset energy export active for supported devices. Currently ADE7880 only #13515
  • Command IfxRp ""|<policy> adds optional InfluxDb Retention Policy #15513
  • Command SspmDisplay 2 to display Sonoff SPM energy data in GUI for user tab-selected relay modules #13447
  • Command SSerialSend9 0/1 to enable Serial Bridge console Tee for debugging purposes
  • Support for Sonoff MS01 soil moisture sensor #15335
  • Support for daisy chaining MAX7219 displays #15345
  • Support for Sensirion SHT4X using define USE_SHT3X #15349
  • Support for Sonoff SPM v1.2.0
  • Support for Sonoff Zigbee Bridge Pro by Stephan Hadinger #15701
  • Support for Sonoff NSPanel Smart Scene Wall Switch
  • Support for flowrate meters like YF-DN50 and similary #15474
  • Support for 5-channel light dimmer driver BP5758D used in Tuya bulbs #15713
  • Support for HYTxxx temperature and humidity sensor #15715
  • Sonoff SPM delayed SetPowerOnState #13447
  • ESP32 Command Restart 3 to switch between SafeBoot and Production

Breaking Changed

Changed

  • Restructured tasmota source directories taking benefit from PlatformIO Core v6.0.2
  • Prepare to remove dedicated Home Assistant discovery in favour of Tasmota Discovery and hatasmota
  • ESP32 Tasmota SafeBoot with changed partition scheme allowing larger binaries
  • ESP32 increase Serial Bridge input buffer from 130 to 520 characters

Fixed

  • Improv initial or erase device installation failing to provide Configure WiFi option
  • SCD40 start low power command #15361
  • BL09xx negative power presentation #15374
  • Possible pin output toggle after power on #15630
  • SHT1X driver hangs and wrong values on ESP32 #15790
  • Resolving NTP and/or MQTT server names regression from v12.0.0 #15816
  • MQTT rc -4 connection regression from v12.0.0 #15809
  • ESP32 Arduino Core WiFi timeout is changed from msec to seconds

Removed

  • Arduino IDE support

v12.0.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.3.

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

Added

  • Command SetOption139 0/1 to switch between pressure unit "mmHg" (0) or "inHg" (1) when SO24 1 #15350
  • Command SetOption140 0/1 to switch between MQTT Clean Session (0) or Persistent Session (1) #15530
  • Command SetOption141 1 to disable display of module name in GUI header
  • Command SetOption142 1 to wait 1 second for wifi connection solving some FRITZ!Box modem issues #14985
  • Command EnergyExportActive<phase> to (p)reset energy export active for supported devices. Currently ADE7880 only #13515
  • Command IfxRp ""|<policy> adds optional InfluxDb Retention Policy #15513
  • Command SspmDisplay 2 to display Sonoff SPM energy data in GUI for user tab-selected relay modules #13447
  • Command SSerialSend9 0/1 to enable Serial Bridge console Tee for debugging purposes
  • Support for Sonoff MS01 soil moisture sensor #15335
  • Support for daisy chaining MAX7219 displays #15345
  • Support for Sensirion SHT4X using define USE_SHT3X #15349
  • Support for Sonoff SPM v1.2.0
  • Support for Sonoff Zigbee Bridge Pro by Stephan Hadinger #15701
  • Support for Sonoff NSPanel Smart Scene Wall Switch
  • Support for flowrate meters like YF-DN50 and similary #15474
  • Support for 5-channel light dimmer driver BP5758D used in Tuya bulbs #15713
  • Support for HYTxxx temperature and humidity sensor #15715
  • Sonoff SPM delayed SetPowerOnState #13447
  • ESP32 Command Restart 3 to switch between SafeBoot and Production

Breaking Changed

Changed

  • Restructured tasmota source directories taking benefit from PlatformIO Core v6.0.2
  • Prepare to remove dedicated Home Assistant discovery in favour of Tasmota Discovery and hatasmota
  • ESP32 Tasmota SafeBoot with changed partition scheme allowing larger binaries
  • ESP32 increase Serial Bridge input buffer from 130 to 520 characters

Fixed

  • Improv initial or erase device installation failing to provide Configure WiFi option
  • SCD40 start low power command #15361
  • BL09xx negative power presentation #15374
  • Possible pin output toggle after power on #15630
  • SHT1X driver hangs and wrong values on ESP32 #15790
  • Resolving NTP and/or MQTT server names regression from v12.0.0 #15816
  • ESP32 Arduino Core WiFi timeout is changed from msec to seconds

Removed

  • Arduino IDE support

v11.1.0

2 years 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.2.1.

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

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32c3.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3 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-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-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-lvgl.bin = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v11.1.0 Ostara

Added

  • Command SetOption135 1 to disable LVGL splash screen
  • Command SetOption136 1 to disable single sensor reports from Tuya devices while keeping teleperiod reports #15216
  • Command SetOption137 1 to avoid MQTT publish of defined Tuya CMDs if SO66 is active #15267
  • Command SetOption138 1 to switch GUI energy multi-column layout from left/center (0) to right (1) align #15342
  • Command SspmMap 0 to reset Sonoff SPM default mapping
  • Command TcpConnect <port><ip_address> to add client connection mode #14874
  • Command RfTimeout 100..60000 to disable duplicate RfReceive. Default 1000 #15061
  • Command IfxSensor 1 to send non-teleperiod data to influxdb
  • Commands Sensor12 D0 .. D5, S0 .. S5 allowing differential or single-ended modes #15001
  • Command Sensor34 10 0|1|<weight in gram> to set HX711 fixed tare (0 = use auto tare, 1 = use calibrated tare, Any other value is user selected tare)
  • Commands Sensor34 11 <valueA> and Sensor34 12 <valueB> to use HX711 absolute weight conversion #15292
  • NeoPool commands NPpHMin, NPpHMax, NPpH, NPRedox, NPHydrolysis, NPIonization, NPChlorine and NPControl #15015
  • NeoPool system voltages display
  • TasmotaSerial implement end()
  • Support for improv as used by esp-web-tools
  • Support for up to four DS3502 digital potentiometers with command Wiper<x> 0..127
  • Support for ADE7880 3 phase energy monitor as used in Shelly 3EM #13515
  • Support for PCF85363 RTC as used in Shelly 3EM #13515
  • Full RTC chip integration and synchronisation when using UBX (=GPS), NTP or manual time
  • NeoPool JSON modules, power module, cell info, chlorine, conductivity and ionization
  • ESP32 Berry always enable rules
  • ESP32 Berry bootloop protection
  • ESP32 Support for OpenHASP v1.0 by Stephan Hadinger #15307
  • ESP32 support for BLE Mi scale V1 #13517
  • ESP32 integrate Homekit in Bluetooth binary #14818
  • ESP32 Berry virtual Alexa hue device #14833
  • ESP32 TasmotaSerial uart mapping to support multiple begin() and implement getUart() #14981

Breaking Changed

  • Remove support for Internet Explorer by allowing ECMAScript6 syntax using less JavaScript code bytes #15280

Changed

  • Adafruit BusIO library from v1.0.10 to v1.11.0
  • TasmotaSerial library from v3.4.0 to v3.5.0 #14981
  • Sonoff SPM increase max number of relays supported to 32 (8 SPM-4Relay modules)
  • Extent number of pulsetimers from 8 to 32 #8266
  • Consolidate three RTC chip drivers (DS3231, BM8563, PCF85363) into one driver updating RTC as soon as possible after restart
  • DS3231 I2C address define USE_RTC_ADDR into DS3231_ADDRESS
  • Display of energy values in GUI use columns when define USE_ENERGY_COLUMN_GUI is enabled (default)
  • ESP8266 Shrinked tasmota-minimal.bin by removing all commands except Upgrade, Upload, OtaUrl, Seriallog, Weblog and Restart
  • ESP32 Arduino core from v2.0.2.2 to v2.0.3
  • ESP32 LVGL library from v8.1.0 to v8.2.0
  • ESP32 NimBLE library from v1.3.3 to v1.3.6
  • ESP32 update the internal Berry type system to sync with Skiars Berry repository. No expected impact on code, but .bec files need to be generated again #14811

Fixed

  • SSPM energy yesterday when zero
  • NeoPool NPBit and NPRead/NPReadL output
  • HX711 false readings by removing large deviations
  • GPIO OptionE1 selection regression #14821
  • BL0939, BL0940 and BL0942 energy monitoring buffer miscompares resulting in wrong daily energy values regression from v9.5.0.8 #14829
  • Wiegand 34-bit rfid reading and presentation #14834
  • Orno WE517 power meter phase 2 current reactive #14841
  • TasMesh relaunch wifi on esp_now_init failure #15334
  • ESP32 save settings after OTA upload regression from v10.0.0.3
  • ESP32 PowerOnState #15084

Removed

  • Command Sensor33 and replaced by RtcNtpserver
  • Command Sensor34 7 as now active tare is persistent resulting in calculated current weight

v11.0.0

2 years 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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

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

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

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

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32c3.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3 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-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-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-lvgl.bin = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v11.0.0 Olivia

Added

  • Command Json {<Tasmota commands>} to enable input of any command as JSON tokens #14568
  • Command SetOption44 1..100 to set base tolerance percentage for matching incoming IR messages (default 25, max 100) #14555
  • Command SetOption134 1 to disable PWM auto-phasing for lights by default (new behavior) #14590
  • Command SSerialConfig <serialconfig> to change Serial Bridge configuration
  • Command SspmDisplay 1 to display Sonoff SPM energy data in GUI for relays powered on only
  • Command SspmEnergyTotal<relay> to (p)reset Sonoff SPM total energy without today's energy
  • Command SspmEnergyYesterday<relay> to (p)reset Sonoff SPM energy yesterday
  • Command SspmHistory<relay> to retrieve Sonoff SPM daily energy up to last six month (as defined by ARM firmware)
  • Command SspmIAmHere<relay> to (faintly) blink Sonoff SPM-4Relay module error light of requested relay
  • Command SspmLog<relay> [x] to retrieve Sonoff SPM relay power state change and cause logging
  • Command SspmMap 2,1,.. to map Sonoff SPM scanned module to physical module #14281
  • Command SspmOverload<relay> <options> to set Sonoff SPM overload criteria for any relay
  • Command SspmScan to rescan Sonoff SPM modbus
  • Command WebTime <start_pos>,<end_pos> to show part of date and/or time in web gui based on "2017-03-07T11:08:02-07:00"
  • Commands for ESP32 ethernet configuration EthIpAddress, EthGateway, EthSubnetmask, EthDnsServer1 and EthDnsServer2 #14385
  • Support for Eastron SDM230 modBus energy meter #13443
  • PWM Dimmer two button support #13993
  • Support for Linkind dimmer as GPIO Option A6 #14004
  • DDP schemes for light and WS2812 #14017
  • Device Group Send full status item #14045
  • Support for MAX7219 Dot Matrix displays #14091
  • Experimental ADE7953 (Shelly EM) reset on restart #14261
  • Solax X1 negative temperature support #14278
  • Solax X1 modbus RTS support and offline status #14305
  • Tasmota favicon to webbrowser tab #14322
  • Support for BME688 with latest Bosch-Sensor-API library #14513
  • Rule variable %color% #14572
  • Rule variables %timer1% to %timer16% #14619
  • Support for MQ analog sensor for air quality by Francesco Adriani #14581
  • ESP32 single binary firmware #14239
  • ESP32 disable serial console when 3 (ESP32) or 2 (Other models) serial interfaces are requested #14487
  • ESP32 support for TuyaMcu
  • ESP32 Berry features
  • ESP32 support for USE_PWM_DIMMER as GPIO Option E1
  • ESP32 increase PWM channels to 16
  • ESP32 auto-configuration
  • ESP32 initial support for ESP32S3 with support for 38 configurable GPIOs

Breaking Changed

Changed

  • ESP32 core library from v2.0.2 to v2.0.2.1
  • PubSubClient library from v2.8.12 to v2.8.13
  • TasmotaSerial library from v3.3.0 to v3.4.0
  • TasmotaModbus library from v1.2.0 to v3.4.0
  • ESP8266Audio library from v1.9.2 to v1.9.5
  • ESP8266SAM library from v1.0 to v1.0.1
  • BME68x-Sensor-API library from v3.5.9 to v4.4.7
  • SR04 driver to support US-100
  • Mitsubishi HVAC temperature resolution #13936
  • Remove restriction of topic must differ from mqttclient #14019
  • ESP32 Set stack size with #define SET_ESP32_STACK_SIZE, added StackLowMark metrics
  • ESP32 Berry stores compiled bytecode into IRAM, freeing space in heap #14307

Fixed

  • Intermittent exceptions and heap corruption due to PubSubClient library buffer overflow #13700
  • EZOO2 sensor message format #14000
  • DHT support negative temperatures on different hardware #14173
  • Hardware serial parity and stop bits support #14212
  • Edit file for SD card #14229
  • Scripter memory corruption #14268
  • ESP32 Webcam exception during flashwrites
  • ESP32 LedPwmMode exception #14073
  • ESP32 Compile error when I2S_Audio is enabled #14095
  • ESP32 Provide proper OTA_URL for tasmota32solo1 #14202
  • ESP32 OneWire-Stickbreaker (DS18x20) library support for ESP32C3 and ESP32S2 #14338

Removed

  • ESP32 consolidate odroidgo and core2 binaries into tasmota32-lvgl using Berry features

v10.1.0

2 years 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. Pay attention to the following version breaks due to dynamic settings updates:

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.

  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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/)

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.

Support of Core versions before 2.7.1 has 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 only. Support for WPS and SmartConfig has been removed.

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-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 based

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32c3.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3 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-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-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-lvgl.bin = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 4M+ flash.
  • tasmota32-odroidgo.bin = The Odroid-Go version is specifically tailored to Odroid_go hardware for 8M+ flash.
  • tasmota32-core2.bin = The Core2 version is specifically tailored to M5Stack Core2 hardware for 8M+ 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v10.1.0 Noelle

Added

  • Support for 1 second heartbeat GPIO
  • Support for FUNC_BUTTON_MULTI_PRESSED in (light)drivers
  • Command TcpConfig for TCPBridge protocol configuration #13565
  • Support for HDC2010 temperature/humidity sensor by Luc Boudreau #13633
  • WS2812 scheme 13 stairs effect #13595
  • Command IfxPeriod to overrule Teleperiod for Influx messages #13750
  • Support for GPE Multi color smart light as sold by Action in the Netherlands
  • Shutter support for venetian blinds with tilt control
  • Support for 74xx595 8-bit shift registers #13921
  • ESP32 Autoconfiguration
  • ESP32 Preliminary support for Tasmota Apps (.tapp extesions)
  • ESP32 OTA over HTTPS
  • ESP32 HTTPS support to WebQuery
  • ESP32 Berry support for neopixel (WS2812, SK6812)
  • ESP32 Berry import re regex module
  • ESP32 Berry add module python_compat to be closer to Python syntax #13428
  • ESP32 Proof of Concept Sonoff SPM with limited functionality (switching and energy monitoring) #13447

Breaking Changed

  • ESP32-S2 TSettings memory usage fixed to 4096 bytes regression from v9.5.0.8

Changed

  • IRremoteESP8266 library from v2.7.20 to v2.8.0
  • ESP32 core library from v1.0.7.4 to v2.0.1.1
  • ESP32-C3 core library from v2.0.0-post to consolidated ESP32 core library
  • ESP32 NimBLE to v.1.3.3
  • ESP32 toolchains changed from 8.4.0-2021r1 to 8.4.0-2021r2
  • Range conversion edge values
  • ESP8266 Gratuitous ARP enabled and set to 60 seconds #13623
  • File editor no-wrap #13427
  • MQTT TLS dual mode (CA or fingeprint) in same firmware, SetOption132 1 to force fingerprint
  • ESP32 Ethernet hostname ending in _eth to -eth according to RFC952

Fixed

  • Initial reset RTC memory based variables like EnergyToday and EnergyTotal
  • SML compile error #13441
  • GUI checkbox MQTT TLS not saved regression from v9.2.0.3 #13442
  • Discovery of shutters #13572
  • Tuya dimmer range issue #13849
  • ESP32 Telegram compile error #13435
  • ESP32-C3 OneWire as used by DS18x20 #13583
  • ESP32 analog NTC temperature calculation #13703
  • ESP32 compile error BLE EQ3 driver with core 2.0.x #13948

Removed

  • ILI9488 driver in favour of Universal Display driver #13719

v10.0.0

2 years 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. 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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/)

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.

Support of Core versions before 2.7.1 has 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 only. Support for WPS and SmartConfig has been removed.

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-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 based

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32c3.bin = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C3 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-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-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-lvgl.bin = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 4M+ flash.
  • tasmota32-odroidgo.bin = The Odroid-Go version is specifically tailored to Odroid_go hardware for 8M+ flash.
  • tasmota32-core2.bin = The Core2 version is specifically tailored to M5Stack Core2 hardware for 8M+ 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v10.0.0 Norman

Added

  • Release of Tasmota WebInstaller
  • Command SetOption2 1 to enable display of global temperature/humidity/pressure info to JSON sensor message
  • Command SetOption127 1 to force Wi-Fi in no-sleep mode even if Sleep 0 is not enabled
  • Command SetOption128 0|1 web referer check disabling HTTP API commands if set to 0. Default set to 1 for backward compatibility #12828
  • Command SetOption129 1 to enable split total energy results #13030
  • Command SetOption130 1 adding heap size (and ESP32 fragmentation) to logging timestamp for debugging
  • Command SetSensor1..127 0|1 to globally disable individual sensor driver
  • Command Subscribe2 ... to subscribe to a MQTT topic without appended "/#" #12858
  • Command WebGetConfig <url> if #define USE_WEBGETCONFIG is enabled to restore/init configuration from external webserver #13034
  • Command WebQuery <url> GET|POST|PUT|PATCH [<headers>] <body> to extent HTTP requests #13209
  • Commands EnergyTotal<phase>, EnergyToday<phase> and EnergyYesterday<phase> to (re)set energy values
  • Commands EnergyUsage and EnergyExport to (re)set energy usage and export values
  • Optional IP filter to command TCPStart #12806
  • Neopool commands NPPHRes, NPCLRes and NPIonRes #12813
  • Support for second DNS server
  • Support for influxdb using #define USE_INFLUXDB and several Ifx commands
  • Support for AM2320 Temperature and Humidity Sensor by Lars Wessels #12485
  • Support for Technoline WS2300-15 Anemometer #12573
  • Support for Telaire T6700 Series CO2 sensor by Alexander Savchenko #12618
  • Support for CAN bus and Freedom Won Battery Management System by Marius Bezuidenhout #12651
  • Support for IEM3155 Wattmeter #12940
  • Support for Hydreon RG-15 Solid State Rain sensor #12974
  • Support for IKEA VINDRIKTNING particle concentration sensor #12976
  • Support for Sensirion SCD40/SCD41 CO2 sensor #13139
  • Support for BL0939 energy monitor as used in ESP32 based Sonoff Dual R3 V2 Pow #13195
  • Support for BL0942 energy monitor #13259
  • Support for HM330X SeedStudio Grove Particule sensor #13250
  • Initial support for Tasmota Mesh (TasMesh) providing node/broker communication using ESP-NOW #11939
  • Initial support for Wi-Fi extender #12784
  • Rule event support as JSON payload #12496
  • MQTT minimum password length restriction in GUI #12553
  • ESP32 Berry partition manager #12465
  • ESP32 Berry class webclient for HTTP/HTTPS requests
  • ESP32 Berry support for I2S audio mp3 playback
  • ESP32 Berry support for vararg
  • ESP32 Berry support for Curve 25519 EC crypto
  • ESP32 Berry support for ESP32/ESP32S2 DAC gpio
  • ESP32 Berry support for Serial
  • ESP32 Berry print stack trace when exception, more detailed with line numbers if #define USE_BERRY_DEBUG
  • ESP32 support for (Yeelight) Mi Desk Pro using binary tasmota32solo1.bin
  • ESP32-S2 support for GPIOs
  • ESP32 add GPIO 6/7/8/11 to template and remove GPIO 28-31 (remapping so backwards compatible)
  • ESP32 crash recorder Status 12 for ESP32/ESP32-S2/ESP32-C3, supporting Esp-idf 3.3/4.4

Breaking Changed

  • ESP32 Light and Versatile Graphics Library (LVGL) updated to v8.0.2

Changed

  • Move firmware binaries to https://github.com/arendst/Tasmota-firmware/tree/main/release-firmware
  • Removed command EnergyReset as it is replaced by new commands
  • IRremoteESP8266 library from v2.7.18 to v2.7.20
  • NeoPixelBus library from v2.6.3 to v2.6.7
  • Message Upload buffer miscompare into Not enough space
  • Command DisplayDimmer has now range 0..100 instead of 0..15
  • Speed up initial GUI console refresh
  • Enable UFILESYS, GUI_TRASH_FILE and GUI_EDIT_FILE for any device compiled with more than 1M flash size
  • Supported sensor driver range extended from 96 to 128
  • Relax NTP poll if no ntpserver can be resolved by DNS
  • Shelly EM template needs to use GPIO ADE7953_IRQ 2
  • Make Sonoff L1 MusicSync persistent #12008
  • Simplified configuration for ir-full and removal of tasmota-ircustom #12428
  • Refactor platformio #12442
  • Allow buttons to work in AP normal mode #12518
  • Enable Ping and rule features for any device compiled with more than 1M flash size #12539
  • Replace spaces by hyphens in final hostname #12710
  • Default disable CORS for enhanced security and provide user compile option #define USE_CORS #12827
  • Prometheus: All metrics are prefixed with tasmota_ #12842 Memory metrics have been cleaned up to work consistently between ESP8266 and ESP32 The device name is reported as an info metric
  • ESP32 core library from v1.0.6 to v1.0.7.4
  • ESP32 Ethernet Phy Type information to IDF v3+
  • ESP32 internal sensor driver id moved from 87 to 127
  • ESP32 disable PSRAM on unsupported hardware
  • ESP32 remove GPIO initialization to INPUT from not used GPIOs to allow JTAG support
  • ESP32 M5 Stack Core2 uses UNIVERSAL_DISPLAY with enabled LVGL as default now
  • ESP32 minimum PWM Frequency lowered to 2Hz #13123
  • ESP32 shrinked Webcam build, uses now USE_TASMOTA_DISCOVERY #13148
  • ESP32 Memory display to exclude IRAM (i.e. less by 40-50KB) #13294

Fixed

  • Sonoff L1 (lite) smoother color transitions
  • DDS238-2 wrong reactive power value #12283
  • NO VALID JSON regression from may 4th #12440
  • Telegram response decoding stopped working after 20210621 and exception on long result message #12451
  • Neopool compile error on DEBUG_TASMOTA_SENSOR #12464
  • Scripter and Display MQTT errors due to MQTT_DATA move to String #12525
  • Scripter moving average and sml input validation #12541
  • Zigbee Hue angle encoding #12545
  • Exception 28 when unable to send MQTT message and a topic name without a slash '/' #12555
  • Wi-Fi initial setup workaround for 11n only routers #12566
  • Discovery fails when using %hostname% in a topic #12710
  • Neopool communication error #12813
  • Shelly Dimmer 2 Energy usage #12815
  • WDT reset on shutters with stepper motors during deceleration #12849
  • Negative power values for ADE7953 based devices like Shelly EM #12874
  • Unable to disable MusicSync mode on Sonoff L1 Lite regression from 9.3.0 #12930
  • Wiegand support for keypad zero key in single key mode using SetOption124 1 #12960
  • Hass and Tasmota discovery prefix topic notifications #12972
  • OpenTherm invalid JSON #13028
  • MQTT TLS related connection timing errors #13033
  • Restore functionality as documented when both GPIO_LED1 and GPIO_LED2 are used regression from v8.5.0 #13368
  • ESP32 core v2.0.0 setting hostname
  • ESP32-C3 settings layout for configuration backup and restore
  • ESP32-Solo OTA upgrade
  • ESP32 Webcam add boundary marker before sending mjpeg image #12376
  • ESP32 Berry button handlers and error messages #12521
  • ESP32 do not use chip temperature sensor as global temperature if external temperature sensor is used #12630
  • ESP32 buzzer in PWM mode exception #12717
  • ESP32 crash when PSRAM is absent and BOARD_HAS_PSRAM set #13037

v9.5.0

2 years 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. 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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/)

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.

Support of Core versions before 2.7.1 has 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 only. Support for WPS and SmartConfig has been removed.

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-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.
  • tasmota-minimal.bin = The Minimal version allows intermediate OTA uploads to support larger versions and does NOT change any persistent parameter for 1M+ flash. This version should NOT be used for initial installation.

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 based

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. RECOMMENDED RELEASE BINARY
  • tasmota32_8M.bin = The Tasmota version with most drivers including additional sensors and KNX for 8M+ flash.
  • tasmota32_16M.bin = The Tasmota version with most drivers including additional sensors and KNX for 16M+ 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-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-display.bin = The Display version without Energy Monitoring but adds display support for 4M+ flash.
  • tasmota32-webcam.bin = The Webcam version adds webcam support for 4M+ flash.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support for 4M+ flash.
  • tasmota32-odroidgo.bin = The Odroid-Go version is specifically tailored to Odroid_go hardware for 8M+ flash.
  • tasmota32-core2.bin = The Core2 version is specifically tailored to M5Stack Core2 hardware for 8M+ 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 http://ota.tasmota.com/tasmota32/release/tasmota32.bin

Additional information

List of embedded modules.

Complete list of available feature and sensors.

Changelog v9.5.0 Michael (Rossi)

Added

  • Command Status0 providing all status information on a single line
  • Command TuyaSend5 for hex string #12211
  • Command MqttWifiTimeout 100..20000 to control MQTT Wi-Fi connection timeout default set to 200 mS #12222
  • Commands Color2 and Dimmer4 to allow retaining brightness ratio between white and color channels when setting dimmer for linked lights #12072
  • Extend command Wifi with Wi-Fi Mode Control #12292
  • Defines USER_RULE1, USER_RULE2 and USER_RULE3 to store rules at compile time
  • Define USER_BACKLOG to store commands at compile time to be executed at firmware load or when executing command reset
  • Support for optional Template JSON fieldpair "CMND":"<any template related command>|<any template related command>|..." #11788
  • ESP32 pulldown buttons Button_d and Button_id and switches Switch_d #10814
  • Support for MQTT using Azure IoT Hub by Kevin Saye #11906
  • Make Telegram command TmState persistent #11965
  • Zigbee binary supporting cc25xx hardware on ESP8266 4M flash hardware #11872
  • Zigbee firmware for Tube's Zigbee coordinator based on EFR32 and ESP32
  • Zigbee firmware 6.7.9 for Sonoff ZBBridge
  • LVGL support for 3 buttons as rotary encoder #12035
  • LVGL support for touchscreen #12039
  • LVGL support for PSRAM #12062
  • LVGL support for TrueType fonts via FreeType library #12087
  • LVGL support for PNG images #12148
  • Allow Home Assistant discovery of MCP2300xx output as relay #12037
  • Preliminary support for Esp32C3 - RiscV based
  • Support for voltage and current monitoring when using Shelly dimmer 2 hardware #11988
  • Support for Azure Device Provisioning Service for IoT Hub #12056
  • Show new IP after the Wi-Fi Initial Config #12091
  • Update Sugar Valley Neopool driver #12171
  • Acer projector support #12190
  • I2S and Interrupt GPIO types #12192
  • Update OpenTherm driver #12195
  • Support for BM8563 RTC chip (I2C) found in M5Stack Core2 and M5StickC #12199

Changed

  • IRremoteESP8266 library from v2.7.16 to v2.7.18
  • NeoPixelBus library from v2.6.1.4 to v2.6.3 stage
  • Shelly Dimmer 1 and 2 stm32 firmware from v51.5 to v51.6
  • Allow longer MQTT response messages by removing fixed memory buffer with size 1040 to heap allocated buffer
  • Command Timers layout of JSON message changed to single line
  • Command Gpio layout of JSON message changed to single line
  • Command Modules layout of JSON message changed to single line
  • ESP32 increase log buffer from 4k to 6k to support longer messages
  • Move Settings from DRAM to heap
  • Refactor platformio configurations by Jason2866
  • WifiManager save Wi-Fi configuration from settings, do it only once #12242
  • Improving SI7021 reading reliability by adjusting timers #12256
  • Refactor ESP32 partition selection, now via boards #12257
  • Use correct template for Home Assistant light #12317

Fixed

  • Wrong flash size detection when saving Zigbee device information on ESP8266 #11870
  • Prometheus metrics parse error on DS18x20 #11931
  • DS18x20 name search id #11958
  • Avoid erasing of Zigbee data if zigbee is not started #11961
  • Zigbee XModem retries #11967
  • Teleinfo standard mode and blacklist feature crash #11991
  • ESP32 Hue light #12005
  • Map received CCT channels back in DevGroups #12044
  • Increase TLS minimum stack thunk to 3800 bytes #12063
  • Delay discovery of PZEM sensors #12076
  • PING race condition breaks JSON in rule #12106
  • Support Tuya powermeter >6500W #12115
  • Zigbee max end-device #12159
  • Prevent keep state MCP230xx output fast toggle on reboot #12264
  • Tuya data type 2 read as 32 bit integer (instead of 16 bit) #12282

Noted

  • ESP32 single core tasmota32solo1.bin binary can only be uploaded using the GUI as OTA upload will trigger the watchdog timer

v9.4.0

3 years 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. 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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/)

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.

Support of Core versions before 2.7.1 has been removed.

Support of TLS

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

Initial configuration tools

For initial configuration this release supports Webserver based WifiManager or Serial based command interface only. Support for WPS and SmartConfig has been removed.

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. RECOMMENDED RELEASE BINARY
  • tasmota-BG.bin to tasmota-TW.bin = The Tasmota version in different languages.
  • tasmota-lite.bin = The Lite version without most drivers and sensors.
  • tasmota-knx.bin = The Knx version without some features but adds KNX support.
  • tasmota-sensors.bin = The Sensors version adds more useful sensors.
  • tasmota-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features.
  • tasmota-display.bin = The Display version without Energy Monitoring but adds display support.
  • tasmota-zbbridge.bin = The dedicated Sonoff Zigbee Bridge version.
  • tasmota-minimal.bin = The Minimal version allows intermediate OTA uploads to support larger versions and does NOT change any persistent parameter. This version should NOT be used for initial installation.

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

The binaries can be downloaded from either https://github.com/arendst/Tasmota/tree/release-firmware or http://ota.tasmota.com/tasmota/release. The latter links can be used for OTA upgrades too like OtaUrl http://ota.tasmota.com/tasmota/release/tasmota.bin.gz

ESP32 based

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

  • tasmota32.bin = The Tasmota version with most drivers including additional sensors and KNX. RECOMMENDED RELEASE BINARY
  • tasmota32solo1.bin = The Tasmota version with most drivers including additional sensors and KNX for single core ESP32.
  • tasmota32-BG.bin to tasmota32-TW.bin = The Tasmota version in different languages.
  • tasmota32-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features.
  • tasmota32-display.bin = The Display version without Energy Monitoring but adds display support.
  • tasmota32-webcam.bin = The Webcam version adds webcam support.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support.
  • tasmota32-odroidgo.bin = The Odroid-Go version is specifically tailored to Odroid_go hardware.
  • tasmota32-core2.bin = The Core2 version is specifically tailored to M5Stack Core2 hardware.

The binaries can be downloaded from either https://github.com/arendst/Tasmota/tree/release-firmware or http://ota.tasmota.com/tasmota32/release. The latter links can be used for OTA upgrades too like OtaUrl http://ota.tasmota.com/tasmota32/release/tasmota32.bin

List of embedded modules.

Complete list of available feature and sensors.

Changelog v9.4.0 Leslie

Added

  • Command Sensor80 1 <0..7> to control MFRC522 RFID antenna gain from 18dB (0) to 48dB (7) #11073
  • Command SerialBuffer 256..520 to change hardware serial receive buffer size from default (256) to max local buffer size (520) #11448
  • Command SetOption126 1 to enable DS18x20 arithmetic mean over teleperiod for JSON temperature based on #11472
  • Command Backlog0 to allow execution of following commands without delay
  • Command TuyaTempSetRes 0..3 to control Tuya Temperature Set Resolution #11781
  • Command Wifi 0/1 for ESP8266 to turn wifi Off and On. When wifi is Off it is always returned On after a restart except for a wake-up from deepsleep #11839
  • Commands MqttKeepAlive 1..100 to set Mqtt Keep Alive timer (default 30) and MqttTimeout 1..100 to set Mqtt Socket Timeout (default 4) #5341
  • Commands DisplayType to select sub-modules where implemented and DisplayInvert to select inverted display where implemented
  • Support for SML VBUS #11125
  • Support for NEC and OPTOMA LCD/DLP Projector serial power control by Jan Bubík #11145
  • Support for XPT2046 touch screen digitizer on ILI9341 display by nonix #11159
  • Support for zigbee lumi.sensor_wleak #11200
  • Support for dummy energy monitor using user values set by commands VoltageSet, CurrentSet, PowerSet and FrequencySet. Enable by selecting any GPIO as Option A2 #10640
  • Support for CSE7761 energy monitor as used in ESP32 based Sonoff Dual R3 Pow #10793
  • Support for Frequency monitoring and zero-cross detection on CSE7761 (Sonoff Dual R3)
  • Support for TM1638 seven segment display by Ajith Vasudevan #11031
  • Support for MAX7219 seven segment display by Ajith Vasudevan #11387
  • Support for MPU6886 on primary or secondary I2C bus
  • Support for multiple CCS811 sensors with baseline control (USE_CCS811_V2) by clanganke #10858
  • Allow MCP230xx pinmode from output to input #11104
  • Berry improvements #11163
  • Extent compile time SetOptions support #11204
  • Tasmota discovery as alternative to Home Assistant discovery using define USE_TASMOTA_DISCOVERY
  • Optional GUI file editor enabled with define GUI_EDIT_FILE by barbudor #11668
  • Initial support for universal display driver UDisplay by Gerhard Mutz. Enable by selecting any GPIO as Option A3 #11665
  • ESP32 Extent BLE #11212
  • ESP32 support for WS2812 hardware driver via RMT or I2S
  • ESP32 support for secondary I2C controller
  • ESP32 support for internal Hall Effect sensor connected to both GPIO36 and GPIO39 only
  • ESP32 support for LVGL 7.11 with Berry binding by Stephan Hadinger #11789

Breaking Changed

  • ESP32 partition layout changed to accomodate more file space on most and more code space on core2 and odroid-go #11746

Changed

  • TasmotaSerial library from v3.2.0 to v3.3.0
  • PubSubClient library from EspEasy v2.7.12 to Tasmota v2.8.12
  • IRremoteESP8266 library from v2.7.15 to v2.7.16
  • ESP32 core library from v1.0.5-rc6 to v1.0.6
  • TuyaMcu dimmer timeout #11121
  • Rename epaper 42 commands #11222
  • DeepSleep announcement topic #11223
  • Limit number of relay/button columns in GUI to 8 #11546
  • ADC range result from int to float using command FreqRes for decimal resolution selection #11545
  • Removed overtemp detection on external energy monitoring devices #11628
  • Redesigned initial GUI wifi configuration by Adrian Scillato #11693
  • Redesigned GUI by moving non-configuration buttons from Configuration to new submenu Consoles
  • In tasmota-sensors.bin enabled support for VL53L0X and disabled TSL2561 #11711
  • Add HLW8012/BL0937 average pulse calculation by Alex Lovett #11722
  • Zigbee refactored storage for device configuration and device last known data #11838

Fixed

  • PN532 on ESP32 Serial flush both Tx and Rx buffers #10910
  • Light scheme related color changes #11041
  • Refactor acceleration function for shutter stepper and servo #11088
  • LM75AD detection on different addresses #11096
  • Timer loop when console is scrolled up regression from v9.3.0 #11108
  • Display exception when no file system is present #11125
  • Scripter and SML fixes #11150
  • Zigbee exception when bad frame is received #11192
  • ESP32 flash script for Odroid and Core2 #11227
  • ESP32 WS2812 bitbang support #11248
  • DS18x20 driver timing issue #11270
  • Alexa discovery in hue emulation #11415
  • HC-SR04 on ESP32 release serial interface if not used #11507
  • Alexa discovery for ZBBridge #11576
  • Telegram chat id incorrect size #11660
  • KNX energy yesterday #11718
  • Command Power should not reset pulsetime #11805
  • Teleperiod rule handling regression from v9.3.1.2 #11851

Noted

  • ESP32 single core tasmota32solo1.bin binary can only be uploaded using the GUI as OTA upload will trigger the watchdog timer

v9.3.1

3 years 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. 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/)
  5. Migrate to Tasmota 7.2.0 (http://ota.tasmota.com/tasmota/release-7.2.0/)

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

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

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

  1. Migrate to Tasmota 9.1 (http://ota.tasmota.com/tasmota/release-9.1.0/)

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.

Support of Core versions before 2.7.1 has been removed.

Support of TLS

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

Initial configuration tools

For initial configuration this release supports Webserver based WifiManager or Serial based command interface only. Support for WPS and SmartConfig has been removed.

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. RECOMMENDED RELEASE BINARY
  • tasmota-BG.bin to tasmota-TW.bin = The Tasmota version in different languages.
  • tasmota-lite.bin = The Lite version without most drivers and sensors.
  • tasmota-knx.bin = The Knx version without some features but adds KNX support.
  • tasmota-sensors.bin = The Sensors version adds more useful sensors.
  • tasmota-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features.
  • tasmota-display.bin = The Display version without Energy Monitoring but adds display support.
  • tasmota-zbbridge.bin = The dedicated Sonoff Zigbee Bridge version.
  • tasmota-minimal.bin = The Minimal version allows intermediate OTA uploads to support larger versions and does NOT change any persistent parameter. This version should NOT be used for initial installation.

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

The attached binaries can also be downloaded from http://ota.tasmota.com/tasmota/release. The links can be used for OTA upgrades too like OtaUrl http://ota.tasmota.com/tasmota/release/tasmota.bin.gz

ESP32 based

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

  • tasmota32.bin = The Tasmota version with most drivers. RECOMMENDED RELEASE BINARY
  • tasmota32-BG.bin to tasmota32-TW.bin = The Tasmota version in different languages.
  • tasmota32-lite.bin = The Lite version without most drivers and sensors.
  • tasmota32-knx.bin = The Knx version without some features but adds KNX support.
  • tasmota32-sensors.bin = The Sensors version adds more useful sensors.
  • tasmota32-ir.bin = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features.
  • tasmota32-display.bin = The Display version without Energy Monitoring but adds display support.
  • tasmota32-webcam.bin = The Webcam version adds webcam support.
  • tasmota32-bluetooth.bin = The Bluetooth version adds BLE support.
  • tasmota32-odroidgo.bin = The Odroid-Go version is specifically tailored to Odroid_go hardware.
  • tasmota32-core2.bin = The Core2 version is specifically tailored to M5Stack Core2 hardware.

The attached binaries can also be downloaded from http://ota.tasmota.com/tasmota32/release. The links can be used for OTA upgrades too like OtaUrl http://ota.tasmota.com/tasmota32/release/tasmota32.bin

List of embedded modules.

Complete list of available feature and sensors.

Changelog v9.3.1 Kenneth

Added

  • Animate PWM dimmer brightness LEDs during transitions and with variable brightness #11076
  • Commands StateRetain and InfoRetain #11084

Changed

  • Remove the need to start filenames with a slash (/) in Ufs commands
  • Removed command VirtualCT as synonym for SetOption106 #11049

Fixed

  • Web request accepts wrong password #11039
  • Ili1942 driver #11046
  • ESP32 Mi32 driver #11048
  • Shutter driver #11055
  • TM1637 driver now needs TM1637 CLK and TM1637 DIO to enable #11057
  • Sml driver #11082
  • Ezo drivers #11083

Changelog v9.3.0 Kenneth

Added

  • Command CTRange to specify the visible CT range the bulb is capable of #10311
  • Command L1MusicSync <0|Off>|<1|On>|<2|Toggle>, 1..10, 1..100> to control Sonoff L1 Music Sync mode sensitivity and speed #10722
  • Command RuleTimer0 to access all RuleTimers at once #10352
  • Command Speed2 to control a once off fade #10741
  • Command VirtualCT to simulate or fine tune CT bulbs with 3,4,5 channels #10311
  • Command SetOption40 0..250 to disable button functionality if activated for over 0.1 second re-introduced
  • Command SetOption43 1..255 to control Rotary step #10407
  • Command SetOption118 1 to move ZbReceived from JSON message and into the subtopic replacing "SENSOR" default #10353
  • Command SetOption119 1 to remove the device addr from json payload, can be used with zb_topic_fname where the addr is already known from the topic #10355
  • Zigbee command SetOption120 1 or ZbEndpointTopic 1 to add the zigbee endpoint as suffix in topic when using SetOption89 1
  • Zigbee command ZbScan to do an energy scan on each radio channel
  • Commands ChannelRemap, MultiPWM, AlexaCTRange, PowerOnFade, PWMCT, WhiteBlend and VirtualCT as synonyms for SetOption37, 68, 82, 91, 92, 105 and 106
  • Commands ZbNameKey, ZbDeviceTopic, ZbNoPrefix, ZbEndpointSuffix, ZbNoAutoBind and ZbNameTopic as synonyms for SetOption83, 89, 100, 101, 110 and 112
  • Commands ZbNoAutoBind, ZbReceivedTopic and ZbOmitDevice as synonyms for SetOption116, 118 and 119
  • Commands BuzzerActive and BuzzerPwm as synonyms for SetOption67 and 111
  • Filesystem commands Ufs, UfsType, UfsSize, UfsFree, UfsDelete, UfsRename and UfsRun
  • Support for filesystem autoexec.bat to execute sequential commands like backlog
  • Milliseconds to console output #10152
  • Gpio Option_a1 enabling PWM2 high impedance if powered off as used by Wyze bulbs #10196
  • Rotary No Pullup GPIO selection Rotary A/B_n #10407
  • BSSID and Signal Strength Indicator to GUI wifi scan result #10253
  • Support for P9813 RGB Led MOSFET controller #10104
  • Support for GPIO option selection
  • Support for FTC532 8-button touch controller by Peter Franck #10222
  • Support for BS814A-2 8-button touch buttons by Peter Franck #10447
  • Support for up to 4 I2C SEESAW_SOIL Capacitance & Temperature sensors by Peter Franck #10481
  • Support for TOF10120 time of flight sensor by Cyril Pawelko #10190
  • Support for Afrikaans language translations by Christiaan Heerze
  • Support for Frysk language translations by Christiaan Heerze
  • Support for IR inverted leds using #define IR_SEND_INVERTED true #10301
  • Support for disabling 38kHz IR modulation using #define IR_SEND_USE_MODULATION false #10301
  • Support for SPI display driver for ST7789 TFT by Gerhard Mutz #9037
  • Support for TM1637 seven segment display by Ajith Vasudevan #10889
  • Support for time proportioned (#define USE_TIMEPROP) and optional PID (#define USE_PID) relay control #10412
  • Support for 24/26/32/34 bit RFID Wiegand interface (D0/D1) by Sigurd Leuther #3647
  • Support for SM2135 current selection using GPIO SM2135 DAT index #10634
  • Support for Sugar Valley NeoPool Controller by Norbert Richter #10637
  • Support for Device Groups Device Map #10898
  • Support for Eastron SDM72D-M three phase 100A Modbus energy meter #10862
  • Support for ESP32 Module 3 Odroid Go 16MB binary tasmota32-odroidgo.bin #8630
  • Support for ESP32 Module 5 Wireless Tag Eth01 #9496
  • Support for ESP32 Module 7 M5stack core2 16MB binary tasmota32-core2.bin #10635
  • Support for Berry language on ESP32
  • Support rotary encoder on Shelly Dimmer #10407
  • Support character # to be replaced by space-character in command Publish topic #10258
  • Support trailing silence in buzzer tune #10694
  • Rule trigger string comparisons for EndsWith $>, StartsWith $< and Contains $| #10538
  • SPI display driver SSD1331 Color oled by Jeroen Vermeulen #10376
  • Compile time option USE_MQTT_TLS_DROP_OLD_FINGERPRINT to drop old (less secure) TLS fingerprint
  • ESP8266 Fallback to *.bin.gz binary when OTA upload of *.bin binary fails

Breaking Changed

  • ESP32 switch from default SPIFFS to default LittleFS file system loosing current (zigbee) files
  • Replaced MFRC522 13.56MHz rfid card reader GPIO selection from SPI CS by RC522 CS
  • Replaced NRF24L01 GPIO selection from SPI CS by NRF24 CS and SPI DC by NRF24 DC
  • Replaced ILI9341 GPIO selection from SPI CS by ILI9341 CS and SPI DC by ILI9341 DC
  • Replaced ST7789 GPIO selection from SPI CS by ST7789 CS and SPI DC by ST7789 DC
  • Replaced ILI9488 GPIO selection from SPI CS by ILI9488_CS
  • Replaced EPaper29 GPIO selection from SPI CS by EPaper29 CS
  • Replaced EPaper42 GPIO selection from SPI CS by EPaper42 CS
  • Replaced SSD1351 GPIO selection from SPI CS by SSD1351 CS
  • Replaced RA8876 GPIO selection from SPI CS by RA8876 CS