Make sure you are running version 8.0.0 or later of CircuitPython. You can download it from the downloads page on circuitpython.org.
If you have previously installed it and you're not sure which version of CircuitPython your board is currently running, you can check the boot_out.txt file in the root folder of your device. Assuming your mass storage has not been disabled, this should be in the CIRCUITPY drive.
Once you have that downloaded, you will want to check out the appropriate learn guide for your specific board for installation instructions. If you would like a more general overview of installing CircuitPython, you can check out the Welcome to CircuitPython guide.
Disabling USB Mass Storage
If you would like to use the REPL for file transfer, the USB mass storage device needs to be disabled, otherwise the file editing will need to done via the File System API.
The easiest way to do this is to simply eject the CIRCUITPY drive in your OS. However, this will only be temporary until the next time you reset the device or plug it back in. If you'd like it to stay disabled, you can create a boot.py file in the root folder of the CIRCUITPY drive with the following contents:
import storage storage.disable_usb_drive()
Once you have saved the file, go ahead and perform a hard reset on the board by pressing the reset button or by temporarily disconnecting it from power. After it starts back up, the CIRCUITPY drive should no longer appear. If you'd like to learn more about editing boot.py to customize the device, check out the Customizing USB Devices in CircuitPython guide.
Re-enabling USB Mass Storage
If you find you want to access the mass storage device after you have disabled it, there are a couple of ways you can do it. The first way to temporarily enable it is to boot it into safe mode. To do this, just reset the device and while it is booting, pay attention to the status NeoPixel. When it starts flashing yellow, press the boot button.
Alternatively, if you'd like to permanently re-enable it, you can run the following code from a serial terminal to remove the boot.py file:
import storage
import os
storage.remount("/", False)
os.remove("/boot.py")
After hard resetting your device, the CIRCUITPY drive should reappear, though re-enabling it will cause web workflow to be in read-only mode again.
Text editor powered by tinymce.
