From 9db650482cc255e4d49fb3e9a8bf6ad0a5fdc900 Mon Sep 17 00:00:00 2001
From: Markus Sattler <help.markus+git@gmail.com>
Date: Sat, 14 Nov 2015 12:48:19 +0100
Subject: [PATCH 1/2] add documentation about boot messages and mode meaning

---
 doc/boards.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/doc/boards.md b/doc/boards.md
index cf8c9343f..088f591e9 100644
--- a/doc/boards.md
+++ b/doc/boards.md
@@ -162,3 +162,52 @@ ESPxx Hardware
 
 ### Improved Stability
 ![ESP improved stability](ESP_improved_stability.png)
+
+### Boot Messages and Modes
+
+The ESP module checks at every boot the Pins 0, 2 and 15.
+based on them its boots in different modes:
+
+| GPIO15 | GPIO0 | GPIO2 | Mode                             |
+| ------ | ----- | ----- | -------------------------------- |
+| 0V     | 0V    | 3.3V  | Uart Bootloader                  |
+| 0V     | 3.3V  | 3.3V  | Boot sketch (SPI flash)          |
+| 3.3V   | x     | x     | SDIO mode (not used for Arduino) |
+
+
+at startup the ESP prints out the current boot mode example:
+```
+rst cause:2, boot mode:(3,6)
+```
+
+#### rst cause
+
+| Number | Description            |
+| ------ | ---------------------- |
+| 0      | unknown                |
+| 1      | normal boot            |
+| 2      | reset pin              |
+| 3      | software reset         |
+| 4      | watchdog reset         | 
+
+
+#### boot mode
+
+the first value respects the pin setup of the Pins 0, 2 and 15.
+
+| Number | GPIO15 | GPIO0 | GPIO2 | Mode       |
+| ------ | ------ | ----- | ----- | ---------- |
+| 0      | 0V     | 0V    | 0V    | Not valid  |
+| 1      | 0V     | 0V    | 3.3V  | Uart       |
+| 2      | 0V     | 3.3V  | 0V    | Not valid  |
+| 3      | 0V     | 3.3V  | 3.3V  | Flash      |
+| 4      | 3.3V   | 0V    | 0V    | SDIO       |
+| 5      | 3.3V   | 0V    | 3.3V  | SDIO       |
+| 6      | 3.3V   | 3.3V  | 0V    | SDIO       |
+| 7      | 3.3V   | 3.3V  | 3.3V  | SDIO       |
+
+Note:
+
+number = ((GPIO15 << 2) | (GPIO0 << 1) | GPIO2);
+
+

From 5192ddb8cbbacfa875180487054ee6a7f69957b7 Mon Sep 17 00:00:00 2001
From: Markus Sattler <help.markus+git@gmail.com>
Date: Sat, 14 Nov 2015 12:53:27 +0100
Subject: [PATCH 2/2] add node about TX on GPIO2

---
 doc/boards.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/boards.md b/doc/boards.md
index 088f591e9..746e395d8 100644
--- a/doc/boards.md
+++ b/doc/boards.md
@@ -180,6 +180,9 @@ at startup the ESP prints out the current boot mode example:
 rst cause:2, boot mode:(3,6)
 ```
 
+note: 
+ - GPIO2 is used as TX output and the internal Pullup is enabled on boot.
+
 #### rst cause
 
 | Number | Description            |
@@ -206,8 +209,7 @@ the first value respects the pin setup of the Pins 0, 2 and 15.
 | 6      | 3.3V   | 3.3V  | 0V    | SDIO       |
 | 7      | 3.3V   | 3.3V  | 3.3V  | SDIO       |
 
-Note:
-
-number = ((GPIO15 << 2) | (GPIO0 << 1) | GPIO2);
+note:
+ - number = ((GPIO15 << 2) | (GPIO0 << 1) | GPIO2);