CircuitPython 8.0.0 Beta 3

This is CircuitPython 8.0.0-beta.3, a beta release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.

NOTE: ESP32-C3 board builds are not functional since 8.0.0-beta.2. Use 8.0.0-beta.1.

WARNING: The flash partitioning for 2MB and 4MB flash ESP32 and ESP32-C3 boards has changed since 8.0.0-beta.2. When you load 8.0.0-beta.3 or later over beta.2 (or vice versa), on these boards, CIRCUITPY will be erased and reformatted.

WARNING: The flash partitioning for the Raspberry Pi Pico W has changed since 8.0.0-beta.1. When you load 8.0.0-beta.2 or later over beta.1 (or vice versa), on the Pico W, CIRCUITPY will be erased and reformatted.

Notable changes to 8.0.0 since 7.3.0

Functionality additions

• Added WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection (available only on Espressif for now).
• Added a one-line status bar, which displays connection status, last exception, and version on a terminal window title or on the top line of an attached display. Support for status bar display is also being added to the Mu and Thonny editors.
• .env file in CIRCUITPY specifies WiFI connection parameters, BLE name, and other startup values.
• dotenv support: os.getenv() values are set by values in .env file. Values can be fetched from other dotenv-format files.
• WiFi functionality implemented on the Pi Pico W.
• Revised Espressif camera support, now available on ESP32, ESP32-S2, and ESP32-S3.
• Bulk analog input: analogbufio (available only on RP2040 for now).
• Pin state can be preserved during deep sleep (available only on Espressif for now).
• Allow setting USB VID, PID, manufacturer, and product ids at runtime.
• Enabled collections.deque on most builds.
• MP3Decoder and WaveFile can now take a filename instead of an open file.
• AnalogIn values are full range from 0 to 65535, instead of having zeros on low-order bits.
• In-place firmware update (dualbank) capability may be disabled in favor of a larger CIRCUITPY drive.
• Added TileGrid.contains().
• Added os.utime().
• Added coproc module, for running programs on an on-chip co-processor. Currently available for the RISC-V core on the ESP32-S2 and ESP32-S3.

Compatibility changes

• PulseOut no longer accepts a PWMOut. Use a Pin instead.
• Auto-brightness support in displayio and framebufferio has been removed. It was never implemented completely.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• Print out whole-number floats exactly and correctly.
• Restored rainbowio and onewireio to a number of boards. Some boards still have rainbowio turned off for space reasons.
• i2ctarget.I2CTarget is the new name for i2cperipheral.I2CPeripheral. Accept both for now. I2CPeripheral will be removed in 9.0.0.
• The property supervisor.runtime.ble_workflow replaces supervisor.disable_ble_workflow().
• The property supervisor.runtime.next_stack_limit replaces supervisor.set_next_stack_limit().
• The property supervisor.runtime.rgb_status_brightness replaces supervisor.set_rgb_status_brightness().

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32, ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 8.0.0-beta.2

Fixes and enhancements

• Improve asyncio implementation and add automated tests. #7059. Thanks @jepler.
• Add coproc module, for running programs on an on-chip co-processor. Currently avaialable for the RISC-V core on the ESP32-S2 and ESP32-S3. #6902. Thanks @microdev1.

Port and board-specific changes

Broadcom

Espressif

• Fix partioning on ESP32 and ESP32-C3 boards with 2MB and 4MB flash. #7073. Thanks @microdev1.
• Improve dualbank error messages. #7061. Thanks @microdev1.
• Fix ESP-IDF logging level. #7052. Thanks @microdev1.

i.MX

nRF

RP2040

SAMx

STM

Individual boards

• Cytron Maker Feather AIoT S3: add pin definitions. #7053. Thanks @CytronTechnologies.
• Raspberry Pi Pico W:
  • Fix pin counting issues affecting PulseIn and other functionality. #7089. Thanks @jepler.
  • Implement static IP configuration. #7088. Thanks @jepler.
  • Fix large send() requests. Add sendall(). Resolve .local names. Allow stopping radio. #7079. Thanks @jepler.
  • Connect to wifi asynchronously. #7076. Thanks @bill88t.
  • Fix check for wifi interface being up. #7075. Thanks @jepler.
  • Fix CYW43 pin initialization. #7064. Thanks @jepler.
  • Power down CYW43 wifi co-processor during deep sleep. #7050. Thanks @jepler.
  • Implement hashlib. #7051. Thanks @jepler.

Documentation changes

• Remove hashlib and zlib from MicroPython-specific modules. #7074. Thanks @jepler.

Build and infrastructure changes

• Use py/stream.h instead of py/ioctl.h. #7058. Thanks @jepler.
• Improve calculation of partial builds. #7057. Thanks @jepler.
• Save about 124 bytes, related to string0.c. #6397. Thanks @jepler.

Translation additions and improvements

Thanks for translations:

• @Atalanttore (German)
• @bergdahl (Swedish)
• @wtuemura (Portugese - Brazil)

