CircuitPython 5.0.0 Beta 3
Pre-releaseThis 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.