Skip to content

Commit 7b0660f

Browse files
committed
Update Troubleshooting.
1 parent 575843a commit 7b0660f

File tree

1 file changed

+16
-4
lines changed

1 file changed

+16
-4
lines changed

docs/troubleshooting.rst

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,24 +19,36 @@ happen on Linux and Mac OSX but it's less likely.
1919
follow one of the procedures below. It's important to note that **any files stored on the**
2020
``CIRCUITPY`` **drive will be erased**.
2121

22+
REPL Erase Method
23+
^^^^^^^^^^^^^^^^^
24+
**For any board if you have access to the REPL:**
25+
26+
#. Connect to the CircuitPython REPL using a terminal program.
27+
#. Type ``import storage`` into the REPL.
28+
#. Then, type ``storage.erase_filesystem()`` into the REPL.
29+
#. The ``CIRCUITPY`` drive will be erased and the board will restart with an empty ``CIRCUITPY`` drive.
30+
31+
Erase File Method
32+
^^^^^^^^^^^^^^^^^
33+
**If you do not have access to the REPL, you have the following options to erase your board.**
34+
2235
**For boards with** ``CIRCUITPY`` **stored on a separate SPI flash chip,
2336
such as Feather M0 Express, Metro M0 Express and Circuit Playground Express:**
2437

25-
26-
#. Download the appropriate flash .erase uf2 from `the Adafruit_SPIFlash repo <https://github.com/adafruit/Adafruit_SPIFlash/tree/master/examples/flash_erase_express>`_.
38+
#. Download the appropriate flash erase .uf2 from `the Adafruit_SPIFlash repo <https://github.com/adafruit/Adafruit_SPIFlash/tree/master/examples/flash_erase_express>`_.
2739
#. Double-click the reset button.
2840
#. Copy the appropriate .uf2 to the xxxBOOT drive.
2941
#. The on-board NeoPixel will turn blue, indicating the erase has started.
3042
#. After about 15 seconds, the NexoPixel will start flashing green. If it flashes red, the erase failed.
31-
#. Double-click again and load the appropriate `CircuitPython .uf2 <https://github.com/adafruit/circuitpython/releases/latest>`_.
43+
#. Double-click again and load the appropriate `CircuitPython .uf2 <https://circuitpython.org/downloads>`_.
3244

3345
**For boards without SPI flash, such as Feather M0 Proto, Gemma M0 and, Trinket M0:**
3446

3547
#. Download the appropriate erase .uf2 from `the Learn repo <https://github.com/adafruit/Adafruit_Learning_System_Guides/tree/master/uf2_flash_erasers>`_.
3648
#. Double-click the reset button.
3749
#. Copy the appropriate .uf2 to the xxxBOOT drive.
3850
#. The boot LED will start pulsing again, and the xxxBOOT drive will appear again.
39-
#. Load the appropriate `CircuitPython .uf2 <https://github.com/adafruit/circuitpython/releases/latest>`_.
51+
#. Load the appropriate `CircuitPython .uf2 <https://circuitpython.org/downloads>`_.
4052

4153
ValueError: Incompatible ``.mpy`` file.
4254
---------------------------------------

0 commit comments

Comments
 (0)