CircuitPython 9.2.5

This is CircuitPython 9.2.5, the latest bugfix revision of CircuitPython, and is a new stable release.

WARNING for nRF52 boards only: If your board has an nRF52 UF2 bootloader whose version is before 0.6.1, you will not be able to load CircuitPython 8.2.0 and later, due to increased size of the firmware. See these instructions for updating your bootloader.

Highlights of this release

• Update frozen modules.
• Enable function attributes and reverse arithmetic operators on most boards.
• displayio:
  • Add tilepalettemapper.
  • add VT100 escape code support for scrolling and colors.
• synthio and audiodelays additions
• Add audioio on Espressif.
• Add spitarget on SAMx (enabled on most SAMx5x boards).
• Initial work on a Zephyr port.
• Bug fixes.

Incompatibility warnings

• Uses of deprecated displayio bindings are now called out with warnings. For instance, displayio.Display is deprecated in favor of busdisplay.BusDisplay. In CircuitPython 10.0.0 the deprecated bindings will be removed.

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-S2, ESP32-S3, ESP32-C2, ESP32-C3, ESP32-C6
• 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: testing with nRF5340, nRF54L15, RA6M5, STM32H7

Changes

Fixes and enhancements

• Update frozen modules. #10139. Thanks @dhalbert.
• Enable warnings when using older displayio bindings deprecated in 9.x. #10137. Thanks @eightycc.
• Enable function attributes and reverse arithmetic operators on most boards. #10134. Thanks @eightycc.
• Add support for a Python-writable /saves partition in addition to CIRCUITPY. #10122. Thanks @tannewt.
• Add tilepalettemapper for displayio. #10113. Thanks @FoamyGuy.
• Add VT100 escape code scrolling in terminalio. #10110, #10108. Thanks @RetiredWizard.
• Add VT100 escape codes for colors in terminalio. #10105. Thanks @RetiredWizard.
• Check for empty SSID before attempting to start web workflow. #10103. Thanks @dhalbert.
• Allow a CIRCUITPY_TERMINAL_SCALE value in settings.toml, to scale the terminalio display. #10099. Thanks @RetiredWizard.
• Fix loading small monochrome OnDiskBitmaps. #10097. Thanks @SamantazFox.
• Fix uses of m_realloc() and m_free when MICROPY_MALLOC_USES_ALLOCATED_SIZE is set. #10094. Thanks @SamantazFox.
• Improve displayio.ColorConverter accuracy for 5:5:5-bit colors. #10076. Thanks @qutefox.
• Add `supervisor.runtime.display. #10062. Thanks @jepler.
• Restore console_uart_printf() internally; fix use of __ZEPHYR__. #10057. Thanks @eightycc.
• Add audiodelays.PitchShift effect. #10052. Thanks @relic-se.
• Fix CIRCUITPY_SERIAL_GUARDING in serial_early_init(). #10043. Thanks @eightycc.
• Provide and use a a default __exit__() object, to save space. #10040. Thanks @jepler.
• Reduce audio processing code size. #10036. Thanks @jepler.
• Skip over unused data in WaveFiles. #10013. Thanks @MarshallMiller.
• Add synthio.BlockBiquad enhanced biquad filter support. #9804. Thanks @jepler.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Remove debug prints in PDMIn. #10101. Thanks @dhalbert.
• Make enabling BLE on 4MB Espressif boards possible. #10089. Thanks @Neradoc.
• Add audioio. #9995. Thanks @MarshallMiller.

i.MX

Nordic

renode

RP2

• Use Adafruit fork of Pico-PIO-USB. #10119. Thanks @tannewt.
• Fix picodvi.Framebuffer issues. #10116. Thanks @eightycc.
• Fix interrupt handling during flash writes. #10116, #10111. Thanks @eightycc.
• Update pico-sdk to 2.1.1. #10083. Thanks @eightycc.
• Fix picodvi.Framebuffer screen height for 640x480. #10069. Thanks @mattuna15.
• Autoconfigure picodvi display settings. #10062. Thanks @jepler.
• Don't block DMA_IRQ_1 when disabling interrupts. #10049. Thanks @jepler.
• Remove previously-added delay before initialization of CYW43. #10038. Thanks @bablokb.
• Speed up network operations by reducing lwip timer intervals; allocate lwip memory dynamically. #10027. Thanks @eightycc.
• Fix PIO state machine allocation for duplicate programs. #10025. Thanks @jepler.
• Fix peripheral clock restoration after light sleep. #10018. Thanks @dhalbert.
• Update Pico-PIO-USB. #10015. Thanks @jepler.

SAMx

• Add spitarget (SPI secondary) support. #9385. Thanks @Bruin-Spacecraft-Group.

SiLabs

Spresense

STM

Zephyr

• Add initial Zephyr port, which supports boards across multiple platforms. #10026. Thanks @tannewt.

Individual boards

• 01Space 0.42 OLED ESP32C3: reduce default transmit power. #10085. Thanks @bill88t.
• Heltec Wireless Paper: fix LoRa SPI pin choice. #10021. Thanks @SeanTheITGuy.
• LILYGO TEMBED ESP32S3: use wheel LEDs for status. #10126. Thanks @Neradoc.
• Particle Boron: support 8MB flash chip. #10098. Thanks @dhalbert.

Documentation changes

• Update picodvi display mode documentation. #10118. Thanks @FoamyGuy.
• Use shorthand type names for displayio types. #10109. Thanks @jepler.
• Fix usb_cdc.Serial.read() documentation. #10019. Thanks @dhalbert.

Build and infrastructure changes

• Add manual tests for USB host mouse support. #10128. Thanks @FoamyGuy.
• Fix custom build CI workflow. #10123. Thanks @Neradoc.
• Fix how to find board info for building and documentaiton. #10121, #10041. Thanks @tannewt, @jepler.
• Use MP_ROM_QSTR instead of MP_OBJ_NEW_QSTR. #10058. Thanks @jepler.
• Require specific ruff version. #10035. Thanks @jepler.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @FK-sauve (French)
  • @hexthat (Chinese - Pinyin)
  • @karlosgliberal (Spanish)
  • Jiayin Liu (Chinese - Pinyin)
  • @wtuemura (Portugese - Brazil)

New boards

• Adafruit Fruit Jam: #10136, #10135, #10114, #10081. Thanks @tannewt, @dhalbert.
• Daisy Seed: #9974. Thanks @snkYmkrct.
• Elecrow CrowPanel 4.2 EPaper. #10107. Thanks @SeanTheITGuy.
• Heltec Vison Master E290. #10090. Thanks @SeanTheITGuy.
• HXR SAO DIgital Multimeter. #10092. Thanks @flummer.
• LILYGO T-Dongle S3. #10065. Thanks @deisterhold.
• LILYGO T-QT PRO NO PSRAM and PSRAM. #10131. Thanks @Neradoc.
• PROVES Kit v4. #10127. Thanks @proveskit.
• Red ESP32-S2-WROOM. #10060. Thanks @Glodigit.
• Spotpear ESP32C3 LCD 1.69. #10106. Thanks @SeanTheITGuy.
• WEMOS LOLIN S3 MINI PRO 4MB Flash 2MB PSRAM. #10088. Thanks @SeanTheITGuy.

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.2.x
  • 9.x.x
  • 10.0.0
  • 10.0.x
  • 10.x.x
  • 11.0.0
  • long term
• 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.