CircuitPython 9.2.0

This is CircuitPython 9.2.0, the latest minor 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 RP2350 cache invalidation for PSRAM.

Notable changes in 9.2.0 from 9.1.x

• Raspberry Pi RP2350 support.
• Update to Espressif ESP-IDF V5.3.1, including new I2C driver.
• Merge MicroPython updates from v1.22.2 and v1.23.
• Espressif BLE improvements.
• Add math.dist().
• _eve updates.
• New busio.I2C.probe() and bitbangio.I2C.probe() methods to check for a single device address.
• ESP32-S3: implement sdioio.
• New audiodelays and audiofilters modules. These modules are experimental, and the API may change.
• Incompatible change: Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif.
• Incompatible change: Use default hostname for mDNS. Fix mDNS collision mangling.

Incompatibility warnings

• Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif. Previous board-specific names were not applied consistently. Use wifi.radio.hostname to set a custom hostname.
• Use default hostname for mDNS. Fix mDNS collision mangling. DNS hostnames will be different.

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-rc.0

Fixes and enhancements

Port and board-specific changes

Broadcom

Espressif

i.MX

nordic

renode

RP2

• Fix RP2350 cache invalidation for PSRAM. #9759. Thanks @dhalbert.

SAMx

SiLabs

Spresense

STM

Individual boards

Documentation changes

• Add note about different _bleio implementations. #9758. Thanks @dhalbert.

Build and infrastructure changes

• Remove version restrictions on Python cryptography library. #9757. Thanks @jepler.

Translation additions and improvements

New boards since 9.2.0-rc.0

Known issues

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

This is CircuitPython 9.2.0-rc.0, a release candidate for 9.2.0 final. This release is believed to be stable, and is meant for testing before the final release of 9.2.0.

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

• New audiodelays and audiofilters modules. These modules are experimental, and the API may change.
• Bug fixes.

Notable changes in 9.2.0 from 9.1.x

• Raspberry Pi RP2350 support.
• Update to Espressif ESP-IDF V5.3.1, including new I2C driver.
• Merge MicroPython updates from v1.22.2 and v1.23.
• Espressif BLE improvements.
• Add math.dist().
• _eve updates.
• New busio.I2C.probe() and bitbangio.I2C.probe() methods to check for a single device address.
• ESP32-S3: implement sdioio.
• New audiodelays and audiofilters modules. These modules are experimental, and the API may change.
• Incompatible change: Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif.
• Incompatible change: Use default hostname for mDNS. Fix mDNS collision mangling.

Incompatibility warnings

• Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif. Previous board-specific names were not applied consistently. Use wifi.radio.hostname to set a custom hostname.
• Use default hostname for mDNS. Fix mDNS collision mangling. DNS hostnames will be different.

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 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-beta.1

Fixes and enhancements

• Fix default values for wifi.Radio.start_dhcp_client(). #9751. Thanks @dhalbert.
• Add audiofilters module. #9744. Thanks @dcooperdalrymple.
• Improve _bleio.Connection.bind() validation, error messages, and documentation. #9732. Thanks @dhalbert.
• Add errno.EROFS and errno.ENOSPC. #9731. Thanks @dhalbert.
• adafruit_pixelbuf: allow modifying transmit buffer to control brightness on TM1814 RGB strips. #9730. Thanks @jepler.
• Fix keypad.ShiftRegisterKeys.key_count value. #9719. Thanks @dhalbert.
• Add audiodelays module. #9640. Thanks @gamblor21.

Port and board-specific changes

Broadcom

Espressif

• Disable hardware stack guard while crashes it causes are investigated. #9748. Thanks @dhalbert and MicroPython folks.
• Disable ipv6 RDNSS: LWIP overwrites ipv4 DNS servers. #9713. Thanks @jepler.

i.MX

nordic

renode

RP2

• Explicitly invalidate cache lines on RP2350. #9752. Thanks @tannewt and @earlephilhower.
• Document picodvi differences between RP2040 and RP2350. #9740. Thanks @tannewt.
• Fix assignment to wifi.radio.dns. #9727. Thanks @jepler.

SAMx

SiLabs

Spresense

STM

Individual boards

Documentation changes

• Correct documentation of wifi.Network.authmode. #9725. Thanks @bablokb.
• Improve keypad.ShiftRegisterKeys documentation. #9717. Thanks @aseanwatson.

Build and infrastructure changes

