CircuitPython 10.0.0-alpha.4

This is CircuitPython 10.0.0-alpha.4, an alpha release for 10.0.0. Further features, changes, and bug fixes will be added before the final release of 10.0.0.

This release is nearly the same as 10.0.0-alpha.3 but has a bug fix that breaks finalisers and results in "in use" errors. (Finalisers will usually release the resources.) It also fixes crashes on ESP32-CX RISC-V boards.

Highlights of this release

• A number of new audio effects.
• Improved garbage collection times
• ESP-IDF update to 5.4.1
• Improved audio playback on RP2

Incompatibility warnings

• synthio.BlockBiquad has been renamed to synthio.Biquad. The old deprecatedsynthio.Biquad has been removed, as well as synthio.Synthesizer.low_pass_filter, synthio.Synthesizer.high_pass_filter, and synthio.Synthesizer.band_pass_filter. Coefficients from biquad_filter_state have been moved into synthio_biquad (biquad_filter_state is still used for input and output state).
• The displayio bindings deprecated in 9.x.x have been removed:
  • busdisplay.BusDisplay replaces displayio.Display.
  • fourwire.FourWire replaces displayio.Fourwire.
  • epaperdisplay.EPaperDisplay replaces displayio.EPaperDisplay.
  • i2cdisplaybus.I2CDisplayBus replaces displayio.I2CDisplay.
• os.uname().sysname and os.uname().nodename now are set to MICROPY_HW_MCU_NAME uniformly across all ports.
• watchdog.WatchDogTimer.deinit() is removed.
• _asyncio removed push_head, push_sorted, pop_head. Ensure you are using the latest version of the asyncio Python-level library.

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, ESP32-H2
• 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

• Chorus audio effect by @gamblor21 in #10044
• Audio Effect Reverb by @gamblor21 in #10196
• Audio Effect Multi-Tap Delay by @relic-se in #10258
• Audio Effect Phaser by @relic-se in #10304
• Add selective collect to memory allocations by @tannewt in #10264
• Increase CFG_TUH_ENUMERATION_BUFSIZE so that USB devices with long descriptors are recognized by @rianadon in #10281
• Wifi power management by @dhalbert in #10271
• increase default PYSTACK size from 1536 to 2048 by @dhalbert in #10236
• Change mix calculation on audiodelays.Echo to allow full range. by @relic-se in #9994
• Add working_directory for subsequent code file by @tannewt in #10263
• Run background tasks during display refresh by @tannewt in #10277
• Fix for fixed point overflow in synthio by @gamblor21 in #10288
• Implement use_global_block_protection_lock for write-enabling flash. by @eightycc in #10249
• fix swapped argument required vars in bitmaptools args helper by @FoamyGuy in #10253
• update frozen libraries, especially asyncio by @dhalbert in #10251
• extmod/modasyncio.c: remove push_head, push_sorted, pop_head by @dhalbert in #10244

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Upgrade ESP-IDF v5.3.2 to v5.4.1 by @eightycc in #10267
• ESP: add MAC address to boot_out.txt (for wifi boards) by @Neradoc in #10239

i.MX

Nordic

renode

RP2

• Add touchio pullup rp2350 by @todbot in #10227
• Implement BOOTSEL button entry to safe mode for RP2. by @eightycc in #10231
• rp2pio mov_status_type and mov_status_n by @burtyb in #10262
• Fix RP2xxx I2SOut reversed channels by @dhalbert in #10250
• Tweak audio playback on RP2 by @tannewt in #10299

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• Add Blues Cygnet Feather (STM32L433) board by @Bucknalla in #10211
• Added peripheral support for Daisy Seed stm32H750 board by @snkYmkrct in #10198
• boards/oxocard_*/board.c: Fix vertical offset for LCD screen by @supcik in #10302
• Seeed Xiao ESP32-C6: Add user LED to pins.c by @KanyonKris in #10273

Documentation changes

Build and infrastructure changes

Translation additions and improvements

New boards

• Feather RP2350 adalogger by @BlitzCityDIY in #10254

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.

New Contributors

• @Bucknalla made their first contribution in #10211
• @KanyonKris made their first contribution in #10273
• @rianadon made their first contribution in #10281

