Skip to content

Commit d85439f

Browse files
committed
esp8266/README: Add short troubleshooting section.
1 parent 1a0a323 commit d85439f

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

esp8266/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,3 +70,19 @@ $ make PORT=/dev/ttyUSB0 deploy
7070
```
7171

7272
The image produced is `firmware-combined.bin`, to be flashed at 0x00000.
73+
74+
Troubleshooting
75+
---------------
76+
77+
While the port is still in alpha, it's known to be generally stable. If you
78+
experience strange bootloops, crashes, lockups, here's a list to check against:
79+
80+
- You didn't erase flash before programming MicroPython firmware.
81+
- Firmware can be occasionally flashed incorrectly. Just retry. Recent
82+
esptool.py versions have --verify option.
83+
- Power supply you use doesn't provide enough power for ESP8266 or isn't
84+
stable enough.
85+
- A module/flash may be defective (not unheard of for cheap modules).
86+
87+
Please consult dedicated ESP8266 forums/resources for hardware-related
88+
problems.

0 commit comments

Comments
 (0)