From b4ad0db80058f0d3268711f5a6a797e1e676e30a Mon Sep 17 00:00:00 2001
From: blakadder <blakadder@users.noreply.github.com>
Date: Fri, 17 May 2019 21:00:15 +0200
Subject: [PATCH] Created Sonoff S20 (markdown)

---
 Sonoff-S20.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 Sonoff-S20.md

diff --git a/Sonoff-S20.md b/Sonoff-S20.md
new file mode 100644
index 00000000..259a8001
--- /dev/null
+++ b/Sonoff-S20.md
@@ -0,0 +1,65 @@
+Sonoff S20 comes in 4 different plug type variations. Flashing process will be the same for each type.
+## Serial Connection
+
+Please see the [Hardware Preparation](https://github.com/arendst/Sonoff-Tasmota/wiki/Hardware-Preparation) page for general instructions.
+
+<img alt="S20 Smart Socket" src="https://github.com/arendst/arendst.github.io/blob/master/media/s20b.jpg?raw=true" width="230" align="right" /> 
+The picture shows how to program the S20 Smart Socket powered by the serial-to-USB converter.  With newer US sockets, either use a right-angle header, or remove the header after flashing.  Otherwise,the pushbutton may rub against a pin and get stuck.
+
+Be sure it is **NOT** plugged in mains!
+
+Remove the "hidden" screw.
+
+<img alt="SonoffS20" src="https://i.imgur.com/fnXEqOW.jpg" width="230" />
+
+> (optional) Remove the board from the plastic shell to have better access to serial pins.
+There are 2 screws at the red and blue wire. Be careful not to damage the soldered connection!
+
+<img alt="SonoffS20" src="https://i.imgur.com/KX00Uer.jpg" width="230" />
+
+Connect the jumper wires.
+
+<img alt="SonoffS20" src="https://i.imgur.com/i8DCijJ.jpg" width="230" />
+
+From top to bottom (see image below):
+- Vcc (3,3V)
+- TXD
+- RXD
+- GND
+
+![S20 Board](https://raw.githubusercontent.com/reloxx13/reloxx13.github.io/master/media/tasmota-wiki-beginner-guide/20160722_195356x-624x415.jpg)
+
+Connected?
+Hold the little button pressed while connecting the serial-to-USB adapter to your computer. After about 2 seconds let go of the button. It is now in flashing mode and ready to be flashed with Tasmota.
+
+### Video tutorial by Don't It Yourself
+[![](http://img.youtube.com/vi/5k_35ppDPho/0.jpg)](http://www.youtube.com/watch?v=5k_35ppDPho "")
+
+## Official Sources
+* Itead Product Page: http://sonoff.itead.cc/en/products/residential/s20-socket
+* Itead Wiki: https://www.itead.cc/wiki/S20_Smart_Socket
+
+### OpenHab Configuration
+
+sonoff.items:
+```
+Switch S20_1 "Coffee S20-1 Powerplug" (LR,gLight) 
+       { mqtt=">[broker:cmnd/sonoff-S20-1/POWER:command:*:default],
+                 <[broker:stat/sonoff-S20-1/POWER:state:default],
+                 <[broker:stat/sonoff-S20-1/RESULT:state:JSONPATH($.POWER)],
+                 <[broker:tele/sonoff-S20-1/STATE:state:JSONPATH($.POWER)]
+                 "}
+Switch S20_1_Reachable "S20-1 reachable" <contact> (gReachable)
+       { mqtt="<[broker:tele/sonoff-S20-1/LWT:state:MAP(reachable.map)],
+               <[broker:stat/sonoff-S20-1/RESULT:state:ON],
+               <[broker:stat/sonoff-S20-1/POWER:state:ON],
+               <[broker:tele/sonoff-S20-1/STATE:state:ON]
+               " }
+```
+
+default.sitemap:
+```
+        Switch item=S20_1 labelcolor=[S20_1_Reachable == "ON" = "green",S20_1_Reachable == "OFF" = "red"]
+
+```
+