• Update to use macos-12 and ubuntu-24.04 for CI runs. #9720. Thanks @dhalbert.
• Support frozen modules that use a src/ directory. #9673. Thanks @bablokb.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @Atalanttore (German)
  • @hexthat (Chinese - Pinyin)
  • @Sokromatrix (German)
  • @wtuemura (Portugese - Brazil)

New boards since 9.2.0-beta.1

• cezerio dev ESP32C6. #9724. Thanks @cezer-io.
• Solder Party ESP32-Pr Stamp XL. #9715. Thanks @solderparty (@arturo182).

Known issues

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

This is CircuitPython 9.2.0-beta.1, a beta release for 9.2.0. It has known bugs that wil be fixed before the final release of 9.2.0.

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

• New busio.I2C.probe() and bitbangio.I2C.probe() methods to check for a single device address.
• Use new ESP-IDF I2C driver.
• ESP32-S3: implement sdioio.
• Incompatible change: Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif. Previous board-specific names were not applied consistently. Use wifi.radio.hostname to set a custom hostname.
• Incompatible change: Use default hostname for mDNS. Fix mDNS collision mangling.

Notable changes in 9.2.0 from 9.1.x

• Raspberry Pi RP2350 support.
• Update to Espressif ESP-IDF V5.3.1, including new I2C driver.
• Merge MicroPython updates from v1.22.2 and v1.23.
• Espressif BLE improvements.
• Add math.dist().
• _eve updates.
• New busio.I2C.probe() and bitbangio.I2C.probe() methods to check for a single device address.
• ESP32-S3: implement sdioio.
• Incompatible change: Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif.
• Incompatible change: Use default hostname for mDNS. Fix mDNS collision mangling.

Incompatibility warnings

• Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif. Previous board-specific names were not applied consistently. Use wifi.radio.hostname to set a custom hostname.
• Use default hostname for mDNS. Fix mDNS collision mangling. DNS hostnames will be different.

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 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-beta.0

Fixes and enhancements

• Incompatible change: Use default hostname for mDNS. Fix mDNS collision mangling. #9699. Thanks @tannewt.
• Fix epaperdisplay to handle delays properly when two_byte_sequence_length=True. #9694. Thanks @Sola85.
• Fix crash when printing DeepSleepRequest exception, used internally by alarm. #9692. Thanks @jepler.
• Fix internal check for connected BLE workflow, which was preventing deep sleep on some BLE boards. #9679. Thanks @dhalbert.
• New busio.I2C.probe() and bitbangio.I2C.probe() methods to check for a single device address. #9671. Thanks @dhalbert.
• Add slight delay in KeyMatrix scanning to allow time for signal setting. #9665. Thanks @SeanCline.
• Update to tinyusb v0.17.0. #9664. Thanks @samblenny.
• Fix MP3Decoder infinite loop when file ends in a partial frame. #9653. Thanks @eric321.

Port and board-specific changes

Broadcom

Espressif

• Save space when copying default hostname. #9677. Thanks @RetiredWizard.
• Fix BLE Characteristic deinit checking. #9676. Thanks @dhalbert.
• Switch to using new ESP-IDF I2C driver. #9671. Thanks @tannewt and @dhalbert.
• Incompatible change: Change default hostname for all Espressif boards to the ESP-IDF default, which is espressif. #9656. Thanks @RetiredWizard.
• ESP32-S3: implement sdioio. #9641. Thanks @jacobcrigby and @RetiredWizard.
• Remove ESP_CONSOLE_UART settings for ESP32-S3 666 display boards. #9583. Thanks @RetiredWizard.

i.MX

nordic

renode

RP2

• Move RP2040 divider wrapper to RAM. #9698. Thanks @tannewt.
• Fix os.uname() values for RP2350. #9683. Thanks @dhalbert.
• Fix rotaryio on RP2350. #9682. Thanks @jepler.
• Clear any pending interrupt flag in rp2pio. #9680. Thanks @jepler.

SAMx

SiLabs

Spresense

STM

Individual boards

• Adafruit Feather RP2350: Add board.IO4 and board.IO7. #9668. Thanks @tannewt.
• Datanoise PicoADK V2. #9696. Thanks @DatanoiseTV.
• Makerfabs TFT7: Allow specifying CIRCUITPY_DISPLAY_WIDTH in settings.toml. #9654, #9634. Thanks @RetiredWizard.
• Sunton ESP32 2432S028: Allow specifying CIRCUITPY_DISPLAY_ROTATION in settings.toml. #9654, #9627. Thanks @RetiredWizard.

