Shelly 1 and 2

Michael Ingraham edited this page Nov 18, 2018 · 21 revisions

The Shelly 1 and 2 are fully supported in Tasmota from version

⚠️️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!

Shelly 1

An ESP8266 with 2MB flash single relay device the size of round 42mm.

Serial Connection

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!

Shelly 2

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."

Serial Connection


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

Theo's Tasmota Tips
What's New

Getting Started

Upload tools


Devices - Additional Info

Home Automation Integration

Other Integrations

Further Topics



Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.