This is CircuitPython 10.0.0-alpha.8, 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

• Increase the firmware partition size for ESP32-S3 boards with 4MB flash, allowing more features to be included, including BLE. You must update the TinyUF2 bootloader on these boards. See below.
• Merge updates from MicroPython v1.25.0.
• Fix regressions caused by SD automount capability.
• Add Terminal.cursor_x and .cursor_y.
• Add picodvi.Framebuffer.color_depth.

Incompatibility warnings

• You must update the TinyUF2 bootloader on all ESP32-S3 4MB flash boards to TinyUF2 0.33.0 or later.
  • The CircuitPython UF2 builds for these boards now assume a firmware partition of at 2.8MB (double the old size), as explained here. Updating the TinyUF2 bootloader will update the partition size. Failure to update the bootloader will likely cause a UF2 load to fail for 10.0.0-alpha.8 and later: you will remain in the bootloader, with the BOOT drive showing.
  • This bootloader update is only needed now for ESP32-S3 with 4MB flash boards; other ESP32-S3 boards are fine. Later this change will be made for 4MB ESP32-S2 boards. This bootloader update is compatible with CircuitPython 9.1.0 and later.
  • If you are loading CircuitPython using a .bin file instead of a UF2, the partition table is included in the .bin, and you don't need to do anything.
• 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 CircuitPython library.
• sys.print_exception() is removed. Use traceback.print_exception() instead. The exception object returned by sys.exc_info() is now a traceback module compatible object.

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 Nordic nRF5340 and nRF54L15, Renesas RA6M5, ST STM32H7

Changes

Fixes and enhancements

• Fix parsing complex numbers with negative real part. #10463. Thanks @ComplexSymbol and @jepler.
• Fix errors caused by SD automount where there is no SD card. #10457. Thanks @dhalbert.
• Add Terminal.cursor_x and .cursor_y. #10442. Thanks @FoamyGuy.
• Merge MicroPython v1.25.0 into CircuitPython. #10437. Thanks @dhalbert.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Expand firmware partition on ESP32-S3 boards, merging with OTA update partition. #10458. Thanks @dhalbert.

i.MX

Nordic

renode

RP2

• Add picodvi.Framebuffer.color_depth. #10431. Thanks @FoamyGuy.

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• LILYGO T-Dongle S3: Fix build: board has no PSRAM. #10462. Thanks @dhalbert.

Documentation changes

• Improve lvfontio documentation. #10452. Thanks @FoamyGuy.

Build and infrastructure changes

• Revert latex docs build workaround after weblate web traffic change. #10435. Thanks @FoamyGuy.

Translation additions and improvements

• Thanks for translations:
  • @CrackXT (multiple languages, especially German)
  • @dhalbert (Indonesian, Italian, Turkish)

New boards

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 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.

This is CircuitPython 10.0.0-alpha.7, 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

• Update frozen modules.
• Merge updates from MicroPython v1.24.1.
• Espressif:
  • Expand the CircuitPython firmware partition on non-USB boards, allowing more space for features in the future.
  • Fix pulseio.PulseIn length limitation.
  • Initial implementation of MicroROS.
• Nordic: reinitialize BLE properly after deep sleep.
• Incorporate fixes from CircuitPython 9.2.8 and later:
  • Fix deque bug.
  • Fix I2S audio file read causing memory corruption.
  • Support "Spectra6" six-color e-ink displays.
  • Fix audiodelays.Delay when freq_shift=True.
  • Board fixes.

Incompatibility warnings

• Starting with 10.0.0-alpha.5, the Adafruit Feather S3 4MB Flash 2MB PSRAM board requires TinyUF2 bootloader 0.31.0 or later (update instructions). This version of the bootloader removes the OTA update partition (not used) and doubles the size of the firmware code partition. This change for this particular board is a trial. If all goes well, all 4MB Flash ESP32-S2 and ESP-S3 boards will have this change applied in a later 10.0.0 alpha or beta release.
• 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 CircuitPython library.
• sys.print_exception() is removed. Use traceback.print_exception() instead. The exception object returned by sys.exc_info() is now a traceback module compatible object.

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 Nordic nRF5340 and nRF54L15, Renesas RA6M5, ST STM32H7

Changes

Fixes and enhancements

