Sonoff-Tasmota v6.5.0

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

Release notes

Core version 2.3.0 vs 2.4.2

This release is based on ESP8266/Arduino library core 2.3.0 (again) as some people encountered wifi related issues on core 2.4.2. For others core 2.4.2 is working just fine. Both version are available from http://thehackbox.org/tasmota/release/

Change in default initial configuration tool

Firmware binary sonoff-classic.bin supports WifiManager, Wps and SmartConfig for initial configuration. The default tool is Wps.

To save memory space all other binaries support WifiManager only.

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 SP20 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 US 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

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library core version 2.3.0.

• sonoff.bin = The Sonoff version without Wps and SmartConfig configuration but adds more sensors. RECOMMENDED RELEASE BINARY
• sonoff-basic.bin = The Basic version without Wps and SmartConfig configuration and most sensors.
• sonoff-classic.bin = The Classic version allows initial installation using either WifiManager, Wps or SmartConfig.
• sonoff-BG.bin to sonoff-TW.bin = The Sonoff version without Wps and SmartConfig configuration in different languages.
• sonoff-knx.bin = The Knx version without Wps and SmartConfig configuration and some other features but adds KNX support.
• sonoff-sensors.bin = The Sensors version without Wps and SmartConfig configuration but adds even more useful sensors.
• sonoff-display.bin = The Display version without Wps and SmartConfig configuration and 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.

Core version 2.4.2 binaries can be found at http://thehackbox.org/tasmota/release/020402/

Available Features and Sensors

Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors	display	Remarks
MY_LANGUAGE en-GB	x	x	x	x	x	x	x
USE_WPS	-	-	x	-	-	-	-	WPS
USE_SMARTCONFIG	-	-	x	-	-	-	-	SmartConfig
USE_ARDUINO_OTA	-	-	-	-	-	-	-
USE_DOMOTICZ	-	-	x	x	x	x	-
USE_HOME_ASSISTANT	-	-	-	x	x	x	-
USE_MQTT_TLS	-	-	-	-	-	-	-
USE_KNX	-	-	-	-	x	-	-
USE_WEBSERVER	x	x	x	x	x	x	x	WifiManager
USE_EMULATION	-	x	x	x	-	x	-
USE_DISCOVERY	-	-	x	x	x	x	x
WEBSERVER_ADVERTISE	-	-	x	x	x	x	x
MQTT_HOST_DISCOVERY	-	-	x	x	x	x	x
USE_TIMERS	-	x	-	x	x	x	x
USE_TIMERS_WEB	-	x	-	x	x	x	x
USE_SUNRISE	-	x	-	x	x	x	x
USE_RULES	-	x	-	x	x	x	x
USE_EXPRESSION	-	-	-	-	-	-	-
USE_ADC_VCC	x	x	x	x	x	-	x
USE_DS18B20	-	-	-	-	-	-	-	Single sensor
USE_DS18x20	-	-	x	x	x	x	x	Multiple sensors
USE_DS18x20_LEGACY	-	-	-	-	-	-	-	Multiple sensors
Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors	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_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	-	-	-	-	-	-	-
...

Sonoff-Tasmota v6.4.1

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

Release notes

Change in default initial configuration tool

Firmware binary sonoff-classic.bin supports WifiManager, Wps and SmartConfig for initial configuration. The default tool is Wps.

To save memory space all other binaries support WifiManager only.

See _changelog.ino how to enable them again.

• Define WIFI_CONFIG_TOOL now contains the default behaviour once a SSID has been configured.
• If no SSID is configured making a wifi connection impossible the new define WIFI_CONFIG_NO_SSID will be used.
• While define WIFI_CONFIG_NO_SSID is set to WIFI_WPSCONFIG in my_user_config.h the compiler will check for define USE_WPS and if not enabled WIFI_CONFIG_NO_SSID will default to WIFI_MANAGER using the webserver. If define USE_WEBSERVER is also not enabled WIFI_CONFIG_NO_SSID will default to WIFI_SMARTCONFIG. If define USE_SMARTCONFIG is also not enabled WIFI_CONFIG_NO_SSID will default to a new option WIFI_SERIAL allowing to enter wifi parameters to serial which is always possible.

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 SP20 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 US and ZooZee SA102 Wifi Smart Switch with Energy Monitoring
60 Manzoku strip	Manzoku Wifi Smart Power Strip with four Relays

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library core version 2.4.2 patched with the Alexa fix.

• 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.
• sonoff-classic.bin = The Classic version allows initial installation using either WifiManager, Wps or SmartConfig.
• sonoff.bin = The Sonoff version without Wps and SmartConfig configuration but adds more sensors.
• sonoff-BG.bin to sonoff-TW.bin = The Sonoff version without Wps and SmartConfig configuration in different languages.
• sonoff-sensors.bin = The Sensors version without Wps and SmartConfig configuration but adds even more useful sensors.
• sonoff-display.bin = The Display version without Wps and SmartConfig configuration but adds display support.
• sonoff-knx.bin = The Knx version without Wps and SmartConfig configuration and some other features but adds KNX support.