Full Changelog: 10.0.0-alpha.3...10.0.0-alpha.4

CircuitPython 10.0.0-alpha.3

This is CircuitPython 10.0.0-alpha.3, an alpha release for 10.0.0. Further features, changes, and bug fixes will be added before the final release of 10.0.0.

Known issue: This release has a bug that breaks finalisers and results in "in use" errors. (Finalisers will usually release the resources.)

Highlights of this release

• A number of new audio effects.
• Improved garbage collection times
• ESP-IDF update to 5.4.1
• Improved audio playback on RP2

Incompatibility warnings

• synthio.BlockBiquad has been renamed to synthio.Biquad. The old deprecatedsynthio.Biquad has been removed, as well as synthio.Synthesizer.low_pass_filter, synthio.Synthesizer.high_pass_filter, and synthio.Synthesizer.band_pass_filter. Coefficients from biquad_filter_state have been moved into synthio_biquad (biquad_filter_state is still used for input and output state).
• The displayio bindings deprecated in 9.x.x have been removed:
  • busdisplay.BusDisplay replaces displayio.Display.
  • fourwire.FourWire replaces displayio.Fourwire.
  • epaperdisplay.EPaperDisplay replaces displayio.EPaperDisplay.
  • i2cdisplaybus.I2CDisplayBus replaces displayio.I2CDisplay.
• os.uname().sysname and os.uname().nodename now are set to MICROPY_HW_MCU_NAME uniformly across all ports.
• watchdog.WatchDogTimer.deinit() is removed.
• _asyncio removed push_head, push_sorted, pop_head. Ensure you are using the latest version of the asyncio Python-level library.

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, ESP32-H2
• 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

• Chorus audio effect by @gamblor21 in #10044
• Audio Effect Reverb by @gamblor21 in #10196
• Audio Effect Multi-Tap Delay by @relic-se in #10258
• Audio Effect Phaser by @relic-se in #10304
• Add selective collect to memory allocations by @tannewt in #10264
• Increase CFG_TUH_ENUMERATION_BUFSIZE so that USB devices with long descriptors are recognized by @rianadon in #10281
• Wifi power management by @dhalbert in #10271
• increase default PYSTACK size from 1536 to 2048 by @dhalbert in #10236
• Change mix calculation on audiodelays.Echo to allow full range. by @relic-se in #9994
• Add working_directory for subsequent code file by @tannewt in #10263
• Run background tasks during display refresh by @tannewt in #10277
• Fix for fixed point overflow in synthio by @gamblor21 in #10288
• Implement use_global_block_protection_lock for write-enabling flash. by @eightycc in #10249
• fix swapped argument required vars in bitmaptools args helper by @FoamyGuy in #10253
• update frozen libraries, especially asyncio by @dhalbert in #10251
• extmod/modasyncio.c: remove push_head, push_sorted, pop_head by @dhalbert in #10244

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Upgrade ESP-IDF v5.3.2 to v5.4.1 by @eightycc in #10267
• ESP: add MAC address to boot_out.txt (for wifi boards) by @Neradoc in #10239

i.MX

Nordic

renode

RP2

• Add touchio pullup rp2350 by @todbot in #10227
• Implement BOOTSEL button entry to safe mode for RP2. by @eightycc in #10231
• rp2pio mov_status_type and mov_status_n by @burtyb in #10262
• Fix RP2xxx I2SOut reversed channels by @dhalbert in #10250
• Tweak audio playback on RP2 by @tannewt in #10299

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• Add Blues Cygnet Feather (STM32L433) board by @Bucknalla in #10211
• Added peripheral support for Daisy Seed stm32H750 board by @snkYmkrct in #10198
• boards/oxocard_*/board.c: Fix vertical offset for LCD screen by @supcik in #10302
• Seeed Xiao ESP32-C6: Add user LED to pins.c by @KanyonKris in #10273

Documentation changes

Build and infrastructure changes

Translation additions and improvements

New boards

• Feather RP2350 adalogger by @BlitzCityDIY in #10254

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.

New Contributors

