Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Shelly 1 and 2
The Shelly 1 and 2 are fully supported in Tasmota from version 184.108.40.206
- Allterco Shelly 1 Product Page: https://shelly.cloud/shelly1-open-source/
- Allterco Shelly 1 Shop: https://shelly.cloud/product/shelly-1-open-source/
- Allterco Shelly 2 Product Page: https://shelly.cloud/shelly2/
- Allterco Shelly 2 Shop: https://shelly.cloud/product/shelly-2/
- Initial issue: https://github.com/arendst/Sonoff-Tasmota/issues/2789
⚠️️Special Shelly Attention⚠️️
Do not connect AC power and the serial connection at the same time The Gnd connection of the Shelly has a 50% chance of being connected to the live AC wire. Connecting serial with your PC will fry your PC.
Do not connect any additional sensors to serial pins. It can at least destroy your Shelly!
Check the correct jumper position before connecting AC power to Shelly 1. If the jumper is set to 12V you will destroy your Shelly!
An ESP8266 with 2MB flash single relay device the size of round 42mm.
Shelly1 comes with a programming/debug header which can be used to flash Tasmota on the device. A USB-to-UART adapter is needed as well as a reliable 3.3V with at least 350 mA drive capability. The following diagram shows the device pinout and power source voltage selection jumper.
Please note what version of the Shelly 1 you have (V1 or V2). The V2 user guide is incorrect. The mains connections are as shown in the image above for both versions of the switch. The labels on the V2 switches are wrong!
An ESP8266 with 2MB flash dual relay device with Energy Monitoring the size of round 45mm.
per Dimitar Dimitrov (Shelly's Facebook board moderator) - "You can order Shelly2 without glued shells. You can glue later."
Tasmota will disable serial logging after a restart as the communication between Tasmota and the Energy Monitoring chip is using the same serial interface. Make sure not to enable seriallog as it will interfere with the Energy Monitoring functionality.
To calibrate the Energy monitoring feature connect a known load and execute the commands shown below. Assumed an AC voltage of 240V, a resistive load of 60W and a line frequency of 50Hz. With a load of 60W the current should be 60W / 240V = 0.25A.
FrequencySet 50.000 PowerSet 60.00 VoltageSet 240.0 CurrentSet 250.0
Pause a few seconds between executing the commands as the communication between Tasmota and the Energy Monitoring chip is a serial interface which can take over a second to complete.
Use rules to control shutter endpoints
As the Shelly 2 contains energy monitoring you can use rules to power off the shutter when too much current is drawn at the end point. The below rule will power off both directions when the current becomes more than 500mA.
rule on energy#current>0.500 do backlog power1 0; power2 0 endon rule 1 rule 5