summaryrefslogtreecommitdiff
path: root/docs/rp2/tutorial
diff options
context:
space:
mode:
authorAngus Gratton <angus@redyak.com.au>2024-10-03 09:28:53 +1000
committerDamien George <damien@micropython.org>2024-11-19 10:57:47 +1100
commit9361a9f50af1e0b657eed270df6556ec253ddaeb (patch)
treedef7f23b435f4fbf7f6174bfdcec9820568f7cb3 /docs/rp2/tutorial
parent0e7c3901b897a1edd53b56b6119f2d4119e88842 (diff)
docs/rp2: Add a small factory reset page.
This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>
Diffstat (limited to 'docs/rp2/tutorial')
-rw-r--r--docs/rp2/tutorial/intro.rst1
-rw-r--r--docs/rp2/tutorial/reset.rst18
2 files changed, 19 insertions, 0 deletions
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