d89e71e6c0
Allows two source files (ports/esp32/boards/deploy.md and deploy_nativeusb.md for boards with only native USB) for all esp32 installation steps, with templated chip name and flash offset inserted via string formatting. The new files add more text to explain the esptool.py port auto-detection, remove the unnecessary -z feature (already enabled by default), and add a bit of troubleshooting and port detection info. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>
1.8 KiB
Program your board using the esptool.py program, found here.
Windows users: You may find the installed program is called esptool instead of esptool.py.
Erasing
If you are putting MicroPython on your board for the first time then you should first erase the entire flash using:
esptool.py erase_flash
esptool.py will try to detect the serial port with the ESP32 automatically,
but if this fails or there might be more than one Espressif-based device
attached to your computer then pass the --port option with the name of the
target serial port. For example:
esptool.py --port PORTNAME erase_flash
- On Linux, the port name is usually similar to
/dev/ttyACM0. - On Mac, the port name is usually similar to
/dev/cu.usbmodem01. - On Windows, the port name is usually similar to
COM4.
Flashing
Then deploy the firmware to the board, starting at address {deploy_options[flash_offset]}:
esptool.py write_flash {deploy_options[flash_offset]} ESP32_BOARD_NAME-DATE-VERSION.bin
Replace ESP32_BOARD_NAME-DATE-VERSION.bin with the .bin file downloaded from this page.
As above, if esptool.py can't automatically detect the serial port
then you can pass it explicitly on the command line instead. For example:
esptool.py --port PORTNAME write_flash {deploy_options[flash_offset]} ESP32_BOARD_NAME-DATE-VERSION.bin
Troubleshooting
If these steps don't work, consult the MicroPython ESP32 Troubleshooting steps and the esptool documentation.
Important: From the options below, download the .bin file for your board.