New boards since 8.0.0-beta.2

Known issues

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

Thanks

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

CircuitPython 8.0.0 Beta 2

This is CircuitPython 8.0.0-beta.2, a beta release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.

NOTE: ESP32-C3 board builds are not functional in this release. Use 8.0.0-beta.1.

NOTE: Some ESP32 board builds are not functional in this release. Use 8.0.0-beta.3.

Warning: The flash partitioning for the Raspberry Pi Pico W has changed since 8.0.0-beta.1. When you load 8.0.0-beta.2 over beta.1 (or vice versa), on the Pico W only, CIRCUITPY will be erased and reformatted.

Notable changes to 8.0.0 since 7.3.0

Functionality additions

• Added WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection (available only on Espressif for now).
• Added a one-line status bar, which displays connection status, last exception, and version on a terminal window title or on the top line of an attached display. Support for status bar display is also being added to the Mu and Thonny editors.
• .env file in CIRCUITPY specifies WiFI connection parameters, BLE name, and other startup values.
• dotenv support: os.getenv() values are set by values in .env file. Values can be fetched from other dotenv-format files.
• WiFi functionality implemented on the Pi Pico W.
• Revised Espressif camera support, now available on ESP32, ESP32-S2, and ESP32-S3.
• Bulk analog input: analogbufio (available only on RP2040 for now).
• Pin state can be preserved during deep sleep (available only on Espressif for now).
• Allow setting USB VID, PID, manufacturer, and product ids at runtime.
• Enabled collections.deque on most builds.
• MP3Decoder and WaveFile can now take a filename instead of an open file.
• AnalogIn values are full range from 0 to 65535, instead of having zeros on low-order bits.
• In-place firmware update (dualbank) capability may be disabled in favor of a larger CIRCUITPY drive.
• Added TileGrid.contains().
• Added os.utime().

Compatibility changes

• PulseOut no longer accepts a PWMOut. Use a Pin instead.
• Auto-brightness support in displayio and framebufferio has been removed. It was never implemented completely.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• Print out whole-number floats exactly and correctly.
• Restored rainbowio and onewireio to a number of boards. Some boards still have rainbowio turned
  off for space reasons.
• i2ctarget.I2CTarget is the new name for i2cperipheral.I2CPeripheral. Accept both for now. I2CPeripheral will be removed in 9.0.0.
• The property supervisor.runtime.ble_workflow replaces supervisor.disable_ble_workflow().
• The property supervisor.runtime.next_stack_limit replaces supervisor.set_next_stack_limit().
• The property supervisor.runtime.rgb_status_brightness replaces supervisor.set_rgb_status_brightness().

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32, ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 8.0.0-beta.1

Fixes and enhancements

• Fix parsing long dotenv values. #7049. Thanks @jepler.
• Improve traceback functionality. #7046. Thanks @jepler.
• Delay very first serial write to allow host connection setup time; especially needed on Linux. #7041. Thanks @dhalbert.
• Restore nvm as an importable module. #7014. Thanks @jepler.
• Add Unicode support to dotenv. #7003. Thanks @jepler.
• Improve dotenv file parsing to be more like the CPython library. #7001, #6987. Thanks @dhalbert.
• Allow choosing between dualbank capability (in-place firmware update) and a larger CIRCUITPY drive. #7000. Thanks @microdev1.
• Fix I2CTarget timeout check and documentation. #6985. Thanks @PaulskPt.
• Fix web workflow file-modified-time minutes value. #6982. Thanks @electronerdian.
• Replace some supervisor functions with supervisor.runtime properties. #6980. Thanks @microdev1.
• Add os.utime(). #6923. Thanks @isacben.
• Do not allow renaming a directory inside itself. #6883. Thanks @makermelissa.

Port and board-specific changes

Broadcom

Espressif

• Update ESP-IDF to latest release/v4.4 commit to fix WiFi scanning and other issues. #7023. Thanks @dhalbert.
• Clean up mpconfigboard.mk on multiple boards. #7008. Thanks @microdev1.

i.MX

nRF

RP2040

• Fix socket errno return value. #7048. Thanks @georgboe.
• SSL support and additional fixes. #7043, #6999. Thanks @jepler.
• Fix cyw43.CywPin. #7019. Thanks @Neradoc.
• Disable cyw43 power-saving mode by default to improve WiFi reliability. #6976. Thanks @jepler.

SAMx

• Improve code size for microcontroller.cpu.temperature, with some loss of accuracy. Extra reductions on very small builds. #7045. Thanks @jepler.

STM

• Remove redundant header files in build (no change in code). #7024. Thanks @flom84.

Individual boards

• AITHinker ESP32-C3S_Kit: fix creation id. #6986. Thanks @dhalbert.
• AITHinker ESP32-C3S_Kit_2M: fix creation id. #6986. Thanks @dhalbert.
• Raspberry Pi Pico W: fix pin definitions. #7021. Thanks @jepler.
• Raspberry Pi Pico W: increase size of CIRCUITPY. #7011. Thanks @jepler.

