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. If you are
running CircuitPython 2.x, you need to update to 3.x (https://adafru.it/Amd).
You need to download the CircuitPython Library Bundle that matches your version of CircuitPython. Please update to
CircuitPython 3.x and then download the 3.x bundle (https://adafru.it/ABU).
We will soon stop providing the 2.x bundle as an automatically created download on the Adafruit CircuitPython Bundle
repo. If you must continue to use 2.x, you can still download the 2.x version of mpy-cross from the 2.x release of
CircuitPython on the CircuitPython repo and create your own 2.x compatible .mpy library files. However, it is best to
update to 3.x for both CircuitPython and the library bundle.
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
and uninstall all the "Adafruit" driver programs.
Windows 7
The latest version of the Adafruit Windows Drivers (version 2.0.0.0 or later) will fix the missing
boardname
BOOT drive
problem on Windows 7. To resolve this, first uninstall the old versions of the drivers:
Unplug any boards. In Uninstall or Change a Program (Control Panel->Programs->Uninstall a program), uninstall
everything named "Windows Driver Package - Adafruit Industries LLC ...".
As we continue to develop CircuitPython and create new releases, we will stop supporting older releases. If
you are running CircuitPython 2.x, you need to update to 3.x. You must download the CircuitPython Library
Bundle that matches your version of CircuitPython. Please update to CircuitPython 3.x and then download the
3.x bundle.
To Next Page
Loading...
Need help?
General