• Update frozen modules. #10430. Thanks @dhalbert.
• Merge MicroPython v1.24.1 into CircuitPython. #10417. Thanks @dhalbert.
• _eve: support bt280 REGION instruction. #10405. Thanks @jamesbowman.
• Fix buffer overflow in deque subscripting. #10383, #10380. Thanks @bablokb.
• Support "Spectra6" six-color e-ink displays. #10370, #10316. Thanks @bablokb.
• I2CTargetRequest: add deinit(), remove close(). #10366. Thanks @dhalbert.
• Fix handling of stereo audio within audiodelays.Delay when freq_shift=True. #10370, #10252. Thanks @relic-se.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Expand firmware partition on non-USB boards, merging with OTA update partition. #10424. Thanks @dhalbert.
• Fix pulseio.PulseIn length limitation. #10397. Thanks @Sola85.
• Fix memory corruption in I2S audio file pre-loading. #10370, #10284. Thanks @bablokb.
• Initial implementation of MicroROS. #9955. Thanks @hierophect.

i.MX

Nordic

• Reintialize BLE properly after deep sleep. #10381. Thanks @dhalbert.

renode

RP2

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• 42 Keebs Frood: update to version 9. #10370, #10335. Thanks @piit79.
• Adafruit Fruit Jam: update to rev D. #10429. Thanks @dhalbert.
• Adafruit Sparkle Motion Stick: update IR pin name. #10364. Thanks @FoamyGuy.
• Heltec ESP32S3 WiFi LoRa V3: fix booting failure. #10410. Thanks @baldengineer.
• Pimoroni Inky Frame 5.7": Fixed reversed board.I2C() SDA/SCL pins. #10370, #10279. Thanks @bablokb.
• Pimoroni Inky Frame 7.3": Fixed reversed board.I2C() SDA/SCL pins. #10370, #10279. Thanks @bablokb.
• Teensy 4.0: enable USB host. #10367. Thanks @Neradoc.
• Waveshare ESP32-S3 Zero: fix pins. #10393. Thanks @Timeline8.

Documentation changes

• Document that SleepMemory is now supported on RP2040. #10412. Thanks @wersimmon.
• Improve documentation for RP23050 erratum E9 keypad workarounds. #10382. Thanks @dhalbert.

Build and infrastructure changes

• Fix devcontainer gcc version. #10403. Thanks @bablokb.
• Update issue ping action. #10389. Thanks @tekktrik.
• Fix mpy-cross builds so they are really static. #10388. Thanks @dhalbert.
• Update to ARM gcc 14.2Rel1. #10386. Thanks @dhalbert.
• Enable -Werror=old-style-definition warning on several ports. #10377, #10375, #10372. Thanks @jepler.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @CrackXT (Dutch, French, German, Polish, Portugese - Brazil, Spanish)
  • @FK-sauve (French)
  • @hexthat (Chinese - Hanyu Pinyin)
  • @jonnybergdahl (Swedish)

New boards

• Orpheus Pico. #10411, #10406. Thanks @samdev-7.

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 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.

This is CircuitPython 9.2.8, 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 deque bug.
• Fix I2S audio file read causing memory corruption.
• Support "Spectra6" six-color e-ink displays.
• Fix audiodelays.Delay when freq_shift=True.
• Board 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 buffer overflow in deque subscripting. #10380. Thanks @bablokb.
• Support "Spectra6" six-color e-ink displays. #10316. Thanks @bablokb.
• Fix handling of stereo audio within audiodelays.Delay when freq_shift=True. #10252. Thanks @relic-se.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Fix memory corruption in I2S audio file pre-loading. #10284. Thanks @bablokb.

i.MX

Nordic

renode

RP2

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• 42. Keebs Frood: update to version 9. #10335. Thanks @piit79.
• Pimoroni Inky Frame 5.7": Fixed reversed board.I2C() SDA/SCL pins. #10279. Thanks @bablokb.
• Pimoroni Inky Frame 7.3": Fixed reversed board.I2C() SDA/SCL pins. #10279. Thanks @bablokb.

Documentation changes

Build and infrastructure changes

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.

This is CircuitPython 10.0.0-alpha.6, 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

• Fix regression causing errors on ARM processors.

Incompatibility warnings