• @Bucknalla made their first contribution in #10211
• @KanyonKris made their first contribution in #10273
• @rianadon made their first contribution in #10281

Full Changelog: 10.0.0-alpha.2...10.0.0-alpha.3

CircuitPython 10.0.0-alpha.2

This is CircuitPython 10.0.0-alpha.2, an alpha release for 10.0.0. Further features, changes, and bug fixes will be added before the final release of 10.0.0.

Highlights of this release

• tilepalettemapper.TilePaletteMapper now supports displayio.ColorConverter.

Incompatibility warnings

• synthio.BlockBiquad has been renamed to synthio.Biquad. The old deprecatedsynthio.Biquad has been removed, as well as synthio.Synthesizer.low_pass_filter, synthio.Synthesizer.high_pass_filter, and synthio.Synthesizer.band_pass_filter. Coefficients from biquad_filter_state have been moved into synthio_biquad (biquad_filter_state is still used for input and output state).
• The displayio bindings deprecated in 9.x.x have been removed:
  • busdisplay.BusDisplay replaces displayio.Display.
  • fourwire.FourWire replaces displayio.Fourwire.
  • epaperdisplay.EPaperDisplay replaces displayio.EPaperDisplay.
  • i2cdisplaybus.I2CDisplayBus replaces displayio.I2CDisplay.
• os.uname().sysname and os.uname().nodename now are set to MICROPY_HW_MCU_NAME uniformly across all ports.
• watchdog.WatchDogTimer.deinit() is 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

This release also includes fixes and changes through CircuitPython 9.2.7.

Fixes and enhancements

• synthio.BlockBiquad is renamed to synthio.Biquad, and replaces the old deprecated synthio.Biquad. #10213. Thanks @relic-se.
• Add lvfontio.OnDiskFont to upport on-disk fonts for terminalio. #10208. Thanks @tannewt.
• Update TinyUSB. Close device endpoints as needed. #10194. Thanks @tannewt.
• Remove deprecated displayio bus bindings. #10193. Thanks @dhalbert.
• tilepalettemapper.TilePaletteMapper now supports displayio.ColorConverter. #10173. Thanks @FoamyGuy.
• Use MICROPY_HW_MCU_NAME for os.uname().sysname and nodename for all ports. #10145. Thanks @eightycc.
• Remove watchdog.WatchDogTimer.deinit(). #10144. Thanks @eightycc.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

i.MX

Nordic

renode

RP2

• Fix USB host issues. #10221. Thanks @tannewt.
• Force critical-section enter/exit routines to be in RAM instead of flash. #10219. Thanks @tannewt.

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• STM32F412G_DISCO: fix typo in chip name. #10150. Thanks @page200.
• WIZnet-5100S-EVB-Pico, EVB-Pico2, W5500 Pico2: normalize pin names and default devices. #10199. Thanks @fasteddy516.

Documentation changes

Build and infrastructure changes

• Fix version determination for multi-digit version numbers. #10216. Thanks @tannewt.
• CIRCUITPY_FULL_BUILD now controls more language features, for uniformity. #10152. Thanks @dhalbert.
• Add pin validation to a manual USB test. #10148. Thanks @FoamyGuy.

Translation additions and improvements

New boards

• WIZnet W5500-EVB-Pico2. #10179. Thanks @fasteddy516.

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.

CircuitPython 9.2.7

This is CircuitPython 9.2.7, 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

• 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

• Fix TileGrid.contains() when used with subclasses of TileGrid. #10192. Thanks @FoamyGuy.
• Allow terminalio.Terminal with height of 1. #10210. Thanks @FoamyGuy.
• Fix regression that did not treat MP3 samples as signed. #10185. Thanks @jepler.
• Correct len() of a keypad.EventQueue. #10184. Thanks @dhalbert.
• Disallow identical left and right channel pins in audioio.AudioOut. #10182. Thanks @dhalbert.
• Fix regression that did not allow reading what was in a usb_cdc.Serial buffer when USB was disconnected. #10177. Thanks @Neradoc.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Guard against multiple deinit of PulseIn and PulseOut objects. #10190. Thanks @eightycc.
• Work around ESP-IDF bug that randomly swaps left and right channels in audioio.AudioOut. #10182. Thanks @dhalbert.

