Releases: adafruit/circuitpython
CircuitPython 7.1.0
This is CircuitPython 7.1.0, the latest minor revision of CircuitPython, and is a new stable release.
Notable additions to 7.1.0 since 7.0.0
- Initial port for Raspberry Pi Broadcom-based boards.
- Preliminary support for
asyncio
cooperative multitasking. bitmaptools
: dithering and alphablend are new.keypad.Event
s now include timestamps.framebufferio
: support for IS31FL3741.- Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support,ParallelImageCapture
. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- SAMD now provides
watchdog
, andalarm
with sleep. - SAMx5 boards now all have sleep support.
- The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
- Russian translation.
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
New boards since 7.0.0
- Adafruit Feather ESP32-S2
- Adafruit Feather ESP32-S2 TFT
- Adafruit KB2040
- Adafruit QT Py ESP32-S2
- AIThinker ESP32-C3S_Kit
- Challenger NB RP204
- Cytron Maker Nano RP2040
- JPConstantineau Pykey60
- Lolin/Wemos S2-Pico
- Melopero Shake RP2040
- MicroDev microC3
- Oak Development Technologies Bread 2040
- Raspberry Pi 4B
- Raspberry Pi Compute Module 4 IO Board
- Raspberry Pi Zero 2W
- Seed XIAO variant build for HID devices
- Solder Party RP2040 Stamp
- Swan R5
Changes since 7.1.0-rc.1
This release is a relabeling of 7.1.0-rc.1 and is otherwise the same as that release.
Known issues
- See https://github.com/adafruit/circuitpython/issues for open issues, including issues still to be addressed for 7.x.x.
Thanks
Thank you to all who used, tested, and contributed since 7.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Release Candidate 1
This is CircuitPython 7.1.0-rc.1, the second release candidate for CircuitPython 7.1.0. We believe it is stable, but want to give time for further testing.
Notable additions to 7.1.0 since 7.0.0
- Initial port for Raspberry Pi Broadcom-based boards.
- Preliminary support for
asyncio
cooperative multitasking. bitmaptools
: dithering and alphablend are new.keypad.Event
s now include timestamps.framebufferio
: support for IS31FL3741.- Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support,ParallelImageCapture
. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- SAMD now provides
watchdog
, andalarm
with sleep. - SAMx5 boards now all have sleep support.
- The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
- Russian translation.
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
New boards since 7.0.0
- Adafruit Feather ESP32-S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5742, #5741, #5738, #5573, #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- Adafruit QT Py ESP32-S2. #5741, #5738, #5622, #5621, #5620. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- Cytron Maker Nano RP2040. #5673. Thanks @waiweng83.
- JPConstantineau Pykey60. #5507, #5497, #5365. Thanks @jpconstantineau.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- Raspberry Pi 4B. #5610. Thanks @tannewt.
- Raspberry Pi Compute Module 4 IO Board. #5610. Thanks @tannewt.
- Raspberry Pi Zero 2W. #5610. Thanks @tannewt.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Changes since 7.1.0-rc.0
Fixes and enhancements
Port and board-specific changes
Individual boards
- Adafruit Feather ESP32-S2: turn on I2C power by default. #5779, #5776. Thanks @ladyada and @dhalbert.
Documentation changes
- [none in this release]
Build and infrastructure changes
- [none in this release]
Translation additions and improvements
- [none in this release]
Known issues
- See https://github.com/adafruit/circuitpython/issues for open issues, including issues still to be addressed for 7.x.x.
Thanks
Thank you to all who used, tested, and contributed since 7.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Release Candidate 0
This is CircuitPython 7.1.0-rc.0, the initial release candidate for CircuitPython 7.1.0. We believe it is stable, but want to give time for further testing.
Notable additions to 7.1.0 since 7.0.0
- Initial port for Raspberry Pi Broadcom-based boards.
- Preliminary support for
asyncio
cooperative multitasking. bitmaptools
: dithering and alphablend are new.keypad.Event
s now include timestamps.framebufferio
: support for IS31FL3741.- Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support,ParallelImageCapture
. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- SAMD now provides
watchdog
, andalarm
with sleep. - SAMx5 boards now all have sleep support.
- The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
- Russian translation.
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0
The full commit log is here.
Fixes and enhancements
- Update frozen libraries. #5773. Thanks @dhalbert. [buggy: will be fixed in 7.1.0-rc.1]
- Fix recording of
alarm.wake_alarm
on real and simulated deep sleep. #5762. Thanks @dhalbert. - Fix
pixelbuf
off-by-one error. #5748: backport of #5746. Thanks @dunkmann00. - Update
ulab
. #5740. Thanks @jepler. - Fix traceback printing crash for non-native exceptions. #5723. Thanks @timhawes and @microdev1.
Port and board-specific changes
- [none in this release]
Individual boards
New boards Since 7.0.0
- Adafruit Feather ESP32-S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5742, #5741, #5738, #5573, #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- Adafruit QT Py ESP32-S2. #5741, #5738, #5622, #5621, #5620. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- Cytron Maker Nano RP2040. #5673. Thanks @waiweng83.
- JPConstantineau Pykey60. #5507, #5497, #5365. Thanks @jpconstantineau.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- Raspberry Pi 4B. #5610. Thanks @tannewt.
- Raspberry Pi Compute Module 4 IO Board. #5610. Thanks @tannewt.
- Raspberry Pi Zero 2W. #5610. Thanks @tannewt.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Documentation changes
Build and infrastructure changes
Translation additions and improvements
- [none in this release]
Known issues
- See https://github.com/adafruit/circuitpython/issues for open issues, including issues still to be addressed for 7.x.x.
Thanks
Thank you to all who used, tested, and contributed since 7.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Beta 3
This is CircuitPython 7.1.0-beta.3, the fourth beta release for CircuitPython 7.1.0. It is relatively stable, but contains issues we may still address for 7.1.0. This release fixes a regression in 7.1.0-beta.2 that caused problems with displayio
and possibly other problems.
Notable additions to 7.1.0 since 7.0.0
- Initial port for Raspberry Pi Broadcom-based boards.
- Preliminary support for
asyncio
cooperative multitasking. bitmaptools
: dithering and alphablend are new.keypad.Event
s now include timestamps.framebufferio
: support for IS31FL3741.- Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support,ParallelImageCapture
. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- SAMD now provides
watchdog
, andalarm
with sleep. - SAMx5 boards now all have sleep support.
- The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
- Russian translation.
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0
The full commit log is here.
Fixes and enhancements
- [no general changes in this release]
Port and board-specific changes
SAMx
- Fix SAMD TAMPER interrupt clearing in
PinAlarm
; fixes some second-order bugs, including indisplayio
. #5708. Thanks @dhalbert.
Individual boards
- [no changes for individual boards in this release]
New boards Since 7.0.0
- Adafruit Feather ESP32-S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5573, #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- Adafruit QT Py ESP32-S2. #5622, #5621, #5620. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- Cytron Maker Nano RP2040. #5673. Thanks @waiweng83.
- JPConstantineau Pykey60. #5507, #5497, #5365. Thanks @jpconstantineau.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- Raspberry Pi 4B. #5610. Thanks @tannewt.
- Raspberry Pi Compute Module 4 IO Board. #5610. Thanks @tannewt.
- Raspberry Pi Zero 2W. #5610. Thanks @tannewt.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Documentation changes
- [no documentation changes in this release]
Build and infrastructure changes
Translation additions and improvements
- [none in this 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.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Beta 2
This is CircuitPython 7.1.0-beta.2, the third beta release for CircuitPython 7.1.0. It is relatively stable, but contains issues we may still address for 7.1.0.
Notable additions to 7.1.0 since 7.0.0
- Initial port for Raspberry Pi Broadcom-based boards.
- Preliminary support for
asyncio
cooperative multitasking. bitmaptools
: dithering and alphablend are new.keypad.Event
s now include timestamps.framebufferio
: support for IS31FL3741.- Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support,ParallelImageCapture
. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- SAMD now provides
watchdog
, andalarm
with sleep. - SAMx5 boards now all have sleep support.
- The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
- Russian translation.
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).
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0
The full commit log is here.
Fixes and enhancements
sdcardio
. Idle state not needed during early init. #5688. Thanks @jepler.- Fix
_bleio
HCI support. #5683. Thanks @dhalbert. - Update
_stage
to avoid backlight problems. #5657. Thanks @deshipu. - Allocate
busio.UART
object more carefully. #5647. Thanks @jepler. - Update
ulab
to 3.3.7. #5642. Thanks @jepler. - Make
bitbangio.SPI
keyword args matchbusio.SPI
. #5641. Thanks @jepler. - Update frozen libraries. #5700. Thanks @dhalbert.
Port and board-specific changes
Broadcom
RP2040
- Use proper slice number for
PWMOut
. #5667. Thanks @dhalbert. - Protect
nvm
writes from interrupts. #5663. Thanks @FoamyGuy. - Use longer clock-stretch timeout for RP2040 zero-byte I2C writes. #5656. Thanks @dhalbert.
SAMx
- Fix
FrequencyIn
. #5665. Thanks @dhalbert. - Enable sleep on all SAM5x boards. #5634. Thanks @dhalbert.
Spresense
- Fix
time.time()
. #5635. Thanks @kamtom480.
Individual boards
- [no changes for individual boards]
New boards Since 7.0.0
- Adafruit Feather ESP32-S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5573, #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- Adafruit QT Py ESP32-S2. #5622, #5621, #5620. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- Cytron Maker Nano RP2040. #5673. Thanks @waiweng83.
- JPConstantineau Pykey60. #5507, #5497, #5365. Thanks @jpconstantineau.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- Raspberry Pi 4B. #5610. Thanks @tannewt.
- Raspberry Pi Compute Module 4 IO Board. #5610. Thanks @tannewt.
- Raspberry Pi Zero 2W. #5610. Thanks @tannewt.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Documentation
- [no documentation changes]
Build and infrastructure changes
- Partial submodule fetching using sha. #5687, #5681. Thanks @tannewt.
- Update file formatting due to
blacken
anduncrustify
updates. #5670. Thanks @hdalbert. - Fix running traceback test. #5649. Thanks @microdev1.
- Add tests for
aesio
. #5638. Thanks @jepler. - Fix CI dependency fetching for automated circuitpython.org updates. #5636. Thanks @dhalbert.
- Add
board_deinit()
for all boards that lacked it. #5634. Thanks @dhalbert. - Add
make fetch-submodules
, to do partial fetches of submodules. #5627. Thanks @tannewt. - Reorder pins to match silk, for automated pin diagrams. #5652, #5626. Thanks @kattni.
Translation additions and improvements
- Thanks for translations:
- @Pixel-Clay (Russian)
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.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Beta 1
This is CircuitPython 7.1.0-beta.1, the second beta release for CircuitPython 7.1.0. It is relatively stable, but contains issues we may still address for 7.1.0.
Notable additions to 7.1.0 since 7.0.0
-
Initial port for Raspberry Pi Broadcom-based boards.
-
Preliminary support for
asyncio
cooperative multitasking. -
bitmaptools
: dithering and alphablend are new. -
keypad.Event
s now include timestamps. -
framebufferio
: support for IS31FL3741. -
Espressif now provides
I2CPeripheral
, WiFi monitor mode, setting MAC address, ESP32-C3 support, ParallelImageCapture`. -
gifio.GifWriter
is new. -
HID now provides boot device and feature report support.
-
rotaryio
now allows setting the divisor of counts per transition. -
SAMD now provides
watchdog
, andalarm
with sleep. -
The STM port now provides STM32L4R5 support.
-
MicroPython 1.17 has been merged in.
-
Russian translation.
-
Preliminary support for
asyncio
is included. Use the CircuitPython asyncio library.
Download from circuitpython.org
Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.
Installation
To install follow the instructions in the Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.
Try 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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. broadcom
(Raspberry Pi), litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0
The full commit log is here.
Fixes and enhancements
bitmaptools
: fix dithering and other bugs. #5616, #5605. Thanks @jepler.- Fix when to write
boot_out.txt
. #5611. Thanks @jepler. - Fix tracebacks. #5608, #5574. Thanks @microdev1.
- Don't run
code.py
when restarting in raw mode. #5602. Thanks @aivarannamaa. - Fix
camera
constructor signature. #5596. Thanks @kamtom480. - Update frozen libraries, notably adafruit_hid to support non-US keyboard layouts. #5587. Thanks @dhalbert.
framebufferio
: support for IS31FL3741. #5584. Thanks @gamblor21.
Port and board-specific changes
Broadcom
Espressif
wifi
: Allow setting access point MAC address. #5593. Thanks @anecdata.wifi
: Allow setting station MAC address; validate SSID length. #5571. Thanks @anecdata.
SAMx
Individual boards
- Adafruit Feather ESP32-S2: fix name of I2C power control pin. #5595. Thanks @anecdata.
- Adafruit Feather ESP32-S2: reorder pins for preferred naming. #5626. Thanks @kattni.
New boards Since 7.0.0
- Adafruit Feather ESP32-S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5573, #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- Adafruit QT Py ESP32-S2. #5622, #5621, #5620. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- JPConstantineau Pykey60. #5507, #5497, #5365. Thanks @jpconstantineau.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- Raspberry Pi 4B. #5610. Thanks @tannewt.
- Raspberry Pi Compute Module 4 IO Board. #5610. Thanks @tannewt.
- Raspberry Pi Zero 2W. #5610. Thanks @tannewt.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Documentation
Build and infrastructure changes
- Shrink some overflowing builds. #5617. Thanks @tannewt.
- Enable
-Werror=missing-prototypes on more builds
. #5582, #5580. Thanks @jepler. - Remove FAT32
mkfs
on boards that don't need it; re-enablerainbowio
on some boards. #5578. Thanks @jepler. - Enable
bitmaptools
onunix
coverage
build. #5575. Thanks @jepler.
Translation additions and improvements
- Initiate new Russian translation. Thanks @urfdvw.
- Enable Russian translation builds. #5592, #5589. Thanks @tannewt and @dhalbert.
- Thanks for translations:
Known issues
- The
broadcom
port for the Raspberry Pi Zero 2 W will sometimes hang when accessing the CIRCUITPY drive. #5628. - 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.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.1.0 Beta 0
This is CircuitPython 7.1.0-beta.0, the initial beta release for CircuitPython 7.1.0. It is relatively stable, but contains issues we may still address for 7.1.0.
Notable additions to 7.1.0 since 7.0.0
keypad.Event
s now include timestamps.- The Espressif port now provides
I2CPeripheral
, WiFi monitor mode, ESP32-C3 support,ParallelImageCapture
. bitmaptools
: dithering and alphablend are new.- Preliminary support for
asyncio
is included. Use the CircuitPython asyncio library. gifio.GifWriter
is new.- HID now provides boot device and feature report support.
rotaryio
now allows setting the divisor of counts per transition.- The SAMD port now provides
watchdog
, andalarm
with sleep. - The STM port now provides STM32L4R5 support.
- MicroPython 1.17 has been merged in.
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).
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0
The full commit log is here.
Fixes and enhancements
- Add preliminary support for
asyncio
. #5564. Thanks @dhalbert. - Fix and refactor traceback handling. #5562. Thanks @microdev1.
bitmaptools
: add dithering support. #5558. Thanks @jepler.- Improve not writing
boot_out.txt
when it does not change. #5557, #5536. Thanks @jepler. bitmaptools
: addalphablend
. #5544. Thanks @jepler.- Fix BLE workflow directory listing. #5524. Thanks @tannewt.
sdcardio
: use CMD25 to improve write speed. #5510. Thanks @jepler.PulseIn
: fix possible memory corruption. #5509. Thanks @DavePutz._bleio
: fixstart_advertising()
argument validation. #5508. Thanks @dhalbert.- Fix flash support to use additional values from the NVM toml data. #5506. Thanks @maholli.
- Update
help()
message to point to circuitpython.org. #5494. Thanks @kattni. - Add
gifio.GifWriter
. #5490. Thanks @jepler. keypad.Event
: fixhash()
. #5486. Thanks @dhalbert.usb_hid
: add boot device support and feature report support. #5481. Thanks @dhalbert.rotaryio
: allow setting count divisor. #5468. Thanks @jepler.- Merge MicroPython 1.17. #5466. Thanks @jepler.
- Use
mp_arg_validate_type()
for keyword args. #5452. Thanks @microdev1. displayio
: fix argument validation forFourWire
andI2CDisplay
. #5450. Thanks @FoamyGuy._stage
: add support for viewport scrolling. #5447. Thanks @pewpew-game.- Fix keyword argument handling in several native modules. #5439. Thanks @dhalbert.
usb_hid
: allow report-id-less HID descriptors. #5392. Thanks @dhalbert.adafruit_bus_device
: allow CS active-high. #5383. Thanks @michthom.displayio.Display.fill_row
now takes anyWriteableBuffer
. #5373. Thanks @lesamouraipourpre.bitmaptools.__init()
: update error message. #5369. Thanks @lesamouraipourpre.- Avoid overflow when scaling ticks in
mp_hal_delay_ms()
. #5364. Thanks @osresearch. keypad
: add Event timestamps. #5360. Thanks @jepler.- Fix importing of
paralleldisplay
. #5358. Thanks @jepler.
Port and board-specific changes
Espressif
- Add
ParallelImageCapture
. #5540, #5457. Thanks @jepler. - Add WiFi monitor mode to capture all packets. #5537. Thanks @microdev1 and @anecdata.
- Add initial ESP32-C3 support. #5394. Thanks @tannewt.
- Fix serial REPL over UART. #5388. Thanks @microdev1.
- Use I2S peripheral for parallel LCD displays. #5378. Thanks @jepler.
- Update port to allow supporting more Espressif chips. #5367. Thanks @microdev1.
- Support for
I2CPeripheral
. #3768. Thanks @microdev1.
i.MX
nRF
- Correct board name for nRF52833 DK. #5441. Thanks @jpconstantineau.
SAMx
- Fix
watchdog
time conversion. #5549. Thanks @jepler. - Fix SAMD21
PDMIn
hang. #5458. Thanks @dhalbert. - SAMD51: Implement
watchdog
. #5483. Thanks @jepler. - Allow PA24 and PA25 pins to be used for other purposes if USB is turned off. #5427. Thanks @EmergReanimator.
- Implementation of
alarm
, including deep sleep. #5425. Thanks @maholli.
STM
- Improve accuracy of
microcontroller.delay_us()
. #5553. Thanks @EmergReanimator. - Add STM32L4R5 support. #5403. Thanks @blues.
Individual boards
- Adafruit Trinket QT2040: fix USB PID. #5550. Thanks @ladyada.
- Challenger RP2040 WiFi: fix pin definitions. #5390. Thanks @pontus0.
- Cytron Maker Pi RP2040: correct pin definitions. #5533. Thanks @CytronTechnologies.
- Lolin S2 Mini: add
board.I2C()
. #5467. Thanks @evildave666. - MicroDev microS2: minor updates. #5421. Thanks @microdev1.
- Pimoroni PicoSystem: freeze the
stage
library. #5437. Thanks @pewpew-game. - Pimoroni PicoSystem: add
displayio
. #5398. Thanks @Gadgetoid. - PyCubed: update for mainboardv05. #5302. Thanks @maholli.
- Sensebox MCU: add
rainbowio
. #5534. Thanks @jepler.
New boards Since 7.0.0
- Adafruit Feather ESP32S2. #5517. Thanks @ladyada.
- Adafruit Feather ESP32-S2 TFT. #5570. Thanks @ladyada.
- Adafruit KB2040. #5550. Thanks @ladyada.
- AIThinker ESP32-C3S_Kit. #5409. Thanks @skieast.
- Challenger NB RP204. #5395. Thanks @pontus0.
- Lolin/Wemos S2-Pico. #5464. Thanks @skieast.
- Melopero Shake RP2040. #5465, #5372. Thanks @melopero.
- MicroDev microC3. #5404. Thanks @microdev1.
- Oak Development Technologies Bread 2040. #5368. Thanks @skerr92.
- PyKey60 #5507, #5497, #5365. Thanks @jpconstantineau.
- Seed XIAO variant build for HID devices. #5442. Thanks @jpconstantineau.
- Solder Party RP2040 Stamp. #5504. Thanks @solderparty.
- Swan R5. #5403. Thanks @blues.
Documentation
- Update Troubleshooting. #5539, #5528. Thanks @kattni.
- Update native module examples using the on-board LED; update PWM example. #5523. Thanks @kattni.
- Update
SocketPool
. #5508. Thanks @dhalbert. - Update how to build documentation. #5472. Thanks @fraziern.
- Add precision information to
time.monotonic()
. #5443. Thanks @dhalbert. - Add ESP32-C3. #5417. Thanks @microdev1.
- Document
board.board_id
. #5416 Thanks @Neradoc. - Improve
usb_hid.Device
. #5379. Thanks @dhalbert. - Correct 'I2C.writeto()`. #5363. Thanks @Neradoc.
Build and infrastructure changes
- Enable
-Werror=missing-prototypes
on various ports. #5563, #5561. Thanks @jepler. - Use Python 3.9 for readthedocs. #5545. Thanks @jepler.
- Handle deleted boards during a build. #5518. Thanks @jepler.
- Allow any character except
/
in port or board names. #5473. Thanks @jepler. - Upload patch to artifacts if pre-commit fails. #5434. Thanks @microdev1.
- Convert all modules to use
MP_REGISTER_MODULE
. #5430. Thanks @microdev1. - Fixed code comments re SAMD21/SAMD51 DAC clock speeds. #5429. Thanks @process1183.
- Upload stubs to pypi for release versions. #5385. Thanks @FoamyGuy.
- Fix stubs upload to S3. #5376. Thanks @microdev1.
- Rebuild documentation only as necessary. #5350. Thanks @microdev1.
Translation additions and improvements
- Thanks for translations:
- @bergdahl (Swedish)
- @hexthat (Chinese - Pinyin)
- @lesamouraipourpre (English - UK)
- @rezaalmanda (Indonesian)
- @Senuros (German)
- @wtuemura (Portuguese - Brazil)
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.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
CircuitPython 7.0.0
This is CircuitPython 7.0.0, the latest major revision of CircuitPython, and is a new stable release.
Notable additions to 7.0.0 since 6.3.0
- Support for the CircuitPython development workflow over BLE.
- Camera support on ESP32S2.
qrio
: QR code decoding.- The
keypad
key-scanning module. - Run-time customization of USB devices.
- Merging in of MicroPython fixes and enhancements as of MicroPython 1.16.
_pixelbuf
is nowadafruit_pixelbuf
.colorwheel()
routine moved torainbowio
.supervisor.ticks_ms()
to allow easier time-keeping.- Simplifications to the RGB status LED codes.
- A clocking fix for a few samples of RP2040 boards.
- Rework of
vectorio
and some of its API.VectorShape
is no longer needed for user code. atexit
module.getpass
module.traceback
module.supervisor.get_previous_traceback()
.board.LED
now consistently present on all boards that have such an LED.PulseOut
no longer needs aPWMOut
.- Unicode filename support.
- Board ID is now in
boot_out.txt
and available asboard.board_id
. aesio
on for full builds by default.
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 our new 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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0-rc.3
This release is a relabeling of 7.0.0-rc.3 and is otherwise the same as that release.
Breaking changes and deprecations since 6.x
- The RGB status LED codes have changed for clarity and to save power.
PWMOut
is now only inpwmio
, and is no longer in bothpulseio
andpwomio
.colorwheel()
has been moved from_pixelbuf
torainbowio
.displayio.Group
no longer has amax_size
parameter.vectorio
:Rectangle
,Circle
, andPolygon
are added directly to aGroup
;VectorShape
is not needed.- Using a
PWMOut
forPulseOut
is deprecated and will be removed in 8.0.0. gamepad
is removed: usekeypad
.gamepadshift
is still present but will be removed in 8.0.0.settings.py
andsettings.txt
are no longer alternative names forboot.py
.- The default for
displayio.Display.refresh(..., minimimum_frames_per_second, ...)
is now 0. displayio.Display()
argumentset_vertical_scroll
argument is deprecated and will be removed in 8.0.0.displayio.ParallelBus
is now available asparallelbus.ParallelBus
and will be removed fromdisplayio
in 8.0.0.busio.OneWire
/bitbangio.OneWire
is now available asonewireio.OneWire
and will be removed frombusio
andbitbangio
in 8.0.0.
New boards since 6.3.0
- ARAMCON2 Badge. #4627. Thanks @aramcon-badge.
- ATMegaZero ESP32-S2. #4634. Thanks @eddieespinal.
- Adafruit LED Glasses nRF52840 Driver. #5224, #5265, #5326. Thanks @dhalbert and @ladyada.
- Adafruit MacroPad RP2040. #4770, #4864. Thanks @ladyada.
- AiThinker ESP-12K NodeMCU. #5149. Thanks @codetyphon.
- Arduino Nano RP2040 Connect. #4802. Thanks @BlitzCityDIY.
- BlueMicro840. #5114. Thanks @jpconstantineau.
- CP Sapling Rev B. #4677. Thanks @skerr92.
- Challenger RP2040 WiFi. #5323. Thanks @PontusO.
- CrumpSpace CrumpS2. #5143. Thanks @tylercrumpton.
- Cytron Maker Pi RP2040. #4824. Thanks @CytronTechnologies.
- EncoderPad RP2040. #5247 Thanks @jpconstantineau.
- Espressif HMI DevKit 1. Thanks @jepler.
- Espressif HMI Development Kit. #5335. Thanks @skieast.
- Espressif Kalgua v1.3. #4870. Thanks @jepler.
- Gravitech Cucumber M. #5097. Thanks @anecdata.
- Gravitech Cucumber MS. #5097. Thanks @anecdata.
- Gravitech Cucumber R. #5097. Thanks @anecdata.
- Gravitech Cucumber RS. #5097. Thanks @anecdata.
- Lolin Mini S2. #5239, #5297. Thanks @durapensa.
- micro:bit V2 (first BLE-only board). #5002. Thanks @tannewt.
- Morpheans MorphESP-240. #5129. Thanks @skieast.
- Muselab nanoESP32-S2 WROVER. #4834. Thanks @reppad.
- Oak Development Technologies PixelWing ESP32-S2. #5156. Thanks @skerr92.
- Pimoroni Interstate 75. #5099. Thanks @ZodiusInfuser.
- Pimoroni PGA2040. #4865. Thanks @ZodiusInfuser.
- Pimoroni Plasma 2040. #5099. Thanks @ZodiusInfuser.
- RayTac MDBT50Q-RX nRF52840 dongle. #5095. Thanks @dhalbert.
- senseBox MCU. #4576. Thanks @felixerdy.
- SparkFun MicroMod SAMD51. #4852. Thanks @stonehippo.
- SparkFun MicroMod STM32. #5060. Thanks @cdwilson.
- UnexpectedMaker Feather S2 Neo. #5294. Thanks @UnexpectedMaker.
- WarmBit BluePixel nRF52840. #5229 Thanks @warmbit.
Known issues
- We are not aware of any show-stopper issues.
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.3.0. See the 7.0.0 alpha, beta and RC releases for all who contributed. Join us on the Discord chat to collaborate.
This release is based on MicroPython 1.16. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
CircuitPython 7.0.0 Release Candidate 3
This is CircuitPython 7.0.0-rc.3, a release candidate for CircuitPython 7.0.0 final. We have addressed all the issues we scheduled for the 7.0.0 release. This release fixes an RP2040 regression introduced in 7.0.0-rc.2. We believe this release is stable, but want to give time for further testing.
Notable additions to 7.0.0 since 6.3.0 include:
- Support for the CircuitPython development workflow over BLE.
- Camera support on ESP32S2.
qrio
: QR code decoding.- The
keypad
key-scanning module. - Run-time customization of USB devices.
- Merging in of MicroPython fixes and enhancements as of MicroPython 1.16.
_pixelbuf
is nowadafruit_pixelbuf
.colorwheel()
routine moved torainbowio
.supervisor.ticks_ms()
to allow easier time-keeping.- Simplifications to the RGB status LED codes.
- A clocking fix for a few samples of RP2040 boards.
- Rework of
vectorio
and some of its API.VectorShape
is no longer needed for user code. atexit
module.getpass
module.traceback
module.supervisor.get_previous_traceback()
.board.LED
now consistently present on all boards that have such an LED.PulseOut
no longer needs aPWMOut
.- Unicode filename support.
- Board ID is now in
boot_out.txt
and available asboard.board_id
. aesio
on for full builds by default.
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 our new 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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0-rc.2
The full commit log is here.
Fixes and enhancements
Port and board-specific changes
nRF
RP2040
- Disable use of
WFI
when idling. Fixes regression introduced by #5341. #5357. Thanks @dhalbert and @Neradoc.
ESP32-S2
Spresense
STM32
Individual Boards
New boards Since 6.3.0
- ARAMCON2 Badge. #4627. Thanks @aramcon-badge.
- ATMegaZero ESP32-S2. #4634. Thanks @eddieespinal.
- Adafruit LED Glasses nRF52840 Driver. #5224, #5265, #5326. Thanks @dhalbert and @ladyada.
- Adafruit MacroPad RP2040. #4770, #4864. Thanks @ladyada.
- AiThinker ESP-12K NodeMCU. #5149. Thanks @codetyphon.
- Arduino Nano RP2040 Connect. #4802. Thanks @BlitzCityDIY.
- BlueMicro840. #5114. Thanks @jpconstantineau.
- CP Sapling Rev B. #4677. Thanks @skerr92.
- Challenger RP2040 WiFi. #5323. Thanks @PontusO.
- CrumpSpace CrumpS2. #5143. Thanks @tylercrumpton.
- Cytron Maker Pi RP2040. #4824. Thanks @CytronTechnologies.
- EncoderPad RP2040. #5247 Thanks @jpconstantineau.
- Espressif HMI DevKit 1. Thanks @jepler.
- Espressif HMI Development Kit. #5335. Thanks @skieast.
- Espressif Kalgua v1.3. #4870. Thanks @jepler.
- Gravitech Cucumber M. #5097. Thanks @anecdata.
- Gravitech Cucumber MS. #5097. Thanks @anecdata.
- Gravitech Cucumber R. #5097. Thanks @anecdata.
- Gravitech Cucumber RS. #5097. Thanks @anecdata.
- Lolin Mini S2. #5239, #5297. Thanks @durapensa.
- micro:bit V2 (first BLE-only board). #5002. Thanks @tannewt.
- Morpheans MorphESP-240. #5129. Thanks @skieast.
- Muselab nanoESP32-S2 WROVER. #4834. Thanks @reppad.
- Oak Development Technologies PixelWing ESP32-S2. #5156. Thanks @skerr92.
- Pimoroni Interstate 75. #5099. Thanks @ZodiusInfuser.
- Pimoroni PGA2040. #4865. Thanks @ZodiusInfuser.
- Pimoroni Plasma 2040. #5099. Thanks @ZodiusInfuser.
- RayTac MDBT50Q-RX nRF52840 dongle. #5095. Thanks @dhalbert.
- senseBox MCU. #4576. Thanks @felixerdy.
- SparkFun MicroMod SAMD51. #4852. Thanks @stonehippo.
- SparkFun MicroMod STM32. #5060. Thanks @cdwilson.
- UnexpectedMaker Feather S2 Neo. #5294. Thanks @UnexpectedMaker.
- WarmBit BluePixel nRF52840. #5229 Thanks @warmbit.
Documentation
Build and infrastructure changes
Translation additions and improvements
Breaking changes and deprecations since 6.x
- The RGB status LED codes have changed for clarity and to save power.
PWMOut
is now only inpwmio
, and is no longer in bothpulseio
andpwomio
.colorwheel()
has been moved from_pixelbuf
torainbowio
.displayio.Group
no longer has amax_size
parameter.vectorio
:Rectangle
,Circle
, andPolygon
are added directly to aGroup
;VectorShape
is not needed.- Using a
PWMOut
forPulseOut
is deprecated and will be removed in 8.0.0. gamepad
is removed: usekeypad
.gamepadshift
is still present but will be removed in 8.0.0.settings.py
andsettings.txt
are no longer alternative names forboot.py
.- The default for
displayio.Display.refresh(..., minimimum_frames_per_second, ...)
is now 0. displayio.Display()
argumentset_vertical_scroll
argument is deprecated and will be removed in 8.0.0.displayio.ParallelBus
is now available asparallelbus.ParallelBus
and will be removed fromdisplayio
in 8.0.0.busio.OneWire
/bitbangio.OneWire
is now available asonewireio.OneWire
and will be removed frombusio
andbitbangio
in 8.0.0.
Known issues
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.3.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
This release is based on MicroPython 1.16. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
CircuitPython 7.0.0 Release Candidate 2
This is CircuitPython 7.0.0-rc.2, the third release candidate for CircuitPython 7.0.0. We have addressed all the issues we scheduled for the 7.0.0 release. We believe this release is stable, but want to give time for further testing.
RP2040 PROBLEM NOTED AFTER RELEASE: RP2040 boards will not restart properly after a power cycle with 7.0.0-rc.2. You can press reset and the board will restart, but stick with 7.0.0-rc.1 for RP2040 now and we will publish a fix soon. Issue is being tracked at #5354.
Notable additions to 7.0.0 since 6.3.0 include:
- Support for the CircuitPython development workflow over BLE.
- Camera support on ESP32S2.
qrio
: QR code decoding.- The
keypad
key-scanning module. - Run-time customization of USB devices.
- Merging in of MicroPython fixes and enhancements as of MicroPython 1.16.
_pixelbuf
is nowadafruit_pixelbuf
.colorwheel()
routine moved torainbowio
.supervisor.ticks_ms()
to allow easier time-keeping.- Simplifications to the RGB status LED codes.
- A clocking fix for a few samples of RP2040 boards.
- Rework of
vectorio
and some of its API.VectorShape
is no longer needed for user code. atexit
module.getpass
module.traceback
module.supervisor.get_previous_traceback()
.board.LED
now consistently present on all boards that have such an LED.PulseOut
no longer needs aPWMOut
.- Unicode filename support.
- Board ID is now in
boot_out.txt
and available asboard.board_id
. aesio
on for full builds by default.
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 our new 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).
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, atmel-samd
, cxd56
(Spresense), esp32s2
, nrf
,raspberrypi
, stm
for the F4 family are stable. stm
for other STM chip families is being actively improved but may be missing functionality and have bugs. litex
and mimxrt10xx
are in an alpha state and will have bugs and missing functionality.
Changes since 7.0.0-rc.1
The full commit log is here. A few changes before 7.0.0-rc.1 are included as well.
Fixes and enhancements
- Correct
sdioio
name. #5345. Thanks @dhalbert. - Enhance BLE file service. #5340. Thanks @tannewt.
- Fix 24-bit decoding in
bitmaptools.readinto()
. #5338. Thanks @lesamouraipourpre. - Update TinyUSB to pass compliance test suite. #5337, #5286, #5268. Thanks @hathach and @tannewt.
- Fix use of allocations for
get_previous_traceback()
. #5333. Thanks @microdev1. - Consistently validate
VectorShape
location properties. #5327. Thanks @lesamouraipourpre. - BLE: do not scan and advertise simultaneously. #5321. Thanks @tannewt.
- Update frozen libraries. #5314, #5288. Thanks @dhalbert and @UnexpectedMaker.
- Do not use translated messages for REPL messages read by editors. #5308. Thanks @microdev1.
- Add
board.board_id
andboard.__name__
. #5299. Thanks @Neradoc. aesio
is now available on more builds. #5293. Thanks @microdev1.- BLE workflow fix. #5284. Thanks @tannewt.
- Move
paralleldisplay
to its own module. #5260. Thanks @jepler.
Port and board-specific changes
nRF
- Correct
I2SOut
pin checking. #5326. Thanks @dhalbert. - Fix builds for use with gcc 11.2. (We still use gcc 10.2.1 for production.) #5319. Thanks @tannewt.
- Fix
watchdog
crashes. #5272. Thanks @tannewt.
RP2040
- Enable use of
WFI
when idling. #5341. Thanks @tannewt and @urish. - Implement
microcontroller.Processor.reset_reason
. #5320. Thanks @rjp5th. - Fix
I2SOut
audio. #5310. Thanks @dhalbert.
ESP32-S2
Spresense
- Update SDK to 2.3.0. #5336. Thanks @kamtom480.
- Update TinyUSB to fix USB MSC issue. #5303. Thanks @kamtom480.
STM32
Individual Boards
- LilyGo T8 S2 ST7789: Add pins. #5279. Thanks @microdev1.
- Nordic PCA10100: shrink flash size. #5339. Thanks @tannewt.
- UnexpectedMaker TinyS2: add
_stage
. #5289. Thanks @UnexpectedMaker.
New boards Since 6.3.0
- ARAMCON2 Badge. #4627. Thanks @aramcon-badge.
- ATMegaZero ESP32-S2. #4634. Thanks @eddieespinal.
- Adafruit LED Glasses nRF52840 Driver. #5224, #5265, #5326. Thanks @dhalbert and @ladyada.
- Adafruit MacroPad RP2040. #4770, #4864. Thanks @ladyada.
- AiThinker ESP-12K NodeMCU. #5149. Thanks @codetyphon.
- Arduino Nano RP2040 Connect. #4802. Thanks @BlitzCityDIY.
- BlueMicro840. #5114. Thanks @jpconstantineau.
- CP Sapling Rev B. #4677. Thanks @skerr92.
- Challenger RP2040 WiFi. #5323. Thanks @PontusO.
- CrumpSpace CrumpS2. #5143. Thanks @tylercrumpton.
- Cytron Maker Pi RP2040. #4824. Thanks @CytronTechnologies.
- EncoderPad RP2040. #5247 Thanks @jpconstantineau.
- Espressif HMI DevKit 1. Thanks @jepler.
- Espressif HMI Development Kit. #5335. Thanks @skieast.
- Espressif Kalgua v1.3. #4870. Thanks @jepler.
- Gravitech Cucumber M. #5097. Thanks @anecdata.
- Gravitech Cucumber MS. #5097. Thanks @anecdata.
- Gravitech Cucumber R. #5097. Thanks @anecdata.
- Gravitech Cucumber RS. #5097. Thanks @anecdata.
- Lolin Mini S2. #5239, #5297. Thanks @durapensa.
- micro:bit V2 (first BLE-only board). #5002. Thanks @tannewt.
- Morpheans MorphESP-240. #5129. Thanks @skieast.
- Muselab nanoESP32-S2 WROVER. #4834. Thanks @reppad.
- Oak Development Technologies PixelWing ESP32-S2. #5156. Thanks @skerr92.
- Pimoroni Interstate 75. #5099. Thanks @ZodiusInfuser.
- Pimoroni PGA2040. #4865. Thanks @ZodiusInfuser.
- Pimoroni Plasma 2040. #5099. Thanks @ZodiusInfuser.
- RayTac MDBT50Q-RX nRF52840 dongle. #5095. Thanks @dhalbert.
- senseBox MCU. #4576. Thanks @felixerdy.
- SparkFun MicroMod SAMD51. #4852. Thanks @stonehippo.
- SparkFun MicroMod STM32. #5060. Thanks @cdwilson.
- UnexpectedMaker Feather S2 Neo. #5294. Thanks @UnexpectedMaker.
- WarmBit BluePixel nRF52840. #5229 Thanks @warmbit.
Documentation
- Update documentation for
vectorio
. #5330. Thanks @lesamouraipourpre. - Remove remaining reference to
settings.py
. #5324. Thanks @Neradoc. - Add required Python packages to build documentation. #5322. Thanks @rdoursenaud.
- Add frozen library information for each board. #5304. Thanks @sommersoft.
- Update
ColorConverter
documentation. #5295. Thanks @lesamouraipourpre. - Update
Display.refresh()
documentation. #5292. Thanks @lesamouraipourpre. - Document
ParallelBus.frequency
. #5290. Thanks @jepler. - Update
TileGrid
argument types. #5285. Thanks @FoamyGuy.
Build and infrastructure changes
- Rename
esp32s2
port directory toespressif
, to handle future chips. #5342. Thanks @tannewt. - Only build boards or ports that have changed. #5312, #5238. Thanks @tannewt.
- Add test for
traceback
. #5296. Thanks @microdev1. - Fix link templates. #5284. Thanks @tannewt.
- Use
MP_REGISTER_MODULE
for more built-in modules. #5281. Thanks @capellini. - Add
0x
prefix on%p
uses inprintf()
. #5263. Thanks @jepler.
Translation additions and improvements
- Thanks for translations:
- @hexthat (Chinese Pinyin)
- @lesamouraipourpre (English UK)
Breaking changes and deprecations since 6.x
- The RGB status LED codes have changed for clarity and to save power.
PWMOut
is now only inpwmio
, and is no longer in bothpulseio
andpwomio
.colorwheel()
has been moved from_pixelbuf
torainbowio
.displayio.Group
no longer has amax_size
parameter.vectorio
:Rectangle
,Circle
, andPolygon
are added directly to aGroup
;VectorShape
is not needed.- Using a
PWMOut
forPulseOut
is deprecated and will be removed in 8.0.0. gamepad
is removed: usekeypad
.gamepadshift
is still present but will be removed in 8.0.0.settings.py
andsettings.txt
are no longer alternative names forboot.py
.- The default for
displayio.Display.refresh(..., minimimum_frames_per_second, ...)
is now 0. displayio.Display()
argumentset_vertical_scroll
argument is deprecated and will be removed in 8.0.0.displayio.ParallelBus
is now available asparallelbus.ParallelBus
and will be removed fromdisplayio
in 8.0.0.busio.OneWire
/bitbangio.OneWire
is now available asonewireio.OneWire
and will be removed frombusio
andbitbangio
in 8.0.0.
Known issues
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.3.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.16. Support upstream Micr...