CircuitPython 2.3.0 Released!

Get the 2.3.0 release on GitHub!


The 2.3.0 CircuitPython release fixes a longstanding issue of CIRCUITPY sometimes being erased when applying power or when batteries run down. It also adds the CircuitPlayground and HID libraries as frozen libraries on the Circuit Playground Express build. And finally, if CIRCUITPY becomes partially corrupted, you can now use storage.clear_filesystem() to erase and reformat it, and reset the board.


Power-on CIRCUITPY corruption fix

CircuitPython writes version information to boot_out.txt when it starts from a hard reset or power on. It also writes whatever (or, etc.) prints to boot_out.txt. If power failed while boot_out.txt was being written, CIRCUITPY could become severely corrupted. When power returned, CircuitPython would erase and reformat CIRCUITPY to fix the corruption. Several things were done to ameliorate this problem:

  1. Do not rewrite boot_out.txt if the version information in it will not change and there is no
  2. If the version information has changed, or there is a file, wait 1.5 seconds to ensure power is stable before starting to write boot_out.txt and run
  3. Raise the “brownout” voltage below which CircuitPython refuses to run from 1.7V to 2.8V. This ensures all chips on the board have proper voltage to run.

Additional frozen libraries added to CircuitPython image for Circuit Playground Express

The CircuitPlayground (aka Express or cpx) library and the HID librariy have been added as frozen libraries to the Circuit Playground Express firmware image. The CircuitPlayground library provides easy access to the built-in sensors and peripherals on the Circuit Playground Express (CPX) board. Using the frozen versions of these libraries can save RAM and allow you to run larger programs. Remove the versions in the lib/ directory if you want to use the frozen versions. (Or change sys.path to put .frozen first.)


Sometimes CIRCUITPY becomes partially corrupted, but not badly enough so that it is automatically reformatted. You can now use erase.filesystem() to reformat easily and quickly, without having to use a special erase .uf2 file and then reload CircuitPython. In the REPL, just do:

import storage

This will erase and reformat CIRCUITPY, and reset the board.

Other changes

The _stage module now uses 16-bit coordinates to support larger screens. Thanks @deshipu!

The esp8266 build now uses the latest version of the SDK toolchain. Thanks @jepler!


Thanks to @dhalbert@tannewt@kattni@jepler@deshipu@ladyada, and @croadfeldt (who helped greatly with testing the power fixes) for help with this release! Join us on the Discord chat to collaborate.


Documentation is available in

Here are all the changes since 2.2.4.

This release is based on MicroPython 1.9.2. Support upstream MicroPython by purchasing a PyBoard(from Adafruit here).


Check out this guide for info on common problems with CircuitPython. If you are still having, then post to the Adafruit Support Forums and join Discord.


The 2.2.0 mpy-cross executables in this release work fine with 2.3.0.

Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here:

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in!

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community!

CircuitPython – The easiest way to program microcontrollers –

Maker Business — “Packaging” chips in the US

Wearables — Enclosures help fight body humidity in costumes

Electronics — Transformers: More than meets the eye!

Python for Microcontrollers — Python on Microcontrollers Newsletter: Silicon Labs introduces CircuitPython support, and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

Adafruit IoT Monthly — Guardian Robot, Weather-wise Umbrella Stand, and more!

Microsoft MakeCode — MakeCode Thank You!

EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProds 7/19/23 Feat. Adafruit Matrix Portal S3 CircuitPython Powered Internet Display!

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at !

No Comments

No comments yet.

Sorry, the comment form is closed at this time.