i.MX

Nordic

renode

RP2

• Fix pin validation for analogbufio.BufferedIn on RP2350B. #10202. Thanks @dhalbert.
• Disallow using board.A3 (GPIO29) with analogbufio.BufferedIn on CYW43 boards. #10202. Thanks @dhalbert.
• Use -isystem to simplify including the correct header files for raspberrypi builds. #10188. Thanks @jepler.
• Add -Wype-limits gcc warnings, and fix them. #10187. Thanks @jepler.
• Fix multiple PIO issues. #10186. Thanks @eightycc.

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• Waveshare ESP32-C6 LCD 1.47: fix NeoPixel colors. #10204. Thanks @Neradoc.

Documentation changes

Build and infrastructure changes

• Correct and clean up .pre-commit-config.yaml. #10205. Thanks @dhalbert.

Translation additions and improvements

New boards

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.

CircuitPython 9.2.6

This is CircuitPython 9.2.6, 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

• Fix storage.remount("/", readonly=False) regression.
• Fix RP2xxx WiFi mDNS limitations.

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

• Fix storage.remount("/", readonly=False) regression from 9.2.5. #10168. Thanks @dhalbert.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

i.MX

Nordic

renode

RP2

• Increase MDNS_MAX_SERVICES to fix mDNS limitations. #10166. Thanks @eightycc.

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• Adafruit Fruit Jam: fix button names. #10156. Thanks @dhalbert.
• Heltec ESP32-S3-WIFI-LoRa-V3: remove unusuable RFM9x frozen library. #10146. Thanks @cmarxmeier.
• Waveshare ESP32-S3-GEEK: add board.SPI(); fix SD SPI. #10164. Thanks @Neradoc.

Documentation changes

• Address multiple documentation issues. #10160. Thanks @dhalbert.

Build and infrastructure changes

• Prevent reformatting Python code inside i.MX SDK submodule. #10156. Thanks @dhalbert.

Translation additions and improvements

New boards

• Waveshare ESP32S3 Touch LCD 2. #10142. Thanks @Neradoc.

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.

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.

CircuitPython 9.2.4

This is CircuitPython 9.2.4, 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, including a fix for adafruit_requests.
• audiofilters: add Distortion and implement LFO ticking.
• Add canio support for i.MX boards.
• Fix RP2 picodvi crash.
• Fix STM USB crashes.

Incompatibility warnings

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

Changes

Fixes and enhancements

• Update frozen modules, including a fix for adafruit_requests. #10012. Thanks @dhalbert.
• MP3Decoder can now handle 40-byte format headers. #10001. Thanks @marshalmiller.
• audiofilters: add Distortion and implement LFO ticking. #9776. Thanks @relic-se.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Cleaner fix for ESP32-S3 USB problem. #9985. Thanks @hathach.

i.MX

• Add canio support. #9982. Thanks @SamantazFox and @qutefox.

Nordic

renode

RP2

• Fix regression re offset in rp2pio.StateMachine. #10010. Thanks @jepler.
• Use newer PIO resource handling API. #9999. Thanks @jepler.
• Better audio DMA error handling. #9989. Thanks @eightycc.
• Fix picodvi crashes due to DMA handling regression. #9980. Thanks @dhalbert.

SAMx

SiLabs

Spresense

STM

• Update TinyUSB to fix regression in counting endpoints. #9985. Thanks @hathach and @dhalbert.

Individual boards

• Adafruit Metro RP2350: enable USB host by default. #10005. Thanks @jepler.
• Adafruit Sparkle Motion: correct and add pin aliases. #9993. Thanks @BlitzCityDIY.
• Spotpear ESP32C3 1.44" LCD: Use legacy 4MB layout to avoid bootloop due to _bleio enabling. #9997. Thanks @SeanTheITGuy.
• Waveshare ESP32-C6 LCD 1.47": allow sharing of SPI bus. #9987. Thanks @bwshockley.

Documentation changes

• Remove reference to long-obsolete audioio names. #10000. Thanks @jepler.

Build and infrastructure changes