Documentation changes

• Fix floppyio documentation formatting. #9658. Thanks @jepler.
• Correct memorymap.AddressRange example. #9639. Thanks @jepler.

Build and infrastructure changes

• Use MP_PROPERTY_GETTER, etc. everywhere. #9684. Thanks @diamant3.
• Keep PYTHONPATH setting when running tests. #9655. Thanks @jepler.

Translation additions and improvements

• Thanks for translations:
  • @andibing (English - UK)
  • @diamant3 (Filipino)
  • Kamborio (weblate user) (Spanish)
  • @wtuemura (Portugese - Brazil)

New boards since 9.2.0-beta.0

• Espressif ESP32-S# LCD EV Board v1.5. #9608. Thanks @sanhu88.
• Makerdiary iMX RT1011 Nano Kit. #9645. Thanks @makerdiary.
• Maker Go C6 SuperMini. #9687. Thanks @bill88t.
• Sunton ESP32 8048S050 [ESP32-S3]. #9661. Thanks @sanhu88.

Known issues

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

This is CircuitPython 9.2.0-beta.0, a beta release for 9.2.0. It has known bugs that wil be fixed before the final release of 9.2.0.

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

• On nRF boards, fix programmatic resetting directly into bootloader.
• Fix BLE storage leak.
• Clear input after ctrl-C on UART REPL boards. This fixes some USB workflow issues.
• Update to Espressif ESP-IDF V5.3.1.
• Merge MicroPython updates from v1.23.
• Raspberry Pi RP2350 additions, fixes, and documentation.
• Espressif BLE improvements.
• Add math.dist().
• _eve updates.

Notable changes in 9.2.0 from 9.1.x

• Raspberry Pi RP2350 support.
• Update to Espressif ESP-IDF V5.3.1.
• Merge MicroPython updates from v1.22.2 and v1.23.
• Espressif BLE improvements.
• Add math.dist().
• _eve updates.

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 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-alpha.2351

Fixes and enhancements

• Web workflow: warn when trying to leave page while an upload is in progress. #9625. Thanks @FoamyGuy.
• Fix gc_alloc_possible(). #9619, #9616. Thanks @tannewt.
• Clear serial input buffer when a ctrl-C is received in UART REPL. #9619, #9616. Thanks @tannewt.
• Merge MicroPython v1.23 into CircuitPython. #9638, #9611. Thanks @dhalbert.
• Extend _eve hardware opcodes for future compatibility. #9604. Thanks @jamesbowman.
• Fix reported type name for stdio objects. #9598, #9556. Thanks @timdechant.
• _eve: allow passing a single float to BitMapTransform*() methods. #9592. Thanks @jamesbowman.
• _eve: use ulab.numpy float vectors in Vertex2f(). #9589. Thanks @jamesbowman.
• Avoid crashing when display components are deinitialized. #9568. Thanks @jepler.
• Add math.dist(). #9560. Thanks @FoamyGuy.

Port and board-specific changes

Broadcom

Espressif

• Free _bleio.Characteristic memory properly. #9619, #9616. Thanks @tannewt.
• Update to ESP-IDF v5.3.1. #9607. Thanks @tannewt.
• More support for BLE descriptors. #9597. Thanks @tannewt.
• Fix resume from sleep. #9590. Thanks @tannewt.
• ESP32-C6: fix UART creation. #9580, #9579. Thanks @hdalbert.
• Fix board-specific pin initialization. #9580, #9553. Thanks @dhalbert.
• Validate analogbufio.BufferedIn sample rate. #9563. Thanks @jepler.

i.MX

nordic

• Fix resetting into UF2 bootloader even when the SoftDevice is not active. #9619, #9618. Thanks @tannewt.

renode

RP2

• Add picodvi 320x240 8-bit color support on RP2530. #9636. Thanks @tannewt.
• Document RP2350 A2 limitations due to RP2350-E9 erratum. #9633. Thanks @dhalbert.
• Enable proper RP2350 modules, including picodvi. #9617. Thanks @tannewt.
• Support RP2350 PIO features. #9610. Thanks @jepler.
• Add XOSC startup delay for RP2350 boards. #9600. Thanks @tannewt.
• rp2pio.StateMachine: add .offset and pc properties. #9594. Thanks @jepler.
• Update PIO USB submodule. #9571. Thanks @tannewt.

