Someone with a GitHub account: Please add -fm dout to the docs

All ESP8266 boards running MicroPython.
Official boards are the Adafruit Huzzah and Feather boards.
Target audience: MicroPython users with an ESP8266 board.
Post Reply
snake77
Posts: 31
Joined: Thu Jun 24, 2021 11:26 pm

Someone with a GitHub account: Please add -fm dout to the docs

Post by snake77 » Sat Jun 26, 2021 8:17 pm

This issue viewtopic.php?f=16&t=10741 just got resolved by using the

Code: Select all

-fm dout
option during flashing. The docs only mention the

Code: Select all

-fm dio
option so far.

This is the file in the repository: https://github.com/micropython/micropyt ... /intro.rst

Code: Select all

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)::

    esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=detect -fm dio 0 esp8266-20170108-v1.8.7.bin
Is there someone with a GitHub account who can make a quick addition to the docs?

User avatar
hcet14
Posts: 34
Joined: Sat Dec 19, 2020 12:59 am

Re: Someone with a GitHub account: Please add -fm dout to the docs

Post by hcet14 » Sat Jun 26, 2021 9:56 pm

Yes, makes sense. I remember having a hard time with that, when I started the first time.

hcet14
I'm a beginner with this stuff and no programmer at all.

snake77
Posts: 31
Joined: Thu Jun 24, 2021 11:26 pm

Re: Someone with a GitHub account: Please add -fm dout to the docs

Post by snake77 » Sat Jun 26, 2021 11:49 pm

hcet14 wrote:
Sat Jun 26, 2021 9:56 pm
Yes, makes sense. I remember having a hard time with that, when I started the first time.
Especially since the docs mention that one option, but not the other one that eventually helped. However, those ESP-01S boards are the first ones where I had to set that option for me at all.

So can you make a quick pull request on GitHub? In case someone else has the same problem? Just adding

Code: Select all

-fm dout
to the existing paragraph would have helped me a lot and probably saved an hour or two.

User avatar
hcet14
Posts: 34
Joined: Sat Dec 19, 2020 12:59 am

Re: Someone with a GitHub account: Please add -fm dout to the docs

Post by hcet14 » Mon Jun 28, 2021 6:46 pm

Today I started with my ESP8266 again and put a new firmware on that thing. The schematic https://www.esp8266.com/wiki/lib/exe/fe ... sp-12e.png of my ESP-12E shows a quad SPI flash. So I can use all modes (and tried it). So -fm dout always works on every module.
SPI Flash Modes: https://github.com/espressif/esptool/wi ... lash-Modes
The programming speed also depends to the chosen baud rate https://github.com/espressif/esptool and of course on the age/condition of the flash device.

I agree, it is irritating for beginners when something goes wrong, the µC boots, and you see funny effects. The manual could mention more conservative settings. But it http://docs.micropython.org/en/latest/e ... html#intro says
You may also need to reduce the baudrate if you get errors when flashing (eg down to 115200). The filename of the firmware should also match the file 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):
I'm a beginner with this stuff and no programmer at all.


katesimon123
Posts: 15
Joined: Mon Jun 14, 2021 12:49 am

Re: Someone with a GitHub account: Please add -fm dout to the docs

Post by katesimon123 » Tue Jun 29, 2021 7:55 pm

It's almost 6 months old.

Post Reply