• Explicitly request board info in bug report template. #10008. Thanks @dhalbert.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @FK-sauve (French)
  • @wtuemura (Portugese - Brazil)

New boards

• Waveshare ESP32-C6 LCD 1.47". #9984. Thanks @bwshockley.

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
  • 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.

CircuitPython 9.2.3

This is CircuitPython 9.2.3, 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

• Fix ESP32-S3 regression: did not connect properly to USB without an interposed hub.
• New boards: Adafruit Sparkle Motion and Mini Sparkle Motion, M5Stack StampS3.

Incompatibility warnings

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

Changes

Fixes and enhancements

• Fix frozen library version numbers. #9959. Thanks @Neradoc.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Fix ESP32-S3 not connecting to USB. #9973. Thanks @hathach and @dhalbert.

i.MX

Nordic

renode

RP2

• Use defined constants for CYW43 pins. #9945. Thanks @arturo182.

SAMx

SiLabs

Spresense

STM

• Prospective fix for STM32H7 crashes on recent builds. #9962, Thanks @snkYmkrct.

Individual boards

• Waveshare Pico S3: fix status LED colors. #9949. Thanks @Neradoc.

Documentation changes

• Document Windows limitation for usb_midi.set_names(). #9946. Thanks @dhalbert.
• Fix rtc documentation typo. #9944. Thanks @KeithTheEE.

Build and infrastructure changes

• Improvements to serial console startup and logging. #9964. Thanks @eightycc.
• Fix version of setuptools_scm used for circuitpython-stubs. #9948. Thanks @jepler.
• Find files with inline documentation using an inclusion instead of an exclusion list. #9947. Thanks @jepler.

Translation additions and improvements

• Thanks for translations:
  • gfbdrgng (Russian)
  • @wtuemura (Portugese - Brazil)

New boards

• Adafruit Mini Sparkle Motion Mini. #9963. Thanks @FoamyGuy.
• Adafruit Sparkle Motion. #9961. Thanks @BlitzCityDIY.
• M5Stack StampS3: #9950. Thanks @StellasFun.

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
  • 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.

CircuitPython 9.2.2

This is CircuitPython 9.2.2, 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

• int.from_bytes() and .to_bytes() calls can omit byteorder arg, as in CPython.
• DemuxKeyMatrix: add scan delay, add columns_to_anodes and transpose args.
• Implement audiomixer.MixerVoice.level as synthio.BlockInput.
• displayio now supports 24-bit color depth.
• Add sideset_pindirs to rp2pio.StateMachine.
• rp2pio: support on GPIO pins 32 and up, available on RP2350B.
• Initial implementation of audiobusio.PDMIn on Espressif.
• Update Espressif ESP-IDF to v5.3.2, which supports ESP32-P4 v1.0 chips.
• New ports/analog port, initially supporting Analog Devices ADI MAX32690 microcontroller.
• Over 20 new boards.

Incompatibility warnings

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

Changes since 9.2.1

Fixes and enhancements

• int.from_bytes() and .to_bytes() calls can omit byteorder arg, as in CPython. #9940. Thanks @dhalbert.
• Discard line-clearing escape characters in web workflow serial stream. #9934. Thanks @Neradoc.
• Fix self arg passed to @classmethod when accessed via super. #9926. Thanks @dhalbert and @dpgeorge (from MicroPython).
• DemuxKeyMatrix: add scan delay, add columns_to_anodes and transpose args. #9912. Thanks @patricksurry.
• Implement audiomixer.MixerVoice.level as synthio.BlockInput. #9899. Thanks @relic-se.
• RGBMatrix speculative fix: added and removed. #9892, #9865. Thanks @jepler.
• displayio: support 24-bit color depth. #9882. Thanks @ddrown.
• MP3Decoder: prevent including old data in stream. #9866. Thanks @jepler.
• Remove unneeded keyword arg handlers in audio classes property setters. #9864, #9862. Thanks @relic-se and @jepler.
• Provide audiomixer.MixerVoice.loop property. #9861. Thanks @pdw-mb.
• Fix vectorio rotation corner case. #9851. Thanks @FoamyGuy.

Port and board-specific changes

Analog Devices