SAMx

SiLabs

Spresense

STM

Individual boards

• Adafruit Qualia ESP32-S3 RGB666: restore 120 MHz clock speed to fix display tearing. #9564. Thanks @tannewt.
• BDMicro VINA-D21 removed. #9637. Thanks @dhalbert.
• LILYGO T-Watch-S3: initialize AXP2101. #9582. Thanks @bill88t.
• M5Stack Cardputer: expose board.KEYBOARD; allow custom key-event handling. #9529. Thanks @konstantint.
• VIDI X V1.1: include board revision in name. #9613. Thanks @lorojakic.

Documentation changes

• Fix typo in top-level README. #9635. Thanks @mpaw.
• Improve Contributing.md and ports/espressif/README.rst with better links to Learn Guides. #9554. Thanks @samblenny.
• Improve type annotations in _bleio. #9548. Thanks @elpekenin.

Build and infrastructure changes

• Unpin autoapi version. #9591. Thanks @tannewt.
• Fix ReadTheDocs build. #9580, #9578. Thanks @tannewt.
• Upload ..x pull request merge builds to AWS S3. #9580, #9557. Thanks @dhalbert.
• Remove the debug printf adapter #9572. Thanks @jepler.

Translation additions and improvements

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

New boards since 9.2.0-alpha.2351

• CircuitART Zero S3. #9593. Thanks @CircuitART.
• Espressif ESP32-P4-Function-EV. #9612. Thanks @tannewt.
• Fablab Barcelona Barduino. #9603. Thanks @JosepMartiElias.
• iLabs Challenger+ RP2350 BConnect. #9562. Thanks @PontusO.
• iLabs Challenger+ RP2350 WiFi/BLE5. #9562. Thanks @PontusO.
• Pimoroni Tiny FX. #9575. Thanks @bablokb.
• Seeed XIAO ESP32S3. #9530. Thanks @djairjr.
• Seeed XIAO RP2350. #9532. Thanks @tannewt.
• Weekin/Debroglie WK-50 Trackball Keyboard. #9585. Thanks @Glodigit.

Known issues

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

This is CircuitPython 9.1.4, the latest bugfix release 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

• On nRF boards, fix programmatic resetting directly into bootloader.
• Fix BLE storage leak.
• Clear input after ctrl-C on UART REPL boards. This fixes some USB workflow issues.

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 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
• 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
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.1.3

Fixes and enhancements

• Fix gc_alloc_possible(). #9616. Thanks @tannewt.
• Clear serial input buffer when a ctrl-C is received in UART REPL. #9616. Thanks @tannewt.

Port and board-specific changes

Broadcom

Espressif

• Free _bleio.Characteristic memory properly. #9616. Thanks @tannewt.

i.MX

nordic

• Fix resetting into UF2 bootloader even when the SoftDevice is not active. #9618. Thanks @tannewt.

renode

RP2040

SAMx

SiLabs

Spresense

STM

Individual boards

Documentation changes

Build and infrastructure changes

Translation additions and improvements

New boards since 9.1.3

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.1.x
  • 9.2.0
  • 9.x.x
  • 10.0.0
  • long term

Thanks

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

CircuitPython 9.1.3

This is CircuitPython 9.1.3, the latest bugfix release 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 Espressif ESP32-C6 UART creation.
• Adafruit Qualia ESP32-S3 RGB666: fix display tearing.
• Pull request merge builds for stable branches, not just the main branch, are now uploaded to AWS S3.
• Fix Espressif board-specific pin initialization. This fixes board.NEOPIXEL_I2C_POWER initialization on the Adafruit Feather C6.

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 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
• 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
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.1.2

Fixes and enhancements

Port and board-specific changes

Broadcom

Espressif

• ESP32-C6: fix UART creation. #9579. Thanks @hdalbert.
• Fix board-specific pin initialization. #9553. Thanks @dhalbert.

i.MX

nordic

renode

RP2040

SAMx

SiLabs

Spresense

STM

Individual boards

Adafruit Qualia ESP32-S3 RGB666: restore 120 MHz clock speed to fix display tearing. #9566, #9564. Thanks @tannewt.

Documentation changes

• Fix ReadTheDocs build. #9578. Thanks @tannewt.

Build and infrastructure changes

