micropython/ports/esp32/boards/UM_FEATHERS2/deploy.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

51 lines
1.5 KiB
Markdown
Raw Normal View History

Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).
To flash or erase your FeatherS2, you have to first put it into download mode.
To do this, follow these steps:
- Press and hold the [BOOT] button
- Press and release the [RESET] button
- Release the [BOOT] button
Now the board is in download mode and the native USB will have enumerated as a serial device.
If you are putting MicroPython on your board for the first time then you should
first erase the entire flash using:
### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
```
### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
```
### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) erase_flash
```
Now download the version of the firmware you would like to install from the options
below, then use the following command to program the firmware starting at address
0x1000, remembering to replace `feathers2-micropython-firmware-version.bin` with the
name of the firmware you just downloaded:
### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```
### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```
### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```