• Starting with 10.0.0-alpha.5, the Adafruit Feather S3 4MB Flash 2MB PSRAM board requires TinyUF2 bootloader 0.31.0 or later (update instructions). This version of the bootloader removes the OTA update partition (not used) and doubles the size of the firmware code partition. This change for this particular board is a trial. If all goes well, all 4MB Flash ESP32-S2 and ESP-S3 boards will have this change applied in a later 10.0.0 alpha or beta release.
• 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.
• sys.print_exception() is removed. Use traceback.print_exception() instead. The exception object returned by sys.exc_info() is now a traceback module compatible object.

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 Nordic nRF5340 and nRF54L15, Renesas RA6M5, ST STM32H7

Changes

Fixes and enhancements

• Fix incorrect number of registers saved as gc roots on ARM processors. #10357. Thanks @eightycc.
• Fix dirty palette never being cleaned by vector shapes. #10356. Thanks @Neradoc.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

i.MX

Nordic

renode

RP2

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

Documentation changes

Build and infrastructure changes

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

This is CircuitPython 10.0.0-alpha.5, 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

• Add stability fixes for Espressif port builds.
• Add fixes for direct connecting USB devices to PIO USB host.
• Improve accuracy of time.sleep() and similar functions.
• Add MixerVoice.end().
• Change partition layout for Adafruit Feather ESP32-S3 4MB Flash 2MB PSRAM board, allowing BLE and other features to be enabled.

Incompatibility warnings

• Starting with 10.0.0-alpha.5, the Adafruit Feather S3 4MB Flash 2MB PSRAM board requires TinyUF2 bootloader 0.31.0 or later (update instructions). This version of the bootloader removes the OTA update partition (not used) and doubles the size of the firmware code partition. This change for this particular board is a trial. If all goes well, all 4MB Flash ESP32-S2 and ESP-S3 boards will have this change applied in a later 10.0.0 alpha or beta release.
• 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.
• sys.print_exception() is removed. Use traceback.print_exception() instead. The exception object returned by sys.exc_info() is now a traceback module compatible object.

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 Nordic nRF5340 and nRF54L15, Renesas RA6M5, ST STM32H7

Changes

Fixes and enhancements

• Fix SD cards showing up as second drive by #10351. Thanks @relic-se.
• Further integrate TilePaletteMapper and TileGrid. #10318. Thanks @FoamyGuy.
• Add end() method to MixerVoice to allow samples to finish playing. #10309. Thanks @rhammell.
• Improve resolution of mp_hal_delay_ms() to subticks. #10315. Thanks @eightycc.
• Show four spaces in place of tab in Terminal. #10324. Thanks @FoamyGuy.
• Factor out register saves to improve gc. #10325, #10337, Thanks @tannewt and @eightycc.
• Fix vectorio in group tracking. #10334. Thanks @tannewt.
• Remove non-standard sys.print_exception(). #10332. Thanks @tannewt.
• Fix terminal on rotation. #10333. Thanks @tannewt.

Port and board-specific changes

Analog Devices

Broadcom

Espressif

• Fix BLE not working by adding missing linker fragment on RISCV processors. #10321. Thanks @eightycc.
• Fix intermittent ESP32 crashes by wrapping longjmp. #10328. Thanks @eightycc.

i.MX

• Fix i.MX microcontroller.pin. #10317. Thanks @tannewt.

Nordic

• Fix microcontroller.cpu.reset_reason after deep sleep and further reset. #10344. Thanks @dhalbert.

renode

RP2

SAMx

SiLabs

Spresense

STM

Zephyr

Individual boards

• Adafruit Feather S3 4MB Flash 2MB PSRAM: use larger single code partition. Must be used with TinyUF2 0.30.0 or laster. #10346. Thanks @dhalbert.

Documentation changes

Build and infrastructure changes

• Update use of datetime. #10350. Thanks @emmanuel-ferdman.
• Update use of logging. #10343. Thanks @emmanuel-ferdman.
• Fix circuitpython.org release PR creation. #10312. Thanks @tannewt.
• Fix latex docs build. #10322. Thanks @FoamyGuy.

Translation additions and improvements

• Fix duplicated error messages #10336. Thanks @jonnybergdahl.
• Thanks for translations:
  • @bergdahl (Swedish)

New boards

• Adafruit Sparkle Motion Stick #10352. Thanks @BlitzCityDIY.

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 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

• @rhammell made their first contribution in #10309.
• @jonnybergdahl made their first contribution in #10336.
• @emmanuel-ferdman made their first contribution in #10343.

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

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

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.

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.

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.