diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index d78c1a4568..42901d1cfc 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -19,16 +19,28 @@ happen on Linux and Mac OSX but it's less likely. follow one of the procedures below. It's important to note that **any files stored on the** ``CIRCUITPY`` **drive will be erased**. +REPL Erase Method +^^^^^^^^^^^^^^^^^ +**For any board if you have access to the REPL:** + +#. Connect to the CircuitPython REPL using a terminal program. +#. Type ``import storage`` into the REPL. +#. Then, type ``storage.erase_filesystem()`` into the REPL. +#. The ``CIRCUITPY`` drive will be erased and the board will restart with an empty ``CIRCUITPY`` drive. + +Erase File Method +^^^^^^^^^^^^^^^^^ +**If you do not have access to the REPL, you have the following options to erase your board.** + **For boards with** ``CIRCUITPY`` **stored on a separate SPI flash chip, such as Feather M0 Express, Metro M0 Express and Circuit Playground Express:** - -#. Download the appropriate flash .erase uf2 from `the Adafruit_SPIFlash repo `_. +#. Download the appropriate flash erase .uf2 from `the Adafruit_SPIFlash repo `_. #. Double-click the reset button. #. Copy the appropriate .uf2 to the xxxBOOT drive. #. The on-board NeoPixel will turn blue, indicating the erase has started. #. After about 15 seconds, the NexoPixel will start flashing green. If it flashes red, the erase failed. -#. Double-click again and load the appropriate `CircuitPython .uf2 `_. +#. Double-click again and load the appropriate `CircuitPython .uf2 `_. **For boards without SPI flash, such as Feather M0 Proto, Gemma M0 and, Trinket M0:** @@ -36,7 +48,7 @@ such as Feather M0 Express, Metro M0 Express and Circuit Playground Express:** #. Double-click the reset button. #. Copy the appropriate .uf2 to the xxxBOOT drive. #. The boot LED will start pulsing again, and the xxxBOOT drive will appear again. -#. Load the appropriate `CircuitPython .uf2 `_. +#. Load the appropriate `CircuitPython .uf2 `_. ValueError: Incompatible ``.mpy`` file. ---------------------------------------