From e10a044d7cdd0aad4c21f1d3cfca03b4a48de8bb Mon Sep 17 00:00:00 2001 From: finefoot <33361833+finefoot@users.noreply.github.com> Date: Mon, 28 Jun 2021 23:36:01 +0200 Subject: [PATCH] docs/esp8266/tutorial: Change flash mode from dio to dout. For some boards, even -fm dio is too fast and they require -fm dout. This commit links to the esptool wiki about available flash modes and changes dio to dout. --- docs/esp8266/tutorial/intro.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/esp8266/tutorial/intro.rst b/docs/esp8266/tutorial/intro.rst index bbf0457fff5a..a5deb3532f6b 100644 --- a/docs/esp8266/tutorial/intro.rst +++ b/docs/esp8266/tutorial/intro.rst @@ -109,10 +109,12 @@ PC. You may also need to reduce the baudrate if you get errors when flashing that you have. For some boards with a particular FlashROM configuration (e.g. some variants of -a NodeMCU board) you may need to use the following command to deploy -the firmware (note the ``-fm dio`` option):: +a NodeMCU board) you may need to manually set a compatible +`SPI Flash Mode `_. +You'd usually pick the fastest option that is compatible with your device, but +the ``-fm dout`` option (the slowest option) should have the best compatibility:: - esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=detect -fm dio 0 esp8266-20170108-v1.8.7.bin + esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=detect -fm dout 0 esp8266-20170108-v1.8.7.bin If the above commands run without error then MicroPython should be installed on your board!