• Upload *.*.x pull request merge builds to AWS S3. #9557. Thanks @dhalbert.
• Fix Python package installation on Windows build. #9549. Thanks @dhalbert.

Translation additions and improvements

New boards since 9.1.2

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.1.x
  • 9.2.0
  • 9.x.x
  • 10.0.0
  • long term

Thanks

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

CircuitPython 9.2.0-alpha.2351

This is CircuitPython 9.2.0-alpha.2351, an alpha release for 9.2.0. It has significant known bugs, and will have further additions and fixes before the final release of 9.2.0.

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 Adafruit FunHouse build, which was not working.
• Correct pins for Adafruit Feather ESP32-C6.
• Prevent crash or hang on nRF boards when stopping VM and BLE is not running.
• Many new RP2350 boards.
• Update to Espressif ESP-IDF V5.3.
• Merge MicroPython updates from v1.22.2.

Notable changes in 9.2.0 from 9.1.x

• Raspberry Pi RP2350 support.
• Update to Espressif ESP-IDF V5.3.
• Merge MicroPython updates from v1.22.2.

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

Fixes and enhancements

• Correct printing of stdio type name. #9544. Thanks @timdechant.
• aurora_epaper display support. #9488. Thanks @wyrdsec.
• Merge from MicroPython v1.22.2 release. #9469. Thanks @dhalbert.

Port and board-specific changes

Broadcom

Espressif

• Update to ESP-IDF v5.3. #9526. Thanks @tannewt.
• Fix Espressif startup. #9512. Thanks @tannewt.

i.MX

nordic

• Reduce sleep power consumption by PinAlarm. #9534. Thanks @Sola85.
• Prevent crash or hang on VM shutdown when BLE not running. #9453. Thanks @dhalbert.

renode

RP2

• Use pico-sdk-style interrupt names. #9520. Thanks @tannewt.
• Enable PIO USB Host on RP2350. #9514. Thanks @tannewt.
• Enable rgbmatrix on RP2350. #9513. Thanks @tannewt.
• Add support for additional UART pins on RP2350 (UART_AUX capability). #9500. Thanks @tannewt.

SAMx

SiLabs

Spresense

STM

Individual boards

• Adafruit Feather ESP32-C6 pin corrections. #9525, #9475. Thanks @dhalbert.
• Adafruit FunHouse: fix hang when starting WiFi. #9546, #9545. Thanks @tannewt.
• Pimoroni Tiny 2040: Add board.BUTTON. #9531. Thanks @tannewt and @ZodiusInfuser.

Documentation changes

• Fix _bleio signatures. #9540 .Thanks @elpekenin.
• Fix ReadTheDocs build. #9466. Thanks @jepler.

Build and infrastructure changes

• Remove unused error messages and consolidate others. #9516. Thanks @tannewt.
• Switch back to upstream TinyUSB submodule. #9499. Thanks @tannewt.

Translation additions and improvements

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

New boards since 9.2.0-alpha.2350

• Adafruit Vindie S2. #9518. Thanks @BlitzCityDIY.
• Cytron IRIV IO Controller. #9509, #9497. Thanks @CytronTechnologies.
• Espressif ESP32-S3-DevKitC-1-N16. This version has no PSRAM. #9512. Thanks @tannewt.
• LILYGO T-Watch-S3. #9480. Thanks @bill88t.
• Pimoroni Pico Plus 2. #9531. Thanks @tannewt and @ZodiusInfuser.
• Pimoroni PGA2350. #9531. Thanks @tannewt and @ZodiusInfuser.
• Pimoroni Plasma 2350. #9531. Thanks @tannewt and @ZodiusInfuser.
• Pimoroni Tiny RP2350. #9531. Thanks @tannewt and @ZodiusInfuser.
• SparkFun Pro Micro 2350. #9515. Thanks @tannewt.
• Unexpected Maker OMGS3. #9522. Thanks @UnexpectedMaker.
• Unexpected Maker TGB Touch Mini. #9522. Thanks @UnexpectedMaker.

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.1.x
  • 9.2.0
  • 9.x.x
  • 10.0.0
  • long term

Thanks

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

CircuitPython 9.1.2

This is CircuitPython 9.1.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

• Fix Adafruit FunHouse build, which was not working.
• Correct pins for Adafruit Feather ESP32-C6.
• Allow wider range of counts for Counter, FrequencyIn, and IncrementalEncoder.
• Prevent crash or hang on nRF boards when stopping VM and BLE is not running.

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 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
• 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
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.1.1