Available Features and Sensors

Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors	Remarks
ESP/Arduino lib v2.3.0	346k	429k	482k	504k	522k	535k
ESP/Arduino lib v2.4.2	366k	446k	496k	522k	538k	551k	No wifi sleep
MY_LANGUAGE en-GB	x	x	x	x	x	x
MQTT_LIBRARY_TYPE PUBSUBCLIENT	x	x	x	x	x	x
USE_WPS	-	-	x	-	-	-	WPS
USE_SMARTCONFIG	-	-	x	-	-	-	SmartConfig
USE_ARDUINO_OTA	-	-	-	-	-	-
USE_DOMOTICZ	-	-	x	x	x	x
USE_HOME_ASSISTANT	-	-	-	x	x	x
USE_MQTT_TLS	-	-	-	-	-	-
USE_KNX	-	-	-	-	x	-
USE_WEBSERVER	x	x	x	x	x	x	WifiManager
USE_EMULATION	-	x	x	x	-	x
USE_DISCOVERY	-	-	x	x	x	x
WEBSERVER_ADVERTISE	-	-	x	x	x	x
MQTT_HOST_DISCOVERY	-	-	x	x	x	x
USE_TIMERS	-	x	-	x	x	x
USE_TIMERS_WEB	-	x	-	x	x	x
USE_SUNRISE	-	x	-	x	x	x
USE_RULES	-	x	-	x	x	x
USE_ADC_VCC	x	x	x	x	x	-
USE_DS18B20	-	-	-	-	-	-	Single sensor
USE_DS18x20	-	-	x	x	x	x	Multiple sensors
USE_DS18x20_LEGACY	-	-	-	-	-	-	Multiple sensors
Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors
USE_I2C	-	-	-	x	x	x
USE_SHT	-	-	-	x	x	x
USE_HTU	-	-	-	x	x	x
USE_BMP	-	-	-	x	x	x
USE_BME680	-	-	-	-	-	x
USE_BH1750	-	-	-	x	x	x
USE_VEML6070	-	-	-	-	-	x
USE_ADS1115	-	-	-	-	-	x
USE_ADS1115_I2CDEV	-	-	-	-	-	-
USE_INA219	-	-	-	-	-	x
USE_SHT3X	-	-	-	x	x	x
USE_TSL2561	-	-	-	-	-	x
USE_MGS	-	-	-	-	-	x
USE_SGP30	-	-	-	x	x	x
USE_SI1145	-	-	-	-	-	x
USE_LM75AD	-	-	-	x	x	x
USE_APDS9960	-	-	-	-	-	-
USE_MCP230xx	-	-	-	-	-	-
USE_PCA9685	-	-	-	-	-	-
USE_MPR121	-	-	-	-	-	-
USE_CCS811	-	-	-	-	-	-
USE_MPU6050	-	-	-	-	-	-
USE_DS...

Sonoff-Tasmota v6.4.0

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

Release notes

Change in default initial configuration tool

Firmware binary sonoff-classic.bin supports WifiManager, Wps and SmartConfig for initial configuration. The default tool is Wps.

To save memory space all other binaries support WifiManager only.

See _changelog.ino how to enable them again.

• Define WIFI_CONFIG_TOOL now contains the default behaviour once a SSID has been configured.
• If no SSID is configured making a wifi connection impossible the new define WIFI_CONFIG_NO_SSID will be used.
• While define WIFI_CONFIG_NO_SSID is set to WIFI_WPSCONFIG in my_user_config.h the compiler will check for define USE_WPS and if not enabled WIFI_CONFIG_NO_SSID will default to WIFI_MANAGER using the webserver. If define USE_WEBSERVER is also not enabled WIFI_CONFIG_NO_SSID will default to WIFI_SMARTCONFIG. If define USE_SMARTCONFIG is also not enabled WIFI_CONFIG_NO_SSID will default to a new option WIFI_SERIAL allowing to enter wifi parameters to serial which is always possible.

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 SP20 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 US and ZooZee SA102 Wifi Smart Switch with Energy Monitoring
60 Manzoku strip	Manzoku Wifi Smart Power Strip with four Relays

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library core version 2.4.2 patched with the Alexa fix.

• 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.
• sonoff-classic.bin = The Classic version allows initial installation using either WifiManager, Wps or SmartConfig.
• sonoff.bin = The Sonoff version without Wps and SmartConfig configuration but adds more sensors.
• sonoff-BG.bin to sonoff-TW.bin = The Sonoff version without Wps and SmartConfig configuration in different languages.
• sonoff-sensors.bin = The Sensors version without Wps and SmartConfig configuration but adds even more useful sensors.
• sonoff-display.bin = The Display version without Wps and SmartConfig configuration but adds display support.
• sonoff-knx.bin = The Knx version without Wps and SmartConfig configuration and some other features but adds KNX support.

Available Features and Sensors

Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors	Remarks
ESP/Arduino lib v2.3.0	346k	429k	482k	504k	522k	535k
ESP/Arduino lib v2.4.2	366k	446k	496k	522k	538k	551k	No wifi sleep
MY_LANGUAGE en-GB	x	x	x	x	x	x
MQTT_LIBRARY_TYPE PUBSUBCLIENT	x	x	x	x	x	x
USE_WPS	-	-	x	-	-	-	WPS
USE_SMARTCONFIG	-	-	x	-	-	-	SmartConfig
USE_ARDUINO_OTA	-	-	-	-	-	-
USE_DOMOTICZ	-	-	x	x	x	x
USE_HOME_ASSISTANT	-	-	-	x	x	x
USE_MQTT_TLS	-	-	-	-	-	-
USE_KNX	-	-	-	-	x	-
USE_WEBSERVER	x	x	x	x	x	x	WifiManager
USE_EMULATION	-	x	x	x	-	x
USE_DISCOVERY	-	-	x	x	x	x
WEBSERVER_ADVERTISE	-	-	x	x	x	x
MQTT_HOST_DISCOVERY	-	-	x	x	x	x
USE_TIMERS	-	x	-	x	x	x
USE_TIMERS_WEB	-	x	-	x	x	x
USE_SUNRISE	-	x	-	x	x	x
USE_RULES	-	x	-	x	x	x
USE_ADC_VCC	x	x	x	x	x	-
USE_DS18B20	-	-	-	-	-	-	Single sensor
USE_DS18x20	-	-	x	x	x	x	Multiple sensors
USE_DS18x20_LEGACY	-	-	-	-	-	-	Multiple sensors
Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors
USE_I2C	-	-	-	x	x	x
USE_SHT	-	-	-	x	x	x
USE_HTU	-	-	-	x	x	x
USE_BMP	-	-	-	x	x	x
USE_BME680	-	-	-	-	-	x
USE_BH1750	-	-	-	x	x	x
USE_VEML6070	-	-	-	-	-	x
USE_ADS1115	-	-	-	-	-	x
USE_ADS1115_I2CDEV	-	-	-	-	-	-
USE_INA219	-	-	-	-	-	x
USE_SHT3X	-	-	-	x	x	x
USE_TSL2561	-	-	-	-	-	x
USE_MGS	-	-	-	-	-	x
USE_SGP30	-	-	-	x	x	x
USE_SI1145	-	-	-	-	-	x
USE_LM75AD	-	-	-	x	x	x
USE_APDS9960	-	-	-	-	-	-
USE_MCP230xx	-	-	-	-	-	-
USE_PCA9685	-	-	-	-	-	-
USE_MPR121	-	-	-	-	-	-
USE_CCS811	-	-	-	-	-	-
USE_MPU6050	-	-	-	-	-	-
USE_DS...

