2023-01-24 09:19:46 +00:00
< picture >
2023-01-24 09:27:47 +00:00
< source media = "(prefers-color-scheme: dark)" srcset = "./tools/logo/TASMOTA_FullLogo_Vector_White.svg" >
< img alt = "Logo" src = "./tools/logo/TASMOTA_FullLogo_Vector.svg" align = "right" height = "76" >
2023-01-24 09:19:46 +00:00
< / picture >
2019-05-22 13:56:47 +01:00
# RELEASE NOTES
2018-08-28 16:34:51 +01:00
## Migration Information
2019-11-13 09:17:52 +00:00
2021-02-12 14:02:55 +00:00
**This version removes support for direct migration from versions before v8.1.0 (Doris)**
2021-02-10 13:45:57 +00:00
2022-02-07 14:13:16 +00:00
See [migration path ](https://tasmota.github.io/docs/Upgrading#migration-path ) for instructions how to migrate to a major version.
2018-08-28 16:34:51 +01:00
2021-10-25 19:44:16 +01:00
**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.
2022-02-07 14:13:16 +00:00
Pay attention to the following version breaks due to dynamic settings updates:
2018-08-28 16:34:51 +01:00
1. Migrate to **Sonoff-Tasmota 3.9.x**
2. Migrate to **Sonoff-Tasmota 4.x**
2022-08-31 14:51:21 +01:00
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
2022-02-12 17:27:01 +00:00
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)
2019-12-23 16:41:36 +00:00
2019-12-23 13:05:26 +00:00
--- Major change in parameter storage layout ---
2019-12-23 16:41:36 +00:00
2022-02-12 17:27:01 +00:00
6. Migrate to **Tasmota 8.5.1** (http://ota.tasmota.com/tasmota/release-8.5.1/tasmota.bin)
2019-12-20 15:22:49 +00:00
2020-10-03 11:08:43 +01:00
--- Major change in internal GPIO function representation ---
2020-09-30 14:44:37 +01:00
2022-02-12 17:27:01 +00:00
7. Migrate to **Tasmota 9.1** (http://ota.tasmota.com/tasmota/release-9.1.0/tasmota.bin.gz)
8. Upgrade to **latest release** (http://ota.tasmota.com/tasmota/release/tasmota.bin.gz)
2020-09-30 14:44:37 +01:00
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** .
2019-12-25 11:59:21 +00:00
2019-10-19 13:55:12 +01:00
## Supported Core versions
2024-01-20 10:46:51 +00:00
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.
2019-11-13 09:17:52 +00:00
2024-04-15 11:26:48 +01:00
This release will be supported from ESP32/Arduino library Core version **3.0.0** .
2022-02-07 13:53:45 +00:00
2024-04-15 11:26:48 +01:00
Support of ESP8266 Core versions before 2.7.6 and ESP32 Core versions before 3.0.0 have been removed.
2019-09-25 14:44:41 +01:00
2019-10-17 17:09:23 +01:00
## Support of TLS
2019-11-13 09:17:52 +00:00
2021-06-14 10:28:48 +01:00
In addition to TLS using fingerprints now also user supplied CA certs, AWS IoT and Azure IoT is supported. Read [full documentation ](https://tasmota.github.io/docs/AWS-IoT )
2019-03-19 14:37:21 +00:00
2019-10-22 15:34:25 +01:00
## Initial configuration tools
2019-11-13 09:17:52 +00:00
2022-02-07 13:53:45 +00:00
For initial configuration this release supports Webserver based **WifiManager** or **Serial** based command interface.
2018-08-28 16:34:51 +01:00
2021-07-13 10:40:13 +01:00
## Initial installation
2022-02-07 13:53:45 +00:00
Easy initial installation of Tasmota can be performed using the [Tasmota WebInstaller ](https://tasmota.github.io/install/ ).
2021-07-13 10:40:13 +01:00
2018-10-31 13:36:28 +00:00
## Provided Binary Downloads
2019-11-13 09:17:52 +00:00
2021-02-12 14:02:55 +00:00
### ESP8266 or ESP8285 based
2024-01-20 10:46:51 +00:00
The following binary downloads have been compiled with ESP8266/Arduino library core version **2.7.6** .
2018-10-31 13:36:28 +00:00
2021-06-13 14:27:02 +01:00
- **tasmota.bin** = The Tasmota version with most drivers for 1M+ flash. **RECOMMENDED RELEASE BINARY**
2023-01-11 09:31:39 +00:00
- **tasmota-4M.bin** = The Tasmota version with most drivers and filesystem for 4M+ flash.
2022-08-18 12:52:39 +01:00
- **tasmota-AD.bin** to **tasmota-VN.bin** = The Tasmota version in different languages for 1M+ flash.
2021-06-13 14:27:02 +01:00
- **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.
2019-03-19 14:37:21 +00:00
2021-02-12 14:02:55 +00:00
Above binaries are also available as gzipped version allowing faster uploads.
2021-06-14 10:28:48 +01:00
Latest released binaries can be downloaded from
2024-03-15 11:56:22 +00:00
- https://github.com/arendst/Tasmota-firmware/tree/firmware/release-firmware
2021-06-14 10:28:48 +01:00
- http://ota.tasmota.com/tasmota/release
Historical binaries can be downloaded from
2023-12-12 15:20:06 +00:00
- http://ota.tasmota.com/tasmota/release-13.3.0
2021-06-14 10:28:48 +01:00
The latter links can be used for OTA upgrades too like ``OtaUrl http://ota.tasmota.com/tasmota/release/tasmota.bin.gz``
2021-02-12 14:02:55 +00:00
2024-04-15 11:26:48 +01:00
### ESP32, ESP32-C2, ESP32-C3, ESP32-C6, ESP32-S2 and ESP32-S3 based
The following binary downloads have been compiled with ESP32/Arduino library core version **3.0.0** .
2021-02-12 14:02:55 +00:00
2021-06-13 14:27:02 +01:00
- **tasmota32.bin** = The Tasmota version with most drivers including additional sensors and KNX for 4M+ flash. **RECOMMENDED RELEASE BINARY**
2024-04-15 11:26:48 +01:00
- **tasmota32xy.bin** = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C2/C3/C6/S2/S3 and 4M+ flash.
- **tasmota32xycdc.bin** = The Tasmota version with most drivers including additional sensors and KNX for ESP32-C2/C3/C6/S2/S3 with serial over embedded USB CDC only and 4M+ flash.
2021-06-13 14:27:02 +01:00
- **tasmota32solo1.bin** = The Tasmota version with most drivers including additional sensors and KNX for single core ESP32 and 4M+ flash.
2022-08-18 12:52:39 +01:00
- **tasmota32-AD.bin** to **tasmota32-VN.bin** = The Tasmota version in different languages for 4M+ flash.
2022-06-07 13:35:28 +01:00
- **tasmota32-bluetooth.bin** = The Bluetooth version adds BLE support for 4M+ flash.
2021-06-13 14:27:02 +01:00
- **tasmota32-display.bin** = The Display version without Energy Monitoring but adds display support for 4M+ flash.
2022-06-07 13:35:28 +01:00
- **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.
2021-10-13 09:46:43 +01:00
- **tasmota32-lvgl.bin** = The LVGL version adds Light and Versatile Graphics Library (LVGL) display support for 4M+ flash.
2022-06-07 13:35:28 +01:00
- **tasmota32-nspanel.bin** = The Sonoff NSPanel Smart Scene Wall Switch version with HASPmota display support.
2021-06-13 14:27:02 +01:00
- **tasmota32-webcam.bin** = The Webcam version adds webcam support for 4M+ flash.
2022-06-07 13:35:28 +01:00
- **tasmota32-zbbridgepro.bin** - The Sonoff Zigbee Bridge Pro version with CC2652P firmware load support.
2021-02-12 14:02:55 +00:00
2021-06-14 10:28:48 +01:00
Latest released binaries can be downloaded from
2024-03-15 11:56:22 +00:00
- https://github.com/arendst/Tasmota-firmware/tree/firmware/release-firmware
2022-12-16 09:20:51 +00:00
- https://ota.tasmota.com/tasmota32/release
2021-06-14 10:28:48 +01:00
Historical binaries can be downloaded from
2023-12-12 15:20:06 +00:00
- https://ota.tasmota.com/tasmota32/release-13.3.0
2021-06-14 10:28:48 +01:00
2022-12-16 09:20:51 +00:00
The latter links can be used for OTA upgrades too like ``OtaUrl https://ota.tasmota.com/tasmota32/release/tasmota32.bin``
2021-06-14 10:28:48 +01:00
## Additional information
2020-09-09 11:44:30 +01:00
2019-12-01 11:56:05 +00:00
[List ](MODULES.md ) of embedded modules.
2019-11-22 21:21:23 +00:00
[Complete list ](BUILDS.md ) of available feature and sensors.
2018-08-29 15:05:27 +01:00
2024-04-15 11:26:48 +01:00
## Changelog v13.4.1.1
2021-02-27 15:58:50 +00:00
### Added
2024-04-15 11:26:48 +01:00
- Command ``Wifi 6`` to enable 11ax on ESP32
2024-04-03 10:47:38 +01:00
- Command ``PowerLock`` to disable power control of selected outputs [#21081 ](https://github.com/arendst/Tasmota/issues/21081 )
2024-03-27 08:38:36 +00:00
- Support for calculated heat index if temperature and humidity is available with ``#define USE_HEAT_INDEX`` [#4771 ](https://github.com/arendst/Tasmota/issues/4771 )
2024-03-29 13:30:31 +00:00
- Support for LoRa and single channel EU863-870 LoRaWanBridge [#17790 ](https://github.com/arendst/Tasmota/issues/17790 )
- Support for AMS5915/AMS6915 temperature and pressure sensors [#20814 ](https://github.com/arendst/Tasmota/issues/20814 )
2024-03-27 08:38:36 +00:00
- Support for LWT messages in TasMesh [#20392 ](https://github.com/arendst/Tasmota/issues/20392 )
2024-03-29 13:30:31 +00:00
- Support IR data larger than 64 bits [#20831 ](https://github.com/arendst/Tasmota/issues/20831 )
2024-03-23 14:20:22 +00:00
- Support for MCP23S08 [#20971 ](https://github.com/arendst/Tasmota/issues/20971 )
- Support for ESP32-S3 120Mhz [#20973 ](https://github.com/arendst/Tasmota/issues/20973 )
2024-03-29 13:30:31 +00:00
- Support Azure iothub direct method [#21013 ](https://github.com/arendst/Tasmota/issues/21013 )
2024-04-01 13:37:42 +01:00
- Support for Domoticz non-persistent ``DzIdx5`` to ``DzIdx32`` and disabling DOMOTICZ_OUT_TOPIC subscribe using command ``DzIdx0 0`` [#21019 ](https://github.com/arendst/Tasmota/issues/21019 )
2024-03-29 13:30:31 +00:00
- Support SPI GPIO configuration for Universal Touch Screen [#21025 ](https://github.com/arendst/Tasmota/issues/21025 )
2024-03-23 14:20:22 +00:00
- Zigbee support for attributes of type `uint48` used by energy monitoring [#20992 ](https://github.com/arendst/Tasmota/issues/20992 )
2024-03-29 13:30:31 +00:00
- QMC5883l check for overflow and scale reading [#20643 ](https://github.com/arendst/Tasmota/issues/20643 )
2024-03-01 09:23:51 +00:00
- Berry explicit error log when memory allocation fails [#20807 ](https://github.com/arendst/Tasmota/issues/20807 )
- Berry `path.rename()` [#20840 ](https://github.com/arendst/Tasmota/issues/20840 )
2024-03-14 15:47:10 +00:00
- Berry `string.startswith` , `string.endswith` and `%q` format [#20909 ](https://github.com/arendst/Tasmota/issues/20909 )
2024-03-27 08:38:36 +00:00
- Berry `close()` to class `serial` [#21042 ](https://github.com/arendst/Tasmota/issues/21042 )
2024-04-05 10:12:33 +01:00
- Berry `flash.current_ota` [#21097 ](https://github.com/arendst/Tasmota/issues/21097 )
2024-02-16 14:04:03 +00:00
- LVGL and HASPmota typicons font [#20742 ](https://github.com/arendst/Tasmota/issues/20742 )
2024-03-14 15:47:10 +00:00
- LVGL `lv.draw_label_dsc` and `lv_bar.get_indic_area` [#20936 ](https://github.com/arendst/Tasmota/issues/20936 )
2024-03-09 12:32:53 +00:00
- HASPmota `p<x>b<y>.delete` to delete an object [#20735 ](https://github.com/arendst/Tasmota/issues/20735 )
- HASPmota improve arc and img [#20894 ](https://github.com/arendst/Tasmota/issues/20894 )
2024-03-18 10:11:12 +00:00
- HASPmota support for scale, percentages [#20974 ](https://github.com/arendst/Tasmota/issues/20974 )
2022-10-17 10:25:22 +01:00
### Breaking Changed
2024-03-01 15:52:28 +00:00
- Drop support for old (insecure) fingerprint format [#20842 ](https://github.com/arendst/Tasmota/issues/20842 )
2024-04-12 10:03:48 +01:00
- Removed dedicated touch drivers in favour of Universal Touch driver [#21146 ](https://github.com/arendst/Tasmota/issues/21146 )
2024-04-01 13:37:42 +01:00
- Berry loading .be file does not generated .bec anymore [#21075 ](https://github.com/arendst/Tasmota/issues/21075 )
2024-03-09 12:32:53 +00:00
- LVGL remove embedded typicons font [#20872 ](https://github.com/arendst/Tasmota/issues/20872 )
2024-03-14 15:47:10 +00:00
- LVGL remove `textarea` and `spinbox` from binaries [#20916 ](https://github.com/arendst/Tasmota/issues/20916 )
2021-04-16 11:05:22 +01:00
2021-02-27 15:58:50 +00:00
### Changed
2024-04-15 11:26:48 +01:00
- ESP32 Framework (Arduino Core) from v2.0.14 to v3.0.0
2024-04-17 09:35:09 +01:00
- ESP32 platform update from 2024.01.12 to 2024.04.12 [#21199 ](https://github.com/arendst/Tasmota/issues/21199 )
2024-03-23 14:20:22 +00:00
- ESP32 LVGL library from v9.0.0 to v9.1.0 [#21008 ](https://github.com/arendst/Tasmota/issues/21008 )
- Refactor Platformio script `post_esp32.py` [#20966 ](https://github.com/arendst/Tasmota/issues/20966 )
2024-04-12 10:03:48 +01:00
- SGP4x Domoticz air quality value from raw to computed [#18880 ](https://github.com/arendst/Tasmota/issues/18880 )
- NeoPool webUI pH alarms (4 & 5) completed [#20743 ](https://github.com/arendst/Tasmota/issues/20743 )
2024-03-01 09:23:51 +00:00
- Prevent shutter MQTT broadcast with activated ShutterLock [#20827 ](https://github.com/arendst/Tasmota/issues/20827 )
2024-03-27 20:38:36 +00:00
- Some `display.ini` to utouch [#21029 ](https://github.com/arendst/Tasmota/issues/21029 )
2024-04-01 13:37:42 +01:00
- KNX format of energy to match specifications [#21074 ](https://github.com/arendst/Tasmota/issues/21074 )
2024-04-06 14:04:05 +01:00
- ESP32 refactored Wifi for ESP32 Core3 release [#21106 ](https://github.com/arendst/Tasmota/issues/21106 )
2024-03-29 12:04:44 +00:00
- ESP32 WiFi phy modes 11n and 11ax represented as HT20, HT40 and HE20 [#19350 ](https://github.com/arendst/Tasmota/issues/19350 )
2024-03-27 08:38:36 +00:00
- berry.exe (pre-compiled for Windows) updated to latest Berry patches [#21024 ](https://github.com/arendst/Tasmota/issues/21024 )
2024-02-14 18:19:24 +00:00
- Berry class `int64` made immutable [#20727 ](https://github.com/arendst/Tasmota/issues/20727 )
2024-02-26 11:22:47 +00:00
- Matter reduce memory usage when reading with wildcards [#20809 ](https://github.com/arendst/Tasmota/issues/20809 )
2024-02-14 18:19:24 +00:00
- LVGL make lv_touch_3_buttons more responsive [#20728 ](https://github.com/arendst/Tasmota/issues/20728 )
2024-03-09 12:32:53 +00:00
- LVGL optimize fonts and add icons [#20880 ](https://github.com/arendst/Tasmota/issues/20880 )
2024-03-10 11:08:30 +00:00
- LVGL improved readability of montserrat-10 [#20900 ](https://github.com/arendst/Tasmota/issues/20900 )
2024-02-16 14:04:03 +00:00
- HASPmota fix and improve demo with pixel-perfect fonts [#20734 ](https://github.com/arendst/Tasmota/issues/20734 )
2024-02-17 14:19:12 +00:00
- HASPmota more attributes [#20744 ](https://github.com/arendst/Tasmota/issues/20744 )
2024-03-04 10:58:46 +00:00
- HASPmota support for spangroup (styled text) [#20852 ](https://github.com/arendst/Tasmota/issues/20852 )
- HASPmota support for led [#20857 ](https://github.com/arendst/Tasmota/issues/20857 )
2024-03-14 15:47:10 +00:00
- HASPmota moved to a distinct library `lv_haspmota` [#20929 ](https://github.com/arendst/Tasmota/issues/20929 )
- HASPmota solidify server-side [#20938 ](https://github.com/arendst/Tasmota/issues/20938 )
2023-07-21 13:35:22 +01:00
2021-02-27 15:58:50 +00:00
### Fixed
2024-03-10 11:08:30 +00:00
- Filesystem save of JSON settings data
2024-04-14 10:43:56 +01:00
- Fade out on CCT bulb with `SO92 1` [#21159 ](https://github.com/arendst/Tasmota/issues/21159 )
2024-02-18 11:41:31 +00:00
- Shutter inverted using internal commands [#20752 ](https://github.com/arendst/Tasmota/issues/20752 )
2024-03-23 14:20:22 +00:00
- TuyaV2 suppressed dimmer updates from MQTT [#20950 ](https://github.com/arendst/Tasmota/issues/20950 )
- Scripter google char memory leak [#20995 ](https://github.com/arendst/Tasmota/issues/20995 )
2024-03-27 08:38:36 +00:00
- Too restrictive checksum checks in Lib_teleinfo [#21033 ](https://github.com/arendst/Tasmota/issues/21033 )
2024-03-27 20:38:36 +00:00
- Color swap option for rgb displaytext [#21049 ](https://github.com/arendst/Tasmota/issues/21049 )
2024-04-05 10:12:33 +01:00
- NeoPool hydrolysis unit for Hidrolife, Bionet and Generic device [#21098 ](https://github.com/arendst/Tasmota/issues/21098 )
2024-02-17 14:19:12 +00:00
- ESP32 PWM activity on unconfigured PWM GPIOs [#20732 ](https://github.com/arendst/Tasmota/issues/20732 )
2024-03-23 14:20:22 +00:00
- BTHome, prep BLE5 [#20989 ](https://github.com/arendst/Tasmota/issues/20989 )
2024-02-29 12:36:08 +00:00
- Berry Memory leak in `import re` [#20823 ](https://github.com/arendst/Tasmota/issues/20823 )
2024-03-01 09:23:51 +00:00
- Berry bug when parsing ternary operator [#20839 ](https://github.com/arendst/Tasmota/issues/20839 )
2024-03-23 14:20:22 +00:00
- Berry walrus with member or index [#20939 ](https://github.com/arendst/Tasmota/issues/20939 )
- Berry walrus bug when assigning to self [#21015 ](https://github.com/arendst/Tasmota/issues/21015 )
2024-02-27 13:16:13 +00:00
- HASPmota PSRAM memory leak [#20818 ](https://github.com/arendst/Tasmota/issues/20818 )
2024-03-09 12:32:53 +00:00
- HASPmota widgets line, btnmatrix, qrcode, bar, checkbox [#20881 ](https://github.com/arendst/Tasmota/issues/20881 )
2024-03-23 14:20:22 +00:00
- HASPmota demo and robotocondensed fonts [#21014 ](https://github.com/arendst/Tasmota/issues/21014 )
2024-04-17 09:35:09 +01:00
- HASPmota dropdown class "options" attribute [#21203 ](https://github.com/arendst/Tasmota/issues/21203 )
2023-12-12 15:20:06 +00:00
2024-01-18 15:32:28 +00:00
### Removed
2024-04-04 16:03:08 +01:00
- Unused `#define MQTT_DATA_STRING` support
2024-04-14 10:43:56 +01:00
- ILI9341 driver replaced with uDisplay [#21169 ](https://github.com/arendst/Tasmota/issues/21169 )
2024-04-15 11:26:48 +01:00
- SSD1306 driver replaced with uDisplay [#21176 ](https://github.com/arendst/Tasmota/issues/21176 )
- SSD1331 driver replaced with uDisplay [#21177 ](https://github.com/arendst/Tasmota/issues/21177 )
- SSH1106 driver replaced with uDisplay [#21183 ](https://github.com/arendst/Tasmota/issues/21183 )
2024-04-17 09:35:09 +01:00
- SSD1351 driver replaced with uDisplay [#21184 ](https://github.com/arendst/Tasmota/issues/21184 )
- ST7789 driver replaced with uDisplay [#21184 ](https://github.com/arendst/Tasmota/issues/21184 )
2024-04-15 11:26:48 +01:00
- Support for ESP32 Arduino Core 2 [#21180 ](https://github.com/arendst/Tasmota/issues/21180 )
2024-03-27 20:38:36 +00:00
- Berry `print "a"` syntax no longer supported [#21048 ](https://github.com/arendst/Tasmota/issues/21048 )