• New ports/analog port, initially supporting Analog Devices ADI MAX32690 microcontroller. #9667. Thanks @Brandon-Hurst.

Broadcom

Espressif

• Add short delay after I2C bus probe to fix I2C bus scanning on ESP32-S2. #9942. Thanks @dhalbert.
• Update Espressif ESP-IDF to v5.3.2, which supports ESP32-P4 v1.0 chips. #9928. Thanks @tannewt.
• Use correct USB Device instance. #9889. Thanks @dhalbert.
• ESP32-P4: USB support. #9889, #9841. Thanks @tannewt and @dhalbert.
• Make alarm available on some boards where it was inadvertently omitted. #9881. Thanks @dhalbert.
• Allow mbedtls data to be stored in PSRAM. #9867. Thanks @jepler.
• Initial implementation of audiobusio.PDMIn. #9828. Thanks @JetForMe.

i.MX

Nordic

renode

RP2

• Enable compiler warning that was disabled for gcc 10. #9942. Thanks @jepler.
• rp2pio: support PIO on GPIO pins 32 and up, available on RP2350B. #9901. Thanks @jepler.
• Better documentation for rp2pio types. #9885. Thanks @jepler.
• Add sideset_pindirs to rp2pio.StateMachine. #9849. Thanks @jepler.
• Update pico-sdk to version 2.1.0. #9831. Thanks @eightycc.

SAMx

SiLabs

Spresense

STM

Individual boards

• Adafruit Floppsy RP2040: add board.DISPLAY; update pins. #9869, #9833. Thanks @jepler.
• LILYGO T-Watch 2020 V3: restore serial connection. #9916. Thanks @Neradoc.
• Oxocard Connect: fix pins. #9932. Thanks @supcik.
• TTGO T8 v1.7 ESP32: PSRAM support. #9824. Thanks @aguaviva.
• Waveshare S3 Zero: add button pin names. #9858. Thanks @Timeline8.
• WIZnet W5100S-EVB-Pico2: update USB names. #9835. Thanks @anecdata.

Documentation changes

• Document safe mode wait interval in README.rst. #9929. Thanks @pdw-mb.
• Update usb_hid boot device documentation. #9836. Thanks @dhalbert.

Build and infrastructure changes

• raspberrypi: revert #5210. Use -Og for debug build. #9925. Thanks @eightycc.
• Update CMAKE version for GitHub codespaces. #9832. Thanks @bablokb

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @odeevee (French)
  • @hexthat (Chinese - Hanyu Pinyin)
  • @jposada202020 (Spanish)
  • @SKRRRRRRT (German)
  • @wtuemura (Portugese - Brazil)

New boards since 9.2.1

• 8086 RP2040 Interfacer. #9894. Thanks @burtyb.
• Adafruit Metro RP2350 (RP2350B chip). #9895, #9890, #9834, #9830. Thanks @dhalbert.
• Analog Devices MAX32690 APARD. #9667. Thanks @Brandon-Hurst.
• Analog Devices MAX32690 EvKit. #9667. Thanks @Brandon-Hurst.
• HEIA-FR Picomo V3. #9933. Thanks @supcik.
• Heltec Wireless Paper. #9838. Thanks @SeanTheITGuy.
• M5Stack M5Stick C Plus2. #9939. Thanks @bootc.
• Music Thing Modular Workshop System. #9850. Thanks @todbot.
• Pimoroni Plasma 2350 W. #9923. Thanks @ShawnEsterman.
• Pimoroni Pico Plus 2 W. #9826. Thanks @eightycc.
• Waveshare ESP32-S3-ETH. #9922. Thanks @anecdata.
• Sunton ESP32-2432S024C. #9919, #9918. Thanks @PasswordVault and @RetiredWizard.
• Sunton ESP32-8048S050. #9911. Thanks @RetiredWizard.
• Waveshare ESP32-S3-Matrix. #9879. Thanks @m4tk.
• Waveshare RP2350-Geek. #9896. Thanks @relic-se.
• Waveshare RP2350-LCD-0.96. #9896. Thanks @relic-se.
• Waveshare RP2350-LCD-1.28. #9896. Thanks @relic-se.
• Waveshare RP2350-One. #9896. Thanks @relic-se.
• Waveshare RP2350-Plus. #9896. Thanks @relic-se.
• Waveshare RP2350-Tiny. #9896. Thanks @relic-se.
• Waveshare RP2350-Touch-LCD-1.28. #9896. Thanks @relic-se.
• Waveshare RP2350-Zero. #9896. Thanks @relic-se.

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
  • 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.

