more updates

docs/Building-your-own-test-circuit.md

@@ -2,11 +2,11 @@ Here is a prototype board you can build yourself on a breadboard for testing.
 
 The breadboard layout was done using [DIY Layout Creator](https://github.com/bancika/diy-layout-creator) and sources files are included in this repo.
 
-![Breadboard Circuit](_media/schematics/breadboard.png)
+![Breadboard Circuit](_media/schematics/breadboard.png ':size=500')
 
 The schematic used:
 
-![Schematic](_media/schematics/circuit.png)
+![Schematic](_media/schematics/circuit.png ':size=500')
 
 *Optionally I've also added 2 0.5A/72V polyfuses between the EMS and the two inductors L1 and L2 for extra protection.*
 
@@ -19,6 +19,6 @@ The EMS circuit will work with both 3.3V and 5V. It's easiest though to power di
 - powering from the 3.5mm service jack (stereo jack) on the boiler. This will give you 8V so you need a buck converter (like a [Pololu D24C22F5](https://www.pololu.com/product/2858)) to step this down to 5V to provide enough power to the ESP8266 (250mA at least)
 - powering direct from the EMS line, which is 15V DC and using a buck converter as described above.
 
-| With Power Circuit                              |
-| ------------------------------------------ |
-| ![Power circuit](_media/schematics/Schematic_EMS-ESP.png) |
+**With Power Circuit**
+
+![Power circuit](_media/schematics/Schematic_EMS-ESP.png ':size=600') |

docs/Home-Assistant.md

@@ -1,24 +1,10 @@
-## Example Dashboard
+The files to read MQTT and parse as sensors and thermostat components into HA can be found [here](integrations/homeassistant/ha) along with a LoveLace dashboard which looks like:
 
-In the `doc` folder there is a basic template for a HA dashboard which looks like:
-
-![Home Assistant panel)](_media/home%20assistant/ha.png)
+![Home Assistant panel](_media/home%20assistant/ha.png ':size=500')
 
 and the alerts on an iOS/Android device using PushBullet, PushOver or any notification service would look like:
 
-![Home Assistant iPhone notify)](_media/home%20assistant/ha_notify.jpg)
-
-You can find the `.yaml` configuration files under `doc/ha`. See also this [HA forum post](https://community.home-assistant.io/t/thermostat-and-boiler-controller-for-ems-based-boilers-nefit-buderus-bosch-using-esp/53382). Make sure you include these YAML files in your `configuration.yaml` file, e.g.
-
-```yaml
-script: !include script.yaml
-sensor: !include sensor.yaml
-switch: !include switch.yaml
-notify: !include notify.yaml
-climate: !include climate.yaml
-automation: !include automation.yaml
-binary_sensor: !include binary_sensor.yaml
-```
+![Home Assistant iPhone notify](_media/home%20assistant/ha_notify.jpg ':size=300')
 
 ## Supporting multiple thermostat heating circuits
 

docs/Running-and-Monitoring.md

@@ -1,17 +1,17 @@
 
-## Using Telnet to monitor traffic
+## Using Telnet to monitor EMS traffic
 
 Use the telnet client to inform you of all activity and errors real-time. This is an example of the telnet output:
 
-![Telnet](https://github.com/proddy/EMS-ESP/raw/master/doc/telnet/telnet_menu.jpg)
+![Telnet](_media/telnet/telnet_menu.jpg)
 
-Type 'log v' and Enter and you'll be seeing verbose logging messages. ANSI colors with white text for info messages, green are for broadcast telegrams, yellow are the ones sent to us and red are for unknown data or telegrams which have failed the CRC check.
+Type `log v` and Enter and you'll be seeing verbose logging messages. ANSI colors with white text for info messages, green are for broadcast telegrams, yellow are the ones sent to us and red are for unknown data or telegrams which have failed the CRC check.
 
-![Telnet](https://github.com/proddy/EMS-ESP/raw/master/doc/telnet/telnet_verbose.PNG)
+![Telnet](_media/telnet/telnet_verbose.PNG)
 
 To see the current stats and collected values type 'info'. Note it is normal behavior to see a few CrcErrors as this is usually noise on the line.
 
-![Telnet](https://github.com/proddy/EMS-ESP/raw/master/doc/telnet/telnet_stats.PNG)
+![Telnet](_media/telnet/telnet_stats.PNG)
 
 **Warning: be careful when sending values to the boiler. If in doubt you can always reset the boiler to its original factory settings by following the instructions in the user guide. For example on my Nefit Trendline that is done by holding down the Home and Menu buttons simultaneously for a few seconds, selecting factory settings from the scroll menu followed by pressing the Reset button.**
 

docs/getting_started.md

@@ -1,13 +1,15 @@
+<img style="margin: 10px 10px; float:right; width:40%" src="_media/boiler.svg" alt="EMS-ESP Logo"></img>
 
 Welcome to EMS-ESP! A small project to read and write to EMS controller heating devices.
+<br>
 
 Follow these steps to get EMS-ESP up and running:
 
-- [Build](Building-your-own-test-circuit) or buy an EMS interface board. I highly recommend purchasing a EMS Gateway from BBQKees. Go to https://bbqkees-electronics.nl/
+- [Build](Building-your-own-test-circuit) or buy an EMS interface board. I highly recommend purchasing a EMS Gateway from BBQKees ([bbqkees-electronics.nl](https://bbqkees-electronics.nl))
 
 - Get an ESP8266 dev board (Wemos D1, Lolin, Nodemcu or equivalent)
   
-- Build or download the firmware](Building-firmware)
+- [Build or download the firmware](Building-firmware)
   
 - [Upload the firmware](Uploading-firmware)
   

docs/index.html

@@ -7,11 +7,11 @@
       <link rel="shortcut icon" type="image/x-icon" href="favicon.ico">
       <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
       <meta name="description" content="EMS-ESP">
-      <meta name="keywords" content="EMS-ESP EMS esp8266 flash firmware help installation flash">  
+      <meta name="keywords" content="EMS-ESP EMS esp8266 flash firmware help installation">  
       <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
       <meta property="og:title" content="EMS-ESP">
       <meta property="og:description" content="An EMS interface">
-      <meta property="og:image" content="https://proddy.github.io/EMS-ESP/_media/logo-proddy-fw.jpg">
+      <meta property="og:image" content="https://proddy.github.io/EMS-ESP/_media/boiler_64.png">
       <meta property="og:url" content="https://proddy.github.io/EMS-ESP/#/Home">
 
 <!-- Theme: Simple Dark -->
@@ -29,7 +29,7 @@
       name       : 'EMS-ESP',
       nameLink   : './#/Home',
       homepage   : 'Home.md',
-      logo       : '/_media/logo-proddy-fw.jpg',
+      logo       : '/_media/EMS-ESP_logo.png',
       repo       : 'https://github.com/proddy/EMS-ESP',
       onlyCover  : true,
       relativePath: false,

docs/integrations/homeassistant/ha.md

@@ -0,0 +1,22 @@
+# Home Assistant Files
+
+* <a href="integrations/homeassistant/automation.yaml">automation.yaml</a>
+* <a href="integrations/homeassistant/binary_sensor.yaml">binary_sensor.yaml</a>
+* <a href="integrations/homeassistant/climate.yaml">climate.yaml</a>
+* <a href="integrations/homeassistant/customize.yaml">customize.yaml</a>
+* <a href="integrations/homeassistant/notify.yaml">notify.yaml</a>
+* <a href="integrations/homeassistant/script.yaml">script.yaml</a>
+* <a href="integrations/homeassistant/sensor.yaml">sensor.yaml</a>
+* <a href="integrations/homeassistant/switch.yaml">switch.yaml</a>
+* <a href="integrations/homeassistant/ui-lovelace.yaml">ui-lovelace.yaml</a>
+
+Make sure you include these YAML files in your `configuration.yaml` file, e.g.
+```yaml
+script: !include script.yaml
+sensor: !include sensor.yaml
+switch: !include switch.yaml
+notify: !include notify.yaml
+climate: !include climate.yaml
+automation: !include automation.yaml
+binary_sensor: !include binary_sensor.yaml
+```