Fixes and enhancements

• Warn on use of non-standard sys.format_exception(). #9451, #9450. Thanks @jepler.

Port and board-specific changes

Broadcom

Espressif

• Allow wider range of counts for Counter, FrequencyIn, and IncrementalEncoder, using PCNT overflow accumulator. #9461. Thanks @vickash.

i.MX

nordic

• Prevent crash or hang on VM shutdown when BLE not running. #9453. Thanks @dhalbert.

renode

RP2040

SAMx

SiLabs

Spresense

STM

Individual boards

• Adafruit Feather ESP32-C6: pin corrections. #9475. Thanks @dhalbert.
• Adafruit FunHouse: fix hang when starting WiFi. #9545. Thanks @tannewt.
• Bradán Lane STUDIO Explorer: support SSD1681 display. #9456. Thanks @bradanlane.

Documentation changes

• Fix ReadTheDocs build. #9466. Thanks @jepler.

Build and infrastructure changes

Translation additions and improvements

New boards since 9.1.0

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.1.x
  • 9.2.0
  • 9.x.x
  • 10.0.0
  • long term

Thanks

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

9.2.0-alpha.2350

This is CircuitPython 9.2.0-alpha.2350, the first unstable release of 9.2.0. It likely contains bugs. It features support for the new Raspberry Pi microcontroller called the RP2350.

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.

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 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
• 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
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• raspberrypi: Raspberry Pi RP2350
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.1.1

Fixes and enhancements

• Add double buffering to RawSample by @timchinowsky in #9421
• 9.1.x: Warn on use of nonstandard sys.format_exception by @dhalbert in #9457
• displayio.Bitmap is now byte-aligned for depth < 8 by @deshipu in #9479

Port and board-specific changes

Broadcom

Espressif

• Add IPv6 support for Espressif by @jepler in #9436
• espressif: enable PCNT accumulator for Counter, FrequencyIn, Incremental Encoder by @vickash in #9461
• Add wifi.radio.listen_interval to ESP32-family chips. by @EternityForest in #9476

i.MX

Nordic

• bleio_user_reset(): check if BLE running before doing any BLE ops by @dhalbert in #9453

Renode

Raspberry Pi

• Add support for the new RP2350 by @tannewt in #9490
• Add looping to rp2040 analogbufio.BufferedIn by @timchinowsky in #9438

SAMx

SiLabs

Spresense

STM

Individual boards

• Extend board driver support for SSD1681 by @bradanlane in #9456

Documentation changes

• Update Standard Library sys documentation by @RetiredWizard in #9427
• Only use pyi files for autoapi doc generation by @jepler in #9466
• Mailmap by @rpavlik in #9462

Translation additions and improvements

New boards since 9.1.1

• VIDI X board by @lovrojakic in #8798
• Waveshare RP2040 One by @johnnohj in #9484
• Adafruit Feather RP2350 by @tannewt
• Adafruit Metro RP2350 by @tannewt
• Cytron Motion 2350 Pro by @SalamCytron
• Raspberry Pi Pico 2 by @tannewt
• Solder Party RP2350 Stamp by @arturo182
• Solder Party RP2350 Stamp XL by @arturo182

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.2.0
  • 9.1.x
  • 9.x.x
  • long term

Thanks

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

CircuitPython 9.1.1

This is CircuitPython 9.1.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.

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 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
• 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
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• renode: hardware simulator
• silabs: Silicon Labs MG24 family
• stm: ST non-STM32F4 chip families

Changes since 9.1.0

Fixes and enhancements

Port and board-specific changes

Broadcom

Espressif

i.MX

nordic

• Fix BLE MTU negotiation. #9441. Thanks @dhalbert.

renode

RP2040

• Check that all busio.UART pins are valid before claiming any. #9425. Thanks @jepler.

SAMx

• SAMD51: fix PWMOut by reverting #9343: symptoms included no backlight on boards with displays. #9447. Thanks @dhalbert.

SiLabs

Spresense

STM

Individual boards

Documentation changes

Build and infrastructure changes

• Exclude circuitpython-stubs when building documentation. #9431. Thanks @jepler.

Translation additions and improvements

New boards since 9.1.0

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 9.1.x
  • 9.x.x
  • long term

Thanks

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