Releases: adafruit/circuitpython
CircuitPython 6.1.0 Release Candidate 0
This is the first release candidate of CircuitPython 6.1.0. See Port status below for details on port stability, and Known Issues for known problems. If you find any issues with this release, please file an issue. If no issues are found within a few days, we'll release this version as stable.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
New features and improvements since 6.1.0 Beta 3
Fixes and enhancements
- Fix initialization of onboard NeoPixels. #3934. Thanks @DavePutz.
- Update
ulab
to 1.6.0. #3929. Thanks @jepler. - Fix handling of zero brightness in
_pixelbuf
. #3917. Thanks @brrzap.
Board- and port-specific changes
- CPX: Add back frozen
adafruit_bus_device
back to CPX. #3932. Thanks @kattni. - UnexpectedMaker FeatherS2: Correct pins and add default
board
devices. #3925, #3914. Thanks @UnexpectedMaker , @askpatrickw. - ESP32S2: Add
alarm.touch.TouchAlarm
. #3850. Thanks @microdev1. - Mini SAM 4: Freeze in
adafruit_dotstar
library. #3923. Thanks @bwshockley.
Documentation
- Translation additions and improvements. Thanks:
Full commit log is here.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use
busio.I2C
to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt _bleio.ConnectionError
has be removed. Code will now raise the nativeConnectionError
instead.
New boards since 6.1.0 Beta 3
(none)
Known issues
- ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2 (#3846)
time.sleep()
sometimes hangs when a board is connected to certain Macintosh hosts (#3918, #3919). This issue is also present in 6.0.x.- Built-in
adafruit_bus_device
has been disabled due to issues (#3859, #3856), please install the version from the Library Bundle - See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.1.0 Beta 3, including @askpatrickw, @bergdahl, @brrzap, @bwshockley, @DavePutz, @dglaude, @dhalbert, @hugodahl, @jepler, @kattni, @ladyada, @microdev1, @oonid, @tannewt, @UnexpectedMaker, @wtuemurua, and many others on Discord. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.1.0 Beta 3
This is the Beta 3 release of CircuitPython 6.1. Please use 6.0.x if you need a stable version of CircuitPython on all ports except ESP32-S2. Please use this release or newer for the ESP32-S2. See port status
below for more stability details.
Notable in this release are a number of ESP32-S2 additions and fixes, bringing us closer to a stable release for that port. There are 2 new boards and one new board revision included in this release.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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. For all unstable ports, please use the latest pre-release.
New features and improvements since 6.1.0-beta.2
All ports
- Make ResetReason and RunReason available (#3797), thanks @dhalbert
- Add
board_deinit
for use with sleep (#3807), thanks @tannewt - Fix some spelling mistakes (#3814), trhanks @mcauser
- Use
$(PYTHON3) instead of $ (PYTHON) in make actions (#3815), thanks @dhalbert - add apt-get update (#3818), thanks @dhalbert
- #3702 breaks printing an exception twice (#3711), thanks @cwalther
- build: Update to gcc10 for ARM targets (#3752), thanks @dhalbert, @jepler
- Update capacity of MX25R1635F flash chip in devices.h (#3838), thanks @StackRduino
- adafruit_bus_device: Don't transmit STOP condition in write_then_readinto (#3847), thanks @jepler
- Adding Support for AT25DF641A SPI Flash (#3824), thanks @skerr92
- displayio: Fix transparency and palettes of OnDiskBitmaps (#3834), thanks @jepler
- Add Adafruit to MICROPY_HW_BOARD_NAME for various boards (#3863), thanks @dhalbert
- Add support for Winbond W25Q64FV (#3864), thanks @djix123
- unmounted filesystems start as ejected (#3862), thanks @dhalbert
- circuitpy_mpconfig.mk: Unconditionally disable CIRCUITPY_BUSDEVICE (#3869), thanks @jepler
- Merge ble-fixes from 6.0.x to main (#3874), thanks @dhalbert
- Re-Arrange CI Actions (#3881), thanks @microdev1
- FIX : common_hal_reset_pin() (#3888), thanks @microdev1
- Restore frozen adafruit_bus_device module (#3900) thanks @jepler
- update frozen libs for 6.1.0-beta.3 (#3905) thanks @dhalbert
ESP32-S2
- allow radio.enabled to be settable (#3790), thanks @dhalbert
- Include wifi.radio singleton in gc (#3799), thanks @dhalbert
- Enhance debug log for wifi scan, sta_start, sta_stop (#3800), thanks @BennyE
- esp32-s2: wifi enhancement to include countrycode (#3868), thanks @BennyE
- esp32s2: make flash: use the stub (#3866), thanks @jepler
- ESP32-S2: Remove calloc in AnalogIn (#3810), thanks @dhalbert
- Store safe mode state in the RTC (#3802), thanks @dhalbert
- ESP32S2: Fix microcontroller.reset() (#3804), thanks @microdev1
- ESP32-S2: Add IDF pin resets to Microcontroller (#3643), thanks @hierophect
- Fix crash after calling stop_scanning_networks() (#3819), thanks @BennyE
- esp32s2: Reserve UART pins only if DEBUG=1 is set to address issue 3811 (#3817), thanks @BennyE
- alarm.sleep_memory + alarm.wake_alarm (#3816), thanks @dhalbert
- I2C bugfixes (#3803), thanks @skieast
- Add pin alarming (#3830), thanks @tannewt
- Enter safe mode after panic or brownout (#3808), thanks @tannewt
- Support for dual bank update on ESP32-S2 (#3812), thanks @microdev1
- Support for Touch Alarm (#3850), thanks @microdev1
- Fix minor typo in ESP32-S2 README (#3896), thanks @hugodahl
SAMD21 ("M0")
SAMD51 ("M4")
- SAMD51: change of DAC power setting (#3880), thanks @digixx
- FrequencyIn: do not raise in interrupt handler (#3867), thanks @dhalbert
AirLift
STM
Translations
- Translations update from Weblate (#3792, #3828, #3832, #3860), thanks @vkuthan, @wtuemura, @bergdahl, @Anton-2, @ryevertigo, @hugodahl
fomu
New boards
- Update Big Honking Button configuration to support its newest board revision. (#3820), thanks @theacodes
- Add new board BastBLE (#3662), thanks @Soulkrown
- add stackrduino_m0_pro (#3842), thanks @StackRduino
Known issues
- ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2 (#3846)
- Built-in adafruit_bus_device has been disabled due to issues (#3859, #3856), please install the version from the Bundle
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to @Anton-2, @BennyE, @bergdahl, @cwalther, @deshipu, @dhalbert, @digixx, @djix123, @hierophect, @hugodahl, @jepler, @mcauser, @microdev1, @ryevertigo, @skerr92, @skieast, @StackRduino, @tannewt, @vkuthan, @wtuemura, @xobs, and all who used, tested, and contributed since 6.1.0-beta.2. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.0.1
This is CircuitPython 6.0.1, the second 6.0.x stable release. This release fixes regressions in BLE and FrequencyIn()
that prevent these functions from operating properly. The release also includes a considerable speedup in JSON parsing.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release. (If you see the unstable release 6.0.0-rc.2 when you browse circuitpython.org, that release is older. Use this one.)
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
Fixes and improvements since 6.0.0
- _bleio:
Characteristic
andDescriptor
max_lengths can be zero. Better argument validation for
start_scan()and
start_advertising()`. #3861. Thanks @dhalbert. frequencyio.FrequencyIn()
caused a crash. #3867. Thanks @dhalbert.json
: Speed up parsing dramatically. #3728. Thanks @tannewt.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of
busio.I2C
andboard.I2C()
is now 100khz, not 400khz as before. Usebusio.I2C
to set the speed explicitly. _bleio.ConnectionError
has been removed. Code will now raise the nativeConnectionError
instead.- Removed
Mixer
,RawSample
, andWaveFile
fromaudioio
. They are now only available inaudiocore
. 5.x has them in both modules.
New boards since 5.3.1 (38 boards)
- Adafruit BLM Badge
- Adafruit Feather M4 CAN
- Adafruit Matrix Portal M4
- Adafruit Metro ESP32S2
- Adafruit Metro M7 1011
- Adafruit QT Py
- Adafruit QT Py Haxpress
- AloriumTech Evo M51
- Atmel SAME54 Xplained
- BDMicro Vina D51
- BH Dynamics DynOSSAT-EDU-EPS
- BH Dynamics DynOSSAT-EDU-OBC
- BLE-SS Dev Board Multi Sensor
- Electronic Cats Bastwifi
- Espressif Saola 1 w/WROOM
- Espressif Saola 1 w/WROVER
- Fluff M0
- HiiBot BlueFi
- Ikigaisense Vita nRF52840
- Loc Ber M4
- MakerDiary M60 Keyboard
- MakerDiary nRF52840 M.2 devkit
- Makerdairy Pitaya Go
- Muselab nano ESP32-S2
- Nice Nano
- Nordic PCA10100
- OpenMV H7
- Picoplanet
- PyCubed MRAM
- Raytac MDBT50Q-DB-40
- STM32F746 Discovery
- STM32F746 Nucleo
- Seeeduino Wio Terminal
- Simmel
- Teensy 4.1
- TinkeringTech ScountMakes
- UnexpectedMaker FeatherS2
- microDev microS2 (ESP32-S2)
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 to this bug fix release: @catequalsgood, @cls22, @d-c-d, @dhalbert, @jepler, @kevinjwalters, @ladyada, @tannewt. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.1.0 Beta 2
This is the Beta 2 release of CircuitPython. Please use 6.0.x if you need a stable version of CircuitPython on all ports except ESP32-S2. Please use this release or newer for the ESP32-S2. See port status
below for more stability details.
Notable in this release are a number of ESP32-S2 additions and fixes, including UDP, AnalogOut
, and deep sleep.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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. For all unstable ports, please use the latest pre-release.
New features and improvements since 6.1.0-beta.1
All ports
- Implemented
adafruit_bus_device
as a native module. Included on builds for which it will fit. #3612. Thanks @gamblor21. - Added
microcontroller.reset_reason
andsupervisor.run_reason
. #3767. Initialalarm
sleep support (implemented for ESP32-S2 only). Thanks @dhalbert. - Add moveable supervisor allocations. #3695. Thanks @cwalther.
- Fix README typos. #3766. Thanks @ehershey.
- Fix
displayio.ColorConverter
make_
methods. #3760. Thanks @arturo182. - Fix EVE
VertexFormat()
opcode bug. #3757. Thanks @jamesbowman - Speed up
readinto
JSON parsing. #3728. Thanks @tannewt. - Update
ulab
to 1.1.0. #3694. Thanks @jepler. EPaperDisplay
: add rotation property. #3718. Thanks @jepler.- Prevent tracebacks from accumulating in REPL. #3702. Thanks @tannewt.
ESP32-S2
- Use
nina-fw
root certificates, for consistency. #3775. Thanks @tannewt. - Add two-minute fallback timeout on
recv
. Do not throwBrokenPipeError
forsocketpool
recv
. #3776. Thanks @tannewt. - Disallow concurrent tasks during flash erase. #3780. Thanks @tannewt.
- Added light sleep and deep sleep support for time-based alarms. Still to come: pin alarms. #3767. Thanks @dhalbert.
- Fix simultaneous use of touchpads. #3738. Thanks @microdev1.
- UDP support. #3708. Thanks @hierophect.
- Update wifi doc. #3758. Thanks @tannewt.
- Fix pin claiming bugs. #3754. Thanks @hierophect.
- Exit faster on
recv
when TLS connection closed. #3759. Thanks @tannewt. - TinyUSB fix for CDC connection race. #3741. Thanks @hathach.
- Support for
ps2io
. #3714. Thanks @microdev1. - Support for
AnalogOut
#3514. Thanks @hierophect. - Retry connection when getting
NOT_AUTHED
. #3720. Thanks @tannewt. - Support for
frequencyio
. #3704. Thanks @microdev1. - Update pin names from silk. #3745. Thanks @kattni.
- Do full WiFi scan when channel and BSSID are not given. #3727. Thanks @BennyE.
- Fix
common_hal_mcu_delay_us()
. #3740. Thanks @dhalbert.
SAMD21 ("M0")
AirLift
Translations
- Portugese updates. #3774, #3756. #@wtuemera
- Swedish updates. #3774, #3734. Thanks @bergdahl.
- Czech updates. #3744. Thanks @vkuthan.
- German updates. #3764. Thanks @danybd.
- Spanish updates. #3764. Thanks @danybd, @begeistert.
- Japanese updates #3764, #3756. Thanks @sporeball, @aoyamaprod.
- French updates. #3756, #734. Thanks @Anton-2, @Edrig.
New boards
Known issues
- ESP32-S2:
import wifi
interferes with I2C. #3743. - See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to @Anton-2, @aoyamaprod, @arturo182, @begeistert, @BennyE, @bergdahl, @brentru, @danybd, @d-c-d, @dhalbert, @Edrig, @ehershey, @gamblor21, @hathach, @hierophect, @jamesbowman, @jepler, @jgillick, @kattni, @ladyada, @microdev1, @skerr92, @sommersoft, @sporeball, @tannewt, @vkuthan, @weblate, @wtuemura and all who used, tested, and contributed since 6.1.0-beta.1. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.1.0 Beta 1
This is the second beta release of 6.1.0. (This first was broken.) It includes many changes that were done while 6.0.0 release candidates were in pre-release. Please use 6.0.x if you need a stable version of CircuitPython on all ports except ESP32-S2. Please use this release or newer for the ESP32-S2. See port status
below for more stability details.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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. For all unstable ports, please use the latest pre-release.
New features and improvements since 6.0.0
All ports
- Added grayscale E-Ink support. (IL0373 control chip.) Thanks to @tannewt
- Added support for transparent_color support in ColorConverter. Allows transparency with full color bitmaps. Thanks to @jensechu
- Fix accumulating tracebacks in REPL. Thanks to @DavePutz
- Luma computation for grayscale conversion corrected. Thanks to @tannewt
- Fixed unhiding a TileGrid. Thanks to @FoamyGuy
- Fixed sharp memory display memory error. Thanks to @jepler
- Added native
binascii
to most boards. Thanks to @dhalbert - README typo fix. Thanks to @ehagerty
- Stub (.pyi) fixes and CI check added. Thanks to @sw23
- Translation updates for French, Portuguese (Brazil), and Swedish. Thanks to @bergdahl, @Edrig, @hexthat, @jepler, and @wtuemura.
ESP32-S2
- Fix TLS certificate errors when root certificate is signed by SHA-1. (Fixes io.adafruit.com and others.) Thanks to @jepler, @tannewt and @BennyE
time.sleep()
can now be interrupted by CTRL-C. Thanks to @DavePutztouchio
,rotaryio
,watchdog
, andcountio
support added. Thanks to @microdev1canio
support added. Thanks to @jepler- Added more
Network
parameters. Thanks to @astrobokonon - Fix I2C crashing. Thanks to @jepler
- Fixed brief AP mode when starting wifi. Thanks to @BennyE
- Fixed stack size. Thanks to @jepler
- Fixed
Socket.recv
behavior to return available bytes immediately when fewer than requested. Thanks to @tannewt - Fixed concurrent NeoPixel strip use. Thanks to @hierophect and @ladyada
- Fixed wifi reset. Thanks to @astrobokonon
- Add
recv_into
argument size check. Thanks to @gamblor21 - Added native display init for MagTag eInk display. Thanks to @tannewt and @ladyada
- Fixed SCL and SDA pins for UnexpectedMaker FeatherS2. Thanks to @askpatrickw
- Add default SPI, UART and I2C busses for UnexpectedMaker FeatherS2 and microS2. Thanks to @FoamyGuy and @microdev1
- Added IO pin naming to Metro ESP32-S2. Thanks to @kattni and @ladyada
- ESP32-S2 README improvements. Thanks to @hierophect
See the 6.0.0 release notes for breaking changes since 5.x.
New boards since 6.0.0
- Adafruit MagTag Thanks to @tannewt
- Targett Module Clip WROOM Thanks to @Targett363
- Targett Module Clip WROVER Thanks to @Targett363
- AtelierDuMaker Breakout NRF52840 v1 Thanks to @Edrig
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.0.0. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.1.0 Beta 0
We only released beta 0 to GitHub because it had a severe bug. It was never on the website or blog. So, please see Beta 1 for full details.
CircuitPython 6.0.0
This is CircuitPython 6.0.0, the latest major revision of CircuitPython, and is a new stable release.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release. (If you see the unstable release 6.0.0-rc.2 when you browse circuitpython.org, that release is older. Use this one.)
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
Major new features and improvements since 5.x
- New port to ESP32-S2 chip.
RGBMatrix
display support.countio
module to count pulses.watchdog
controls hardware watchdog timer. Only on certain ports.vectorio
provides nativedisplayio
shapes.canio
provides support for CAN bus operations._bleio
adds support for HCI-based BLE co-processors, such as AirLift boards.aesio
provides support for AES computations.async/await
made available by default in many builds; support improved.- Network modules are revamped, adding
wifi
,socketpool
,ssl
, and other modules. Disabledsocket
,wiznet5k
andnetwork
modules. They will be removed in 7.x in favor of networking libraries. - Updated
stage
andpew
libraries. _pixelbuf
improvements.- Improved USB serial detection.
json
can now read from stream objects.pulseio.PWMOut
is split out intopwmio.PWMOut
. It is still available inpulseio
, but that is deprecated and will be removed in 7.x.- Added
memorymonitor
for memory debugging. It is not enabled by default. - Reduced power consumption (light sleep) during
time.sleep()
when possible.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of
busio.I2C
andboard.I2C()
is now 100khz, not 400khz as before. Usebusio.I2C
to set the speed explicitly. _bleio.ConnectionError
has been removed. Code will now raise the nativeConnectionError
instead.- Removed
Mixer
,RawSample
, andWaveFile
fromaudioio
. They are now only available inaudiocore
. 5.x has them in both modules.
New boards since 5.3.1 (38 boards)
- Adafruit BLM Badge
- Adafruit Feather M4 CAN
- Adafruit Matrix Portal M4
- Adafruit Metro ESP32S2
- Adafruit Metro M7 1011
- Adafruit QT Py
- Adafruit QT Py Haxpress
- AloriumTech Evo M51
- Atmel SAME54 Xplained
- BDMicro Vina D51
- BH Dynamics DynOSSAT-EDU-EPS
- BH Dynamics DynOSSAT-EDU-OBC
- BLE-SS Dev Board Multi Sensor
- Electronic Cats Bastwifi
- Espressif Saola 1 w/WROOM
- Espressif Saola 1 w/WROVER
- Fluff M0
- HiiBot BlueFi
- Ikigaisense Vita nRF52840
- Loc Ber M4
- MakerDiary M60 Keyboard
- MakerDiary nRF52840 M.2 devkit
- Makerdairy Pitaya Go
- Muselab nano ESP32-S2
- Nice Nano
- Nordic PCA10100
- OpenMV H7
- Picoplanet
- PyCubed MRAM
- Raytac MDBT50Q-DB-40
- STM32F746 Discovery
- STM32F746 Nucleo
- Seeeduino Wio Terminal
- Simmel
- Teensy 4.1
- TinkeringTech ScountMakes
- UnexpectedMaker FeatherS2
- microDev microS2 (ESP32-S2)
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 5.3.1. See the 5.4.0 and 6.0.0 alpha, beta and RC releases for all who contributed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.0.0 Release Candidate 2
This is the third release candidate of CircuitPython 6.0.0. We don't know of any stability issues overall. See port status
below for more stability detail. If you find any issues with it, please file an issue. If no issues are found in the near future, we'll release this version as stable.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
New features and improvements since 6.0.0 Release Candidate 0
Full commit log is here.
Fixes and enhancements
RGBMatrix
: validate bit-depth argument in constructor (#3661). Thanks @aocole for the issue, @jepler for the fix, and @FoamyGuy for testing.- Update
protomatter
library, used forRGBMatrix
(#3666). Thanks @maxmckinney for the issue, @jepler for the fix.
Board- and port-specific changes
- Nothing in this release.
Documentation
- No changes in this release.
Internals and build process
- No changes in this release.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use
busio.I2C
to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt _bleio.ConnectionError
has been removed. Code will now raise the nativeConnectionError
instead.
New boards since 6.0.0-rc.1
- No new boards in this release.
Known issues
- No 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.0.0 Release Candidate 1, including @jepler, @aocole, @FoamyGuy, @tannewt, @maxmckinney, and many more on Discord. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.0.0 Release Candidate 1
This is the second release candidate of CircuitPython 6.0.0. We don't know of any stability issues overall. See port status
below for more stability detail. If you find any issues with it, please file an issue. If no issues are found within a week or so, we'll release this version as stable.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
New features and improvements since 6.0.0 Release Candidate 0
Fixes and enhancements
- USB serial detection improved. Fixes REPL not available after host computer sleeps, and
supervisor.runtime.serial_available
is more accurate now (#3624). Thanks @dhalbert. board.I2C()
andboard.SPI()
now can be de-inited and re-inited safely, and their lifetimes are correct in the presence of displays (#3603). Thanks @cwalther.ulab
is updated to 0.54.5 (#3602). Thanks @jepler.
Board- and port-specific changes
- Feather M4 CAN: revised pins (#3636). Thanks @ladyada and @dhalbert.
analogio
is restored to the M0 RFM boards, due to increased space available (#3603). Thanks @jerryneedell.- MatrixPortal ESP32 TX and RX pins were reversed (#3618). Thanks @dhalbert.
- CPB SPI pin mappings were not correct (#3590). Thanks @jerryneedell.
- MatrixPortal: Fix which pins not to reset (#3574). Thanks @tannewt.
Documentation
- No changes in this release.
Internals and build process
Full commit log is here.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use
busio.I2C
to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt _bleio.ConnectionError
has be removed. Code will now raise the nativeConnectionError
instead.
New boards since 6.0.0-rc.0
- No new boards in this release.
Known issues
- Nothing major.
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.0.0 Release Candidate 0, including @cwalther, @dhalbert, @jepler, @jerryneedell, @ladyada, @makermelissa, @tannewt, and many more on Discord. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.
CircuitPython 6.0.0 Release Candidate 0
This is the first release candidate of CircuitPython 6.0.0. We don't know of any stability issues overall. See port status
below for more stability detail. If you find any issues with it, please file an issue. If no issues are found within a week or so, we'll release this version as stable.
Download from circuitpython.org
Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.
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 implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd
, nrf
, and stm
for the F4 family are stable. cxd56
, esp32s2
, and stm
for other chip families are 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.
New features and improvements since 6.0.0 Beta 2
Fixes and enhancements
- Enable
async
andawait
keywords and adds__await__
support. Thanks to @warriorofwire - Add ESP32-S2
analogio
support. Thanks to @hierophect - Add
canio
support to the STM32F405 boards. Thanks to @jepler - The HCI version of
_bleio
is available on many non-nRF boards (nRF is not included since it already has native BLE). Thanks to @dhalbert - Fix display memory bugs. Thanks to @jepler and @cwalther
Board- and port-specific changes
- Add ability to set hostname to ESP32-S2. Thanks to @askpatrickw, @microdev1, @UnexpectedMaker
- Fix STM sleep timing. Thanks to @tannewt, @FoamyGuy, @DavePutz
- Fix STM time keeping that lead to unnecessary I2C timeouts. Thanks to @tannewt, @jepler, @FoamyGuy, @eLEcTRiCZiTy, @mdroberts1243, @DavePutz, @hierophect
- Fix SAMD21 auto-reload issue. Thanks to @tannewt
- Fix SAMD21 timing issue causing flickering on the pew. Thanks to @tannewt, @deshipu, @cwalther, @DavePutz, @jepler
- Fix RGB Matrix crash when brightness is set to zero. Thanks to @jepler
- Rework the flash config for iMX RT boards and enable the DCache (but disable caching for the OCRAM.) Thanks to @tannewt
- Update to the latest ESP-IDF from Espressif. Thanks to @hierophect
Documentation
- Numerous translation additions and improvements. Thanks:
Full commit log is here.
Breaking changes since 5.x
i2cslave
is nowi2cperipheral
and the class in it is changed as well.- The
stop
kwarg has been removed fromI2C.writeto()
. If no stop is desired, then usewriteto_then_readfrom
. - The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use
busio.I2C
to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt _bleio.ConnectionError
has be removed. Code will now raise the nativeConnectionError
instead.
New boards since 6.0.0 Beta 2
- BDMicro Vina D51 Thanks to @bd34n and @ladyada
- BH Dynamics DynOSSAT-EDU-EPS Thanks to @ecasadod
- BH Dynamics DynOSSAT-EDU-OBC Thanks to @ecasadod
- Adafruit Metro M7 1011 Thanks to @tannewt and @ladyada
Known issues
- Nothing major.
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, and contributed since 6.0.0 Beta 2, including @askpatrickw, @bergdahl, @bh34n, @caternuson, @cwalther, @DavePutz, @deshipu, @dhalbert, @dherrada, @ecasadod, @Edrig, @eLEcTRiCZiTy, @FoamyGuy, @hexthat, @hierophect, @jepler, @ladyada, @mdroberts1243, @microdev1, @oonid, @tannewt, @UnexpectedMaker, @warriorofwire, @wtuemura and many more on Discord. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.
Translations
One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!
Troubleshooting
Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.
Assets
Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.