Sonoff-Tasmota v6.3.0

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

Release notes

Change in default initial configuration tool

Firmware binary sonoff-classic.bin supports WifiManager, Wps and SmartConfig for initial configuration. The default tool is Wps.

To save memory space all other binaries support WifiManager only.

See _changelog.ino how to enable them again.

• Define WIFI_CONFIG_TOOL now contains the default behaviour once a SSID has been configured.
• If no SSID is configured making a wifi connection impossible the new define WIFI_CONFIG_NO_SSID will be used.
• While define WIFI_CONFIG_NO_SSID is set to WIFI_WPSCONFIG in my_user_config.h the compiler will check for define USE_WPS and if not enabled WIFI_CONFIG_NO_SSID will default to WIFI_MANAGER using the webserver. If define USE_WEBSERVER is also not enabled WIFI_CONFIG_NO_SSID will default to WIFI_SMARTCONFIG. If define USE_SMARTCONFIG is also not enabled WIFI_CONFIG_NO_SSID will default to a new option WIFI_SERIAL allowing to enter wifi parameters to serial which is always possible.

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 SHP2	BlitzWolf BW-SHP2, BW-SHP6, HomeCube SP1, Gosund SP111 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 SP20, 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

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library version 2.3.0

• 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.
• sonoff-classic.bin = The Classic version allows initial installation using either WifiManager, Wps or SmartConfig.
• sonoff.bin = The Sonoff version without Wps and SmartConfig configuration but adds more sensors.
• sonoff-BG.bin to sonoff-TW.bin = The Sonoff version without Wps and SmartConfig configuration in different languages.
• sonoff-sensors.bin = The Sensors version without Wps and SmartConfig configuration but adds even more useful sensors.
• sonoff-display.bin = The Display version without Wps and SmartConfig configuration but adds display support.
• sonoff-knx.bin = The Knx version without Wps and SmartConfig configuration and some other features but adds KNX support.

See Tasmota ESP/Arduino library version related issues why these files are still released using ESP/Arduino library version v2.3.0.

Available Features and Sensors

Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors	Remarks
ESP/Arduino lib v2.3.0	343k	425k	484k	490k	508k	517k
ESP/Arduino lib v2.4.2	372k	451k	497k	517k	533k	541k	No sleep
MY_LANGUAGE en-GB	x	x	x	x	x	x
MQTT_LIBRARY_TYPE PUBSUBCLIENT	x	x	x	x	x	x
USE_WPS	-	-	x	-	-	-	WPS
USE_SMARTCONFIG	-	-	x	-	-	-	SmartConfig
USE_ARDUINO_OTA	-	-	-	-	-	-
USE_DOMOTICZ	-	-	x	x	x	x
USE_HOME_ASSISTANT	-	-	x	x	x	x
USE_MQTT_TLS	-	-	-	-	-	-
USE_KNX	-	-	-	-	x	-
USE_WEBSERVER	x	x	x	x	x	x	WifiManager
USE_EMULATION	-	x	x	x	-	x
USE_DISCOVERY	-	-	x	x	x	x
WEBSERVER_ADVERTISE	-	-	x	x	x	x
MQTT_HOST_DISCOVERY	-	-	x	x	x	x
USE_TIMERS	-	x	-	x	x	x
USE_TIMERS_WEB	-	x	-	x	x	x
USE_SUNRISE	-	x	-	x	x	x
USE_RULES	-	x	-	x	x	x
USE_ADC_VCC	x	x	x	x	x	-
USE_DS18B20	-	-	-	-	-	-	Single sensor
USE_DS18x20	-	-	x	x	x	x	Multiple sensors
USE_DS18x20_LEGACY	-	-	-	-	-	-	Multiple sensors
Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors
USE_I2C	-	-	-	x	x	x
USE_SHT	-	-	-	x	x	x
USE_HTU	-	-	-	x	x	x
USE_BMP	-	-	-	x	x	x
USE_BME680	-	-	-	-	-	x
USE_BH1750	-	-	-	x	x	x
USE_VEML6070	-	-	-	-	-	x
USE_ADS1115	-	-	-	-	-	x
USE_ADS1115_I2CDEV	-	-	-	-	-	-
USE_INA219	-	-	-	-	-	x
USE_SHT3X	-	-	-	x	x	x
USE_TSL2561	-	-	-	-	-	x
USE_MGS	-	-	-	-	-	x
USE_SGP30	-	-	-	x	x	x
USE_SI1145	-	-	-	-	-	x
USE_LM75AD	-	-	-	x	x	x
USE_APDS9960	-	-	-	-	-	-
USE_MCP230xx	-	-	-	-	-	-
USE_PCA9685	-	-	-	-	-	-
USE_MPR121	-	-	-	-	-	-
USE_CCS811	-	-	-	-	-	-
USE_MPU6050	-	-	-	-	-	-
USE_DS3231	-	-	-	-	-	-
Feature or Sensor	minimal	basic	classic	sonoff	knx	sensors
USE_SPI	-	...

Sonoff-Tasmota v6.2.1

Update 20180909-2100

Thanks to Andre Thomas the latest released binaries work as intended on all hardware.

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

Release notes

Change in default initial configuration tool

Firmware binary sonoff-classic.bin supports WifiManager, Wps and SmartConfig for initial configuration. The default tool is Wps.

To save memory space all other binaries support WifiManager only.

See _changelog.ino how to enable them again.

