Tasmota/RELEASENOTES.md

24 KiB

Logo

RELEASE NOTES

Migration Information

See wiki 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.x

Supported Core versions

This release will be supported from ESP8266/Arduino library Core version pre-2.6.0 due to reported security and stability issues on previous Core version.

Although it might still compile on previous Core versions all support will be removed starting in the next Release.

Support of TLS

To save resources when TLS is enabled mDNS needs to be disabled. In addition to TLS using fingerprints now also user supplied CA certs and AWS IoT is supported. See full documentation on https://github.com/arendst/Sonoff-Tasmota/wiki/AWS-IoT

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.

Supported Modules

The following hardware modules are supported.

Module Description
01 Sonoff Basic Sonoff Basic Wifi Smart Switch
02 Sonoff RF Sonoff RF Wifi Smart Switch with RF (434MHz) receiver
03 Sonoff SV Sonoff SV Safe Voltage Wifi Smart Switch
04 Sonoff TH Sonoff TH10/TH16 Wifi Smart Switch with Sensor connection
05 Sonoff Dual Sonoff Dual Wifi Smart Switch
06 Sonoff Pow Sonoff Pow Wifi Smart Switch with Energy Monitoring
07 Sonoff 4CH Sonoff 4CH 4-gang Wifi Smart Switch
08 Sonoff S2X Sonoff S20/S26 Wifi Smart Socket
09 Slampher Sonoff Slampher Wifi Smart Light Bulb Socket with RF (434MHz) receiver
10 Sonoff Touch Sonoff Touch Wifi Light Switch
11 Sonoff LED Sonoff Led Wifi Led Pack (Retired)
12 1 Channel 1 Channel Inching/Self Locking Wifi Switch 5V/12V
13 4 Channel 4 Channel Inching/Self Locking Wifi Switch (Retired)
14 Motor C/AC Motor Clockwise/Antoclockwise Wifi Switch (Retired)
15 ElectroDragon Electrodragon Wifi IoT Board
16 EXS Relay(s) Electronic Experience Store 1 or 2-gang Wifi Module
17 WiOn WiOn Wifi Smart Socket
18 Generic Any ESP8266/ESP8285 device like WeMos and NodeMCU
19 Sonoff Dev Sonoff Dev Wifi Development Board
20 H801 H801 Wifi RGBWW Led Controller
21 Sonoff SC Sonoff SC Wifi Environmental Monitor
22 Sonoff BN-SZ Sonoff BN-SZ01 Wifi Ceiling Led (Retired)
23 Sonoff 4CH Pro Sonoff 4CH Pro 4-gang Wifi Smart Switch
24 Huafan SS HuaFan Wifi Smart Socket
25 Sonoff Bridge Sonoff RF (434MHz) transceive to Wifi Bridge
26 Sonoff B1 Sonoff B1 Wifi RGBWW Led Bulb
27 AiLight Ai-Thinker RGBW Led Bulb
28 Sonoff T1 1CH Sonoff T1 1-gang Wifi Light Switch
29 Sonoff T1 2CH Sonoff T1 2-gang Wifi Light Switch
30 Sonoff T1 3CH Sonoff T1 3-gang Wifi Light Switch
31 Supla Espablo 2-gang Wifi Module
32 Witty Cloud Witty Cloud ESP8266 Wifi Development Board
33 Yunshan Relay ESP8266 Wifi Network Relay Module
34 MagicHome MagicHome, Flux-light and some Arilux LC10 RGB(W) Led Controller
35 Luani HVIO Luani ESP8266 Wifi I/O Module
36 KMC 70011 KMC Wifi Smart Socket with Energy Monitoring
37 Arilux LC01 Arilux AL-LC01 RGB Led Controller
38 Arilux LC11 Arilux AL-LC11 RGBWW Led Controller
39 Sonoff Dual R2 Sonoff Dual R2 Wifi Smart Switch
40 Arilux LC06 Arilux AL-LC06 RGB(WW) Led Controller
41 Sonoff S31 Sonoff S31 Wifi Smart Socket with Energy Monitoring
42 Zengge WF017 Zengge WF017 Wifi RGB(W) Led Controller
43 Sonoff Pow R2 Sonoff Pow R2 Wifi Smart Switch with Energy Monitoring
44 Sonoff iFan02 Sonoff iFan02 Wifi Smart Ceiling Fan with Light
45 BlitzWolf SHP BlitzWolf BW-SHP2, BW-SHP6, HomeCube SP1, Gosund SP111, Teckin SP22 Wifi Smart Switch with Energy Monitoring
46 Shelly 1 Shelly 1 Open Source Wifi Relay Module
47 Shelly 2 Shelly 2 Wifi 2-gang Relay Module with Energy Monitoring
48 Xiaomi Philips Xiaomi Philips Wifi WW Led Bulb
49 Neo Coolcam Neo Coolcam Wifi Smart Socket
50 ESP Switch ESP Switch 4-gang Wifi Switch with Leds
51 OBI Socket OBI Wifi Smart Socket
52 Teckin Teckin SP22 Wifi Smart Switch with Energy Monitoring
53 AplicWDP303075 Aplic WDP 303075 CSL Wifi Smart Switch with Energy Monitoring
54 Tuya Dimmer MIUO (and other Tuya based) Wifi Dimmer for Incandescent Lights and Led
55 Gosund SP1 v23 Gosund SP1 v2.3 Wifi Smart Switch with Energy Monitoring
56 ARMTR Dimmer ARMtronix Wifi dimmer for Incandescent Lights and Led
57 SK03 Outdoor SK03 Outdoor Wifi Smart Switch with Energy Monitoring
58 PS-16-DZ PS-16-DZ Wifi dimmer for Incandescent Lights and Led
59 Teckin US Teckin SP20 and ZooZee SA102 Wifi Smart Switch with Energy Monitoring
60 Manzoku strip Manzoku Wifi Smart Power Strip with four Relays
61 OBI Socket 2 OBI 2 Wifi Smart Socket
62 YTF IR Bridge YTF Infra Red Wifi Bridge
63 Digoo DG-SP202 Digoo DG-SP202 Dual Wifi Smart Switch with Energy Monitoring
64 KA10 Smanergy KA10 Wifi Smart Wall Switch with Energy Monitoring
65 Luminea ZX2820 Luminea ZX2820 Wifi Smart Switch with Energy Monitoring
66 Mi Desk Lamp Mi Desk Lamp with rotary switch and Wifi
67 SP10 Tuya SP10 Wifi Smart Switch with Energy Monitoring
68 WAGA CHCZ02MB WAGA life CHCZ02MB Wifi Smart Switch with Energy Monitoring
69 SYF05 Sunyesmart SYF05 RGBWW Wifi Led Bulb
70 Sonoff L1 Sonoff L1 light strip
71 Sonoff iFan03 Sonoff iFan03 Wifi Smart Ceiling Fan with Light
72 EXS Dimmer EXS Wifi Dimmer v4

