adafruit/circuitpython 10.2.0-rc.0 on GitHub

This is CircuitPython 10.2.0-rc.0, a release candidate for CircuitPython 10.2.0 final. CircuitPython 10.2.0 will be the latest minor revision of CircuitPython, and will be a new stable release.

Highlights of this release

New audiotools.SpeedChanger.
New qspibus support for displayio.
Stability improvements to USB SD card handling.
Merge of MicroPython v1.27.
Update to ESP-IDF v5.5.3.
Many additions to the Zephyr port.
Simulated hardware testing is now being done in the Zephyr port.

Download from circuitpython.org

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

Installation

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

Try code.circuitpython.org or 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).

Documentation

Documentation is available in readthedocs.io.

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, these ports are consider stable (but see Known Issues below):

atmel-samd: Microchip SAMD21, SAMx5x
cxd56: Sony Spresense
espressif: Espressif ESP32, ESP32-C2, ESP32-C3, ESP32-C6, ESP32-C61, ESP32-H2, ESP32-S2, ESP32-S3
nordic: Nordic nRF52840, nRF52833
raspberrypi: Raspberry Pi RP2040, RP2350
stm: ST STM32F4 chip family

These ports are considered alpha and will have bugs and missing functionality:

analog: Analog Devices MAX32690
broadcom: Raspberry Pi boards such as RPi 4, RPi Zero 2W
espressif: , ESP32-P4
litex: fomu
mimxrt10xx: NXP i.MX RT10xxx
renode: hardware simulator
silabs: Silicon Labs MG24 family
stm: ST non-STM32F4 chip families
zephyr: multiplatform RTOS, running on multiple chip families

Changes

Fixes and enhancements

Update frozen libraries. #10945, #10853, Thanks @dhalbert and @FoamyGuy.
Merge MicroPython v1.27 into CircuitPython. #10931. Thanks @dhalbert.
Fix palette length validation in _stage. #10904. Thanks @deshipu.
Add audiotools.SpeedChanger. #10900. Thanks @todbot.
Add mcp4822 SPI DAC support. #10895. Thanks @todbot.
Improve USB SD presentation, sdcardio implementation, displayio bus sharing. #10887. Thanks @dhalbert.
Add arg validations in various bitmaptools methods. #10884. Thanks @FoamyGuy.
Merge 10.1.x fixes. #10877, #10839. Thanks @dhalbert.
Fix handling of full-width glyphs in lvfontio. #10865. Thanks @FoamyGuy.
Added displayio qspibus support. #10844. Thanks @ppsx.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

Change USB task priority to be the same as the CircuitPython task. #10887. Thanks @dhalbert.
Fix BLE startup crash. #10858. Thanks @tannewt.
Update to ESP-IDF 5.5.3. #10840. Thanks @tannewt.

i.MX

Nordic

renode

RP2

Fix i2ctarget bugs. #10933. Thanks @FoamyGuy.
Fix i2ctarget start bug. #10474. Thanks @MarkEbrahim.

SAMx

SiLabs

Spresense

STM

Zephyr

Enable adafruit_bus_device, hashlib, zlib, aesio, msgpack. #10943, #10939, #10932, #10927. Thanks @FoamyGuy.
Add nvm support. #10918. Thanks @tannewt.
Add Adafruit Feather RP240. #10925. Thanks @FoamyGuy.
Add Adafruit Feather nRF2840 Sense. #10923. Thanks @tannewt.
Add Raspberry Pi Pico, Pico W, Pico2, Pico2 W. #10917. Thanks @tannewt.
add audiobusio.I2SOut support. #10916. Thanks @tannewt.
Zephyr port and build fixes. #10912, #10911, #10863, #10860, #10859. Thanks @tannewt.
Allow building and uploading native_sim .exe. #10897. Thanks @tannewt.
Add heap statistics tracking to native_sim. #10869. Thanks @tannewt.
Add zephyr_display to support fixed Zephyr displays. #10868. Thanks @tannewt.
Implement _bleio scanning, advertising, connect, and disconnect. #10862, #10833. Thanks @tannewt.
Add TCP neworking support. #10847. Thanks @tannewt.
Test simulated hardware using perfetto traces. #10846. Thanks @tannewt.
Handle time simulation wihtout using yields. #10834. Thanks @tannewt.

Individual boards

Cytron Maker Pi RP2040: add GP29 pin definitions. #10893. Thanks @CytronTechnologies.
uGame S3: slow down SPI to avoid display glitches. #10837. Thanks @deshipu.

Documentation changes

Explain SD card initialization more thoroughly. #10947. Thanks @mikeysklar.
Correct return type in busio.I2C.probe(). #10891. Thanks @FoamyGuy.

Build and infrastructure changes

Update CI actions to Node.24 versions. #10910. Thanks @dhalbert.
Fix ReadTheDocs build warnings. #10907. Thanks @dhalbert.
Add support for user-supplied build configuration files: user_pre_mpconfigport.mk, user_post_mpconfigport.mk, user_post_circuitpy_defns.mk. #10817. Thanks @bablokb.

Translation additions and improvements

New boards

Pimoroni Badger2350. #10929. Thanks @bablokb.
Pimoroni Explorer RP2350. #10778. Thanks @tyeth.
TinyCircuits Thumby and Thumby Color. #10851, #10303. Thanks @tannewt.
Waveshare ESP32-S# Touch AMOLED 2.41". #10844. Thanks @ppsx.
WeAct Studio RP2350B Core. #10646. Thanks @cvmanjoo.
Xteink X4. #10873. Thanks @BlitzCityDIY.

Known issues

See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
The CIRCUITPY drive is not working on at least some STM32 boards.
Native-code .mpy files are not working. This capability is currently enabled only on the winterbloom_sol board.

Thanks

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

adafruit/circuitpython 10.2.0-rc.0 CircuitPython 10.2.0-rc.0 on GitHub