djsundog/circuitpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

esp8266: Update docs for esptool 1.2.1/SDK 2.0 (--flash_size=detect).

Browse Source
This commit is contained in:
Paul Sokolovsky 2016-11-08 04:52:07 +03:00
parent 933198c55f
commit 5630778f0f
2 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/esp8266/tutorial/intro.rst
View File

@ -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 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 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 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:: 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 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 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 a NodeMCU board) you may need to use the following command to deploy
the firmware (note the ``-fm dio`` option):: 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 If the above commands run without error then MicroPython should be installed on
your board! 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 * If lower baud rate didn't help, you may want to try older version of
esptool.py, which had a different programming algorithm:: esptool.py, which had a different programming algorithm::
pip install esptool==1.0.1 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 * The ``--flash_size`` option in the commands above is mandatory. Omitting
it will lead to a corrupted firmware. it will lead to a corrupted firmware.

9
esp8266/README.md
View File

@ -70,13 +70,14 @@ $ make deploy
``` ```
This will use the `esptool.py` script to download the images. You must have This will use the `esptool.py` script to download the images. You must have
your ESP module in the bootloader mode, and connected to a serial port on your PC. your ESP module in the bootloader mode, and connected to a serial port on your PC.
The default serial port is `/dev/ttyACM0`, flash mode is `qio` and flash size is `8m`. The default serial port is `/dev/ttyACM0`, flash mode is `qio` and flash size is
To specify other values, use, eg: `detect` (auto-detect based on Flash ID). To specify other values, use, eg (note
that flash size is in megabits):
```bash ```bash
$ make PORT=/dev/ttyUSB0 FLASH_MODE=qio FLASH_SIZE=8m deploy $ make PORT=/dev/ttyUSB0 FLASH_MODE=qio FLASH_SIZE=32m deploy
``` ```
The image produced is `firmware-combined.bin`, to be flashed at 0x00000. The image produced is `build/firmware-combined.bin`, to be flashed at 0x00000.
First start First start
----------- -----------