CircuitPython 7.0.0 Release Candidate 2 Released! @circuitpython

This is CircuitPython 7.0.0-rc.2, the third release candidate for CircuitPython 7.0.0. We have addressed all the issues we scheduled for the 7.0.0 release. We believe this release is stable, but want to give time for further testing.

RP2040 PROBLEM NOTED AFTER RELEASE: RP2040 boards will not restart properly after a power cycle with 7.0.0-rc.2. You can press reset and the board will restart, but stick with 7.0.0-rc.1 for RP2040 now and we will publish a fix soon. Issue is being tracked at

Non-RP2040 boards do not have this problem and can try 7.0.0-rc.2.

Notable additions to 7.0.0 since 6.3.0 include:

  • Support for the CircuitPython development workflow over BLE.
  • Camera support on ESP32S2.
  • qrio: QR code decoding.
  • The keypad key-scanning module.
  • Run-time customization of USB devices.
  • Merging in of MicroPython fixes and enhancements as of MicroPython 1.16.
  • _pixelbuf is now adafruit_pixelbuf.
  • colorwheel() routine moved to rainbowio.
  • supervisor.ticks_ms() to allow easier time-keeping.
  • Simplifications to the RGB status LED codes.
  • A clocking fix for a few samples of RP2040 boards.
  • Rework of vectorio and some of its API. VectorShape is no longer needed for user code.
  • atexit module.
  • getpass module.
  • traceback module.
  • supervisor.get_previous_traceback().
  • board.LED now consistently present on all boards that have such an LED.
  • PulseOut no longer needs a PWMOut.
  • Unicode filename support.
  • Board ID is now in boot_out.txt and available as board.board_id.
  • aesio on for full builds by default.

Download from

Firmware downloads are available from the downloads page on The site makes it easy to select the correct file and language for your board.


To install follow the instructions in our new Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.

Try the latest version of the Mu editor for creating and editing your CircuitPython programs and for easy access to the CircuitPython serial connection (the REPL).

Port status

CircuitPython has a number of “ports” that are the core implementations for different microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, cxd56 (Spresense), esp32s2, nrf,raspberrypi, stm for the F4 family are stable. stm for other STM chip families is being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 7.0.0-rc.1

The full commit log is here. A few changes before 7.0.0-rc.1 are included as well.

Fixes and enhancements

  • Correct sdioio name. #5345. Thanks @dhalbert.
  • Enhance BLE file service. #5340. Thanks @tannewt.
  • Fix 24-bit decoding in bitmaptools.readinto(). #5338. Thanks @lesamouraipourpre.
  • Update TinyUSB to pass compliance test suite. #5337, #5286, #5268. Thanks @hathach and @tannewt.
  • Fix use of allocations for get_previous_traceback(). #5333. Thanks @microDev1.
  • Consistently validate VectorShape location properties. #5327. Thanks @lesamouraipourpre.
  • BLE: do not scan and advertise simultaneously. #5321. Thanks @tannewt.
  • Update frozen libraries. #5314, #5288. Thanks @dhalbert and @UnexpectedMaker.
  • Do not use translated messages for REPL messages read by editors. #5308. Thanks @microDev1.
  • Add board.board_id and board.__name__. #5299. Thanks @Neradoc.
  • aesio is now available on more builds. #5293. Thanks @microDev1.
  • BLE workflow fix. #5284. Thanks @tannewt.
  • Move paralleldisplay to its own module. #5260. Thanks @jepler.

Port and board-specific changes


  • Correct I2SOut pin checking. #5326. Thanks @dhalbert.
  • Fix builds for use with gcc 11.2. (We still use gcc 10.2.1 for production.) #5319. Thanks @tannewt.
  • Fix watchdog crashes. #5272. Thanks @tannewt.


  • Enable use of WFI when idling. #5341. Thanks @tannewt and @urish.
  • Implement microcontroller.Processor.reset_reason. #5320. Thanks @rjp5th.
  • Fix I2SOut audio. #5310. Thanks @dhalbert.


  • Improved fix for heap metadata fix #5245. #5348. Thanks @tannewt and @anecdata.


  • Update SDK to 2.3.0. #5336. Thanks @kamtom480.
  • Update TinyUSB to fix USB MSC issue. #5303. Thanks @kamtom480.


Individual Boards

  • LilyGo T8 S2 ST7789: Add pins. #5279. Thanks @microDev1.
  • Nordic PCA10100: shrink flash size. #5339. Thanks @tannewt.
  • UnexpectedMaker TinyS2: add _stage. #5289. Thanks @UnexpectedMaker.