Over 500 additional devices are supported using templates.

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library core version pre-2.6.0.

  • sonoff.bin = The Sonoff version with sensors. RECOMMENDED RELEASE BINARY
  • sonoff-BG.bin to sonoff-TW.bin = The Sonoff version in different languages.
  • sonoff-basic.bin = The Basic version without most sensors.
  • sonoff-knx.bin = The Knx version without some features but adds KNX support.
  • sonoff-sensors.bin = The Sensors version adds more useful sensors.
  • sonoff-ir = The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features.
  • sonoff-display.bin = The Display version without Energy Monitoring but adds display support.
  • sonoff-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.

Available Features and Sensors

Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
MY_LANGUAGE en-GB x x x x x x x
USE_ARDUINO_OTA - - - - - - -
USE_DOMOTICZ - - x x x x -
USE_HOME_ASSISTANT - - x x x x -
USE_MQTT_TLS - - - - - - -
USE_MQTT_TLS_CA_CERT - - - - - - -
USE_MQTT_AWS_IOT - - - - - - -
USE_KNX - - - x - - -
USE_WEBSERVER x x x x x x x
USE_JAVASCRIPT_ES6 - - - - - - -
USE_WEBSEND_RESPONSE - - - - - - -
USE_EMULATION_HUE - x x - x - -
USE_EMULATION_WEMO - x x - x - -
USE_DISCOVERY - - x x - - x
WEBSERVER_ADVERTISE - - x x - - x
MQTT_HOST_DISCOVERY - - x x - - x
USE_TIMERS - x x x x x x
USE_TIMERS_WEB - x x x x x x
USE_SUNRISE - x x x x x x
USE_RULES - x x x x x x
USE_SCRIPT - - - - - - -
USE_EXPRESSION - - - - - - -
SUPPORT_IF_STATEMENT - - - - - - -
Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
ROTARY_V1 - - - - - - -
USE_SONOFF_RF - - x x x - -
USE_RF_FLASH - - x x x - -
USE_SONOFF_SC - - x - x - -
USE_TUYA_MCU - x x x x - x
USE_ARMTRONIX_DIMMERS - - x x - - -
USE_PS_16_DZ - - x x x - -
USE_SONOFF_IFAN - - x x x - -
USE_BUZZER - - x x x - -
USE_ARILUX_RF - - x x x - -
USE_SHUTTER - - - - - - -
USE_DEEPSLEEP - - - - - - -
USE_EXS_DIMMER - - - - - - -
Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
USE_LIGHT - x x x x x x
USE_WS2812 - - x x x - x
USE_WS2812_DMA - - - - - - -
USE_MY92X1 - - x x x - x
USE_SM16716 - - x x x - x
USE_SM2135 - - x x x - x
USE_SONOFF_L1 - - x x x - x
USE_ENERGY_SENSOR - x x x x - -
USE_PZEM004T - - x x x - -
USE_PZEM_AC - - x x x - -
USE_PZEM_DC - - x x x - -
USE_MCP39F501 - x x x x - -
USE_SDM120 - - - - x - -
USE_SDM630 - - - - x - -
USE_DDS2382 - - - - x - -
USE_DDSU666 - - - - x - -
USE_SOLAX_X1 - - - - - - -
USE_ADC_VCC x x - - - - -
USE_COUNTER - - x x x x x
USE_DS18x20 - - x x x - x
USE_DHT - - x x x x x
USE_MAX31855 - - - - x - -
USE_MAX31865 - - - - - - -
Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
USE_I2C - - x x x - x
USE_SHT - - x x x - x
USE_HTU - - x x x - x
USE_BMP - - x x x - x
USE_BME680 - - - - x - -
USE_BH1750 - - x x x - x
USE_VEML6070 - - - - x - -
USE_ADS1115 - - - - x - -
USE_ADS1115_I2CDEV - - - - - - -
USE_INA219 - - - - x - -
USE_INA226 - - - - - - -
USE_SHT3X - - x x x - x
USE_TSL2561 - - - - x - -
USE_MGS - - - - x - -
USE_SGP30 - - x x x - x
USE_SI1145 - - - - - - -
USE_LM75AD - - x x x - x
USE_APDS9960 - - - - - - -
USE_MCP230xx - - - - - - -
USE_PCA9685 - - - - - - -
USE_MPR121 - - - - - - -
USE_CCS811 - - - - - - -
USE_MPU6050 - - - - - - -
USE_DS3231 - - - - - - -
USE_MGC3130 - - - - - - -
USE_MAX44009 - - - - - - -
USE_SCD30 - - - - x - -
USE_SPS30 - - - - - - -
USE_ADE7953 - - x x x - x
USE_VL53L0X - - - - - - -
USE_MLX90614 - - - - - - -
USE_CHIRP - - - - - - -
USE_PAJ7620 - - - - - - -
USE_PCF8574 - - - - - - -
Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
USE_SPI - - - - - - x
USE_MHZ19 - - x x x - x
USE_SENSEAIR - - x x x - x
USE_PMS5003 - - x x x - x
USE_NOVA_SDS - - x x x - x
USE_SERIAL_BRIDGE - - x x x - x
USE_MP3_PLAYER - - - - x - -
USE_AZ7798 - - - - - - -
USE_PN532_HSU - - - - x - -
USE_ZIGBEE - - - - - - - Experimental
USE_IR_REMOTE - - x x x x x
USE_IR_HVAC - - - - x x -
USE_IR_RECEIVE - - x x x x x
USE_SR04 - - x x x - x
USE_TM1638 - - - - x - -
USE_HX711 - - x x x - x
USE_TX20_WIND_SENSOR - - - - x - -
USE_RC_SWITCH - - - - x - -
USE_RF_SENSOR - - - - x - - AlectoV2 only
USE_HRE - - - - x - -
USE_A4988_STEPPER - - - - - - -
USE_ARDUINO_SLAVE - - - - - - - Experimental
Feature or Sensor minimal basic sonoff knx sensors ir display Remarks
USE_DISPLAY - - - - - - x
USE_DISPLAY_LCD - - - - - - x
USE_DISPLAY_SSD1306 - - - - - - x
USE_DISPLAY_MATRIX - - - - - - x
USE_DISPLAY_SH1106 - - - - - - x
USE_DISPLAY_ILI9341 - - - - - - x
USE_DISPLAY_EPAPER_29 - - - - - - x Disabled for core 2.3.0
USE_DISPLAY_EPAPER_42 - - - - - - x Disabled for core 2.3.0
USE_DISPLAY_ILI9488 - - - - - - -
USE_DISPLAY_SSD1351 - - - - - - -
USE_DISPLAY_RA8876 - - - - - - -