Documentation changes

• Fixed README.rst formatting. #7022. Thanks @tekktrik.
• Add _asyncio, array, builtins, collections, io, select, and sys to the Module Support Matrix. #6995. Thanks @dhalbert.
• Add ESP32 to README.rst. #6974. Thanks @microdev1.

Build and infrastructure changes

• Update how to set build outputs. #7044. Thanks @jepler.
• Update to newer CI actions. #7035. Thanks @microdev1.
• Shrink builds by about 112 bytes. #7026. Thanks @dhalbert.
• Remove multiterminal, which is obsolete and was not used anywhere. #7016. Thanks @jepler.
• Refactor dotenv to allow testing on host. #6991. Thanks @jepler.
• Remove redundant .gitignore files. #6974. Thanks @microdev1.
• Save about 124 bytes in gc.c and string0.c. #6397. Thanks @jepler.

Translation additions and improvements

Thanks for translations:

• @bill88t (Greek)
• @boranroni (Turkish)

New boards since 8.0.0-beta.1

• BananaPi BPI-PicoW-S3. #7031. Thanks @BPI-STEAM.
• Espressif ESP32-S2-DevKitC-1-N8R2. #6989. Thanks @kylefmohr.
• VCC-GND Studio YD RP2040. #7039, #6410. Thanks @fabaff, @evildave66, @DerBroader71, and @dhalbert.

Known issues

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

Thanks

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

CircuitPython 8.0.0 Beta 1

This is CircuitPython 8.0.0-beta.1, a beta release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.

Notable changes to 8.0.0 since 7.3.0

• Added WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection.
• Added a one-line status bar, which displays connection status, last exception, and version on a terminal window title or on the top line of an attached display. Support for status bar display is also being added to the Mu and Thonny editors.
• .env file in CIRCUITPY specifies WiFI connection parameters, BLE name, and other startup values.
• dotenv support: os.getenv() values can be set in the .env file.
• Preliminary implementation of WiFi on the Pi Pico W.
• Revised Espressif camera support, now available on ESP32, ESP32-S2, and ESP32-S3.
• Bulk analog input: analogbufio (available only on RP2040 for now).
• Pin state can be preserved during deep sleep (available only on Espressif for now).
• Allow setting USB VID, PID, manufacturer, and product ids at runtime.
• AnalogIn values are full range from 0 to 65535, instead of having zeros on low-order bits.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• MP3Decoder and WaveFile can now take a filename instead of an open file.
• PulseOut no longer accepts a PWMOut. Use a Pin instead.
• Added TileGrid.contains().
• i2ctarget.I2CTarget is the new name for i2cperipheral.I2CPeripheral. Accept both for now. I2CPeripheral will be removed in 9.0.0.
• Auto-brightness support in displayio and framebufferio has been removed. It was never implemented completely.
• Restored rainbowio and onewireio to a number of boards.
• Print out whole-number floats exactly and correctly.
• Enabled collections.deque on most builds.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32, ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 8.0.0-beta.0

Fixes and enhancements

• Update frozen libraries #6971. Thanks @dhalbert.
• Simplify status bar code, and make partial writes less likely. #6952. Thanks @dhalbert.
• Support opening a file by name in MP3Decoder and WaveFile. #6943, #6931. Thanks @snkYmkrct.
• Update ulab to 5.1.1. #6939. Thanks @jepler.
• Clean up implementation and internal use of ringbuf. #6915. Thanks @dhalbert.
• Fix slowdown on devices with dimmable displays. #6894. Thanks @gamblor21.
• Improve web workflow directory page. #6885. Thanks @microdev1.
• Allow writing empty color frame in EpaperDisplay. #6871. Thanks @pepijndevos.
• Allow status bar to be enabled and disabled. #6847. Thanks @dhalbert.
• Make PulseIn objects be long-lived so they won't be moved. #6834. Thanks @DavePutz.
• Improve usb_hid.Device.get_last_received_report(). #6818, #6810, #6767. Thanks @maximkulkin.
• Allow move and rename to be used from localhost in web workflow. #6807. Thanks @makermelissa.
• Remove deprecated usb_hid.Device.last_received_report, replaced by get_last_received_report(). #6802. Thanks @dhalbert.
• Fix hashlib.Hash.digest_size. #6797. Thanks @jepler.
• Make rotaryio objects be long-lived so they won't be moved. #6789. Thanks @DavePutz.
• Add UID to web workflow version.json. #6787. Thanks @Neradoc.
• Fix is31fl3741 display issues. #6784. Thanks @gamblor21.
• Fix display scroll area issues when scale > 1. #6783. Thanks @tannewt.
• Allow setting USB VID, PID, manufacturer, and product ids at runtime. #6247. Thanks @s-ol.

Port and board-specific changes

Broadcom

• Enable console UART by default. #6887. Thanks @RetiredWizard.

Espressif