• Define WIFI_CONFIG_TOOL now contains the default behaviour once a SSID has been configured.
• If no SSID is configured making a wifi connection impossible the new define WIFI_CONFIG_NO_SSID will be used.
• While define WIFI_CONFIG_NO_SSID is set to WIFI_WPSCONFIG in user_config.h the compiler will check for define USE_WPS and if not enabled WIFI_CONFIG_NO_SSID will default to WIFI_MANAGER using the webserver. If define USE_WEBSERVER is also not enabled WIFI_CONFIG_NO_SSID will default to WIFI_SMARTCONFIG. If define USE_SMARTCONFIG is also not enabled WIFI_CONFIG_NO_SSID will default to a new option WIFI_SERIAL allowing to enter wifi parameters to serial which is always possible.

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library version 2.3.0

• 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.
• sonoff-classic.bin = The Classic version allows initial installation using either WifiManager, Wps or SmartConfig.
• sonoff.bin = The Sonoff version without Wps and SmartConfig configuration but adds more sensors.
• sonoff-BG.bin to sonoff-TW.bin = The Sonoff version without Wps and SmartConfig configuration in different languages.
• sonoff-sensors.bin = The Sensors version without Wps and SmartConfig configuration but adds even more useful sensors.
• sonoff-knx.bin = The Knx version without Wps and SmartConfig configuration and some other features but adds KNX support.

See Tasmota ESP/Arduino library version related issues why these files are still released using ESP/Arduino library version v2.3.0.

Available Features and Sensors

Feature or Sensor	minimal	classic	sonoff	knx	sensors	Remarks
ESP/Arduino lib v2.3.0	340k	477k	473k	492k	497k
ESP/Arduino lib v2.4.2	360k	491k	491k	509k	513k	No sleep
MY_LANGUAGE en-GB	x	x	x	x	x
USE_WPS	-	x	-	-	-	WPS
USE_SMARTCONFIG	-	x	-	-	-	SmartConfig
USE_ARDUINO_OTA	-	-	-	-	-
MQTT_LIBRARY_TYPE PUBSUBCLIENT	x	x	x	x	x
USE_DOMOTICZ	-	x	x	x	x
USE_HOME_ASSISTANT	-	x	x	x	x
USE_MQTT_TLS	-	-	-	-	-
USE_KNX	-	-	-	x	-
USE_WEBSERVER	x	x	x	x	x	WifiManager
USE_EMULATION	-	x	x	-	x
USE_DISCOVERY	-	x	x	x	x
WEBSERVER_ADVERTISE	-	x	x	x	x
MQTT_HOST_DISCOVERY	-	x	x	x	x
USE_TIMERS	-	-	x	x	x
USE_TIMERS_WEB	-	-	x	x	x
USE_SUNRISE	-	-	x	x	x
USE_RULES	-	-	x	x	x
USE_ADC_VCC	x	x	x	x	x
USE_DS18B20	-	-	-	-	-	Single sensor
USE_DS18x20	-	x	x	x	x	Multiple sensors
USE_DS18x20_LEGACY	-	-	-	-	-	Multiple sensors
Feature or Sensor	minimal	classic	sonoff	knx	sensors
USE_I2C	-	-	x	x	x
USE_SHT	-	-	x	x	x
USE_HTU	-	-	x	x	x
USE_BMP	-	-	x	x	x
USE_BME680	-	-	-	-	x
USE_BH1750	-	-	x	x	x
USE_VEML6070	-	-	-	-	x
USE_ADS1115	-	-	-	-	x
USE_ADS1115_I2CDEV	-	-	-	-	-
USE_INA219	-	-	-	-	x
USE_SHT3X	-	-	x	x	x
USE_TSL2561	-	-	-	-	x
USE_MGS	-	-	-	-	x
USE_SGP30	-	-	x	x	x
USE_SI1145	-	-	-	-	x
USE_LM75AD	-	-	x	x	x
USE_APDS9960	-	-	-	-	-
USE_MCP230xx	-	-	-	-	-
USE_MPR121	-	-	-	-	-
USE_CCS811	-	-	-	-	-
USE_MPU6050	-	-	-	-	-
Feature or Sensor	minimal	classic	sonoff	knx	sensors
USE_SPI	-	-	-	-	-
USE_MHZ19	-	-	x	x	x
USE_SENSEAIR	-	-	x	x	x
USE_PMS5003	-	-	x	x	x
USE_NOVA_SDS	-	-	x	x	x
USE_PZEM004T	-	-	x	x	x
USE_SERIAL_BRIDGE	-	-	x	x	x
USE_SDM120	-	-	-	-	x
USE_SDM630	-	-	-	-	x
USE_IR_REMOTE	-	-	x	x	x
USE_IR_HVAC	-	-	-	-	x
USE_IR_RECEIVE	-	-	x	x	x
USE_WS2812	-	x	x	x	x
USE_WS2812_DMA	-	-	-	-	-
USE_ARILUX_RF	-	-	x	x	x
USE_SR04	-	-	x	x	x
USE_TM1638	-	-	-	-	-
USE_RF_FLASH	-	-	x	x	x

Changelog

Version 6.2.1 20180905

