mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Shelly 2.5 (markdown)

Michael Ingraham 2019-08-26 00:15:03 -04:00
parent 036320f2d4
commit df30664a78
1 changed files with 16 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
Shelly-2.5.md

@ -8,37 +8,33 @@ The Shelly 2.5 is supported from Tasmota 6.5.0.8 using a template.
## ⚠️️Special Shelly Attention⚠️️
**DO NOT CONNECT ANYTHING TO ANY GPIOs OF THESE DEVICES!!! (No sensors, no switches, nothing) <br>
**DO NOT CONNECT ANYTHING TO ANY GPIOs OF THESE DEVICES!!! (No sensors, no switches, nothing)
The GPIOs on the Shelly are connected to AC power!** Only use a Shelly as designed.
**Do not connect AC power and the serial connection at the same time**
The GND connection of the Shelly is connected to the live AC wire. Connecting serial with your PC will fry your PC.
# [Shelly 2.5](https://shelly.cloud/shelly-25-wifi-smart-relay-roller-shutter-home-automation/)
**Warning (April 10, 2019):** https://www.facebook.com/groups/ShellyIoTCommunitySupport/permalink/2029876037111750/
_This appears to affect a percentage of their entire first run production. **Check your device before powering it on.**_
**[Warning](https://www.facebook.com/groups/ShellyIoTCommunitySupport/permalink/2029876037111750/) (April 10, 2019):** _This appears to affect a percentage of their entire first run production. **Check your device before powering it on.**_
An ESP8266 with 2MB flash dual relay device with Energy Monitoring. Slightly smaller than the original Shelly 2.
<img src="https://shelly.cloud/wp-content/uploads/2019/01/s25_size2.jpg" height="250" />
<img src="https://shelly.cloud/wp-content/uploads/2019/01/s25_size.jpg" height="250" />
[Internals](https://scontent-atl3-1.xx.fbcdn.net/v/t1.0-9/51092632_10217564446085547_6543895133773889536_o.jpg?_nc_cat=102&_nc_oc=AQnK1H8PXH4F33xiICspBkHRoBBJIxoj_YJHxin3yHWFQTS6LB_PwD4AejRY_FYj4NA&_nc_ht=scontent-atl3-1.xx&oh=5cb978d3ded4e93b0a549723153c2b3f&oe=5CF298EF)
## Serial Connection
**New** Shelly 2.5 model comes with a partially exposed 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. Onboard connector is 1,27mm raster with 1mm diameter holes so normal dupont cables won't fit. Use either a stripped ethernet cable and breadboard as adapter to avoid damaging the pcb, or female header socket legs (see image below).
The Shelly 2.5 model comes with a partially exposed 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.
<img src="https://shelly.cloud/wp-content/uploads/2019/01/pin_out-650x397.png" height="250" />
The legs of female header sockets fit nicely. Solder them to custom-crimped dupont wires for use with your USB-to-UART adapter. These often come with Wemos D1 Mini boards in mutliple lengths:
The onboard connector is 1.27mm raster with 1mm diameter holes. Normal Dupont cables won't fit. To avoid damaging the pcb, use either a stripped Ethernet cable and breadboard as an adapter, or female header socket legs (see image below). The legs of a female header socket fit nicely. Solder them to custom-crimped Dupont wires for use with your USB-to-UART adapter. These often come with Wemos D1 Mini boards in multiple lengths.
<img src="https://user-images.githubusercontent.com/188284/63646301-aef1d800-c710-11e9-9bf7-5b45ca470144.png" height="250" />
<img src="https://user-images.githubusercontent.com/188284/63646333-3dfef000-c711-11e9-9446-82ea0ce88c95.png" height="250" />
## Template
Tasmota 6.5.0.8 and up supports Shelly 2.5
Tasmota 6.5.0.8 and higher supports Shelly 2.5
| GPIO | Component |
| -- | -- |
@ -53,22 +49,14 @@ Tasmota 6.5.0.8 and up supports Shelly 2.5
| 16 | ADE7953 IRQ
| A0 | Internal Temperature
Energy metering is done by a ADE7953 chip connected via I2C and IRQ on GPIO16
`{"NAME":"Shelly 2.5","GPIO":[56,255,17,255,21,83,0,0,6,82,5,22,156],"FLAG":2,"BASE":18}`
```
{"NAME":"Shelly 2.5","GPIO":[56,255,17,255,21,83,0,0,6,82,5,22,156],"FLAG":2,"BASE":18}
```
As the Temperature sensor uses the Analog input the firmware needs to be compiled with ``//#define USE_ADC_VCC``.
Energy metering is done by a ADE7953 chip connected via I2C and IRQ on GPIO16. As the Temperature sensor uses the Analog input the firmware needs to be compiled with `#define USE_ADC_VCC`.
If you connect momentary switches and want press/double press/hold functionality, use the following template:
```
{"NAME":"Shelly 2.5 (buttons)","GPIO":[56,255,17,255,21,127,0,0,6,128,5,22,156],"FLAG":2,"BASE":18}
```
Run
```
backlog SetOption1 1; SetOption11 1; SetOption32 1
```
to enable all three states. Button1 is the button on the back of the device, Button2 and Button3 are the externally connected buttons.
If you connect momentary switches and want press/double press/hold functionality, use the following template:
`{"NAME":"Shelly 2.5 (buttons)","GPIO":[56,255,17,255,21,127,0,0,6,128,5,22,156],"FLAG":2,"BASE":18}`
Run `Backlog SetOption1 1; SetOption11 1; SetOption32 1` to enable all three states. Button1 is the button on the back of the device. Button2 and Button3 are the externally connected buttons.
## Flash mode
To be able to flash the Tasmota firmware you need to get into flash mode. Therefore connect a wire from GPIO0 to ground. For further information have a look at [bringing-the-module-in-flash-mode](https://github.com/arendst/Sonoff-Tasmota/wiki/Hardware-Preparation#bringing-the-module-in-flash-mode).
@ -76,21 +64,19 @@ To be able to flash the Tasmota firmware you need to get into flash mode. Theref
## Calibration
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.
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.
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.
As the Shelly 2.5 contains energy monitoring you can use rules to power off the shutter when too much current is drawn at the end point. This rule will power off both directions when the current becomes greater than 500mA.
```
rule on energy#current>0.500 do backlog power1 0; power2 0 endon
rule1 on energy#current>0.500 do backlog power1 0; power2 0 endon
rule 1
rule 5
```
@ -100,6 +86,6 @@ The Shelly 2.5 inputs appear to be notoriously susceptible to interference. Ther
You might want to experiment with the switch debounce delay. It is set to 50 milliseconds by default.
Use command `SwitchDebounce 100` to change it to a less sensitive value, which might work better. The value can change up to 1000 milliseconds.
Use command `SwitchDebounce 100` to change it to a less sensitive value, which might work better. The value be set up to 1000 milliseconds.
Some issues were reported for this topic - [search query](https://github.com/arendst/Sonoff-Tasmota/issues?utf8=%E2%9C%93&q=ghost+shelly)