• Manage I2C device locking for esp32_camera. #6940. Thanks @jepler.
• Pin state can be preserved during deep sleep. #6907. Thanks @dhalbert.
• Fix PWM reset issues. #6898. Thanks @dhalbert.
• Correct available run modes on different chips. #6886. Thanks @microdev1.
• Improve esp32_camera error checking. #6794. Thanks @jepler.

i.MX

nRF

• UART.read() now returns None when nothing read, consistent with other ports. #6908. Thanks @dhalbert.
• Handle zero-length PulseOut pulses properly. #6798. Thanks @DavePutz.

RP2040

• Preliminary implementation of WiFi on the Pi Pico W. #6976, #6960, #6933. Thanks @jepler.
• Bulk analog input: analogbufio. #6911, #6757. Thanks @latkinso42.
• Fix rp2pio issue when no OUT pins used. #6863. Thanks @jepler.
• Update pico-sdk to 1.4.0. #6822. Thanks @jepler.
• Improve compilation error checking. #6973. Thanks @jepler.

SAMx

STM

• Can now enter DFU bootloader mode programmatically. #6961, #6919. Thanks @flom84.

Individual boards

• Adafruit ESP32-S2 TFT: remove now-unneeded pin reset workaround. #6909. Thanks @dhalbert.
• Adafruit Grand Central M4: update preferred pin names to match silkscreen. #6953. Thanks @kattni.
• Adafruit MatrixPortal: disable ulab to make room for frozen modules. #6779. Thanks @dhalbert.
• AIThinker ESP32-C3S-2M: use unique creation ids. #6937. Thanks @jepler.
• Cytron Maker Feather AIoT S3: most pins now enable pulldown when reset. #6895. Thanks @CytronTechnologies.
• Cytron Maker Feather AIoT S3: change pin assignments due to redesign. #6881. Thanks @CytronTechnologies.
• MicroDev microC3: update board definition. #6888. Thanks @microdev1.
• PewPew: remove alias to non-existent PewPew13 board. #6842. Thanks @Neradoc.
• PewPew ugame10: Update ugame.py and fix build typo. #6823. Thanks @pypewpew (@deshipu).
• Smart Bee Designs Bee-Motion-S3: fix pin name. #6917. Thanks @strid3r21.
• Unexpected Maker FeatherS3: fix pin names. #6873. Thanks @UnexpectedMaker (@UnexpectedCircuitPython).
• Unexpected Maker ProS3: fix pin names. #6873. Thanks @UnexpectedMaker (@UnexpectedCircuitPython).
• Waveshare Electronics ESP32-S2-Pico: pin fixes. #6864. Thansk @bill88t.

Documentation changes

• Run black over all inline documentation to make its formatting consistent. #6972, #6951, #6950. Thanks @jepler.
• Temporary fixes to work around documentation building issues. #6946, #6944. Thanks @jepler.
• Correct documentation for usb_cdc.Serial.readinto(). #6944. Thanks @jepler.
• Correct documentation for UART.read(). #6908. Thanks @dhalbert.
• Fix some type annotations. #6905. Thanks @hardfury-labs.
• Add more links to external documentation. #6900. Thanks @tekktrik.
• Add documentation for socketpool.SocketPool(). #6855. Thanks @tekktrik.
• Add web workflow documentation and links. #6854. Thanks @makermelissa.
• Fix UART documentation. #6846. Thanks @tekktrik.
• Improve os.stat documentation. #6841. Thanks @thetazero.
• Copyediting in Design Guide. #6833. Thanks @rshah713.
• Update license files. #6826. Thanks @microdev1.
• Fix type annotation for adafruit_bus_device.SPIDevice(). #6814. Thanks @microdev1.
• Add ESP32 to Espressif port status in README. #6974. Thanks @microdev1.

Build and infrastructure changes

