These are some of the common questions regarding CircuitPython and CircuitPython microcontrollers.
I have to continue using an older version of CircuitPython; where can I find compatible libraries?
We are no longer building or supporting library bundles for older versions of CircuitPython. We highly encourage you to update CircuitPython to the latest version and use the current version of the libraries. However, if for some reason you cannot update, here are points to the last available library bundles for previous versions:
We dropped ESP8266 support as of 4.x - For more information please read about it here!
https://learn.adafruit.com/welcome-to-circuitpython/circuitpython-for-esp8266
We do not support ESP32 because it does not have native USB. We do support ESP32-S2, which does.
We do not have asyncio support in CircuitPython at this time. However, async
and await
are turned on in many builds, and we are looking at how to use event loops and other constructs effectively and easily.
The status LED can tell you what's going on with your CircuitPython board. Read more here for what the colors mean!
What is a MemoryError
?
Memory allocation errors happen when you're trying to store too much on the board. The CircuitPython microcontroller boards have a limited amount of memory available. You can have about 250 lines of code on the M0 Express boards. If you try to import
too many libraries, a combination of large libraries, or run a program with too many lines of code, your code will fail to run and you will receive a MemoryError
in the serial console (REPL).
What do I do when I encounter a MemoryError
?
Try resetting your board. Each time you reset the board, it reallocates the memory. While this is unlikely to resolve your issue, it's a simple step and is worth trying.
Make sure you are using .mpy versions of libraries. All of the CircuitPython libraries are available in the bundle in a .mpy format which takes up less memory than .py format. Be sure that you're using the latest library bundle for your version of CircuitPython.
If that does not resolve your issue, try shortening your code. Shorten comments, remove extraneous or unneeded code, or any other clean up you can do to shorten your code. If you're using a lot of functions, you could try moving those into a separate library, creating a .mpy
of that library, and importing it into your code.
You can turn your entire file into a .mpy
and import
that into code.py
. This means you will be unable to edit your code live on the board, but it can save you space.
Can the order of my import
statements affect memory?
It can because the memory gets fragmented differently depending on allocation order and the size of objects. Loading .mpy
files uses less memory so its recommended to do that for files you aren't editing.
How can I create my own .mpy
files?
You can make your own .mpy
versions of files with mpy-cross
.
You can download mpy-cross
for your operating system from https://adafruit-circuit-python.s3.amazonaws.com/index.html?prefix=bin/mpy-cross/. Almost any version will do. The format for .mpy files has not changed since CircuitPython 4.x.
To make a .mpy file, run ./mpy-cross path/to/yourfile.py
to create a yourfile.mpy
in the same directory as the original file.
How do I check how much memory I have free?
import gc
gc.mem_free()
Will give you the number of bytes available for use.
Does CircuitPython support interrupts?
No. CircuitPython does not currently support interrupts. We do not have an estimated time for when they will be included.
Commonly Used Acronyms
CP or CPy = CircuitPython
CPC = Circuit Playground Classic
CPX = Circuit Playground Express