New boards Since 6.3.0

  • ARAMCON2 Badge. #4627. Thanks @aramcon-badge.
  • ATMegaZero ESP32-S2. #4634. Thanks @eddieespinal.
  • Adafruit LED Glasses nRF52840 Driver. #5224, #5265, #5326. Thanks @dhalbert and @ladyada.
  • Adafruit MacroPad RP2040. #4770, #4864. Thanks @ladyada.
  • AiThinker ESP-12K NodeMCU. #5149. Thanks @codetyphon.
  • Arduino Nano RP2040 Connect. #4802. Thanks @BlitzCityDIY.
  • BlueMicro840. #5114. Thanks @jpconstantineau.
  • CP Sapling Rev B. #4677. Thanks @skerr92.
  • Challenger RP2040 WiFi. #5323. Thanks @PontusO.
  • CrumpSpace CrumpS2. #5143. Thanks @tylercrumpton.
  • Cytron Maker Pi RP2040. #4824. Thanks @CytronTechnologies.
  • EncoderPad RP2040. #5247 Thanks @jpconstantineau.
  • Espressif HMI DevKit 1. Thanks @jepler.
  • Espressif HMI Development Kit. #5335. Thanks @skieast.
  • Espressif Kalgua v1.3. #4870. Thanks @jepler.
  • Gravitech Cucumber M. #5097. Thanks @anecdata.
  • Gravitech Cucumber MS. #5097. Thanks @anecdata.
  • Gravitech Cucumber R. #5097. Thanks @anecdata.
  • Gravitech Cucumber RS. #5097. Thanks @anecdata.
  • Lolin Mini S2. #5239, #5297. Thanks @durapensa.
  • micro:bit V2 (first BLE-only board). #5002. Thanks @tannewt.
  • Morpheans MorphESP-240. #5129. Thanks @skieast.
  • Muselab nanoESP32-S2 WROVER. #4834. Thanks @reppad.
  • Oak Development Technologies PixelWing ESP32-S2. #5156. Thanks @skerr92.
  • Pimoroni Interstate 75. #5099. Thanks @ZodiusInfuser.
  • Pimoroni PGA2040. #4865. Thanks @ZodiusInfuser.
  • Pimoroni Plasma 2040. #5099. Thanks @ZodiusInfuser.
  • RayTac MDBT50Q-RX nRF52840 dongle. #5095. Thanks @dhalbert.
  • senseBox MCU. #4576. Thanks @felixerdy.
  • SparkFun MicroMod SAMD51. #4852. Thanks @stonehippo.
  • SparkFun MicroMod STM32. #5060. Thanks @cdwilson.
  • UnexpectedMaker Feather S2 Neo. #5294. Thanks @UnexpectedMaker.
  • WarmBit BluePixel nRF52840. #5229 Thanks @warmbit.


  • Update documentation for vectorio. #5330. Thanks @lesamouraipourpre.
  • Remove remaining reference to #5324. Thanks @Neradoc.
  • Add required Python packages to build documentation. #5322. Thanks @rdoursenaud.
  • Add frozen library information for each board. #5304. Thanks @sommersoft.
  • Update ColorConverter documentation. #5295. Thanks @lesamouraipourpre.
  • Update Display.refresh() documentation. #5292. Thanks @lesamouraipourpre.
  • Document ParallelBus.frequency. #5290. Thanks @jepler.
  • Update TileGrid argument types. #5285. Thanks @FoamyGuy.

Build and infrastructure changes

  • Rename esp32s2 port directory to espressif, to handle future chips. #5342. Thanks @tannewt.
  • Only build boards or ports that have changed. #5312, #5238. Thanks @tannewt.
  • Add test for traceback. #5296. Thanks @microDev1.
  • Fix link templates. #5284. Thanks @tannewt.
  • Use MP_REGISTER_MODULE for more built-in modules. #5281. Thanks @capellini.
  • Add 0x prefix on %p uses in printf(). #5263. Thanks @jepler.

Translation additions and improvements

  • Thanks for translations:
    • @hexthat (Chinese Pinyin)
    • @lesamouraipourpre (English UK)

Breaking changes and deprecations since 6.x

  • The RGB status LED codes have changed for clarity and to save power.
  • PWMOut is now only in pwmio, and is no longer in both pulseio and pwomio.
  • colorwheel() has been moved from _pixelbuf to rainbowio.
  • displayio.Group no longer has a max_size parameter.
  • vectorio: Rectangle, Circle, and Polygon are added directly to a Group; VectorShape is not needed.
  • Using a PWMOut for PulseOut is deprecated and will be removed in 8.0.0.
  • gamepad is removed: use keypad. gamepadshift is still present but will be removed in 8.0.0.
  • and settings.txt are no longer alternative names for
  • The default for displayio.Display.refresh(..., minimimum_frames_per_second, ...) is now 0.
  • displayio.Display() argument set_vertical_scroll argument is deprecated and will be removed in 8.0.0.
  • displayio.ParallelBus is now available as parallelbus.ParallelBus and will be removed from displayio in 8.0.0.
  • busio.OneWire/bitbangio.OneWire is now available as onewireio.OneWire and will be removed from busio and bitbangio in 8.0.0.

Known issues

  • See for other issues.


Thank you to all who used, tested, and contributed since 6.3.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.


Documentation is available in

This release is based on MicroPython 1.16. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Download from

Firmware downloads are available from the downloads page on The site makes it easy to select the correct file and language for your board.


To install follow the instructions in our new Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.

Try the latest version of the Mu editor for creating and editing your CircuitPython programs and for easy access to the CircuitPython serial connection (the REPL).

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.