• Clean up of port/*/.gitignore. #6974. Thanks @microdev1 and @dhalbert.
• Make makeversionhdr more strict. #6912. Thanks @jepler.
• fontio by itself can now be enabled or disabled at compile time. #6890. Thanks @jepler.
• Provide default versions for common board.c routines. #6878. Thanks @dhalbert.
• Use Ubuntu 22.04 for pre-commit CI runs. #6875. Thanks @jepler.
• Check creatorid:creationid uniqueness. #6831. Thanks @jepler.
• Improve argument validation and consolidate error messages. #6522. Thanks @jepler.

Translation additions and improvements

Thanks for translations:

• @alvaro (Spanish)
• @bergdahl (Swedish)
• @bill88t (Greek)
• @boranroni (Turkish)
• @hexthat (Chinese - Pinyin)
• @Lisapple (French)
• @urfdvw (Chinese - Pinyin)
• @wtuemura (Portugese - Brazil)

New boards since 8.0.0-beta.0

• BananaPi BPI-Bit-S2. #6899. Thanks @BPI-STEAM.
• BananaPi BPI-Leaf-S3. #6904. Thanks @BPI-STEAM.
• Invector Labs Challenger RP2040 subGhz. #6681. Thanks @PontusO.
• Invector Labs Challenger RP2040 WiFi/BLE. #6868. Thanks @PontusO.
• STM Nucleo-F446RE. #6945. Thanks @flom84.
• Unexpected Maker TinyPICO Nano. #6918. Thanks @UnexpectedMaker.
• Unexpected Maker TinyPICO (V2/V3). #6918. Thanks @UnexpectedMaker.
• WEMOS LOLIN S3 ...

CircuitPython 7.3.3

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

Notable changes to 7.3.3 since 7.3.2

• Adafruit MatrixPortal: Turn off ulab to allow freezing adafruit_portalbase, to create more available RAM.
• Return None from usb_hid.get_last_received_report() when no report is available or the last report has already been read.
• Don't reload or enter REPL when autoreloading.
• Fix _bleio.PacketBuffer handling of fixed-length characteristics.
• Update frozen libraries.
• Build macOS mpy-cross executables with macOS 11.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.2

Fixes and enhancements

• Make PulseIn objects long-lived to prevent a bug. #6835, #6834. Thanks @DavePutz.
• Update frozen libraries. #6817. Thanks @dhalbert.
• Return None from usb_hid.get_last_received_report() when no report is available or the last report has already been read. #6818, #6810, #6808, #6717. Thanks @maximkulkin.
• Don't reload or enter REPL when auto-reloading. #6806, #6751. Thanks @tannewt.

Port and board-specific changes

nRF

• Fix _bleio.PacketBuffer handling of fixed-length characteristics. #6800. Thanks @dhalbert.

Individual boards

• Adafruit MatrixPortal: Remove ulab to allow freezing of adafruit_portalbase, to create more available RAM. #6809, #6779. Thanks @dhalbert.

Build and infrastructure changes

• Build macOS mpy-cross executables with macOS 11. #6803, #6659. Thanks @dhalbert

New boards since 7.3.2

• (none)

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 7.3.x
  • 8.0.0

Thanks

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

CircuitPython 8.0.0 Beta 0

This is CircuitPython 8.0.0-beta.0, a beta release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.

Notable changes to 8.0.0 since 7.3.0

• Added WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection.
• Added a one-line status bar, which displays connection status, last exception, and version on a terminal window title or on the top line of an attached display. Support for status bar display is also being added to the Mu and Thonny editors.
• .env file in CIRCUITPY specifies WiFI connection parameters, BLE name, and other startup values.
• Revised Espressif camera support, now available on ESP32, ESP32-S2, and ESP32-S3.
• Added TileGrid.contains().
• AnalogIn values are full range from 0 to 65535, instead of having zeros on low-order bits.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• dotenv support: os.getenv() values can be set in the .env file.
• PulseOut no longer accepts a PWMOut. Use a Pin instead.
• i2ctarget.I2CTarget is the new name for i2cperipheral.I2CPeripheral. Accept both for now. I2CPeripheral will be removed in 9.0.0.
• Auto-brightness support in displayio and framebufferio has been removed. It was never implemented completely.
• Restored rainbowio and onewireio to a number of boards.
• Print out whole-number floats exactly and correctly.
• Enabled collections.deque on most builds.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32, ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 8.0.0-alpha.1

Fixes and enhancements

• WiFi workflow. Thanks @tannewt for most of the pull requests below and thanks especially to @RetiredWizard for testing.
  • Device discovery: #6697. Thanks @tannewt.
  • General: #6778, #6662, #6651, #6638, #6608, #6591, #6503, #6528, #6473: thanks @tannewt. #6683: thanks @Neradoc. #6682: thanks @andywarburton.
  • File management, including upload, download, rename, editing: #6770, 6769, #6733, #6731, #6695, #6693: thanks @tannewt.
  • File editing: #6777, #6771, #6686: thanks @tannewt. #6680, #6611: thanks @FoamyGuy.
  • Websocket-based serial/REPL: #6729, #6666, #6584: thanks @tannewt.
• Check for UTF-8 content when reading a file into a str. #6754. Thanks @jepler.
• Correct status LED handling on many boards. #6753. Thanks @tannewt.
• Do not reload again or enter REPL during an auto-reload. #6751. Thanks @tannewt.
• Fix generic TouchIn deinit on constructor failure. #6743. Thanks @Sciss.
• Remove support for passing a PWMOut to PulseOut. #6741. Thanks @tannewt.
• Update frozen libraries. #6782, #6780, #6520, #6517, #6490: thanks @dhalbert; #6740: thanks @pypewpew (@deshipu).
• Support RGB565 in qrio. #6739. Thanks @jepler.
• Rename i2cperipheral.I2CPeripheral to i2ctarget.I2CTarget to match new official I2C nomenclature. Both are available in 8.x.x; I2CPeripheral will be removed in 9.0.0. #6738, #6722. Thanks @dhalbert.
• Remove auto_brightness support. #6734. Thanks @dhalbert.
• Remove all= keyword argument from _bleio.ScanEntry.matches(). Use match_all= instead. #6730. Thanks @tannewt.
• Restore rainbowio and onewireio to a number of boards. #6727. Thanks @dhalbert.
• Format all whole-number floats exactly. #6722 (cherry-pick from MicroPython). Thanks @dhalbert.
• Status/title bar, displaying connection status, exception information, and version. #6715, #6713, #6698, #6666, #6473. Thanks @tannewt.
• Make keypad.EventQueue event be selectable, which allows more efficient asyncio polling for events. #6712. Thanks @jepler.
• Validate cs parameter in adafruit_bus_device.SPIDevice. #6696. Thanks @gamblor21.
• Update stage frozen library to add PNG support. #6648. Thanks @pypewpew (@deshipu).
• Ctrl-L in REPL will clear screen and redraw line. #6639. Thanks @jepler.
• Specify default BLE name in .env. #6596. Thanks @Neradoc.
• Add framebufferio.FrameBufferDisplay.root_group. #6595. Thanks @Neradoc.
• Update pwpewpew-lcd frozen library. #6569. Thanks @pypewpew (@deshipu).
• Update ulab. #6567. Thanks @jepler.
• Always release displays during deep-sleep. #6543. Thanks @jepler.
• Catch most exceptions during dir(). #6539. Thanks @jepler.
• Update frozen libraries. #6782, #6780, #6520, #6517, #6490: Thanks @dhalbert; #6740: thanks @pypewpew (@deshipu).
• Validate palette_index in Palette functions. #6515. Thanks @FoamyGuy.
• Enable collections.deque on most builds. #6474. Thanks @rtyley.

Port and board-specific changes

Broadcom

Espressif

• Fix ESP32 touch; rework Espressif touch. #6772. Thanks @dhalbert.
• Fix dimly-on LEDs that should be off. #6753. Thanks @tannewt.
• Allow connection retries if connection is intermittent. #6744. Thanks @tannewt.
• Retry wifi send only if initial send at least partially succeeded. #6742. Thanks @tannewt.
• Increase main task stack size. #6725. Thanks @dhalbert.
• Add plain ESP32 support. #6719, #6694, #6571. Thanks @dhalbert, @jepler.
• Fix handling of long inputs to ESP32-C3 serial connection. #6698. Thanks @tannewt.
• Fix ESP32-S2, ESP32-S3 USB problem. #6687. Thanks @tannewt.
• Rewrite camera support using esp32-camera library. #6684. Thanks @jepler.
• Allow reserving PSRAM via espidf. #6667. Thanks @jepler.
• Fix ESP32-C3 wifi crash and REPL responsiveness. #6666. Thanks @tannewt.
• Use -Os to shrink builds. #6663. Thanks @tannewt.
• Improve USB serial connection on ESP32-C3. #6660. Thanks @tannewt.
• Fix issue with empty BLE characteristic. #6614. Thanks @litui.
• Don't fully reset wifi device: allows reconnects without hard reset. #6600. Thanks @jepler.
• Add wifi.Radio.tx_power. #6572, #6542. Thanks @todbot.
• Validate args to int.from_bytes(). #6562. Thanks @isacben.
• Go into safe mode when ESP interrupt watchdog fires. #6534. Thanks @tannewt.
• Update ESP-IDF. #6531. Thanks @tannewt.
• Use UART configuration struct internally. #6453. Thanks @KurtE.

i.MX

nRF

• Test for BLE disconnect while reading. #6495. Thanks @DavePutz.

RP2040

• I2CTarget support. #6758. Thanks @gamblor21.
• Improve PIO documentation. #6714. Thanks @dannystaple.
• Allow zero-length PIO init programs. #6637. Thanks @jepler.
• Fix interrupt handling in UART.in_waiting, allowing longer inputs. #6583. Thanks @tannewt.
• Fix validation on WAIT PIO instruction. #6550. Thanks @crackmonkey.

SAMx

• Fix I2C frequency validation. #6670. Thanks @dhalbert.
• Fix SPI DMA race problem. #6520, #6498. Thanks @dhalbert.

STM

• Make family IDs consistent with TinyUF2. #6577. Thanks @NathanY3G.
• Add basic rtc implementation. #6468. Thanks @blues.

Individual boards

• Adafruit CLUE: release display before deep sleep. #6520, #6486. Thanks @DavePutz.
• Adafruit MagTag: add board.GPIO0. #6657. Thanks @nitz.
• Adafruit MatrixPortal: restore traceback. #6530. Thanks @dhalbert.
• Blues Wireless Swan R5: build UF2's. #6511. Thanks @blues.
• Blues Wireless Swan R5: fix 3v3 enabling. #6458. Thanks @blues.
• ELECFREAKS Pico:ed: support status LED, use frozen libraries. #6578, #6526. Thanks @xuhow.
• HiiBot IoTs2: add default buses. #6516. Thanks @Neradoc.
• Invector Challenger 840: add support for 8MB flash. #6652. Thanks @Arudinne.
• Pimoroni Interstate 75: add board.LED. #6664. Thanks @dglaude.

Documentation changes

• Add adafruit_register library documentation to design guide. #6726. Thanks @tannewt.
• Fix autoapi signature parsing bug. #6643. Thanks @jepler.
• Link to more Learn Guides from documentation. #6581. Thanks @FoamyGuy.
• Correct typo in build instructions. #6567. Thanks @thetazero.
• Add WiFi workflow to branding documentation. #6545. Thanks @jepler.
• Improve rotozoom() documentation. #6477. Thanks @FoamyGuy.

Build and infrastructure changes

• Update macOS version for mpy-cross builds and canonicalize executable names. #6665, #6659. Thanks @dhalbert.
• Add pre-commit to requirements-dev.txt. #6658. Thanks @andywarburton.
• Specify which firmware extensions (.bin, .uf2, .hex) to build in mpconfigport.mk and mpconfigboard.mk. #6629. Thanks @Neradoc.
• Download ARM gcc t...

CircuitPython 7.3.2

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

Notable changes to 7.3.2 since 7.3.1

• Adafruit MatrixPortal: restore traceback, which allows asyncio use.
• Always release displays during deep sleep.
• Update frozen libraries: fixes issues due to older libraries on certain AirLift boards.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.1

Fixes and enhancements

• Update frozen libraries. #6619. Thanks @dhalbert.
• Always release displays during deep sleep. #6546: backport of #6543. Thanks @jepler and @dhalbert.

Port and board-specific changes

Individual boards

• Adafruit MatrixPortal: restore traceback module. #6530. Thanks @dhalbert.
• ELECFREAKS PICO:ED: update and add frozen libraries. #6587. Thanks @xuhow.

Build and infrastructure changes

New boards since 7.3.1

• (none)

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 7.3.x
  • 8.0.0

Thanks

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

CircuitPython 7.3.1

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

Notable changes to 7.3.1 since 7.3.0

• Adafruit MatrixPortal: fix ESP32SPI hang.
• Espressif: fix use of multiple rotaryio.IncrementalEncoder objects.
• nRF: fix crash when waking up from sleep when a display is in use.
• Update frozen libraries.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.0

Fixes and enhancements

• Update frozen libraries. #6517. Thanks @dhalbert.

Port and board-specific changes

Espressif

• Fix allocation of multiple rotaryio.IncrementalEncoder objects. #6430. Thanks @dhalbert.

nRF

• Fix crash when waking up from sleep when display is in use. #6512. Backport of #6486. Thanks @DavePutz.
• Handle BLE disconnect when reading. #6513. Backport of #6495. Thanks @DavePutz.

SAMx5x

• Make SPI DMA setup be atomic. Fixes hangs on Adafruit MatrixPortal. #6498. Thanks @dhalbert.

Individual boards

• Adafruit Circuit Playground Express boards: Do not freeze unneeded code. #6508. Backport of #6346. Thanks @Neradoc.

Build and infrastructure changes

• Improve Espressif build cache key handling. #6506. Backport of #6494, #6497. Thanks @jepler.

New boards since 7.3.0

• (none)

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 7.x.x
  • 8.0.0

Thanks

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

CircuitPython 8.0.0 Alpha 1

This is CircuitPython 8.0.0-alpha.1, an alpha release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.

Notable changes to 8.0.0 since 7.3.0

• Added TileGrid.contains().
• AnalogIn values are full range from 0 to 65535, instead of having zeros on low-order bits.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• dotenv support: os.getenv() values can be set in the .env file.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.0

Fixes and enhancements

• Add TileGrid.contains(). #6442. Thanks @FoamyGuy.
• Finish moving OneWire from busio to onewireio. #6427. Thanks @dhalbert.
• Make AnalogIn be full range from 0 to 65535, instead of having zeros on low-order bits. #6426. Thanks @PaintYourDragon.
• Change display brightness PWM frequency to 500 Hz to fix brightness range. #6416. Thanks @FoamyGuy and @CedarGroveStudios.
• Add dotenv support: read values from .env file. #6407. Thanks @tannewt.
• Fix hiding of vectorio shapes. #6383. Thanks @FoamyGuy.
• Remove gamepadshift; use keypad.ShiftRegisterKeys instead. #5491. Thanks @deshipu.

Port and board-specific changes

Broadcom

Espressif

• Fix multiple uses of rotaryio.IncrementalEncoder. #6463, #6430. Thanks @dhalbert.
• Support use of a static IP address. #6441. Thanks @gamblor21.

i.MX

• Teensy boards: preserve filesystem when updating firmware. #6425. Thanks @KurtE.

nRF

RP2040

• PulseIn improvements. #6450. Thanks @mwisslead.
• Update pico-sdk to version 1.3.1. #6414. Thanks @dhalbert.

SAMx

• Disable traceback on SAMD21 to save space. #6438. Thanks @dhalbert.
• Implement UART RTS/CTS flow control. #6434. Thanks @stonehippo.

STM

• Fix SPI frequency settings. #6446. Thanks @EmergReanimator.

Individual boards

• Adafruit Circuit Playground Express boards: Do not freeze unneeded code. #6346. Thanks @Neradoc.
• Adafruit Metro M0: reenable onewireio. #6438. Thanks @dhalbert.
• Challenger NB RP2040: remove non-functional board.SPI(). #6463, #6462. Thanks @NathanY3G.
• LILYGO TTGO T-OI PLUS: Fix board startup. #6447. Thanks @SimonVail.
• SolderParty RP2040: Add Round Carrier frozen library. #6418. Thanks @solderparty.
• SparkFun STM32 Thing Plus: enable UF2 builds. #6459. Thanks @NathanY3G.
• Swan R5 improvements. #6437. Thanks @blues.

Documentation changes

• Fix autoapi bug. #6449. Thanks @jepler.
• Fix countio example. #6423. Thanks @tylercrumpton.

Build and infrastructure changes

• Fix dependencies for translate.c. #6466. Thanks @jepler.
• Restore ulab to boards that now have room. #6465. Thanks @tannewt.
• Speed up translation calculation. #6455. Thanks @jepler.
• Switch translate() to a header file to save space. #6440. Thanks @tannewt.
• Use -flto and -flto-partition=one only when necessary, to speed up builds. #6436. Thanks @dhalbert.
• Restore rainbowio to most small builds. #6428. Thanks @dhalbert.
• Consolidate similar error messages; use argument validators. #6409. Thanks @dhalbert.

Translation additions and improvements

Thanks for translations:

• @ajs256 (French)
• @bergdahl (Swedish)
• @Chameloun (Czech)
• @fabaff (German)
• @Lisapple (French)
• @wtuemura (Portugese - Brazil)

New boards since 7.3.0

• Adafruit Feather ESP32-S3 4MB Flash 2MB PSRAM. #6456. Thanks @dhalbert.
• Adafruit Feather ESP32-S3 TFT. #6424. Thanks @ladyada.
• Ctryon Maker Zero SAMD21. #6432. Thanks @CytronTechnologies.
• Challenger RP204 LoRA boards. #6472. Thanks @PontusO.
• MixGo CE. #6422, #6383. Thanks @dahanzimin.
• WeAct Studio Pico. #6411. Thanks @fabaff.

Known issues

• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 8.0.0

Thanks

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

CircuitPython 7.3.0

This is CircuitPython 7.3.0, the latest minor revision of CircuitPython, and is a new stable release.

Notable changes to 7.3.0 since 7.2.5

• Experimental mDNS support.
• USB to to Serial/JTAG support for REPL on appropriate boards.
• Initial experimental USB host support.
• Merge MicroPython 1.18 changes.
• Preliminary zlib module support. gzip module will be added later.
• RP2040 PIO: Background write to a PIO state machine. Looping is possible.
• RP2040 PIO: wrap and wrap_target support.
• keypad: scan keystates immediately on creation.
• Improve NeoPixel timings on many ports, to handle a wider range of devices.
• Add floppyio, used in conjunction with a library.
• Allow TileGrid bitmap to be changed.
• Module support matrix includes frozen modules for each board.
• f-strings available in all builds.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.0-rc.2

This release is a relabeling of 7.3.0-rc.2 and is otherwise the same as that release.

Known issues

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

Thanks

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

CircuitPython 7.3.0 Release Candidate 2

This is CircuitPython 7.3.0-rc.2, the third release candidate for CircuitPython 7.3.0. It is considered stable, and is available as a release candidate for testing before the final release of 7.3.0.

Notable changes to 7.3.0 since 7.2.5

• Experimental mDNS support.
• USB to to Serial/JTAG support for REPL on appropriate boards.
• Initial experimental USB host support.
• Merge MicroPython 1.18 changes.
• Preliminary zlib module support. gzip module will be added later.
• RP2040 PIO: Background write to a PIO state machine. Looping is possible.
• RP2040 PIO: wrap and wrap_target support.
• keypad: scan keystates immediately on creation.
• Improve NeoPixel timings on many ports, to handle a wider range of devices.
• Add floppyio, used in conjunction with a library.
• Allow TileGrid bitmap to be changed.
• Module support matrix includes frozen modules for each board.
• f-strings available in all builds.

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:

• atmel-samd: Microchip SAMD21, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• nrf: 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
• espressif: ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 7.3.0-rc.1

Fixes and enhancements

• Turn on f-strings for all builds. #6415. Thanks @dhalbert.

Port and board-specific changes

Broadcom

Espressif

i.MX

nRF

RP2040

SAMx

STM

Individual boards

Documentation changes

Build and infrastructure changes

Translation additions and improvements

New boards since 7.3.0-rc.1

Known issues

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

Thanks

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