NOT indicate any status while running CircuitPython.
Here's what the colors and blinking mean:
steady GREEN:
code.py
(or
code.txt
,
main.py
, or
main.txt
) is running
pulsing GREEN:
code.py
(etc.) has finished or does not exist
steady YELLOW at start up: (4.0.0-alpha.5 and newer) CircuitPython is waiting for a reset to indicate that it should
start in safe mode
pulsing YELLOW: Circuit Python is in safe mode: it crashed and restarted
steady WHITE: REPL is running
steady BLUE: boot.py is running
Colors with multiple flashes following indicate a Python exception and then indicate the line number of the error. The
color of the first flash indicates the type of error:
GREEN: IndentationError
CYAN: SyntaxError
WHITE: NameError
ORANGE: OSError
PURPLE: ValueError
YELLOW: other error
These are followed by flashes indicating the line number, including place value. WHITE flashes are thousands' place,
BLUE are hundreds' place, YELLOW are tens' place, and CYAN are one's place. So for example, an error on line 32
would flash YELLOW three times and then CYAN two times. Zeroes are indicated by an extra-long dark gap.
ValueError: Incompatible
.mpy
file.
This error occurs when importing a module that is stored as a
mpy
binary file that was generated by a different
version of CircuitPython than the one its being loaded into. In particular, the
mpy
binary format changed between
CircuitPython versions 2.x and 3.x, as well as between 1.x and 2.x.
So, for instance, if you upgraded to CircuitPython 3.x from 2.x you’ll need to download a newer version of the library
that triggered the error on
import
. They are all available in the
Adafruit bundle
(https://adafru.it/y8E)
.
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.
© Adafruit Industries
https://learn.adafruit.com/adafruit-feather-m4-express-atsamd51
Page 90 of 183