• Fix possible ambiguity on command parameters if StateText contains numbers only (#3656)
• Fix Wemo emulation to select the first relay when more than one relay is present (#3657)
• Fix possible exception due to buffer overflow (#3659)
• Fix lost energy today and total energy value after power cycle (#3689)

Version 6.2.0 20180901

• Allow user override of define MAX_RULE_VARS and MAX_RULE_TIMERS (#3561)
• Disable wifi sleep for both Esp8266/Arduino core 2.4.1 and 2.4.2 to solve device freeze caused by Espressif SDK bug (#3554)
• Change DS18B20 driver to provide better instant results
• Change some sensor drivers to provide instant results
• Change define USE_ALL_SENSORS to USE_SENSORS as it doesn't contain all sensors due to duplicate I2C addresses
• Change some sensor update timings: AdcEvery 200 -> 250, Senseair 300 -> 250, SDM120 300 -> 250, SDM630 300 -> 250
• Change default Wifi config option from WPS to Wifi Manager if WPS is disabled or Wifi Smartconfig if webserver is disabled or Wifi Serial input if Smartconfig is disabled
• Change SHT1x driver to provide better instant results and fix I2C interference
• Change DHT driver to provide better instant results and add decimals to DHT11 (#3164)
• Change DS18x20 driver to provide better instant results (#3169)
• Change CounterType 1 from milliseconds to microseconds (#3437)
• Change scheduler for better sleep support using Uptime, Delay, PulseTime and TelePeriod, Blinktime (#3581)
• Remove unused functionality from Sonoff-minimal to save space
• Remove WPS and SmartConfig from sonoff-minimal saving 56k code space
• Remove TSL2561 debug message and update library (#2415)
• Remove forced restart when sleep command is executed (#3554)
• Fix invalid response using more than 4 switches and domoticz
• Fix sonoff-minimal not using default settings
• Fix unsecure main webpage update
• Fix DHT driver mixing values for different sensors (#1797)
• Fix EnergyReset3 regression not clearing total energy (#2723)
• Fix rules once regression from v6.1.0 (#3198, #3226)
• Fix command Scale buffer overflow (#3236)
• Fix possible WDT due to long MQTT publish handling (#3313)
• Fix command TimeDst/TimeStd invalid JSON (#3322)
• Fix handling of default names when using names starting with shortcut character ",0,1 or 2 (#3392, #3600, #3618)
• Fix LM75AD I2C sensor detection (#3408)
• Fix iFan02 power on state (#3412, #3530)
• Fix some Pow R2 and S31 checksum errors using optimized re-sync (#3425)
• Fix SDM120 reporting wrong negative values to Domoticz (#3521)
• Fix MQTT reconnection detection when using TasmotaMqtt library (#3558)
• Fix OtaMagic when file path contains a dash (-) (#3563)
• Fix Sonoff Bridge data reception when using Portisch EFM8 firmware using in data buffer length (#3605)
• Add read sensor retry to DS18B20, DS18x20, DHT, SHT1X and ...

Sonoff-Tasmota

Update 20180731

Replaced sonoff.bin with a slightly smaller version (disabled sensor LM75AD) making wifi connection more stable due to different compiler optimization.
Replaced sonoff-minimal with a version not forcing to default settings leading to unability to upload final image.

Update 20180723

Removed Travis builds containing byte alignment errors and uploaded new re-compiled binaries.

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

Changelog

Version 6.1.1 20180714

• Revert wifi changes (#3177)
• Revert some sonoff-minimal removals causing failure of wifi connection (#3177)

Version 6.1.0 20180706

• Remove version 3, 4 and pre 5.2 settings auto-upgrade. See https://github.com/arendst/Sonoff-Tasmota/wiki/Upgrade#migration-path
• Change default CFG_HOLDER from 0x20161209 to 4617 (=0x1209) - no impact on default upgrades
• Change number of supported switches from 4 to 8 (#2885, #3086)
• Change BME680 driver from Adafruit to Bosch BME680 library (#2969)
• Fix Pzem004T checksum error
• Fix KNX bug when doing reply of sensors values
• Fix rules induced LWT message
• Fix possible wifi connection problem (#1366)
• Fix some Pow R2 and S31 checksum errors (#1907)
• Fix display selection of un-available GPIO options in Module Configuration webpage (#2718)
• Fix timer re-trigger within one minute after restart (#2744)
• Fix IRSend not accepting data value of 0 by David Conran (#2751)
• Fix vars on rules by Adrian Scillato (#2769)
• Fix bug in KNX menu by Adrian Scillato (#2770)
• Fix anomalies in rules (#2778)
• Fix HUE bridge V1 software version by Heiko Krupp (#2788)
• Fix Hardware Watchdog restart when using event command (#2853)
• Add Ukrainian language file
• Add KNX support for DS18S20 Temperature sensor
• Add CRC to Settings making future upgrades more fail-safe
• Add feature information to Status 4
• Add tools folder with python script decode-status.py for decoding some status fields like SetOption and Features
• Add Slots on the KNX Web Menu to select Group Addess to receive data to trigger rules
• Add two rule sets of 511 characters using commands rule1, rule2 and rule3
• Add Console Commands to send KNX Commands and KNX Values
• Add Slots on the KNX Web Menu to select Group Addess to send data from console commands
• Add Events to trigger rules when a command or read requests is received from KNX
• Add command SetOption30 to enforce Hass discovery as light group (#1784)
• Add support for BlitzWolf BW-SHP2 (and Homecube, Gosund SP1) Energy Monitoring Smart Socket (#2223)
• Add time in minutes to rule Time#Initialized, Time#set and Time#Minute (#2669)
• Add Eastron SDM630 energy meter by Gennaro Tortone (#2735)
• Add KNX communication enhancement by Adrian Scillato (#2742)
• Add KNX energy data by Adrian Scillato (#2750)
• Add rule support for IrReceive and RfReceive (#2758)
• Add python script fw-server.py in tools folder to create a simple OTA server by Gennaro Tortone (#2759)
• Add rule variables %time% for minutes since midnight, %uptime%, %sunrise% and %sunset% giving time in minutes (#2669)
• Add rules %mem1% to %mem5% variable names storing data in flash (#2780)
• Add rules test on %varx% or %memx% (#2780)
• Add optional token %id% substituting the unique MAC address to fulltopic by Michael Graf (#2794)
• Add support for Sonoff S26 Smart Socket (#2808)
• Add command WebSend [<host>(:<port>,<user>:<password>)] <command> (#2821)
• Add increment and decrement value to command Counter (#2838)
• Add support for Sonoff iFan02 as module 44 introducing command FanSpeed 0..3 (#2839)
• Add source information to command execution to be shown with logging option 3 (#2843)
• Add support for uploading Sonoff Bridge firmware found in tools/fw_efm8bb1 folder build by Portisch using Web Gui File Upload (#2886)
• Add command RfRaw to control Portisch firmware features
• Add support for I2C temperature sensor LM75AD (#2909)
• Add option 0 to command Timers disarming all timers (#2962)
• Add performance improvement when updating multiple individual WS2812 pixels (#3007)
• Add command SetOption28 to switch between hex or decimal Sonoff Bridge RF received data format (#3008)
• Add command SetOption29 to switch between hex or decimal IR received data format
• Add decimal values support for commands ADD, SUB, MULT and SCALE (#3083, #3089)
• Add support for bitflags SetOption50 .. SetOption81 (#3118)

Provided Binary Downloads

The following binary downloads have been compiled with ESP8266/Arduino library version 2.3.0

• sonoff.bin = the default firmware in English
• sonoff-minimal.bin = is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired sonoff.bin allows for firmware size growth over the OTA file limit of 1/2 flash size. The settings in this version are non-persistent.
• sonoff-classic.bin = is a version of sonoff.bin with almost the same features as previous releases (without IR receive) to enable OTA upload in one go.
• sonoff-knx.bin = is a version of sonoff.bin with KNX enabled and Emulation disabled to safe some code and memory space.
• sonoff-allsensors.bin = is a version of sonoff.bin with all sensors enabled including support for more ds18x20 sensors.
• sonoff-BG.bin to sonoff-TW.bin = the default firmware in different languages

See Tasmota ESP/Arduino library version related issues why these files are still released using ESP/Arduino library version v2.3.0.

Sonoff-Tasmota

Update 20180731

Replaced sonoff-minimal with a version not forcing to default settings leading to unability to upload final image.

Update 20180723

Removed Travis builds containing byte alignment errors and uploaded new binaries.

Changelog

Version 5.14.0 20180515

• Update language files
• Update TasmotaSerial to 2.0.0 allowing Hardware Serial Fallback when correct connections are configured
• Change command handling
• Change user_config(_override).h defines TIME_STD and TIME_DST
• Change user_config(_override).h otaurl to http://sonoff.maddox.co.uk/tasmota/sonoff.bin (#2588, #2602)
• Fix configuration restore regression from 5.13.1
• Fix compile error when ADC is enabled and Rules are disabled (#2608)
• Fix rule power trigger when no backlog command is used (#2613)
• Fix several timer data input and output errors (#2597, #2620)
• Fix KNX config error (#2628)
• Fix sensor MHZ-19 vanishing data over time (#2659)
• Fix KNX reconnection issue (#2679)
• Fix DST and STD time for Southern Hemisphere (#2684, #2714)
• Add Portuguese in Brazil language file
• Add SetOption26 to enforce use of indexes even when only one relay is present (#1055)
• Add support for sensor SI1145 UV Index / IR / Visible light (#2496)
• Add rule state test for On/Off in addition to 0/1 (#2613)
• Add hardware serial option to MHZ-19 sensor (#2659)
• Add Eastron SDM120 energy meter (#2694)
• Add user entry DST/STD using commands TimeStd and TimeDst (See wiki for parameter syntax) (#2721)

Provided pre-compiled binary downloads

The following binary downloads have been compiled with ESP8266/Arduino core version 2.3.0

• sonoff.bin = the default firmware in English
• sonoff-minimal.bin = is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired sonoff.bin allows for firmware size growth over the OTA file limit of 1/2 flash size.
• sonoff-classic.bin = is a version of sonoff.bin with almost the same features as previous releases (without IR receive) to enable OTA upload in one go.
• sonoff-knx.bin = is a version of sonoff.bin with KNX enabled and Emulation disabled to safe some code and memory space.
• sonoff-allsensors.bin = is a version of sonoff.bin with all sensors enabled including support for more ds18x20 sensors.
• sonoff-BG.bin = the default firmware in Bulgarian
• sonoff-BR.bin = the default firmware in Portuguese in Brazil
• sonoff-CN.bin = the default firmware in Simplified Chinese
• sonoff-CZ.bin = the default firmware in Czech
• sonoff-DE.bin = the default firmware in German
• sonoff-ES.bin = the default firmware in Spanish
• sonoff-FR.bin = the default firmware in French
• sonoff-GR.bin = the default firmware in Greek
• sonoff-HU.bin = the default firmware in Hungarian
• sonoff-IT.bin = the default firmware in Italian
• sonoff-NL.bin = the default firmware in Dutch
• sonoff-PL.bin = the default firmware in Polish
• sonoff-PT.bin = the default firmware in Portuguese
• sonoff-RU.bin = the default firmware in Russian
• sonoff-TW.bin = the default firmware in Traditional Chinese in Taiwan

Sonoff-Tasmota

Changelog

Version 5.13.1 20180501

• Fix JSON buffers size too small for execution in some situations (#2580)
• Fix configuration restore (#2591)
• Add define MODULE for user selecting default model although it preferably should not be changed (#569, #2589)

Version 5.13.0 20180430

• Change platformio option sonoff-ds18x20 to sonoff-allsensors enabling ds18x20 and all other sensors in one image
• Change status display of Ssid and SetOption
• Change default option SetOption15 from 0 to 1 providing better initial PWM experience
• Change webpage parameter communication
• Change max number of commands in Backlog from 15 to 30 and ignore commands overflowing
• Change TSL2561 driver to joba library and delete Adafruit library (#1644)
• Change default parameters in user_config.h to undefined for easy installation (#1851)
• Change max user configurable hold time from 10 to 25 seconds (#1851)
• Change Sonoff SC JSON format (#1939)
• Change Polish language to using Diacritics (#2005)
• Change user_config_override usage by providing user_config_override_sample.h (#2228)
• Change MQTT response topic for Energy changes from ENERGY to SENSOR (#2229, #2251)
• Change default Reset configuration time from 4 seconds to 40 seconds on Button hold (#2268)
• Change ESP8266 Analog JSON message from {"Analog0:123"} to {"ANALOG":{"A0:123"}} to accomodate rules (#2560)
• Change Counter JSON message from {"Counter1":0,"Counter3":0} to {"COUNTER":{"C1":0,"C3":0}} to accomodate rules
• Change ADS1115 JSON message from {"ADS1115":{"Analog0":123,"Analog1":123}} to {"ADS1115":{"A0":123,"A1":123}}
• Fix intermittent exception when dns lookup is used while sleep is enabled
• Fix 5.4.0 regression turning off single press after button hold during 4x hold time
• Fix possible wifi connection problem by erasing sdk configuration parameters
• Fix NTP sync to Thu Jan 01 08:00:10 1970 results in uptime 17651+ days (core2.4.1/sdk2.2.1)
• Fix MAX31850 higher temperatures (#1269)
• Fix freeing more code space when emulation is disabled (#1592)
• Fix providing web page configuratin option for Friendly Name when no device (relay or light) is configured (#1850)
• Fix compile error when define HOME_ASSISTANT_DISCOVERY_ENABLE is not set (#1937)
• Fix MQTT TLS fingerprint validation (#2033)
• Fix update temperature on DS18x20 drivers (#2328)
• Fix compile error when not defined USE_TIMERS (#2400)
• Fix configuration filename truncation when it contains spaces (#2484, #2490)
• Fix Energy Today and Yesterday overflow (#2543)
• Add serial debug info
• Add Portuguese language file
• Add Czech language file
• Add Bulgarian language file
• Add Domoticz dust (custom) sensors to PMS5003 and NovaFitness SDS drivers as PM1, PM2.5 and PM10
• Add commands Publish, Rule, RuleTimer and Event. See Wiki about Rule restriction, usage and examples
• Add sonoff-classic, sonoff-allsensors and sonoff-knx
• Add some coloring to important web buttons
• Add support for sensor HC-SR04 ultrasonic (#113, #1964, #2444)
• Add define MQTT_TELE_RETAIN compile option default set to 0 (#1071)
• Add 16 timers using commands Timer and Timers (#1091)
• Add optional Timer configuration webpage to be enabled in user_config.h with define USE_TIMERS_WEB
• Add Multichannel Gas sensor using MultiChannel_Gas_Sensor library (#1245)
• Add Domoticz Battery and RSSI Quality (#1604)
• Add command HSBColor Hue,Sat,Bri (#1642, #2203)
• Add compile time support for WS2812 BRG and RBG led configurations to be defined in user_config.h (#1690)
• Add optional usage of %d or %X suffices in MQTT client to append chipid (#1871)
• Add optional usage of %d or %X suffices in MQTT topic to append chipid (#1871)
• Add optional usage of %d or %04d in ota url to be replaced with chipid (#1871)
• Add Sonoff Bridge command RfKey 5 to show current RF key values either default or learned (#1884)
• Add user configurable serial GPIOs to MagicHome and Arilux modules (#1887)
• Add Russian language file (#1909)
• Add Webserver upload preflight request support (#1927)
• Add Home Assistant clear other device (#1931)
• Add Restart time to Status 1 (#1938)
• Add optional TSL2561 driver using library Joba_Tsl2561 to be enabled in user_config.h with define USE_TSL2561_JOBA (#1951)
• Add support for sensor SHTC3 (#1967)
• Add compiler check for stable lwIP version v1.4 (#1940)
• Add support for multiple SHT3X sensors (#1949, #2110)
• Add always suffix with device number in Mqtt discovery topic (#1962)
• Add support for optional MQTT drivers to be selected in user_config.h (#1992)
• Add optional Arduino OTA support to be enabled in user_config.h (#1998)
• Add diacritics to Polish language file (#2005)
• Add Hungarian language file (#2024)
• Add support for Nova Fitness SDS011 and possibly SDS021 particle concentration sensor (#2070)
• Add single decimal precision to Nova Fitness SDS0x1 sensor values (#2093)
• Add Chinese (Traditional) in Taiwan language file (#2108)
• Add Sonoff SC domoticz support for Sound level as Counter and Air quality (#2118)
• Add a second TLS fingerprint to allow switching keys in TLS mode (#2033, #2102)
• Add display of remaining pulse time to command PulseTime (#2085)
• Add additional time offset to Wifi Retry based on device mac address (#2089)
• Add command Color6 RRGGBB for Clock hour marker color and command Rotation pixels for Clock rotation (#2092)
• Add HTML language header in local language (#2123)
• Add command PowerDelta 0..100 (percentage) to Energy monitoring devices to report on active power load change (#2157)
• Add Restart Reason to Status 1 report (#2161)
• Add command Channel 0..100 to control dimmer value for individual color channels (#2111, #2203)
• Add support for Hardware Serial bridge using commands SerialDelimiter, Baudrate and SerialSend. Supports 8N1 and text only (#2182)
• Add support for Software Serial bridge using commands SerialDelimiter, SBaudrate and SSerialSend. Supports 8N1 and text only (#2190)
• Add support for Zengge WF017 PWM Led strip controller (#2202)
• Add PWM status to command State if PWM enabled (#2203)
• Add all FriendlyNames to Status information (#2208)
• Add Channel status information (#2211)
• Add hexadecimal Data entry to command IrSend using 0x notation (#1290, #2314)
• Add Home Assistant MQTT Discovery for Buttons and change SetOption19 response (#2277)
• Add multiple color entry support for command Led like Led2 120000 001200 000012 setting led2 as Red, Led3 as Green and Led4 as Blue (#2303)
• Add hexadecimal RGB color entry on RGBCW leds (#2304)
• Add support for SGP30 gas and air quality sensor (#2307)
• Add optional Sunrise and Sunset timers with commands Latitide and Longitude to be enabled with define USE_SUNRISE in user_config.h (#2317)
• Add timer sunrise and sunset offset (#2378)
• Add user selectable defines for Sunrise/set Dawn option (#2378)
• Add optional KNX IP Protocol Support (#2402)
• Add random window to timers (#2447)
• Add Greek language file (#2491)
• Add support for Sonoff Pow R2 (#2340)
• Add GPIO_User to GPIO02 for all Sonoff T1 (#2524)

Provided pre-compiled binary downloads

The following binary downloads have been compiled with ESP8266/Arduino core version 4.0.0

• sonoff.bin = the default firmware in English
• sonoff-minimal.bin = is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired sonoff.bin allows for firmware size growth over the OTA file limit of 1/2 flash size.
• sonoff-classic.bin = is a version of sonoff.bin with almost the same features as previous releases (without IR receive) to enable OTA upload in one go.
• sonoff-knx.bin = is a version of sonoff.bin with KNX enabled and Emulation disabled to safe some code and memory space.
• sonoff-allsensors.bin = is a version of sonoff.bin with all sensors enabled including support for more ds18x20 sensors.
• sonoff-BG.bin = the default firmware in Bulgarian
• sonoff-CN.bin = the default firmware in Simplified Chinese
• sonoff-CZ.bin = the default firmware in Czech
• sonoff-DE.bin = the default firmware in German
• sonoff-ES.bin = the default firmware in Spanish
• sonoff-FR.bin = the default firmware in French
• sonoff-GR.bin = the default firmware in Greek
• sonoff-HU.bin = the default firmware in Hungarian
• sonoff-IT.bin = the default firmware in Italian
• sonoff-NL.bin = the default firmware in Dutch
• sonoff-PL.bin = the default firmware in Polish
• sonoff-PT.bin = the default firmware in Portuguese
• sonoff-RU.bin = the default firmware in Russian
• sonoff-TW.bin = the default firmware in Traditional Chinese in Taiwan

Sonoff-Tasmota

5.12.0 20180209

• Change library PubSubClient.h define MQTT_MAX_PACKET_SIZE from 512 to 1000 for Home Assistant support
• Change relation of define MESSZ being dependent on PubSubClient.h define MQTT_MAX_PACKET_SIZE
• Change command color parameter input checks to less strict for Home Assistant support
• Change command Ina219Mode into command Sensor13
• Change commands HlwPCal, HlwUCal and HlwICal to PowerCal, VoltageCal and CurrentCal to be used for both Pow and S31 calibration
• Change commands HlwPSet, HlwUSet and HlwISet to PowerSet, VoltageSet and CurrentSet to be used for both Pow and S31 calibration
• Change uptime from hour to second resulting in a display of 123T13:45:21 where 123 is days
• Change module name Wemos D1 mini into Generic (#1220)
• Change HTML from width=100% to style=width:100% supporting HTML5 (#1358)
• Change OSWATCH_RESET_TIME (Blocked loop) from 30 to 120 seconds to allow slow networks (#1556)
• Change WIFI_MANAGER_SEC into WIFI_CONFIG_SEC (#1616)
• Change function pointers code to save code space and memory (#1683)
• Change webserver argument processing gaining 5k code space (#1705)
• Change weblog memory usage (#1730, #1793, #1819)
• Update TasmotaSerial library to 1.1.0
• Update language files Italian (#1594), Dutch (#1723) and Spanish (#1722)
• Fix Non-English JSON temperature unit attachement
• Fix Arilux RF induced exception by moving interrupt handler to iram on non ESP8266/Arduino lib v2.3.0
• Fix truncated command names and wrong response for DomoticzSwitchIdx (#1571)
• Fix %-sign issue as printf escape character in Humidity and Sonoff SC (#1579)
• Fix DS18B20 temperature JSON decimal dot (#1561)
• Fix Energy JSON message (#1621)
• Fix IRSend parameter translation (#1636)
• Fix TSL2561 device detection (#1644, #1825)
• Fix BME680 teleperiod resistance measuring (#1647)
• Fix Energy Monitoring Energy Today and Energy Total reading after restart (#1648)
• Fix IRReceive Data value (#1663)
• Fix Energy Monitoring Energy Period roll-over (#1688)
• Fix compiler warnings (#1774)
• Fix command PWM response if no PWM channel is configured (#1783)
• Add locale Decimal Separator to Web sensor page
• Add ColorTemperature to light status message
• Add command PowerOnState option 5 which inverts PulseTime and allows for delayed always on after power on
• Add OtaMagic two step Web server OTA upgrade using filename-minimal image if OTA free space is too small
• Add support for PMS5003 and PMS7003 particle concentration sensor
• Add command SetOption21 1 to allow Energy Monitoring when power is off on Sonoff Pow and Sonoff S31 (#1420)
• Add Chinese language file (#1551)
• Add French language file (#1561)
• Add Spanish language file (#1589)
• Add HTTP Allow Cross Origin removed from ESP8266/Arduino lib v2.4.0 (#1572)
• Add Home Assistant MQTT Discovery for switch and light to be enabled by command SetOption19 1 (#1534) or define HOME_ASSISTANT_DISCOVERY_ENABLE in user_config.h (#1685)
• Add command State to retrieve device state information (same data as teleperiod state and status 11 in slightly different JSON format)
• Add optional login to Webserver AP mode (#1587, #1635)
• Add command Sensor15 2 to start MHZ19(B) Zero Point Calibration (#1643)
• Add support for Sonoff S31 Smart Socket with Power Consumption Detection (#1626)
• Add command SetOption20 to allow update of Dimmer/Color/Ct without turning power on (#1719, #1741)
• Add NTP sync time slot based on chip id (#1773)
• Add cursor pointer to web button (#1836)

Provided pre-compiled binary downloads

• sonoff.bin = the default firmware in English
• sonoff-CN.bin = the default firmware in Simplified Chinese
• sonoff-DE.bin = the default firmware in German
• sonoff-ES.bin = the default firmware in Spanish
• sonoff-FR.bin = the default firmware in French
• sonoff-IT.bin = the default firmware in Italian
• sonoff-NL.bin = the default firmware in Dutch
• sonoff-PL.bin = the default firmware in Polish
• sonoff-minimal.bin = is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired sonoff.bin allows for firmware size growth over the OTA file limit of 1/2 flash size.
• sonoff-ds18x20.bin = is a version of sonoff.bin with the USE_DS18x20 define enabled to be used when more than 1 ds18x20 sensor is connected.

Sonoff-Tasmota

5.11.1 20180107

• Fix Sonoff Pow command handling (#1542)

Provided pre-compiled binary downloads

• sonoff.bin = the default firmware for all devices in English
• sonoff-DE.bin = the default firmware for all devices in German
• sonoff-IT.bin = the default firmware for all devices in Italian
• sonoff-NL.bin = the default firmware for all devices in Dutch
• sonoff-PL.bin = the default firmware for all devices in Polish
• sonoff-minimal.bin = is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired sonoff.bin allows for firmware size growth over the OTA file limit of 1/2 flash size.
• sonoff-ds18x20.bin = is a version of sonoff.bin with the USE_DS18x20 define enabled and a larger MQTT buffer size to be used by people having more than 6 ds18x20 sensors connected.