User Manual

Troubleshooting

From time to time, you will run into issues when working with CircuitPython. Here are a few things you may encounter

and how to resolve them.

Always Run the Latest Version of CircuitPython and Libraries

As we continue to develop CircuitPython and create new releases, we will stop supporting older releases. You need to

update to the latest CircuitPython. (https://adafru.it/Em8).

You need to download the CircuitPython Library Bundle that matches your version of CircuitPython. Please update

CircuitPython and then download the latest bundle (https://adafru.it/ENC).

As we release new versions of CircuitPython, we will stop providing the previous bundles as automatically created

downloads on the Adafruit CircuitPython Library Bundle repo. If you must continue to use an earlier version, you can

still download the appropriate version of mpy-cross from the particular release of CircuitPython on the CircuitPython

repo and create your own compatible .mpy library files. However, it is best to update to the latest for both

CircuitPython and the library bundle.

I have to continue using CircuitPython 3.x or 2.x, where can I find compatible

libraries?

We are no longer building or supporting the CircuitPython 2.x and 3.x library bundles. We highly encourage you to

update CircuitPython to the latest version (https://adafru.it/Em8) and use the current version of the

libraries (https://adafru.it/ENC). However, if for some reason you cannot update, you can find the last available 2.x

build here (https://adafru.it/FJA) and the last available 3.x build here (https://adafru.it/FJB).

CPLAYBOOT, TRINKETBOOT, FEATHERBOOT, or GEMMABOOT Drive Not

Present

You may have a different board.

Only Adafruit Express boards and the Trinket M0 and Gemma M0 boards ship with the UF2 bootloader

(https://adafru.it/zbX)installed. Feather M0 Basic, Feather M0 Adalogger, and similar boards use a regular Arduino-

compatible bootloader, which does not show a

boardname

BOOT drive.

MakeCode

If you are running a MakeCode (https://adafru.it/zbY) program on Circuit Playground Express, press the reset button

just once to get the CPLAYBOOT drive to show up. Pressing it twice will not work.

Windows 10

Did you install the Adafruit Windows Drivers package by mistake? You don't need to install this package on Windows

10 for most Adafruit boards. The old version (v1.5) can interfere with recognizing your device. Go to Settings -> Apps

As we continue to develop CircuitPython and create new releases, we will stop supporting older releases.

Visit https://circuitpython.org/downloads to download the latest version of CircuitPython for your board. You

must download the CircuitPython Library Bundle that matches your version of CircuitPython. Please update

CircuitPython and then visit https://circuitpython.org/libraries to download the latest Library Bundle.

