summaryrefslogtreecommitdiffstatshomepage
path: root/esp8266/README.md
diff options
context:
space:
mode:
authorPaul Sokolovsky <pfalcon@users.sourceforge.net>2016-04-07 00:21:04 +0300
committerPaul Sokolovsky <pfalcon@users.sourceforge.net>2016-04-07 00:21:04 +0300
commitd85439fd190221bd7ab1dd8f57490a1353542286 (patch)
treef004687743c17e4dbf0b2ee14a05fde65a2de6f6 /esp8266/README.md
parent1a0a323ca8daadb30e5ed3d58bc7e8e8e5a95629 (diff)
downloadmicropython-d85439fd190221bd7ab1dd8f57490a1353542286.tar.gz
micropython-d85439fd190221bd7ab1dd8f57490a1353542286.zip
esp8266/README: Add short troubleshooting section.
Diffstat (limited to 'esp8266/README.md')
-rw-r--r--esp8266/README.md16
1 files changed, 16 insertions, 0 deletions
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.