Skip to content

Releases: adafruit/circuitpython

CircuitPython 5.1.0-rc.0

26 Mar 14:42
@jepler jepler
5.1.0-rc.0
4603c6d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.1.0-rc.0 Pre-release
Pre-release

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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4 microcontrollers. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0

02 Mar 23:02
@dhalbert dhalbert
5.0.0
ba0c14f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
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
  • 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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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

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...

Read more
Assets 2
Loading

5.0.0 Release Candidate 1

01 Mar 21:15
@dhalbert dhalbert
5.0.0-rc.1
ba0c14f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
5.0.0 Release Candidate 1 Pre-release
Pre-release

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 and adafruit_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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0 Release Candidate 0

26 Feb 19:40
@dhalbert dhalbert
5.0.0-rc.0
1b33cd1
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Release Candidate 0 Pre-release
Pre-release

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 singleton Adapter 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 for mimxrt10xx 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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0 Beta 5

05 Feb 02:24
@dhalbert dhalbert
5.0.0-beta.5
433671f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Beta 5 Pre-release
Pre-release

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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0 Beta 4

22 Jan 02:59
@dhalbert dhalbert
5.0.0-beta.4
f99157b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Beta 4 Pre-release
Pre-release

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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0 Beta 3

08 Jan 21:17
@tannewt tannewt
5.0.0-beta.3
a10cd85
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Beta 3 Pre-release
Pre-release

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-450
  • audiomp3.MP3 has been named audiomp3.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

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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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.

Assets 2
Loading

CircuitPython 5.0.0 Beta 2

20 Dec 20:59
@tannewt tannewt
5.0.0-beta.2
e6fd513
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Beta 2 Pre-release
Pre-release

Backup your files before updating!!!

This is a Beta Release

This is release 5.0.0 beta.2. It improves our internal filesystem definitions and may overwrite your existing files so make sure to back them up before updating!

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 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

New Boards

Find downloads for all boards, including these, at https://circuitpython.org/downloads.

New since 5.0.0-beta.1

Breaking Changes and Deprecations from 4.x

  • 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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.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, @cbyr2401, @CedarGroveStudios, @Dar-Scott, @dhalbert, @dmgrime, @dpgeorge, @gotfredsen, @hathach, @hexthat, @hierophect, @iayanpahwa, @jepler, @Jerryn, @JoeBakalor, @KalbeAbbas, @kattni, @ladyada, @makermelissa, @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.1.

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.

Assets 2
Loading

Update for new Circuit Playground lib; fix PyRuler RGB LED; fix nrf PWMOut.deinit()

18 Dec 21:28
@dhalbert dhalbert
4.1.2
483a6a9
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Update for new Circuit Playground lib; fix PyRuler RGB LED; fix nrf PWMOut.deinit()

4.1.2 is a minor stable release. Most notably, it updates the adafruit_circuitplayground frozen library for Circuit Playground Express. It shouldn't break any code compatible with previous 4.x releases. If you don't have a Circuit Playground Express or a PyRuler, or a board with frozen libraries, there is no strong reason to update to 4.1.2.

Download it now from circuitpython.org. See here for the full release notes.

(In case you're wondering, release 4.1.1 was built incorrectly and was deleted.)

Over 60 boards are now supported by CircuitPython 4.1.2. Check out the new circuitpython.org/downloads page for full list of all available versions.

Contribute to CircuitPython! Check out this guide for details. Subscribe to the Python for Microcontrollers newsletter on adafruitdaily.com for the latest news for all things Python.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier 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 Fixes and Features since 4.1.0

  • On Circuit Playground Express (CPX) builds, the frozen-in adafruit_circuitplayground library now supports:
    from adafruit_circuitplayground import cp
    in addition to the previous standard import:
    from adafruit_circuitplayground.express import cpx
    This allows uniform library support for the the Circuit Playground Bluefruit (which requires CircuitPython 5.x). The library examples have all been updated to use cp instead of cpx. The names cp and cpx can be used identically: only the import is different. You do not need to change your existing code. Thanks @kattni.
  • The stack size on CPX builds has been increased slightly to accommodate the restructured library. Thanks @dhalbert and @jepler.
  • Other frozen libraries have been updated to their latest versions. Thanks @dhalbert.
  • The PyRuler now displays correct colors on its on-board DotStar RGB LED. Thanks @dhalbert.
  • PWMOut.deinit() on nrf builds was now releases the pin. Thanks @jepler.
  • The library freezing process now makes sure not to include subdirectories of excluded directories. Thanks @jepler.
  • Translated messages are now compressed more effectively, preventing certain translated builds from being too large. Thanks @jepler.

Thanks

Thank you to all who contributed and tested to this release: @dhalbert, @jepler, @kattni, @ladyada, @tannewt.
Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

Here are all the changes since 4.1.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 trouble, then post to the Adafruit Support Forums and join Discord.

Assets 794
Loading

CircuitPython 5.0.0 Beta 1

10 Dec 22:43
@tannewt tannewt
5.0.0-beta.1
024ba97
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 5.0.0 Beta 1 Pre-release
Pre-release

This is a Beta Release

This is release 5.0.0 beta.1. 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 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 0

  • Add MP3 playback support and audio improvements. Thanks to @jepler, @urish, @Dar-Scott
  • Various BLE fixes and improvements including pairing support, raising specific BluetoothErrors and extended advertisements. Thanks to @kattni, @tannewt and @dhalbert
  • Filesystem creation now includes code.py. Thanks to @iayanpahwa
  • Added Korean translation thanks to @rafa-gould and @jepler
  • Additional Chinese Pinyin translations. Thanks to @hexthat
  • The @micropython.native decorator will no longer throw an exception when it isn't supported. It will fallback to using byte code. Thanks to @theacodes
  • Fixed displayio ePaper support that lead to displays not updating. Thanks to @tannewt
  • Fixed displayio support in STM32F4. Thanks to @hierophect
  • Fixed UART blocking behavior on SAMD. Thanks to @dhalbert
  • Fixed crash from attempt at long living frozen code. Thanks to @dmgrime
  • Removed Robo Hat MM1 M0 board. Thanks to @wallarug
  • Switched to GCC 9 for builds. Thanks to @jepler

New Boards

Find downloads for all boards, including these, at https://circuitpython.org/downloads.

New since 5.0.0-beta.0

Breaking Changes and Deprecations from 4.x

  • 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 latest adafruit_ble library for end-user BLE programming.
  • The displayio refresh API has been revamped to be simpler. wait_for_frame and refresh_soon have been removed. In both 4.x and 5.x, auto refresh will automatically refresh the display so they can be removed. The new auto_refresh property and refresh() function can be used to control when the screen refreshes and at a specific rate.
  • Moved audioio.Mixer to audiomixer.Mixer, which is only available on M4s. Moved audioio.RawSample, and audioio.WaveFile to the new module audiocore. However, for backwards compatibility, they are still available in audioio. They will be removed from audioio in 6.0.0. Thanks @jepler.
  • Added I2C.writeto_then_readfrom(). Deprecate stop= arg which will be removed in 6.x. Use I2C.writeto_then_readfrom() instead.

Known Issues

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord,including @cbyr2401, @CedarGroveStudios, @Dar-Scott, @dhalbert, @dmgrime, @hexthat, @hierophect, @iayanpahwa, @jepler, @Jerryn, @kattni, @ladyada, @makermelissa, @rafa-gould, @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.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.

Assets 2
Loading