Changelog

Version 6.7.0 20191025

  • Remove support for WPS and SmartConfig in favour of Web server (!) based WifiManager (#6680)
  • Remove binary sonoff-classic (#6680)
  • Remove command SetOption2
  • Remove default DS18B20 driver and only support define USE_DS18x20 (#6647)
  • Remove support for define USE_DS18x20_LEGACY and legacy DS18x20 driver (#6486)
  • Replace xsns_23_sdm120 with xnrg_08_sdm120
  • Replace xsns_25_sdm630 with xnrg_10_sdm630
  • Replace xsns_49_solaxX1 with xnrg_12_solaxX1 (#6677)
  • Change Sonoff L1 support by adding define USE_SONOFF_L1
  • Change light drivers internals to ease management
  • Change command PulseTime JSON message format and allow display of all pulsetimer information (#6519)
  • Change command SetOption43 to make it more general. Now supports PS_16_DZ driver too (#6544)
  • Change command handling by moving buffers up in chain solving MQTTlog support (#6529)
  • Change commands Var and Mem to show all parameters when no index is given (#6107)
  • Change detection of non-MQTT commands by allowing non-space characters as delimiter (#6540)
  • Change rename "Data" to "Hash" and limit to 32 bits when receiving UNKNOWN IR protocol (see DECODE_HASH from IRremoteESP8266)
  • Change JSON output format for commands Adc, Adcs, Modules, Gpio and Gpios from list to dictionary (#6407)
  • Change energy sensors for three phase/channel support
  • Change Settings crc calculation allowing short term backward compatibility
  • Change Improve reliability of TasmotaSerial at 115200 bauds and reduce IRAM usage
  • Change Tuya support by Shantur Rathore removing tuya related commands SetOption34, 41, 44, 45, 46, 65, 66 and 69 (#6353)
  • Change theoretical baudrate range to 300..19660500 bps in 300 increments (#6294)
  • Change Settings area to 4k for future use
  • Change some table locations from RAM to Flash
  • Change filename of configuration backup from using FriendlyName1 to Hostname solving diacritic issues (#2422)
  • Change Store AWS IoT Private Key and Certificate in SPI Flash avoiding device-specific compilations
  • Change defines USE_TX20_WIND_SENSOR and USE_RC_SWITCH in my_user_config.h to disable to lower iram usage enabling latest core compilation (#6060, #6062)
  • Fix handling of ligth channels when pwm_multichannel (SetOption68) is enabled
  • Fix better handling of PWM White Temperature mode for Module 48 (#6534)
  • Fix TasmotaSerial: move serial send to IRAM for high speed baud rates
  • Fix Domoticz battery level set to 100 if define USE_ADC_VCC is not used (#6033)
  • Fix Force Elliptic Curve for Letsencrypt TLS #6042
  • Fix WeMo emulation for 1G echo and 2G echo dot (#6086)
  • Fix Xiaomi Philips brightness (#6091)
  • Add support for EX-Store WiFi Dimmer V4 (#5856)
  • Add support for Arduino serial connection (EXPERIMENTAL)
  • Add support for Zigbee devices Xiaomi lumi.weather air quality sensor, Osram mini-switch
  • Add support for Zigbee device cc2530 initialization and basic ZCL decoding
  • Add support for PMS3003 dust particle sensor
  • Add support for Chint DDSU666 Modbus energy meter by Pablo Zerón
  • Add support for SM2135 as used in Action LSC Smart Led E14 (#6495)
  • Add support for Shelly 2.5 dual energy (#6160)
  • Add support for shutters by Stefan Bode (#288)
  • Add support for PCF8574 I2C I/O Expander (currently output only) by Stefan Bode
  • Add support for up to three PZEM-014/-016 on one serial modbus connection with addresses 1 (default), 2 and 3 (#2315)
  • Add support for up to three PZEM-004T on one serial connection with addresses 192.168.1.1 (default), 2 and 3 (#2315)
  • Add support for up to three PZEM-003/-017 on one serial modbus connection with addresses 1 (default), 2 and 3 (#2315)
  • Add support for up to 4 INA226 Voltage and Current sensors by Steve Rogers (#6342)
  • Add support for A4988 stepper-motor-driver-circuit by Tim Leuschner (#6370)
  • Add support for Hiking DDS238-2 Modbus energy meter by Matteo Campanella (#6384)
  • Add support for HM17 bluetooth LE passive scan of ibeacon devices by Gerhard Mutz
  • Add support for Solax X1 inverter by Pablo Zerón
  • Add support for PAJ7620 gesture sensor by Christian Baars
  • Add support for MAX31865 Thermocouple sensor by Alberto Lopez Siemens
  • Add support for RDM6300 125kHz RFID Reader by Gerhard Mutz
  • Add support for CHIRP soil moisture sensor by Christian Baars
  • Add support for Sonoff iFan03 as module 71 (#5988)
  • Add support for a buzzer
  • Add support for IRSend long press ('repeat' feature from IRRemoteESP8266) (#6074)
  • Add support for IRHVAC Midea/Komeco protocol (#3227)
  • Add support for more IRSend protocols enabled in my_user_config.h
  • Add support for IRSend Pioneer protocol (#6100)
  • Add support for up to 4 INA219 sensors (#6046)
  • Add support for I2C display driver SH1106 oled by Gerhard Mutz
  • Add support for SPI display drivers epaper 4.2 inch, ILI9488 TFT, SSD1351 Color oled and RA8876 TFT by Gerhard Mutz
  • Add command Buzzer with optional parameters ,<duration of beep in 100mS steps>,<duration of silence in 100mS steps> enabled when a buzzer is configured (#5988)
  • Add command DimmerRange in Light module to support 2 byte dimming ranges from Tuya
  • Add command DisplayHeight to set pixel height on supported devices
  • Add command DisplayWidth to set pixel width on supported devices
  • Add command EnergyReset4 x,x to initialize total usage for two tarrifs
  • Add command EnergyReset5 x,x to initialize total export (or production) for two tarrifs
  • Add command Gpio 255/All to show physical GPIO configuration of all non-flash pins (#6407)
  • Add command Gpios 255/All to show all available GPIO components (#6407)
  • Add command ModuleAddress 1/2/3 to set Pzem module address when a single module is connected (#2315)
  • Add command MqttLog <loglevel> for support of MQTT logging (#6498)
  • Add command Power0 0/1/2/Off/On/Toggle to control all power outputs at once (#6340)
  • Add command PowerDelta 101..32000 for absolute power delta where 101 = 101-100 = 1W, 202 = 202-100 = 102W (#5901)
  • Add command Reset 99 to reset bootcount to zero (#684, #6351)
  • Add command Sensor29 pin,0/1/2 for OFF/ON/TOGGLE
  • Add command Sensor34 8,0 and Sensor34 8,1 to disable/enable JSON message on weight change over 4 gram
  • Add command SetOption34 0..255 to set backlog delay. Default value is 200 (mSeconds) (#6562)
  • Add command SetOption42 0..255 to set overtemperature (Celsius only) threshold resulting in power off all on energy monitoring devices. Default setting is 90 (#6036)
  • Add command SetOption65 0/1 to disable (1) fast power cycle detection fixing unwanted brownout trigger
  • Add command SetOption67 0/1 to disable or enable a buzzer as used in iFan03
  • Add command SetOption68 0/1 to enable multi-channel PWM instead of a single light (#6134)
  • Add command SetOption71 0/1 to switch between different Modbus Active Energy registers on DDS238-2 energy meters (#6531)
  • Add command SetOption72 0/1 to switch between software (0) or hardware (1) energy total counter (#6561)
  • Add command Time to disable NTP and set UTC time as Epoch value if above 1451602800 (=20160101). Time 0 re-enables NTP (#5279)
  • Add command Time 1/2/3 to select JSON time format ISO + Epoch, ISO or Epoch
  • Add command Tariff to default to 0 (=disabled) and allowing to set both Standard Time (ST) and Daylight Savings Time (DST) start hour ex. Tariff1 22,23 = Tariff1 (Off-Peak) ST,DST Tariff2 6,7 = Tariff2 (Standard) ST,DST Tariff9 0/1 = Weekend toggle (1 = Off-Peak during weekend)
  • Add command WebSensor<sensor number> 0/1 to control display of sensor data in web GUI (#6085)
  • Add command ZigbeeRead (#6095)
  • Add define USE_DEEPSLEEP and command DeepSleepTime 0 or 10..86400 (seconds) to enter deepsleep mode (#6638)
  • Add define USE_ENERGY_MARGIN_DETECTION to disable Energy Margin and Power Limit detection
  • Add define USE_ENERGY_POWER_LIMIT to disable Energy Power Limit detection while Energy Margin detection is active
  • Add define USE_SONOFF_RF to enable/disable Sonoff Rf support (#6648)
  • Add define USE_WS2812_HARDWARE to select hardware type WS2812, WS2812X, WS2813, SK6812, LC8812 or APA106 (DMA mode only)
  • Add incremental beeps to Ifan03 remote control fan speed buttons (#6636)
  • Add rule support after every command execution like Fanspeed#Data=2 (#6636)
  • Add WebUI for multiple, independent PWM channels
  • Add JSON array index support to rules evaluation allowing trigger on ENERGY#POWER[2]>0.60 from JSON ..,"Power":[0.00,0.68],.. (#6160)
  • Add Full support of all protocols in IRremoteESP8266, to be used on dedicated-IR Tasmota version. Warning: +81k Flash when compiling with USE_IR_REMOTE_FULL
  • Add 'sonoff-ir' pre-packaged IR-dedicated firmware and 'sonoff-ircustom' to customize firmware with IR Full protocol support
  • Add Tuya Energy monitoring by Shantur Rathore
  • Add Domoticz P1 Smart Meter support using energy sensors handled by xdrv_03_energy.ino based on an idea by pablozg
  • Add debug compile features using defines DEBUG_TASMOTA_CORE, DEBUG_TASMOTA_DRIVER and DEBUG_TASMOTA_SENSOR. See DEBUG_CORE_LOG example in sonoff.ino and DEBUG_DRIVER_LOG example in xdrv_09_timers.ino
  • Add option 0 to Width1 (Marker), Width2 (Second), Width3 (Minute) and Width4 (Hour) disabling display (#6152)
  • Add MqttCount metric to STATE (#6155)
  • Add allow repeat/longpress for IRSend raw, introduced IRSend<r> option (#6074)
  • Add Oled reset GPIO option "OLED reset"
  • Add blend RGB leds with White leds for better whites (#5895, #5704)
  • Add AZ7798 automatic setting of clock display (#6034)
  • Add Epoch and UptimeSec to JSON messages (#6068)