esp8266: Update flashing instructions in README.

This commit is contained in:
Paul Sokolovsky 2016-03-23 12:32:27 +02:00
parent 919b70b7ec
commit debbaac1bd

View File

@ -32,7 +32,8 @@ Build instructions
The tool chain required for the build is the OpenSource ESP SDK, which can be The tool chain required for the build is the OpenSource ESP SDK, which can be
found at <https://github.com/pfalcon/esp-open-sdk>. Clone this repository and found at <https://github.com/pfalcon/esp-open-sdk>. Clone this repository and
run `make` in its directory to build and install the SDK locally. Make sure run `make` in its directory to build and install the SDK locally. Make sure
to add toolchain bin directory to your PATH. to add toolchain bin directory to your PATH. Read esp-open-sdk's README for
additional important information on toolchain setup.
Add the external dependencies to the MicroPython repository checkout: Add the external dependencies to the MicroPython repository checkout:
```bash ```bash
@ -46,22 +47,26 @@ Then, to build MicroPython for the ESP8266, just run:
$ cd esp8266 $ cd esp8266
$ make $ make
``` ```
This should produce binary images in the `build/` subdirectory. To flash them This will produce binary images in the `build/` subdirectory. If you install
to your ESP8266, use: MicroPython to your module for the first time, or after installing any other
firmware, you should erase flash completely:
```
esptool.py --port /dev//ttyXXX erase_flash
```
Erase flash also as a troubleshooting measure, if a module doesn't behave as
expected.
To flash MicroPython image to your ESP8266, use:
```bash ```bash
$ make deploy $ 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, 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`. To specify another, use, eg: The default serial port is `/dev/ttyACM0`. To specify another, use, eg:
```bash ```bash
$ make PORT=/dev/ttyUSB0 deploy $ make PORT=/dev/ttyUSB0 deploy
``` ```
The images that are built are: The image produced is `firmware-combined.bin`, to be flashed at 0x00000.
- `firmware.elf-0x00000.bin`: to be flashed at 0x00000
- `firmware.elf-0x10000.bin`: to be flashed at 0x10000
There is also a combined image, made up of the above 2 binary files with the
appropriate padding:
- `firmware-combined.bin`: to be flashed at 0x00000