From d85439fd190221bd7ab1dd8f57490a1353542286 Mon Sep 17 00:00:00 2001
From: Paul Sokolovsky <pfalcon@users.sourceforge.net>
Date: Thu, 7 Apr 2016 00:21:04 +0300
Subject: [PATCH] esp8266/README: Add short troubleshooting section.

---
 esp8266/README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/esp8266/README.md b/esp8266/README.md
index f1136f32d8..3518cedd54 100644
--- a/esp8266/README.md
+++ b/esp8266/README.md
@@ -70,3 +70,19 @@ $ make PORT=/dev/ttyUSB0 deploy
 ```
 
 The image produced is `firmware-combined.bin`, to be flashed at 0x00000.
+
+Troubleshooting
+---------------
+
+While the port is still in alpha, it's known to be generally stable. If you
+experience strange bootloops, crashes, lockups, here's a list to check against:
+
+- You didn't erase flash before programming MicroPython firmware.
+- Firmware can be occasionally flashed incorrectly. Just retry. Recent
+  esptool.py versions have --verify option.
+- Power supply you use doesn't provide enough power for ESP8266 or isn't
+  stable enough.
+- A module/flash may be defective (not unheard of for cheap modules).
+
+Please consult dedicated ESP8266 forums/resources for hardware-related
+problems.