Now we'll set up the CPX for CircuitPython mode to be able to upload the code we write to the board.
If your CPX is already in CircuitPython mode, double check it is updated to the latest version. Check on the circuitpython.org site to see the latest version. You can find the current version by opening up the file boot_out.txt on the root directory of the CIRCUITPY drive.
You will know you are in CircuitPython mode if the drive CIRCUITPY shows up on your computer when connected via micro-B USB cable to your computer.
If your board doesn't have CircuitPython installed
If this is your first time using your CPX with CircuitPython or you see a drive entitled CPLAYBOOT, your board may not have CircuitPython installed yet. No worries. Follow the steps and extended guide below to switch to CircuitPython mode.
- First install or update CircuitPython. The latest file from circuitpython.org will be a .uf2 file.
- Next, plug the CPX to your a computer via micro-B USB cable and double click the reset button on the Circuit Playground Express (the CPX NeoPixels should turn green).
- Now drag the recently downloaded .uf2 file onto the CPLAYBOOT drive oon your computer.
- The drive should disappear from your File Explorer or Finder (depending on your operating system) and come back as CIRCUITPY.
Here is an extended guide on how to follow the above steps with images and pictures to help.
Running Your Program
Once you have CircuitPython installed, when you want to run your main.py file, copy it via your computer to the root directory of the CIRCUITPY drive.
Problems?
If issues are still arising while getting into CircuitPython mode, check out this troubleshooting guide.
Page last edited December 03, 2025
Text editor powered by tinymce.