Skip to content

Commit 9361a9f

Browse files
projectgusdpgeorge
authored andcommitted
docs/rp2: Add a small factory reset page.
This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <[email protected]>
1 parent 0e7c390 commit 9361a9f

File tree

3 files changed

+20
-0
lines changed

3 files changed

+20
-0
lines changed

docs/reference/reset_boot.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -245,6 +245,7 @@ The specific process(es) are different on each port:
245245

246246
- :doc:`pyboard and stm32 port instructions </pyboard/tutorial/reset>`
247247
- :doc:`renesas-ra port instructions </renesas-ra/tutorial/reset>`
248+
- :doc:`rp2 port instructions </rp2/tutorial/reset>`
248249
- :doc:`wipy port instructions </wipy/tutorial/reset>`
249250

250251
For ports without specific instructions linked above, the factory reset process

docs/rp2/tutorial/intro.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,5 @@ Let's get started!
88
.. toctree::
99
:maxdepth: 1
1010

11+
reset.rst
1112
pio.rst

docs/rp2/tutorial/reset.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
Factory reset
2+
=============
3+
4+
If something unexpected happens and your RP2xxx-based board no longer boots
5+
MicroPython, then you may have to factory reset it. For more details, see
6+
:ref:`soft_bricking`.
7+
8+
Factory resetting the MicroPython rp2 port involves fully erasing the flash and
9+
resetting the flash memory, so you will need to re-flash the MicroPython
10+
firmware afterwards and copy any Python files to the filesystem again.
11+
12+
1. Follow the instructions on the Raspberry Pi website for `resetting flash
13+
memory`_.
14+
2. Copy the MicroPython .uf2 firmware file to your board. If needed, this file
15+
can be found on the `MicroPython downloads page`_.
16+
17+
.. _resetting flash memory: https://www.raspberrypi.com/documentation/microcontrollers/pico-series.html#resetting-flash-memory
18+
.. _MicroPython downloads page: https://micropython.org/download/?port=rp2

0 commit comments

Comments
 (0)