Moved introduction

krzychb · krzychb · commit f8fe995334c8 · 2016-03-12T14:43:55.000+01:00
diff --git a/5-Show/readme.md b/5-Show/readme.md
@@ -1,22 +1,26 @@
 # Show
 
-In [previous section](../4-Measure)  I have shown how to use an inexpensive digital humidity sensor DHT22 with ESP8266 to measure relative humidity. We have been displaying humidity values in Serial Monitor of Arduino IDE.
-
-Now it is time to do next step and use ESP’s Wi-Fi functionality and show humidity values in a web browser. I am really excited to show you that, since it provides freedom to get our measurements online and shown them to the whole world!
-
-Such functionality is also fairly easy to complete. There is an example sketch available in Arduino IDE that demonstrates how to set up a simple web server on an ESP. We will use it to serve a web page with humidity measurement that we or anybody else can open in a web browser :sunglasses:
-
-Let us get started!
-
 
 ## Table of Contents
 
+* [Introduction](#introduction)
 * [What You Need](#what-you-need)
 * [Setup Web Server](#setup-web-server)
 * [Test It](#test-it)
 * [Next Step](#next-step)
 
 
+## Introduction
+
+In [previous section](../4-Measure)  I have shown how to use an inexpensive digital humidity sensor DHT22 with ESP8266 to measure relative humidity. We have been displaying humidity values in Serial Monitor of Arduino IDE.
+
+Now it is time to do next step and use ESP’s Wi-Fi functionality and show humidity values in a web browser. I am really excited to show you that, since it provides freedom to get our measurements online and shown them to the whole world!
+
+Such functionality is also fairly easy to complete. There is an example sketch available in Arduino IDE that demonstrates how to set up a simple web server on an ESP. We will use it to serve a web page with humidity measurement that we or anybody else can open in a web browser :sunglasses:
+
+Let's get started!
+
+
 ## What You Need
 
 To implement this part of project you will need the following:
diff --git a/6-Chart/readme.md b/6-Chart/readme.md
@@ -1,14 +1,9 @@
 # Chart
 
-I think that development of applications for ESP8266 has been made really easy to everybody. This is thanks to [ESP8266 core for Arduino](https://github.com/esp8266/Arduino) developed by [Ivan Grokhotkov](https://twitter.com/i_grr) and [esp8266/Arduino](https://github.com/esp8266/Arduino/graphs/contributors) team. In [previous section](../5-Show) I have shown how easy it is to present measurements online with just couple of simple modifications to existing example sketch.
-
-In this section I would like to make another step - push data to the cloud and present them online on a chart. 
-
-![A sample humidity control chart](pictures/humidity-control-chart-1.png)
-
 
 ## Table of Contents
 
+* [Introduction](#introduction)
 * [Emoncms](#emoncms)
 * [Setup](#setup)
 * [Push](#push)
@@ -18,6 +13,15 @@ In this section I would like to make another step - push data to the cloud and p
 * [Next Steps](#next-steps)
 
 
+## Introduction
+
+I think that development of applications for ESP8266 has been made really easy to everybody. This is thanks to [ESP8266 core for Arduino](https://github.com/esp8266/Arduino) developed by [Ivan Grokhotkov](https://twitter.com/i_grr) and [esp8266/Arduino](https://github.com/esp8266/Arduino/graphs/contributors) team. In [previous section](../5-Show) I have shown how easy it is to present measurements online with just couple of simple modifications to existing example sketch.
+
+In this section I would like to make another step - push data to the cloud and present them online on a chart. 
+
+![A sample humidity control chart](pictures/humidity-control-chart-1.png)
+
+
 ## Emoncms
 
 There are several cloud services that you can use for such purpose. I am pretty familiar with [ThingSpeak](https://thingspeak.com/) and [Emoncms](http://emoncms.org/) and will refer to them.
diff --git a/7-Control/readme.md b/7-Control/readme.md
@@ -1,15 +1,9 @@
 # Control
 
-In [previous section](../6-Chart) I have presented how to show your measurements online using Emoncms.org that is powerful web application for logging and visualizing data. We need such data for analysis of performance of our humidity control system. We do not have this system operating yet, but we are just there. In this section I would find a demonstrate how to control our humidifier, so we can then remotely switch it on and off depending on current humidity value. 
-
-To do so you will need the following hardware used in section [Measure](../4-Measure/) and in addition:
-
-* RF433 transmitter
-* RF433 socket
-
 
 ## Table of Contents
 
+* [Introduction](#introduction)
 * [Select RF Socket](#select-rf-socket)
 * [Install Library](#install-library)
 * [Connect Components](#connect-components)
@@ -21,6 +15,16 @@ To do so you will need the following hardware used in section [Measure](../4-Mea
 * [The Next Step - Put it All Together](#the-next-step---put-it-all-together)
 
 
+## Introduction
+
+In [previous section](../6-Chart) I have presented how to show your measurements online using Emoncms.org that is powerful web application for logging and visualizing data. We need such data for analysis of performance of our humidity control system. We do not have this system operating yet, but we are just there. In this section I would find a demonstrate how to control our humidifier, so we can then remotely switch it on and off depending on current humidity value. 
+
+To do so you will need the following hardware used in section [Measure](../4-Measure/) and in addition:
+
+* RF433 transmitter
+* RF433 socket
+
+
 ## Select RF Socket
 
 We should start off by finding proper library to control RF433 socket. There is variety of such sockets on the market as well as variety of Arduino libraries to control them. I propose you to start with nice wiki site with [433MHz libraries for Arduino](https://bitbucket.org/fuzzillogic/433mhzforarduino) by [Randy Simons](http://randysimons.nl/88,over-mij/). It provides couple of libraries for 433 MHz devices including mains sockets. The library I found on this site works perfectly with my ORNO socket. It may or may not work for specific socket you have. Therefore before buying particular socket do research on internet if there is a library available for to control it. You may also decipher protocol used for particular socket and this is a subject by its own. Please see below couple of links to give you an idea what you should be looking for: 
diff --git a/8-Automate/readme.md b/8-Automate/readme.md
@@ -1,14 +1,9 @@
 # Automate
 
-Now comes the fun part of joining all the dots we have been discussing and testing in last seven [sections](https://github.com/krzychb/OnlineHumidifier#step-by-step-tutorial). All we need to do now is to write a simple procedure that will compare ambient humidity against set point and switch humidifier on if it is below or on if it is above the set point.
-
-Before you rush to write this procedure think about humidifier being constantly switched on and off for any swing of humidity. To avoid such situation, it is a common practice to add a dead band below and above the set point and do not operate humidifier if ambient humidity is within the dead band. Exactly the same method of control is used in electric iron or in toilet flush. 
-
-The dead band range above and below the set point is called hysteresis. An automatic controller that is working as desribed above is called [bang–bang controler](https://en.wikipedia.org/wiki/Bang%E2%80%93bang_control) or hysteresis controller.
-
 
 ## Table of Contents
 
+* [Introduction](#introduction)
 * [The Hysteresis Controller](#the-hysteresis-controller)
 * [What Else?](#what-else)
 * [Let's Get it Work](#lets-get-it-work)
@@ -17,6 +12,15 @@ The dead band range above and below the set point is called hysteresis. An autom
 * [Next Step](#next-step)
 
 
+## Introduction
+
+Now comes the fun part of joining all the dots we have been discussing and testing in last seven [sections](https://github.com/krzychb/OnlineHumidifier#step-by-step-tutorial). All we need to do now is to write a simple procedure that will compare ambient humidity against set point and switch humidifier on if it is below or on if it is above the set point.
+
+Before you rush to write this procedure think about humidifier being constantly switched on and off for any swing of humidity. To avoid such situation, it is a common practice to add a dead band below and above the set point and do not operate humidifier if ambient humidity is within the dead band. Exactly the same method of control is used in electric iron or in toilet flush. 
+
+The dead band range above and below the set point is called hysteresis. An automatic controller that is working as desribed above is called [bang–bang controler](https://en.wikipedia.org/wiki/Bang%E2%80%93bang_control) or hysteresis controller.
+
+
 ## The Hysteresis Controller
 
 You can experiment what will happen if you have no hysteresis or if you set it to specific value. At this stage, as a starting point, let us assume a hysteresis of +/- 2% RH.  Below is a procedure that implements hysteresis controller:
diff --git a/9-Maintain/readme.md b/9-Maintain/readme.md
@@ -1,21 +1,25 @@
 # Maintain
 
-In [previous section](../8-Automate) we have completed our goal of implementation of automatic humidity control. Now I would like to discuss supplementary topic of making the changes to the sketch in more convenient way. For sure you have several ides how to improve this project by providing better automatic control strategy, more friendly and feature rich user interface or maybe adding additional sensors to monitor conditions in your house.
-
-If you have been working with Arduino UNO board before, you may noticed that compilation and then uploading a sketch to ESP8266 takes a lot of time. This is due to size of compiled sketch that is likely 10x bigger comparing to Arduino UNO. To upload [OnlinHumidifier-Automate.ino](../8-Automate/OnlineHumidifier-Automate) sketch using a serial port takes about 30 seconds. Fortunately we can improve this time if we upload module using Wi-Fi connection rather than a serial port. Such method of module upload is called OTA (Over the Air) and has some additional benefits. You can get rid of USB/serial cable and can perform the update remotely - there is no limitation how far the module is located assuming that it is reachable over Wi-Fi connection.
-
-There are three basic options to perform OTA uploads and they are discussed in in details in [documentation](https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/readme.md#introduction) of [esp8266/Arduino] (https://github.com/esp8266/Arduino) repository. Out of these options I would like to implement uploads directly from [Arduino IDE] (https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/readme.md#arduino-ide).
-
 
 ## Table of Contents
 
+* [Introduction](#introduction)
 * [Preparation](#preparation)
 * [Update the Sketch](#update-the-sketch)
 * [Make First Upload](#make-first-upload)
 * [Make Next Uploads Faster](#make-next-uploads-faster)
 * [Conclusion](#conclusion)
 
 
+## Introduction
+
+In [previous section](../8-Automate) we have completed our goal of implementation of automatic humidity control. Now I would like to discuss supplementary topic of making the changes to the sketch in more convenient way. For sure you have several ides how to improve this project by providing better automatic control strategy, more friendly and feature rich user interface or maybe adding additional sensors to monitor conditions in your house.
+
+If you have been working with Arduino UNO board before, you may noticed that compilation and then uploading a sketch to ESP8266 takes a lot of time. This is due to size of compiled sketch that is likely 10x bigger comparing to Arduino UNO. To upload [OnlinHumidifier-Automate.ino](../8-Automate/OnlineHumidifier-Automate) sketch using a serial port takes about 30 seconds. Fortunately we can improve this time if we upload module using Wi-Fi connection rather than a serial port. Such method of module upload is called OTA (Over the Air) and has some additional benefits. You can get rid of USB/serial cable and can perform the update remotely - there is no limitation how far the module is located assuming that it is reachable over Wi-Fi connection.
+
+There are three basic options to perform OTA uploads and they are discussed in in details in [documentation](https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/readme.md#introduction) of [esp8266/Arduino] (https://github.com/esp8266/Arduino) repository. Out of these options I would like to implement uploads directly from [Arduino IDE] (https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/readme.md#arduino-ide).
+
+
 ## Preparation
 
 To start with please check documentation what are the [basic requirements](https://github.com/esp8266/Arduino/blob/master/doc/ota_updates/readme.md#basic-requirements) for performing OTA. If the module you are using meets these requirements then go to the next step. 
