diff options
| author | Paul Sokolovsky <pfalcon@users.sourceforge.net> | 2016-11-08 04:52:07 +0300 |
|---|---|---|
| committer | Paul Sokolovsky <pfalcon@users.sourceforge.net> | 2016-11-08 04:52:07 +0300 |
| commit | 5630778f0f3a114f5b7d7f71f3df0bd1c3b378f6 (patch) | |
| tree | 04590ea7b3e996b9d3ca66a4f38e6b1fbbaa1891 /docs/esp8266/tutorial/intro.rst | |
| parent | 933198c55fdc4881198139676b61ff1f621cb39a (diff) | |
| download | micropython-5630778f0f3a114f5b7d7f71f3df0bd1c3b378f6.tar.gz micropython-5630778f0f3a114f5b7d7f71f3df0bd1c3b378f6.zip | |
esp8266: Update docs for esptool 1.2.1/SDK 2.0 (--flash_size=detect).
Diffstat (limited to 'docs/esp8266/tutorial/intro.rst')
| -rw-r--r-- | docs/esp8266/tutorial/intro.rst | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/esp8266/tutorial/intro.rst b/docs/esp8266/tutorial/intro.rst index 32e9326b37..87d4463406 100644 --- a/docs/esp8266/tutorial/intro.rst +++ b/docs/esp8266/tutorial/intro.rst @@ -54,7 +54,7 @@ device before putting on new MicroPython firmware. Currently we only support esptool.py to copy across the firmware. You can find this tool here: `<https://github.com/themadinventor/esptool/>`__, or install it -using pip:: +using pip (at least version 1.2.1 is required):: pip install esptool @@ -69,7 +69,7 @@ Using esptool.py you can erase the flash with the command:: And then deploy the new firmware using:: - esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=8m 0 esp8266-2016-05-03-v1.8.bin + esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=detect 0 esp8266-2016-05-03-v1.8.bin You might need to change the "port" setting to something else relevant for your PC. You may also need to reduce the baudrate if you get errors when flashing @@ -80,7 +80,7 @@ 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=8m -fm dio 0 esp8266-2016-05-03-v1.8.bin + esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash --flash_size=detect -fm dio 0 esp8266-2016-05-03-v1.8.bin If the above commands run without error then MicroPython should be installed on your board! @@ -138,6 +138,8 @@ after it, here are troubleshooting recommendations: * If lower baud rate didn't help, you may want to try older version of esptool.py, which had a different programming algorithm:: pip install esptool==1.0.1 + This version doesn't support ``--flash_size=detect`` option, so you will + need to specify FlashROM size explicitly (in megabits). * The ``--flash_size`` option in the commands above is mandatory. Omitting it will lead to a corrupted firmware. |