From 9361a9f50af1e0b657eed270df6556ec253ddaeb Mon Sep 17 00:00:00 2001 From: Angus Gratton Date: Thu, 3 Oct 2024 09:28:53 +1000 Subject: [PATCH] docs/rp2: Add a small factory reset page. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton --- docs/reference/reset_boot.rst | 1 + docs/rp2/tutorial/intro.rst | 1 + docs/rp2/tutorial/reset.rst | 18 ++++++++++++++++++ 3 files changed, 20 insertions(+) create mode 100644 docs/rp2/tutorial/reset.rst diff --git a/docs/reference/reset_boot.rst b/docs/reference/reset_boot.rst index 7c0d5f334..f6307c08c 100644 --- a/docs/reference/reset_boot.rst +++ b/docs/reference/reset_boot.rst @@ -245,6 +245,7 @@ The specific process(es) are different on each port: - :doc:`pyboard and stm32 port instructions ` - :doc:`renesas-ra port instructions ` +- :doc:`rp2 port instructions ` - :doc:`wipy port instructions ` For ports without specific instructions linked above, the factory reset process diff --git a/docs/rp2/tutorial/intro.rst b/docs/rp2/tutorial/intro.rst index 69c3e6b0a..2d2990105 100644 --- a/docs/rp2/tutorial/intro.rst +++ b/docs/rp2/tutorial/intro.rst @@ -8,4 +8,5 @@ Let's get started! .. toctree:: :maxdepth: 1 + reset.rst pio.rst diff --git a/docs/rp2/tutorial/reset.rst b/docs/rp2/tutorial/reset.rst new file mode 100644 index 000000000..3c296ec46 --- /dev/null +++ b/docs/rp2/tutorial/reset.rst @@ -0,0 +1,18 @@ +Factory reset +============= + +If something unexpected happens and your RP2xxx-based board no longer boots +MicroPython, then you may have to factory reset it. For more details, see +:ref:`soft_bricking`. + +Factory resetting the MicroPython rp2 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. Follow the instructions on the Raspberry Pi website for `resetting flash + memory`_. +2. Copy the MicroPython .uf2 firmware file to your board. If needed, this file + can be found on the `MicroPython downloads page`_. + +.. _resetting flash memory: https://www.raspberrypi.com/documentation/microcontrollers/pico-series.html#resetting-flash-memory +.. _MicroPython downloads page: https://micropython.org/download/?port=rp2