Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add note about erasing flash memory to fix upload issues #481

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Learn how to reset the default Arduino bootloader on the Nano ESP32.
These are some reasons you may want to reset the bootloader:

* Update the Arduino bootloader already on the board. This can resolve issues with Nano ESP32 being misidentified as other ESP32 boards.
* Restore the ability to upload regular Arduino sketches to a Nano ESP32 that has been flashed with the MicroPython firmware.
* Restore the ability to upload regular Arduino sketches to a Nano ESP32 that has been flashed with MicroPython or other third-party firmware images.

---

Expand Down Expand Up @@ -60,6 +60,19 @@ Try this:

* Ensure you are uploading the sketch by selecting **Sketch > Upload Using Programmer** and not by clicking the regular Upload button.

### Must double-click the RESET pin to reload a sketch, or the board is only recognized once

Some users report having to double-click the RESET button every time they want to load a new sketch because their board is not recognized after the first upload.

This issue can be caused by previous data on the Flash memory confusing the Arduino bootloader. Most of the Flash memory is intentionally NOT erased by the above process, to preserve as much user data as possible.

To resolve this issue, you can following the same steps as above, but with a slight modification: before uploading the firmware in Step 9, select **Tools > Burn Bootloader**. This will erase all sectors of the Flash memory.

> [!WARNING]
> Any data saved by sketches or Micropython in the user partition will be lost.

After erasing the Flash, proceed with the rest of the Arduino bootloader upload as usual.

[^colors]: On some earlier versions of the Nano ESP32, the LED will be blue instead of green, and yellow instead of purple.

<!-- markdownlint-disable-file HC001 -->
Loading