User Manual

Make sure to download a version with 2.0.0 or higher in the filename if you're using CircuitPython version 2.2.4, and

the version with 3.0.0 or higher in the filename if you're using CircuitPython version 3.0.

CIRCUITPY Drive Issues

You may find that you can no longer save files to your CIRCUITPY drive. You may find that your CIRCUITPY stops

showing up in your file explorer, or shows up as NO_NAME . These are indicators that your filesystem has issues.

First check - have you used Arduino to program your board? If so, CircuitPython is no longer able to provide the USB

services. Reset the board so you get a

boardnameBOOT

drive rather than a CIRCUITPY drive, copy the latest version

of CircuitPython ( .uf2 ) back to the board, then Reset. This may restore CIRCUITPY functionality.

If still broken - When the CIRCUITPY disk is not safely ejected before being reset by the button or being disconnected

from USB, it may corrupt the flash drive. It can happen on Windows, Mac or Linux.

In this situation, the board must be completely erased and CircuitPython must be reloaded onto the board.

Easiest Way: Use storage.erase_filesystem()

Starting with version 2.3.0, CircuitPython includes a built-in function to erase and reformat the filesystem. If you have an

older version of CircuitPython on your board, you can update to the newest version (https://adafru.it/Amd) to do this.

1. Connect to the CircuitPython REPL (https://adafru.it/Bec) using Mu or a terminal program.

2. Type:

CIRCUITPY will be erased and reformatted, and your board will restart. That's it!

Old Way: For the Circuit Playground Express, Feather M0 Express, and Metro M0 Express:

If you can't get to the REPL, or you're running a version of CircuitPython before 2.3.0, and you don't want to upgrade,

you can do this.

1. Download the correct erase file:

https://adafru.it/AdI

https://adafru.it/AdJ

https://adafru.it/EVK

You WILL lose everything on the board when you complete the following steps. If possible, make a copy of

your code before continuing.



>>> import storage

>>> storage.erase_filesystem()