Formatting sorted - more details.

Teckin-SP23.md

@@ -1,18 +1,105 @@
-Placeholder page for now.
+# Teckin SP23
 
-Teckin SP23s (marked V1.2) bought from Amazon UK Jan 2019 flashed successfully and need the  Sonoff BlitzWolf SHP2 configuration.
+The Teckin SP23 is wifi enabled smart plug with the ability to remotely monitor power consumption and turn devices on and off.
 
-Might need voltage calibration
+## Details:
 
-This device: https://www.amazon.co.uk/TECKIN-Outlet-Wireless-Control-Required/dp/B07CVJYV3G
+The Teckin SP23 appears to be a clone of the BlitzWolf SHP2 hardware with Tuya software / firmware.
 
-Can be flashed via 
+The uses an ESP8266EX and is capable of switching up to 16 amps at 250 VAC.
-https://github.com/SynAckFin/TuyOTA
 
-To get tasmota and is fully functional using the BlitzWolf SHP2 config.
+2 Teckin SP23s (marked V1.2) [bought from Amazon UK in January 2019](https://www.amazon.co.uk/TECKIN-Outlet-Wireless-Control-Required/dp/B07CVJYV3G) have been flashed successfully and use BlitzWolf SHP2 Sonoff configuration. Voltage calibration may be required for accurate power monitoring.
+
+## How to flash:
+
+No hardware preparation is required to flash if you are confident about having the same version and can easily be flashed following the procedure detailed at https://github.com/SynAckFin/TuyOTA
+
+This results in a fully functional device when using the BlitzWolf SHP2 config.
 
 Consider this risky until more users report supported! (I have tested on 2 devices with success.)
 
-Will  update later with images and formatting!
+## How to disassemble if desired:
 
-https://imgur.com/a/stdhc4c
+If you wish to confirm you have the same hardware the Teckin SP23 can be opened by hitting each side of the plug at the lip with a rubber mallet or similar. This will leave a visually unblemished enclosure which can be resecured with superglue or similar.
+
+## Disassembled device pictures:
+
+![](https://i.imgur.com/1wwz6kb.jpg)
+![](https://i.imgur.com/4RiNCfg.jpg)
+![](https://i.imgur.com/ZTSMI7j.jpg)
+
+**[Full album](https://imgur.com/a/stdhc4c)**
+
+
+### OpenHab configuration
+
+sonoff.items:
+```
+Switch BlitzwoIFSHP2 "Switch"  { mqtt=">[broker:cmnd/BlitzwoIFSHP2/POWER:command:*:default],<[broker:stat/BlitzwoIFSHP2/POWER:state:default]" }
+Number Power_Total "Total: [%.3f kWh]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Total)]" }
+Number Power_Today "Today: [%.3f kWh]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Today)]" }
+Number Power_Yesterday "Yesterday: [%.3f kWh]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Yesterday)]" }
+Number Power "Power: [%.1f Watt]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Power)]" }
+Number Voltage "Voltage: [%.0f V]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Voltage)]" }
+Number Current "Current: [%.3f A]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Current)]" }
+Number Factor "Factor: [%.2f]"  { mqtt="<[broker:tele/BlitzwoIFSHP2/SENSOR:state:JSONPATH($.ENERGY.Factor)]" }
+```
+
+default.sitemap:
+```
+Switch item=BlitzwoIFSHP2 label="BlitzWoIF SHP2" icon="socket" mappings=[OFF="Off",ON="On"]		
+Text item=Power label="Power: [%.1f Watt]" icon="energy"
+Text item=Voltage label="Voltage: [%.0f V]" icon="energy"
+Text item=Current label="Current: [%.3f A]" icon="energy"
+Text item=Factor label="Factor: [%.2f]" icon="energy"
+Text item=Power_Total label="Power Total: [%.3f kWh]" icon="energy"
+Text item=Power_Today label="Power Today: [%.3f kWh]" icon="energy"
+Text item=iPower_Yesterday label="Power Yesterday: [%.3f kWh]" icon="energy"
+```
+### Home Assistant configuration 
+
+configuration.yaml
+```
+switch:
+  - platform: mqtt
+    name: "Blitzwolf"
+    state_topic: "stat/blitzwolf/POWER"
+    command_topic: "cmnd/blitzwolf/POWER"
+    payload_on: "ON"
+    payload_off: "OFF"
+    retain: false
+  
+sensor:
+  - platform: mqtt
+    name: "Blitzwolf Energy Today"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Today"] }}'
+    unit_of_measurement: "kWh"
+  - platform: mqtt
+    name: "Blitzwolf Energy Yesterday"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Yesterday"] }}'
+    unit_of_measurement: "kWh"
+  - platform: mqtt
+    name: "Blitzwolf Energy Total"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Total"] }}'
+    unit_of_measurement: "kWh"
+  - platform: mqtt
+    name: "Blitzwolf Power"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Power"] }}'
+    unit_of_measurement: "W"
+  - platform: mqtt
+    name: "Blitzwolf Voltage"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Voltage"] }}'
+    unit_of_measurement: "V"
+  - platform: mqtt
+    name: "Blitzwolf Power Factor"
+    state_topic: "tele/blitzwolf/SENSOR"
+    value_template: '{{ value_json["ENERGY"]["Factor"] }}'
+```
+
+## Attention
+Consider flashing your device risky as only two successfully flashed devices have been reported (21/01/2019).