This is the documentation for the latest development branch of MicroPython and may refer to features that are not available in released versions.

If you are looking for the documentation for a specific release, use the drop-down menu on the left and select the desired version.

4. Factory reset

If something unexpected happens and your ESP32-based board no longer boots MicroPython, then you may have to factory reset it. For more details, see Soft Bricking (failure to boot).

Factory resetting the MicroPython esp32 port involves fully erasing the flash and resetting the flash memory, so you will need to re-flash the MicroPython firmware afterwards and copy any Python files to the filesystem again.

  1. You will need the Espressif esptool installed on your system. This is the same tool that you may have used to initially install MicroPython on your board (see installation instructions).

  2. Find the serial port name of your board, and then use esptool to erase the entire flash contents:

    esptool.py -p PORTNAME erase_flash

  3. Use esptool to flash the MicroPython file to your board again. If needed, this file and flashing instructions can be found on the MicroPython downloads page.