2019-10-27 11:04:08 +00:00
< img src = "https://github.com/arendst/Tasmota/blob/master/tools/logo/TASMOTA_FullLogo_Vector.svg" alt = "Logo" align = "right" height = "76" / >
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
2020-03-29 22:28:41 +01:00
See [migration path ](https://tasmota.github.io/docs/Upgrading#migration-path ) for instructions how to migrate to a major version. 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**
3. Migrate to **Sonoff-Tasmota 5.14**
2020-11-10 09:39:36 +00:00
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/)
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
2020-11-10 09:39:36 +00:00
6. Migrate to **Tasmota 8.5.1** (http://ota.tasmota.com/tasmota/release-8.5.1/)
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
2020-11-10 09:39:36 +00:00
7. Migrate to **Tasmota 9.1** (http://ota.tasmota.com/tasmota/release-9.1.0/)
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
2020-12-07 11:34:09 +00:00
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.
2019-11-13 09:17:52 +00:00
2020-07-21 10:03:03 +01:00
Support of Core versions before 2.7.1 has 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
2019-10-22 15:34:25 +01:00
For initial configuration this release supports Webserver based **WifiManager** or **Serial** based command interface only. Support for **WPS** and **SmartConfig** has been removed.
2018-08-28 16:34:51 +01:00
2021-07-13 10:40:13 +01:00
## Initial installation
2021-08-08 15:20:49 +01:00
Easy initial installation of Tasmota can be performed using the [Tasmota WebInstaller ](https://arendst.github.io/Tasmota-firmware/ ).
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
2020-12-07 11:34:09 +00:00
The following binary downloads have been compiled with ESP8266/Arduino library core version **2.7.4.9** .
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**
- **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.
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
2021-08-08 15:35:48 +01:00
- https://github.com/arendst/Tasmota-firmware/tree/main/release-firmware
2021-06-14 10:28:48 +01:00
- http://ota.tasmota.com/tasmota/release
Historical binaries can be downloaded from
- http://ota.tasmota.com/tasmota/release-9.5.0
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
### ESP32 based
2021-07-21 12:26:32 +01:00
The following binary downloads have been compiled with ESP32/Arduino library core version **1.0.7.3** .
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**
- **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.
2021-02-12 14:02:55 +00:00
2021-06-14 10:28:48 +01:00
Latest released binaries can be downloaded from
2021-08-08 15:35:48 +01:00
- https://github.com/arendst/Tasmota-firmware/tree/main/release-firmware
2021-06-14 10:28:48 +01:00
- http://ota.tasmota.com/tasmota32/release
Historical binaries can be downloaded from
- http://ota.tasmota.com/tasmota32/release-9.5.0
The latter links can be used for OTA upgrades too like ``OtaUrl http://ota.tasmota.com/tasmota32/release/tasmota32.bin``
## 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
2021-09-27 13:36:19 +01:00
## Changelog v9.5.0.9
2021-02-27 15:58:50 +00:00
### Added
2021-08-08 15:20:49 +01:00
- Release of [Tasmota WebInstaller ](https://arendst.github.io/Tasmota-firmware/ )
2021-09-01 08:42:10 +01:00
- Command ``SetOption2 1`` to enable display of global temperature/humidity/pressure info to JSON sensor message
2021-08-01 16:57:13 +01:00
- Command ``SetOption127 1`` to force Wi-Fi in no-sleep mode even if ``Sleep 0`` is not enabled
2021-08-20 14:54:26 +01:00
- Command ``SetOption128 0|1`` web referer check disabling HTTP API commands if set to 0. Default set to 1 for backward compatibility [#12828 ](https://github.com/arendst/Tasmota/issues/12828 )
2021-09-29 14:33:58 +01:00
- Command ``SetOption129 1`` to enable split total energy results [#13030 ](https://github.com/arendst/Tasmota/issues/13030 )
2021-10-08 10:04:07 +01:00
- Command ``SetOption130 1`` adding heap size (and ESP32 fragmentation) to logging timestamp for debugging
2021-07-14 13:20:50 +01:00
- Command ``SetSensor1..127 0|1`` to globally disable individual sensor driver
2021-09-02 09:56:20 +01:00
- Command ``Subscribe2 ...`` to subscribe to a MQTT topic without appended "/#" [#12858 ](https://github.com/arendst/Tasmota/issues/12858 )
2021-09-02 09:46:29 +01:00
- Command ``WebGetConfig < url > `` if ``#define USE_WEBGETCONFIG`` is enabled to restore/init configuration from external webserver [#13034 ](https://github.com/arendst/Tasmota/issues/13034 )
2021-09-24 10:34:44 +01:00
- Command ``WebQuery < url > GET|POST|PUT|PATCH [< headers > ] < body > `` to extent HTTP requests [#13209 ](https://github.com/arendst/Tasmota/issues/13209 )
2021-09-29 14:33:58 +01:00
- Commands ``EnergyTotal< phase > ``, ``EnergyToday< phase > `` and ``EnergyYesterday< phase > `` to (re)set energy values
2021-10-02 17:29:05 +01:00
- Commands ``EnergyUsage`` and ``EnergyExport`` to (re)set energy usage and export values
2021-09-20 14:10:30 +01:00
- Optional IP filter to command ``TCPStart`` [#12806 ](https://github.com/arendst/Tasmota/issues/12806 )
2021-08-02 10:05:02 +01:00
- Neopool commands ``NPPHRes``, ``NPCLRes`` and ``NPIonRes`` [#12813 ](https://github.com/arendst/Tasmota/issues/12813 )
2021-07-29 15:57:04 +01:00
- Support for second DNS server
2021-09-02 09:56:20 +01:00
- Support for influxdb using ``#define USE_INFLUXDB`` and several ``Ifx`` commands
- Support for AM2320 Temperature and Humidity Sensor by Lars Wessels [#12485 ](https://github.com/arendst/Tasmota/issues/12485 )
- Support for Technoline WS2300-15 Anemometer [#12573 ](https://github.com/arendst/Tasmota/issues/12573 )
- Support for Telaire T6700 Series CO2 sensor by Alexander Savchenko [#12618 ](https://github.com/arendst/Tasmota/issues/12618 )
- Support for CAN bus and Freedom Won Battery Management System by Marius Bezuidenhout [#12651 ](https://github.com/arendst/Tasmota/issues/12651 )
- Support for IEM3155 Wattmeter [#12940 ](https://github.com/arendst/Tasmota/issues/12940 )
- Support for Hydreon RG-15 Solid State Rain sensor [#12974 ](https://github.com/arendst/Tasmota/issues/12974 )
- Support for IKEA VINDRIKTNING particle concentration sensor [#12976 ](https://github.com/arendst/Tasmota/issues/12976 )
2021-09-23 13:47:43 +01:00
- Support for Sensirion SCD40/SCD41 CO2 sensor [#13139 ](https://github.com/arendst/Tasmota/issues/13139 )
2021-09-22 11:45:56 +01:00
- Support for BL0939 energy monitor as used in ESP32 based Sonoff Dual R3 V2 Pow [#13195 ](https://github.com/arendst/Tasmota/issues/13195 )
2021-10-03 13:10:11 +01:00
- Support for BL0942 energy monitor [#13259 ](https://github.com/arendst/Tasmota/issues/13259 )
2021-10-08 12:59:11 +01:00
- Support for HM330X SeedStudio Grove Particule sensor [#13250 ](https://github.com/arendst/Tasmota/issues/13250 )
2021-07-02 13:08:06 +01:00
- Initial support for Tasmota Mesh (TasMesh) providing node/broker communication using ESP-NOW [#11939 ](https://github.com/arendst/Tasmota/issues/11939 )
2021-09-20 14:10:30 +01:00
- Initial support for Wi-Fi extender [#12784 ](https://github.com/arendst/Tasmota/issues/12784 )
2021-07-04 11:14:16 +01:00
- Rule event support as JSON payload [#12496 ](https://github.com/arendst/Tasmota/issues/12496 )
- MQTT minimum password length restriction in GUI [#12553 ](https://github.com/arendst/Tasmota/issues/12553 )
2021-09-20 14:10:30 +01:00
- ESP32 Berry partition manager [#12465 ](https://github.com/arendst/Tasmota/issues/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
2021-09-27 13:36:19 +01:00
- ESP32 Berry print stack trace when exception, more detailed with line numbers if `#define USE_BERRY_DEBUG`
2021-09-20 14:10:30 +01:00
- 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
2021-04-16 11:05:22 +01:00
2021-10-02 14:36:01 +01:00
### Breaking Changed
- ESP32 LVGL updated to v8.0.2
2021-02-27 15:58:50 +00:00
### Changed
2021-08-09 11:08:20 +01:00
- Move firmware binaries to https://github.com/arendst/Tasmota-firmware/tree/main/release-firmware
2021-10-02 17:29:05 +01:00
- Removed command ``EnergyReset`` as it is replaced by new commands
2021-08-31 15:41:19 +01:00
- IRremoteESP8266 library from v2.7.18 to v2.7.20
2021-08-09 11:08:20 +01:00
- NeoPixelBus library from v2.6.3 to v2.6.7
2021-07-22 14:14:58 +01:00
- Message ``Upload buffer miscompare`` into ``Not enough space``
2021-09-20 14:10:30 +01:00
- Command ``DisplayDimmer`` has now range 0..100 instead of 0..15
2021-06-19 14:22:17 +01:00
- Speed up initial GUI console refresh
2021-07-04 11:14:16 +01:00
- Enable UFILESYS, GUI_TRASH_FILE and GUI_EDIT_FILE for any device compiled with more than 1M flash size
2021-09-02 09:56:20 +01:00
- Supported sensor driver range extended from 96 to 128
2021-08-08 14:22:44 +01:00
- Relax NTP poll if no ntpserver can be resolved by DNS
2021-09-02 09:56:20 +01:00
- Shelly EM template needs to use GPIO ``ADE7953_IRQ 2``
2021-08-03 13:12:38 +01:00
- Make Sonoff L1 MusicSync persistent [#12008 ](https://github.com/arendst/Tasmota/issues/12008 )
2021-06-21 13:46:30 +01:00
- Simplified configuration for ir-full and removal of tasmota-ircustom [#12428 ](https://github.com/arendst/Tasmota/issues/12428 )
2021-07-04 11:14:16 +01:00
- Refactor platformio [#12442 ](https://github.com/arendst/Tasmota/issues/12442 )
- Allow buttons to work in AP normal mode [#12518 ](https://github.com/arendst/Tasmota/issues/12518 )
- Enable Ping and rule features for any device compiled with more than 1M flash size [#12539 ](https://github.com/arendst/Tasmota/issues/12539 )
2021-07-21 10:41:31 +01:00
- Replace spaces by hyphens in final hostname [#12710 ](https://github.com/arendst/Tasmota/issues/12710 )
2021-08-09 10:55:12 +01:00
- Default disable CORS for enhanced security and provide user compile option ``#define USE_CORS`` [#12827 ](https://github.com/arendst/Tasmota/issues/12827 )
2021-08-09 11:08:20 +01:00
- Prometheus: All metrics are prefixed with ``tasmota_`` [#12842 ](https://github.com/arendst/Tasmota/issues/12842 )
Memory metrics have been cleaned up to work consistently between ESP8266 and ESP32
The device name is reported as an info metric
2021-09-20 14:10:30 +01:00
- 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 ](https://github.com/arendst/Tasmota/issues/13123 )
- ESP32 shrinked Webcam build, uses now `USE_TASMOTA_DISCOVERY` [#13148 ](https://github.com/arendst/Tasmota/issues/13148 )
2021-10-08 10:04:07 +01:00
- ESP32 Memory display to exclude IRAM (i.e. less by 40-50KB) [#13294 ](https://github.com/arendst/Tasmota/issues/13294 )
2021-02-27 15:58:50 +00:00
### Fixed
2021-09-01 10:14:30 +01:00
- Sonoff L1 (lite) smoother color transitions
2021-06-20 10:36:34 +01:00
- DDS238-2 wrong reactive power value [#12283 ](https://github.com/arendst/Tasmota/issues/12283 )
2021-06-22 15:54:47 +01:00
- NO VALID JSON regression from may 4th [#12440 ](https://github.com/arendst/Tasmota/issues/12440 )
2021-06-24 17:29:12 +01:00
- Telegram response decoding stopped working after 20210621 and exception on long result message [#12451 ](https://github.com/arendst/Tasmota/issues/12451 )
2021-07-04 11:14:16 +01:00
- Neopool compile error on DEBUG_TASMOTA_SENSOR [#12464 ](https://github.com/arendst/Tasmota/issues/12464 )
- Scripter and Display MQTT errors due to MQTT_DATA move to String [#12525 ](https://github.com/arendst/Tasmota/issues/12525 )
- Scripter moving average and sml input validation [#12541 ](https://github.com/arendst/Tasmota/issues/12541 )
- Zigbee Hue angle encoding [#12545 ](https://github.com/arendst/Tasmota/issues/12545 )
2021-07-06 10:28:33 +01:00
- Exception 28 when unable to send MQTT message and a topic name without a slash '/' [#12555 ](https://github.com/arendst/Tasmota/issues/12555 )
- Wi-Fi initial setup workaround for 11n only routers [#12566 ](https://github.com/arendst/Tasmota/issues/12566 )
2021-07-21 10:41:31 +01:00
- Discovery fails when using ``%hostname%`` in a topic [#12710 ](https://github.com/arendst/Tasmota/issues/12710 )
2021-08-02 10:05:02 +01:00
- Neopool communication error [#12813 ](https://github.com/arendst/Tasmota/issues/12813 )
2021-08-30 17:03:24 +01:00
- Shelly Dimmer 2 Energy usage [#12815 ](https://github.com/arendst/Tasmota/issues/12815 )
2021-08-22 15:09:56 +01:00
- WDT reset on shutters with stepper motors during deceleration [#12849 ](https://github.com/arendst/Tasmota/issues/12849 )
2021-08-12 19:38:31 +01:00
- Negative power values for ADE7953 based devices like Shelly EM [#12874 ](https://github.com/arendst/Tasmota/issues/12874 )
2021-08-25 14:24:55 +01:00
- Unable to disable MusicSync mode on Sonoff L1 Lite regression from 9.3.0 [#12930 ](https://github.com/arendst/Tasmota/issues/12930 )
2021-08-24 19:58:17 +01:00
- Wiegand support for keypad zero key in single key mode using ``SetOption124 1`` [#12960 ](https://github.com/arendst/Tasmota/issues/12960 )
2021-08-25 08:41:07 +01:00
- Hass and Tasmota discovery prefix topic notifications [#12972 ](https://github.com/arendst/Tasmota/issues/12972 )
2021-09-02 09:56:20 +01:00
- OpenTherm invalid JSON [#13028 ](https://github.com/arendst/Tasmota/issues/13028 )
2021-09-02 09:09:23 +01:00
- MQTT TLS related connection timing errors [#13033 ](https://github.com/arendst/Tasmota/issues/13033 )
2021-09-20 14:10:30 +01:00
- 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 ](https://github.com/arendst/Tasmota/issues/12376 )
- ESP32 Berry button handlers and error messages [#12521 ](https://github.com/arendst/Tasmota/issues/12521 )
- ESP32 do not use chip temperature sensor as global temperature if external temperature sensor is used [#12630 ](https://github.com/arendst/Tasmota/issues/12630 )
- ESP32 buzzer in PWM mode exception [#12717 ](https://github.com/arendst/Tasmota/issues/12717 )
2021-09-02 09:09:23 +01:00
- ESP32 crash when PSRAM is absent and ``BOARD_HAS_PSRAM`` set [#13037 ](https://github.com/arendst/Tasmota/issues/13037 )
