Releases: adafruit/circuitpython
CircuitPython 5.3.0-rc.0
This is CircuitPython 5.3.0-rc0, the latest minor revision of CircuitPython, and a release candidate. If this release does not have show-stopper issues, it will be re-released as 5.3.0, the first 5.3.x stable release. This release adds support for 3 new boards, adds the RGBMatrix driver for RGB LED matrices. See below for a more detailed list.
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).
New features and improvements since 5.2.0
- Add support for RGB Matrix displays (#2706, #2775), thanks @jepler @PaintYourDragon
- Add a
fill
method todisplayio.Bitmap
(#2756), thanks @caternuson - Make the colors used by the stage library compatible with those used in the displayio library (#2777), thanks @deshipu
- Multiple improvements to the STM32 port (#2735, #2788), thanks @k0d, @hierophect
- Improvements to the litex port (#2768), thanks @xobs
- Improvements to ulab (#2767), thanks @v923z, @jepler
- Use "checkout@v2" in the circuitpython build process (#2765), thanks @jepler
- Fix the maximum keycode in keyboard HID descriptor (#2764), thanks @dhalbert
- Fix bad submodule patk (#2763), thanks @larsks
- Add the NFC Copy Cat board (#2758), thanks @sabas1080
- Use Sphinx 3 to build the documentation (#2757), thanks @sommersoft
Full commit log is here.
3 New boards since 5.2.0
- nfc_copy_cat
- nucleo_f767zi
- nucleo_h743zi_2
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4 microcontrollers. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from Circuit Playground Express Display build. - Removed
gamepad
from Circuit Playground Express Crickit build.
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @caternuson, @deshipu, @dhalbert, @heirophect, @jepler, @tannewt, @xobs, @k0d, @v923z, @larsks, @sabas1080, and surely more we have missed. 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).
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 5.2.0
5.2.0
This is CircuitPython 5.2.0, it features a new port to LiteX, a Python powered hardware description system used to define a soft System on Chip (SoC) that is then loaded into a Field Programmable Gate Array (FPGA). There are a few minor fixes and improvements over 5.1.0 as well.
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).
New features and improvements since 5.1.0
- Add LiteX port for CircuitPython on an FPGA. Thanks to @xobs.
- Add support for additional baudrates for nRF UART (including MIDI's 31250). Thanks to @billmoser
- Add support for MX25L51245G SPI Flash. Thanks to @bd34n and @ladyada
- Add
displayio
support for inverted backlights. Thanks to @siddacious and @tannewt - Add support for phase and polarity to FourWire as kwargs. Thanks to @tannewt
- Fix iMX RT UART read length. Thanks to @arturo182 and @theacodes
- Fix iMX RT neopixel timing. Thanks to @arturo182
- Fix reading pixel values from Pixelbuf. Thanks to @jepler.
- Fix
_bleio.PacketBuffer
when in server mode. Required for BLE Midi. Thanks to @tannewt
Full commit log is here.
5 New boards since 5.1.0
- Fomu Thanks to @xobs
- ThunderPack Thanks to @jgillick
- Winterbloom Big Honking Button Thanks to @theacodes
- 8086 Consultancy Commander Thanks to @burtyb
- BDMicro Vina M0 Thanks to @bd34n
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4 microcontrollers. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from Circuit Playground Express Display build. - Removed
gamepad
from Circuit Playground Express Crickit build.
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.ulab
can give erroneous results when sorting 2D arraysulab
can give erroneous results with expressions likea[a<1]
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @arturo182, @bd34n, @billmoser, @burtyb, @caternuson, @dhalbert, @dpgeorge, @hierophect, @jepler, @jgillick, @ladyada, @siddacious, @sommersoft, @tannewt, @theacodes, @xobs, and surely more we have missed. 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).
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 5.1.0
5.1.0
This is CircuitPython 5.1.0, the latest minor revision of CircuitPython and the first 5.1.x stable release. It is identical to 5.1.0-rc.0.
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).
New features and improvements since 5.0.0
- ulab, a numpy-like fast vector module (#2583 and others). Thanks @v923z, @jepler
- Perform mathematical operations 10-50x as fast as raw CircuitPython
- Enabled on almost all boards except those with samd21 microcontrollers
- Guide: https://learn.adafruit.com/ulab-crunch-numbers-fast-with-circuitpython/overview
- Support for "f-strings", a more convenient way to build strings dynamically. (#2690) Thanks @klardotsh, @jepler
- Enabled on almost all boards except those with samd21 microcontrollers.
- mpy-cross signals certain syntax errors better (#2670). Thanks @jepler
- nRF now properly handles unaligned disk reads (#2662). Thanks @jepler
- New builds of unix port and mpy-cross facilitate testing (#2672). Thanks @jepler
- STM port: add PulseOut (#2668). Thanks @hierophect
- STM port: add PulseIn (#2697). Thanks @hierophect
- STM port: fix some GPIO clocking issues (#2680). Thanks @hierophect
- STM port: rename directory to reflect the scope of the port (#2699). Thanks @hierophect
- STM port: change ST drivers submodule to match TinyUSB (#2701). Thanks @hierophect
- Winterbloom Sol: Disable USB HID descriptor (#2681). Thanks @theacodes
- Support importing native modules in native packages (#2657). Thanks @tannewt
- Document proximity and sound_level in design guide (#2684). Thanks @caternuson
- Improve argument validation in displayio (#2666). thanks @dhalbert
- Add TG-Watch02A board (#2695). Thanks @TG-Techie
- Add UARTLogger2 board (#2705). Thanks @NightSkySK
- Fix DotStar status LED init (#2712). Thanks @tannewt
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4 microcontrollers. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from Circuit Playground Express Display build. - Removed
gamepad
from Circuit Playground Express Crickit build.
2 New boards since 5.0.0
- TG-Watch02A
- UARTLogger2
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.ulab
can give erroneous results when sorting 2D arraysulab
can give erroneous results with expressions likea[a<1]
- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @dhalbert, @jepler, @hierophect, @ladyada, @TG-Techie, @theacodes, @sommersoft, @tannewt, @v923z and surely more we have missed. 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).
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 5.1.0-rc.0
5.1.0-rc.0
This is CircuitPython 5.1.0-rc0, the latest minor revision of CircuitPython, and a release candidate. If this release does not have show-stopper issues, it will be re-released as 5.1.0, the first 5.1.x 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.
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).
New features and improvements since 5.0.0
- ulab, a numpy-like fast vector module (#2583 and others). Thanks @v923z, @jepler
- Perform mathematical operations 10-50x as fast as raw CircuitPython
- Enabled on almost all boards except those with samd21 microcontrollers
- Guide: https://learn.adafruit.com/ulab-crunch-numbers-fast-with-circuitpython/overview
- Support for "f-strings", a more convenient way to build strings dynamically. (#2690) Thanks @klardotsh, @jepler
- Enabled on almost all boards except those with samd21 microcontrollers.
- mpy-cross signals certain syntax errors better (#2670). Thanks @jepler
- nRF now properly handles unaligned disk reads (#2662). Thanks @jepler
- New builds of unix port and mpy-cross facilitate testing (#2672). Thanks @jepler
- STM port: add PulseOut (#2668). Thanks @hierophect
- STM port: add PulseIn (#2697). Thanks @hierophect
- STM port: fix some GPIO clocking issues (#2680). Thanks @hierophect
- STM port: rename directory to reflect the scope of the port (#2699). Thanks @hierophect
- STM port: change ST drivers submodule to match TinyUSB (#2701). Thanks @hierophect
- Winterbloom Sol: Disable USB HID descriptor (#2681). Thanks @theacodes
- Support importing native modules in native packages (#2657). Thanks @tannewt
- Document proximity and sound_level in design guide (#2684). Thanks @caternuson
- Improve argument validation in displayio (#2666). thanks @dhalbert
- Add TG-Watch02A board (#2695). Thanks @TG-Techie
- Add UARTLogger2 board (#2705). Thanks @NightSkySK
- Fix DotStar status LED init (#2712). Thanks @tannewt
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4 microcontrollers. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from Circuit Playground Express Display build. - Removed
gamepad
from Circuit Playground Express Crickit build.
2 New boards since 5.0.0
- TG-Watch02A
- UARTLogger2
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @dhalbert, @jepler, @hierophect, @ladyada, @TG-Techie, @theacodes, @sommersoft, @tannewt, @v923z and surely more we have missed. 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).
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 5.0.0
5.0.0
This is CircuitPython 5.0.0, the latest major revision of CircuitPython, and is a new stable release.
5.0.0 features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontroller families, and PWM audio support.
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).
New features and improvements since 4.1.2
- Many improvements to
displayio
- Revamped refresh API
- Grayscale OLED support
- e-paper display support
- Groups can be hidden
- Many
_bleio
improvements- Renamed
bleio
to_bleio
to emphasize one should use the BLE library and that_bleio
's API may change without a major CircuitPython version bump - Central support
- Client support
- Pairing and bonding support
- Renamed
- Many audio fixes and improvements
- MP3 decoding support
- PWM audio out
- nRF52840 I2S support
- Mixer moved to
audiomixer
and now supports per-voice volume
- Finalized
_pixelbuf
API for RGB pixel speedups - Additional chip families with beta support:
- STM32F4
- iMX RT 10xx
- CXD56 (Sony Spresense)
- Added Korean translation
- Many translation improvements
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
51 New boards since 4.1.2
- Adafruit Bluefruit Sense
- Adafruit Circuit Playground Bluefruit
- Adafruit Circuit Playground Express with displayio
- Adafruit Clue nRF52840 Express
- Adafruit Edge Badge
- Adafruit Feather M7 1011
- Adafruit Feather STM32F405 Express
- Adafruit Itsy Bitsy nRF52840 Express
- Adafruit Metro nRF52840 Express
- Adafruit Monster M4SK
- Adafruit PyPortal Pynt
- Adafruit PyPortal Titano
- Alethea Flowers Winterbloom Sol
- ARAMCON Badge 2019
- Arduino NANO 33 BLE
- Arduino NANO 33 IoT
- arturo182 Feather MIMXRT1011
- arturo182 Feather MIMXRT1062
- arturo182 Serpente
- Cedar Grove Studios StringCar M0 Express
- Elecrow PYB Nano v2
- Espruino Pico
- Espruino WiFi
- George Robotics Pyboard
- keithp.com Snekboard
- KittenBot Meowbit
- Null Bytes Labs CircuitBrains Basic
- Null Bytes Labs CircuitBrains Deluxe
- NXP MIMXRT1010 Eval Kit
- NXP MIMXRT1020 Eval Kit
- NXP MIMXRT1060 Eval Kit
- n°Garage Ndbit6
- Oddly Specific Objects Open Book
- OSHWA Open Hardware Summit 2020 Badge
- PJRC Teensy 4.0
- Radomir Dopieralski PewPew M4
- Robot Exploration Lab PyCubed
- Robotics Masters Robo HAT MM1 M4
- Seeed Seeeduino XIAO
- Sarfata shIRtty
- Sony Spresense
- SparkFun Qwiic Micro w/o Flash
- SparkFun Qwiic Micro w/Flash
- SparkFun SAMD51 Thing Plus
- ST STM32F407 Discovery Kit
- ST STM32F411 Discovery Kit
- ST STM32F412 Discovery Kit
- Teknikio Bluebird
- TZT STM32F411CE Black Pill
- XinaBox CC03
- XinaBox CS11
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @3ach, @adafruit, @AdinAck, @aine, @albang, @alexwhittemore, @AndrewTribble, @anecdata, @anneb, @anne B, @AnthonyDiGirolamo, @Anton-2, @antonio, @ardnew, @arturo182, @ATMakersBill, @becky-lou, @bitbank Mr. Optimization, @bmeisels, @brentru, @C47D, @callmeraffiq, @CarlFK, @carternuson, @cater, @caternuson, @cbyr2401, @CedarGroveStudios, @cgrover, @charlesburnaford, @_cli_ninja, @codeNsolder, @CollinCunningham, @cr1901, @CSchmitz, @CudaCoreRoo, @curt Olson, @dalegrover, @Dar, @darkmusic, @Dar-Scott, @dastels, @davep, @DavePutz, @DavidGlaude, @dcbricetti, @ddiminnie, @deanm1278, @deshipu, @devoh, @dglaude, @dhalbert, @dherrada, @diegoMini+, @dmgrime, @dmopalmer, @dpgeorge, @DrewFustini, @DudeImOnly6, @Duewester, @dunkmann00, @dhalbert, @edspark, @fede2, @fgallaire, @FoamyGuy, @Frank.H, @gallaugher, @geekguy, @gotfredsen, @graham, @hathach, @hexthat, @hierophect, @hukuzatuna, @hybotics, @iayanpahwa, @iot49, @iraytrace, @jackdanielsmurphy, @jamesbowman, @jasonp, @jedgarpark, @jepler, @Jerryn, @jerryneedell, @JoeBakalor, @joey, @joeycastillo, @josh, @jp, @jpecor, @KalbeAbbas, @kamtom480, @kattni, @kdb424, @kevinjwalters, @kickbutts, @KingerNorth, @KittenCanaveral, @kjw, @klardotsh, @ladyada, @lgnashold, @loganwedwards, @madbodger, @maholli, @makermelissa, @marius_450, @Marius-450, @matthewnewberg, @MikeB, @MrCertainly, @mr. Certainly, @Mr-Coxall, @mscosti, @mubes, @mwelling, @mytechnotalent, @ndGarage, @n...
5.0.0 Release Candidate 1
This is a 5.0.0 Release Candidate -- please test
This is release 5.0.0-rc.1 (Release candidate 1). If this release does not have show-stopper issues, it will be re-released as 5.0.0, the first 5.x.x stable release.
If you find a bug please check the current known issues and file an issue if something isn't already known.
5.0.0
5.0.0 is the latest major revision of CircuitPython. It features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontroller families, and PWM audio support.
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).
New Features, Updates, and Fixes Since 5.0.0-rc.0
i.MX
- Fix I2C clock speed on i.MX boards. Thanks @mubes.
- Freeze
adafruit_requests
andadafruit_esp32spi
libraries into mimxrt1011 builds to save RAM. Thanks @arturo182.
Other board-specific fixes
- Arduino M0 boards now have both
.bin
and.uf2
downloads available. Thanks @dhalbert, and thanks to @fgallaire for pointing out the issue.
Build infrastructure
- Release download links available at https://circuitpython.org/downloads now point to AWS S3 instead of to GitHub release assets. Thanks @dhalbert, @jwcooper, and @sommersoft.
New Boards
Find downloads for all boards, including these, at https://circuitpython.org/downloads.
New Since 5.0.0-rc.0
None.
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.@
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @arturo182, @bmeisels, @DavePutz, @dhalbert, @fgallaire, @hierophect, @jamesbowman, @jepler, @ladyada, @lgnashold, @maholli, @makermelissa, @mubes, @neubauek, @pdp7, @rhooper, @tannewt, @ATMakersBill, @AndrewTribble, @anne B, @antonio, @cgrover, @CarlFK, @curt Olson, @Dar, @davep, @DavidGlaude, @DudeImOnly6, @Duewester, @KingerNorth, @SouthernDragon, @TG-Techie, @ThomasAtBBTF, @adafruit, @anecdata, @brentru, @cater, @charlesburnaford, @codeNSolder, @deshipu, @dherrada, @diegoMini+, @ednl, @FoamyGuy, @geekguy, @graham, @hexthat, @jasonp, @Jerryn, @kattni, @kjw, @madbodger, @marius_450, @mscosti, @ntoll, @siddacious, @sommersoft, @stargirl, @timvictor, @v923z and surely more we have missed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 5.0.0-rc.0.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
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 5.0.0 Release Candidate 0
This is a 5.0.0 Release Candidate -- please test
This is release 5.0.0-rc.0 (Release candidate 0). If this release does not have show-stopper issues, it will be re-released as 5.0.0, the first 5.x.x stable release.
If you find a bug please check the current known issues and file an issue if something isn't already known.
5.0.0
5.0.0 is the latest major revision of CircuitPython. It features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontroller families, and PWM audio support.
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.
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).
New Features, Updates, and Fixes since 5.0.0 Beta 5
General
- Speed up heap allocation by tracking first free chunk for multiple block sizes. Thanks @tannewt.
- Fix crash after empty REPL session. Thanks @tannewt.
- Fix MacOS crash when Mac wakes up with an ejected CIRCUITPY. Thanks @tannewt.
- Added draft implementation of
eveL
, the Gameduino low-level bindings. Thanks @jamesbowman. - Allow
storage.remount()
to work even if MSC is disabled. Thanks @bmeisels. time.monotonic_ns()
is now accurate to microseconds.time.sleep()
now rounds to the nearest millisecond. Thanks @dhalbert.- Include filename in "No such file/directory" error messages. Thanks @dhalbert.
- Fix
os.stat()
integer overflow on non-longint builds. Thanks @dhalbert. - Implement
to_bytes(..., signed=True)
. Thanks @dhalbert. - Support echoing of Unicode characters in REPL. Thanks @DavePutz.
- Add RTS/CTS and RS485 capabilities to
busio.UART
. Thanks @mubes.
displayio
- Update rotation so 0 is the default, making
OnDiskBitmap
much faster. Thanks @ladyada. - Allow tuple or list for
displayio.Palette
color. Thanks @dhalbert. - Fix
OnDiskBitmap
documentation. Thanks @makermelissa.
nRF and BLE
- Add cached buffer on heap for nRF
neopixel_write
. Thanks @rhooper and @dhalbert. - Add nRF SPIM3 support, allowing 32MHz SPI. Thanks @dhalbert.
- Fix using too-small SPI transactions on nRF. Thanks @dhalbert.
- Correct I2C frequency setting on nRF. Thanks @dhalbert.
- Enable
_bleio
singletonAdapter
when_bleio
is imported. Thanks @dhalbert. - Disable experimental BLE file editing service for now. Thanks @tannewt.
- Improve BLE error messages. Thanks @tannewt.
STM
- Add core temperature and voltage for STM32. Thanks @hierophect.
i.MX
- Fix SPI clock speed on iMX. Thanks @mubes.
- Fix i.MX UART initialization. Thanks @mubes.
- Enable
displayio
formimxrt10xx
boards. Thanks @arturo182. - Add directly loadable image support for i.MX. Thanks @mubes.
Other board-specific fixes
- Fix Arduino MKR Zero USB VID. Thanks @fgallaire.
- Add additional pin definitions for OHS2020 board. Thanks @pdp7.
Build infrastructure
- Add support for W25Q80DV external flash chip. Thanks @lgnashold.
- Allow CIRCUITPY drive name to be set in
mpconfigboard.h
. Thanks @mubes. - Fix a build alignment warning. Thanks @mubes.
- Fix build checks for proper flash granularity for flash erases. Thanks @dhalbert.
New Boards
Find downloads for all boards, including these, at https://circuitpython.org/downloads.
New since 5.0.0-beta.5
- SparkFun SAMD51 Thing Plus. Thanks @jepler.
- Feather M7 1011. Thanks @arturo182.
- Arduino Nano 33 IoT. Thanks @fgallaire.
- PyCubed. Thanks @maholli.
- Espruino Wifi. Thanks @hierophect.
- Espruino Pico. Thanks @hierophect.
- CircuitBrains Basic. Thanks @neubauek.
- CircuitBrains Deluxe. Thanks @neubauek.
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.@
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord, including @arturo182, @bmeisels, @DavePutz, @dhalbert, @fgallaire, @hierophect, @jamesbowman, @jepler, @ladyada, @lgnashold, @maholli, @makermelissa, @mubes, @neubauek, @pdp7, @rhooper, @tannewt, @ATMakersBill, @AndrewTribble, @anne B, @antonio, @cgrover, @CarlFK, @curt Olson, @Dar, @davep, @DavidGlaude, @DudeImOnly6, @Duewester, @KingerNorth, @SouthernDragon, @TG-Techie, @ThomasAtBBTF, @adafruit, @anecdata, @brentru, @cater, @charlesburnaford, @codeNSolder, @deshipu, @dherrada, @diegoMini+, @ednl, @FoamyGuy, @geekguy, @graham, @hexthat, @jasonp, @Jerryn, @kattni, @kjw, @madbodger, @marius_450, @mscosti, @ntoll, @siddacious, @sommersoft, @stargirl, @timvictor, @v923z and surely more we have missed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 5.0.0-beta.5.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
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 5.0.0 Beta 5
This is a Beta Release
This is release 5.0.0 beta.5. Beta releases are largely feature-complete, but are meant for testing. Use the latest stable 4.x release when first starting with CircuitPython.
When you find a bug please check the current known issues and file an issue if something isn't already known.
5.0.0
5.0.0 is the latest major revision of CircuitPython. It features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontrollers, and PWM audio support.
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.
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).
New Features, Updates, and Fixes since 5.0.0 Beta 4
- Fix BLE reinitialization on soft reload, preventing some hangs and crashes. Thanks @dhalbert.
- Increase maximum number of BLE connection from 2 to 5. Thanks @dhalbert.
- Fixed
_bleio.PacketBuffer.packet_size
returning wrong value. Thanks @dhalbert. - Most
OSError
exceptions that involve filenames will print the filenames, so you know which filename can't be found, etc. (on vfat only). Thanks @dhalbert. - Fix use and exposure of internal buffers for
PixelBuf
. Thanks @tannewt. displayio.Palette
now takes tuples and lists as color values in addition to integers. Thanks @kattni for noticing the issue and @jepler and @dhalbert for the fix.- Improve DMA for stereo
AudioOut
. Thanks @jepler. - Increase stack size on Circuit Playground Express builds to accommodate updated CP library. Thanks @dmopalmer for noticing the issue, and @kattni and @dhalbert for the fix.
- Turn off on-board user NeoPixels after soft reload on Circuit Playground Bluefruit, PyBadge, and PyGamer. Thanks @dhalbert.
- Update and improve CLUE
board
definition. Thanks @ladyada and @dhalbert. - Use hardware rotation to speed up CLUE display. Thanks @ladyada.
- Allow specifying background color for
stage
library and_stage
native module. Thanks @deshipu. - Add
gamepad
to CPX crickit and displayio builds; needed for updated CP library. Thanks @dhalbert. - Update all frozen libraries. Thanks @dhalbert.
- Update handling of bad nRF fuse setting. Thanks @dhalbert.
- Fix on-board display initialization code pin handling. Thanks @dhalbert.
- Fix compilation of native micropython on OS X. Thanks @tsupplis.
- Add automatic builds of
mpy-cross
to GitHub actions. Thanks @jepler. - Fix native module support matrix generation. Thanks @deshipu.
- Improve README documentation of differences from MicroPython. Thanks @deshipu.
New Boards
Find downloads for all boards, including these, at https://circuitpython.org/downloads.
New since 5.0.0-beta.4
- ndGarage Ndbit6. Thanks @ndGarage.
- Feather Bluefruit Sense. Thanks @ladyada.
- meowbit_v121. Thanks @hierophect.
- teensy40. Thanks @tannewt.
- imxrt1060_evk. Thanks @tannewt.
- imxrt1020_evk. Thanks @tannewt.
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
Known Issues
displayio
operations that read from an SD card (e.g.,OnDiskBitmap
) will interfere with other SD card operations and can cause lockup. To work around this problem, do not read or write files on the SD while the display is updating, and vice versa.- See https://github.com/adafruit/circuitpython/issues for other issues.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord,including @tsupplis, @timvictor, @theacodes, @tannewt, @sommersoft, @shane, @rhooper, @pdp7 (Drew Fustini), @ntoll, @ndGarage, @mr. Certainly, @makermelissa, @maholli, @madbodger, @ladyada, @kevinjwalters, @kattni, @joey, @jerryneedell, @jepler, @jasonp, @hierophect, @geekguy, @Frank.H, @FoamyGuy, @Duewester, @dherrada, @dhalbert, @deshipu, @dcbricetti, @DavidGlaude, @dastels, @Dar-Scott, @CudaCoreRoo, @codeNsolder, @cgrover, @carternuson, @callmeraffiq, @brentru, @bitbank Mr. Optimization, @becky-lou, @ATMakersBill, @arturo182, @ardnew, @anecdata, @aine, and surely more we have missed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 5.0.0-beta.4.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
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 5.0.0 Beta 4
This is a Beta Release
This is release 5.0.0 beta.4. Beta releases are largely feature-complete, but are meant for testing. Use the latest stable 4.x release when first starting with CircuitPython.
When you find a bug please check the current known issues and file an issue if something isn't already known.
5.0.0
5.0.0 is the latest major revision of CircuitPython. It features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontrollers, and PWM audio support.
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.
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).
New Features, Updates, and Fixes since 5.0.0 Beta 3
- Add BLE bonding. Thanks @dhalbert.
- Fix tuple subscripting regression. Thanks @rhooper.
- STM32: Fix I2C and clean up
busio
. Thanks @hierophect. - Make buffer handling more robust for
urandom
. Thanks to @jepler - Updates for Capable Robot USB Hub. Thanks @CapableRobot.
mimxrt1011
updates. Thanks to arturo182.- Add
Dxx
pin names to Feather M4 Express. Thanks @scs217. - Spresense: use source files instead of preocmpiled binaries for
mkspk
. Thanks @kamtom480. - Spresense: fix
board_timerhook
. Thanks @kamtom480. - Use Python 3 to run all Python scripts. Thanks @theodox.
- Fix support matrix generation. Thanks @deshipu.
- Requiring I2C pullups can now be turned off for a build. Thanks @dhalbert.
New Boards
Find downloads for all boards, including these, at https://circuitpython.org/downloads.
New since 5.0.0-beta.3
- Ohs2020 badge. Thanks @mwelling.
- Seeduino XIAO. Thanks @dalegrover
- Open Book. Thanks @joeycastillo.
- AramCon Badge 2019. Thanks @bmeisels.
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
Known Issues
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord,including @ATMakersBill, @anneb, @cgrover, @Dar-Scott, @DrewFustini, @KittenCanaveral, @TG-Techie, @arturo182, @bmeisels, @brentru, @caternuson, @codeNsolder, @CSchmitz, @dalegrover, @deshipu, @deshipu, @dglaude, @dhalbert, @dherrada, @FoamyGuy, @geekguy, @hathach, @hierophect, @hukuzatuna, @jepler, @Jerryn, @joeycastillo, @kamtom480, @kattni, @kevinjwalters, @ladyada, @madbodger, @maholli, @makermelissa, @mwelling, @nickzoic, @osterwood, @rhooper, @scs217, @siddacious, @tannewt, @theacodes, @theodox, @wallarug and surely more we have missed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 5.0.0-beta.3.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
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 5.0.0 Beta 3
This is a Beta Release
This is release 5.0.0 beta.3. Beta releases are largely feature-complete, but are meant for testing. Use the latest stable 4.x release when first starting with CircuitPython.
When you find a bug please check the current known issues and file an issue if something isn't already known.
5.0.0
5.0.0 is the latest major revision of CircuitPython. It features many improvements and enhancements to displayio
, including grayscale OLED and e-paper displays, extensive additions and improvements to BLE support, support for the STM32F4, iMX RT10xx and Sony Spresense microcontrollers, and PWM audio support.
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.
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).
New Features, Updates, and Fixes since 5.0.0 Beta 1
- Initial support for the iMX RT10xx microcontroller line from NXP. Huge thanks to @arturo182.
_pixelbuf
's API has been finalized and will speed up the DotStar and Neopixel libraries once they are updated. Huge thank you to @rhooper and @kattni.- Added
_bleio.PacketBuffer
to allow for packet oriented BLE protocols such as the Apple Media Service and BLE MIDI. Thanks to @tannewt. - File creation time on nRF now uses the RTC correctly. Thanks to @iot49.
displayio
now supports both displays on Monster M4SK. Thanks to @Marius-450audiomp3.MP3
has been namedaudiomp3.MP3Decoder
so that it makes sense with the new.file
attribute that enables decoder reuse. Thanks to @jepler- Numerous audio related fixes. Thanks to @jepler.
- Numerous USB fixes. Thanks to @hathach
- nRF UARTs are reset correctly. Thanks to @tannewt
- Added
board.VOLTAGE_MONITOR
to feather_stm32f405_express. Thanks to @jerryneedell - Correct UART pin mapping on hallowing_m4_express. Thanks to @tannewt and fnord
- The frozen HID library is now 4.0.0 on CPX and pIRkey which requires passing in a list of HID devices.
- A doc fix. Thanks to @dglaude.
New Boards
Find downloads for all boards, including these, at https://circuitpython.org/downloads.
New since 5.0.0-beta.2
- NXP iMXRT 1010-EVK. Thanks to @arturo182
- arturo182 Feather iMX RT1011. Thanks to @arturo182
- arturo182 Feather iMX RT1062. Thanks to @arturo182
- Adafruit Clue nRF52840 Express. Thanks to @dhalbert
Breaking Changes and Deprecations from 4.x
- 5.0.0 improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!
- The
bleio
module has been renamed to_bleio
to indicate that it is meant to be used only for writing BLE libraries, and that its API may change between CircuitPython minor versions. There are many incompatible changes in_bleio
since 4.0.0. Please use the latestadafruit_ble
library for end-user BLE programming. - The
displayio
refresh API has been revamped to be simpler.wait_for_frame
andrefresh_soon
have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The newauto_refresh
property andrefresh()
function can be used to control when the screen refreshes and at a specific rate. - Moved
audioio.Mixer
toaudiomixer.Mixer
, which is only available on M4s. Movedaudioio.RawSample
, andaudioio.WaveFile
to the new moduleaudiocore
. However, for backwards compatibility, they are still available inaudioio
. They will be removed fromaudioio
in 6.0.0. Thanks @jepler. - Added
I2C.writeto_then_readfrom()
. Deprecatestop=
arg which will be removed in 6.x. UseI2C.writeto_then_readfrom()
instead. - Removed
re
from CircuitPlayground Express Display build. - Removed
gamepad
from CircuitPlayground Express Crickit build.
Known Issues
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord,including @albang, @arturo182, @cbyr2401, @CedarGroveStudios, @Dar-Scott, @deshipu, @dglaude, @dhalbert, @dmgrime, @dpgeorge, @gotfredsen, @hathach, @hexthat, @hierophect, @iayanpahwa, @iot49, @jepler, @Jerryn, @JoeBakalor, @KalbeAbbas, @kattni, @ladyada, @makermelissa, @Marius-450, @rafa-gould, @rhooper, @sarfata, @tannewt, @theacodes, @urish, @wallarug and surely more we have missed. Join us on the Discord chat to collaborate.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 5.0.0-beta.2.
This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
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.