CircuitPython 9.2.1

This is CircuitPython 9.2.1, 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

• Additional synthio and audiofilters functionality.
• I2CTarget and keys.*.reset() fixes.
• RP2350: PSRAM and cpu.temperature fixes.
• rp2pio: add background read operation.
• Five new boards.

Incompatibility warnings

• Raise TypeError when attempt to produce JSON for invalid types. Previously the types were serialized as strings.

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:

• broadcom: Raspberry Pi boards such as RPi 4, RPi Zero 2W
• espressif: ESP32-P4 (currently no USB support)
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.2.0

Fixes and enhancements

• Fix regression of keypad.*.reset() behavior. #9819. Thanks @aseanwatson and @dhalbert.
• Add finaliser to I2CTarget to fix problems on soft retart. #9810. Thanks @dhalbert.
• Raise TypeError when attempt to produce JSON for invalid types. #9789. Thanks @jepler.
• Add synthio.BlockInput support to synthio.Note waveform loop parameters. #9788. Thanks @relic-se.
• Supply silence when sample missing in audiofilters.Filter. #9787. Thanks @relic-se.
• Force reboot to normal mode after storage.erase_filesystem(). #9786. Thanks @bill88t.
• Add support for tuple of Biquad objects within audiofilters.Filter. #9772. Thanks @relic-se.
• synthio: Add a form of biquad filter, BlockBiquad, that uses BlockInput. #9756. Thanks @jepler.

Port and board-specific changes

Broadcom

Espressif

i.MX

nordic

renode

RP2

• Fix serial REPL bootloop. #9799. Thanks @eightycc.
• Avoid mbedtls function that exists only on RP2040. #9792. Thanks @jepler.
• Fix cpu.temperature on RP2350. #9784. Thanks @bablokb.
• Flush cache properly when PSRAM is in use on RP2350. #9783. Thanks @dhalbert.
• Update cyw43-driver module to match pico-sdk 2.0.0. #9775. Thanks @eightycc.
• Add rp2pio background read operation. #9659. Thanks @timchinowsky.

SAMx

SiLabs

Spresense

STM

Individual boards

• LILYGO T-Deck (Plus): improve port, add support for variant "Plus" functionality. #9815. Thanks @bill88t.
• LILYGO TEMBED ESP32S3: fix display initialization sequence. #9650. Thanks @bytiful.
• Meowbit: enabled gifio, and disable other modules unlikely to be used to make room. #9761. Thanks @dglaude.
• Pimoroni Pico Plus 2: rework pin names. #9803. Thanks @bablokb.
• WIZnet W5100S EVB Pico: Add ssl. #9791. Thanks @anecdata.

Documentation changes

• Fix typo in BusDisplay parameters. #9806. Thanks @RetiredWizard.

Build and infrastructure changes

• Make default unix variant be coverage. #9796. Thanks @jepler.
• Add audiodelays and audioeffects to unix coverage port. #9793. Thanks @jepler.
• Fix security issues in GitHub Actions found by zizmor. #9785. Thanks @jepler.
• Check for proper gcc version when building. #9779. Thanks @jepler.
• Enable vectorio in coverage build. #9766. Thanks @jepler.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @hexthat (Chinese - Hanyu Pinyin)
  • @py7hon (Indonesian)
  • @wtuemura (Portugese - Brazil)

New boards since 9.2.0

• 0xCB Gemini. #9801. Thanks @0xCB-dev.
• Bradán Lane STUDIO Coin M0. #9797. Thanks @bradanlane.
• Raspberry Pi Pico 2 W. #9817. Thanks @jepler.
• SparkFun Thing Plus RP2350. #9812. Thanks @sparkfun.
• WIZnet W5100S EVB Pico2. #9791. Thanks @anecdata.

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
  • 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.