Skip to content

Releases: adafruit/circuitpython

CircuitPython 6.0.0 Beta 0

21 Sep 19:21
@dhalbert dhalbert
6.0.0-beta.0
df067b4
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 6.0.0 Beta 0 Pre-release
Pre-release

This is the initial beta release of CircuitPython 6.0.0. It is relatively stable. The most notable additions since 5.3.x are basic lower power support when in time.sleep(), initial ESP32-S2 support, including WiFi, and and _bleio HCI support for ESP32 co-processors. The lower power work changed time keeping and may have introduced bugs. Please use 5.3.x if you need a stable version of CircuitPython.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

Installation

To install follow the instructions in our new Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.

Try the latest version of the Mu editor for creating and editing your CircuitPython programs and for easy access to the CircuitPython serial connection (the REPL).

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, and stm for other chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

New features and improvements since 6.0.0 Alpha 3

API changes and additions

  • Revamp network API, adding wifi, socketpool, ssl, and other modules (#3326, #3397). Thanks @tannewt.
  • Implement _bleio for HCI Bluetooth adapters (#3310). Note that this supports peripheral mode only right now. Thanks @dhalbert.
  • Add usb_hid.Device.last_received_report to receive HID OUT (from host) reports (#3302). Thanks @xiongyihui.
  • Implement .bit_length() and 3-argument pow(), needed for a port of Decimal (#3377). Thanks @jepler.
  • display.refresh() will force an immediate redraw (#3366). Thanks @kmatch98.
  • supervisor.runtime.serial_connected is now more accurate, and can detect both disconnect and reconnect (#3437). Thanks @jepler.

Fixes and enhancements

  • struct: improve compliance with CPython (#3404). Thanks @jepler.
  • Implement improved message compression scheme (#3398). Thanks @ciscorn and @jepler.
  • Add bigram message compression (#3370, superseded by #3370). Thanks @jepler.
  • Fix I2C-related displayio crashes (#3392). Thanks @hierophect.
  • Fix decompression of certain Unicode values (#3385). Thanks @jepler.
  • Make sure board.SPI() is unlocked after a soft reboot (#3378). Thanks @DavePutz.
  • Guard against NO_PIN pin numbers being passed to various routines (#3375). Thanks @DavePutz.
  • Add dirty Rectangle tracking to displayio.Shape (#3374). Thanks @kmatch98.
  • Fix several RGBMatrix and FrameBufferDisplay bugs (#3344). Thanks @jepler.
  • Clean up a conditionally compiled part of the code for sdioio (#3435). Thanks @jepler.

Board- and port-specific changes

  • ESP32-S2:
  • Feather M4 Express was using dual-mode QSPI instead of quad-mode (#3399). Thanks @jepler.
  • Feather M0 RFM69: Freeze libraries into build (#3388). Thanks @jerryneedell.
  • Add SAME51 support to atmel-samd (#3384). Thanks @jepler.
  • Trellis M4: Fix pins used for `board.I2C() (#3373). Thanks @dhalbert.
  • Spresense: Add native camera support (#3369). Thanks @kamtom480.
  • Unix: Fix import ulab.linalg crash (#3355). Thanks @jepler.
  • BLM Badge: Add board.I2C() (#3348). Thanks @ladyada.
  • SAME54: Disable microcontroller.cpu.voltage, as it is hanging (#3434). Thanks @jepler.
  • atmel-samd: Fix SPI code that handled SAMR21 special case (#3436). Thanks @jepler.
  • STM32: Make sure MOSI is high during SPI read (#3431). Thanks @hierophect.
  • MakerDiary boards: Add pin aliases such as SCL and SDA, and canonicalize other names (#3438). Thanks @nitz.
  • BDMICRO VINA M0 renamed to VINA D21; pins updated (#3432). Thanks @bd34n.
  • STM32: Add never_reset calls to RGBMatrix init (#3441). Thanks @hierophect.

Documentation

Internals and build process

  • Enable diagnostic for fall-through case arms in switch statements, catching several bugs. Thanks @jepler.
  • Remove debugging printout in endpoint-counting code during build (#3359). Thanks @jepler.
  • Clone the esp-idf submodules explicitly in the GitHub build action to prevent build hiccups (#3358). Thanks @jepler.
  • Make build script not rely on Python 3.7 features (#3443). Thanks @jepler.

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.

New boards since 6.0.0 Alpha 3

Known issues

  • Use of the adafruit_sdcard library can interfere with displayio operations that use read from an SD card (e.g., OnDiskBitmap). Use the native sdcardio or sdio modules instead, to avoid this problem.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.0.0 Alpha 3, including @Andon-A, @anecdata, @askpatrickw, @astrobokonon, @bd34n, @bergdahl, @CarlFK, @ciscorn, @cjsieh, @DavePutz, @dhalbert, @emard, @fede2cr, @fetchall, @FoamyGuy, @hierophect, @hugodahl, @jepler, @jerryneedell, @julianrendell, @kamtom480, @kmatch98, @ladyada, @maditnerd, @microdev1, @nitz, @PaintYourDragon, @siehputz, @sommersoft, @tannewt, @tawez, @titoluyo, @weblate, @wtuemura, and many more on Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.0.0 Alpha 3

28 Aug 18:42
@dhalbert dhalbert
6.0.0-alpha.3
893a125
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 6.0.0 Alpha 3 Pre-release
Pre-release

This is the third alpha release of CircuitPython 6.0.0. It is relatively stable. The release is still alpha because some API changes and additions are not yet included. Upcoming in a future release but not yet included are ESP32-S2 Wifi support, and _bleio HCI support for ESP32 co-processors.

The most notable additions since 5.3.x are basic lower power support when in time.sleep() and initial ESP32-S2 support. The lower power work changed time keeping and may have introduced bugs. Please use 5.3.x if you need a stable version of CircuitPython.

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 6.0.0 Alpha 2

API changes

  • Disable socket, wiznet5k and network modules. They will be removed in 7.x in favor of networking libraries. Thanks @tannewt.
  • Add memorymonitor for memory debugging. It must be enabled on a local build. Thanks @tannewt.
  • Add .find, .rfind, .index and .rindex to bytearray for CPython-compatible builds. Thanks @tannewt.
  • json.load now works with any object with readinto. Thanks @tannewt.
  • pulseio.PWMOUT is split out into pwmio.PWMOut. It is still available in pulseio, but that is deprecated and will be removed in 7.x (#3299). Thanks @tannewt.
  • _bleio: Allow changing MAC address (#3276). Thanks @xiongyihui.
  • _pixelbuf now supports iterables and floats (#3260). Thanks @rhooper.
  • nrf: Turn off QSPI when sleeping (#3244). Thanks @xiongyihui.
  • Add coroutine behavior for generators (#3178). Thanks @WarriorOfWire.

Fixes

  • UTF-8 handled properly in REPL (#3305, #3243). Thanks @dunkmann00.
  • terminalio is disabled for Japanese and Korean translations, because we currently have no font available (#3295). Thanks @tannewt.
  • Fix storage management in displayio (#3292). Thanks @jepler.
  • nrf: Code error in _bleio (#3284). Thanks @kevinjwalters for finding it, and @dhalbert for the fix.
  • nrf: SPIM3 buffer was in the wrong place. Thanks @riggs for pointing out the error, and @dhalbert for the fix.
  • ESP32-S2: Fix writing sector 0 in filesystem (#3262). Thanks @tannewt.
  • sharpdisplay: Prevent pin in use error (#3277). Thanks @jepler.
  • Improve high-speed USB (#3225). Thanks @hathach.
  • Allow assigment to 32-bit Bitmap (#3227). Thanks @cwalther.
  • Prevent crashing Linux when doing storage.erase_filesystem() (#3323). Thanks @dhalbert.
  • async for __aiter__ fix (#3222). Thanks @WarriorOfWire.
  • Improve appearance of vectorio.Polygon (#3221). Thanks @WarriorOfWire.
  • Fix displayio.Group.insert(). (#3214). Thanks @kmatch98.
  • Allow larger pystack on SAMD21 (#3213). Thanks @jerryneedell.
  • await must be inside an async def (#3202). Thanks @WarriorOfWire.

Board- and port-specific changes

Documentation

Internals and build process

  • Check for too many USB endpoints needed (#3304). Thanks @jepler.
  • Compress messages more efficiently by not including QSTR's (#3298). Thanks @ciscorn.
  • Squeeze builds to fit new translations (#3273, #3236, #3230). #3236 in particular saved a lot of space in a math routine. Thanks @jepler.
  • Report number of missing displayio font characters for messages (#3300). Thanks @jepler.
  • Less verbose build logs (#3290). Thanks @jepler.
  • Fix mpy-cross dependency analysis during make (#3239). Thanks @jepler.
  • Fix gcc10 compilation issues (#3231, #3218). Thanks @jepler and @tannewt.
  • Upload mpy-cross builds to Amazon S3 (#3220). Thanks @dhalbert.
  • Fix compilation on Windows msys (#3219). Thanks @ladyada.
  • Fix doc-building dependencies (#3212). Thanks @tannewt.
  • Parallelize GitHub CI builds (#3203). Thanks @WarriorOfWire.
  • Allow different compiler optimizations per board. Choose faster optimization on boards that have the space (#3190). Thanks @DavePutz.
  • Fix same-line comment issue in makefiles (#3333). Thanks @hierophect.

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.

New boards since 6.0.0 Alpha 2

Known issues

  • Use of the adafruit_sdcard library can interfere with displayio operations that use read from an SD card (e.g., OnDiskBitmap). Use the native sdcardio or sdio modules instead, to avoid this problem.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.0.0 Alpha 2, including @anecdata, @ansonhe97, @bergdahl, @bleeptrack, @brentru, @bunnie, @burtyb, @bwshockley, @ciscorn, @cwalther, @DavePutz, @deshipu, @dhalbert, @dpgeorge, @dunkmann00, @fede2cr, @FoamyGuy, @hathach, @hexthat, @hierophect, @jepler, @jerryneedell, @joeycastillo, @jonathanhogg, @josecastillo, @kamtom480, @kmatch98, @ladyada, @microdev1, @rhooper, @ryevertigo, @sabas1080, @sommersoft, @tannewt, @WarriorOfWire, @weblate, @wtuemura, @xiongyihui, and many more on Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.0.0 Alpha 2

23 Jul 21:57
@tannewt tannewt
6.0.0-alpha.2
5437084
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 6.0.0 Alpha 2 Pre-release
Pre-release

This is the second alpha release of CircuitPython 6.0.0. It is alpha because we are planning one more API change to ulab. It is relatively stable.

Feature-wise, this unstable release adds basic lower power support when in time.sleep() and initial ESP32-S2 support. The lower power work changed time keeping and may have introduced bugs. Please use 5.3.0 if you need a stable version of CircuitPython.

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 6.0.0 Alpha 1

API Changes

  • Disable socket, wiznet5k and network modules. They will be removed in 7.x in favor of networking libraries. Thanks to @tannewt
  • Add memorymonitor for memory debugging. It must be enabled on a local build. Thanks to @tannewt
  • Add .find, .rfind, .index and .rindex to bytearray for CPYTHON compatible builds. Thanks to @tannewt
  • json.load now works with any object with readinto. Thanks to @tannewt

Internals

  • Improved performance with background task rework. Now on par with 5.3.x Thanks to @jepler
  • Enable PYSTACK which separates python code state from C code state and improves memory use. Let us know if you hit a RuntimeError from an exhausted pystack. It may be too small. Thanks to @tannewt

Fixes

  • ESP32S2 build can now be parallelized. Thanks to @jepler
  • ESP32S2 unique IDs are now actually unique. Thanks to @jepler
  • Fixed VectorShape non-transposed pixel placement. Thanks to @warriorofwire
  • Fixed USB starvation during long numeric calculations. Thanks to @DavePutz
  • Fixed Polygon.points. Thanks to @WarriorOfWire
  • SAMD brown out levels are now configurable. Thanks to @deshipu
  • MP3 playback improvements. Thanks to @jepler
  • PulseIn fixed on SAMD. Thanks to @DavePutz

Board changes

  • Enable analogio on PewPew M4. Thanks to @deshipu
  • Seeed Wio Terminal display now init by default. Thanks to @ansonhe97

Documentation

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.

New boards since 6.0.0 Alpha 1

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 since 6.0.0 Alpha 1, helped out, and participated on GitHub and/or Discord, including @ansonhe97, @arms22 @Arudinne, @bergdahl, @ciscorn, @DavePutz, @deshipu, @dhalbert, @dherrada, @dkhawk, @dunkmann00, @fede2cr, @Flameeyes, @jepler, @ladyada, @oonid, @ryevertigo, @tannewt, @tinkeringtech, @warriorofwire, @wtuemura and @xiongyihui 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) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 5.3.1

13 Jul 22:33
@tannewt tannewt
5.3.1
365d69e
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.3.1

This is CircuitPython 5.3.1, the second 5.3.x stable release. This release fixes RGBW handling with PixelBuf. Otherwise, it is identical to 5.3.0. 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.3.0

  • Add pixelbuf support for setting the white component of RGBW pixels automatically when given an RGB color value. (This is what NeoPixel used to do.) Thanks to @rhooper

Full commit log is here.

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.

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 @rhooper, 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 6.0.0 Alpha 1

02 Jul 23:43
@tannewt tannewt
6.0.0-alpha.1
ed34d52
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 6.0.0 Alpha 1 Pre-release
Pre-release

This is the first alpha release of CircuitPython 6.0.0. It is a renumbered version of 5.4.0 because i2cslave module and class have been renamed to i2cperipheral. It is alpha because we may remove or rename additional APIs. It is relatively stable.

Feature-wise, this stable release adds basic lower power support when in time.sleep() and initial ESP32-S2 support. The lower power work changed time keeping and may have introduced bugs. Please use 5.3.0 if you need a stable version of CircuitPython.

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.4.0 Beta 1

  • Added sdioio and sdcardio for native SDCard support. Available on SAMD51 and spresense. Thanks to @jepler and @kamtom480.
  • Added busio support to ESP32-S2. Thanks to @tannewt
  • Add support for SAME54. Thanks to @jepler
  • Add global navigation satellite system (gnss) support for Spresense. Thanks to @kamtom480
  • Improved ESP32-S2 performance. Thanks to @tannewt and @DavePutz
  • Updated ulab thanks to @jepler and @v923z
  • Fix time.sleep() after it has been ctrl-c'd. Thanks to @DavePutz
  • Fix microcontroller.cpu.temperature read hang. Thanks to @dhalbert
  • Fix ScanEntry prefix matching when any=False. Thanks to @dhalbert
  • Fixed port D pins on STM32 LQFP64 boards. Thanks to @hierophect
  • Fixed I2C timing on STM32 F7 and H7. Thanks to @hierophect
  • Fixed display refresh when changing palette transparency. Thanks to @DavePutz
  • Meowbit build is now UF2 rather than a bin. Thanks to @hierophect
  • Documentation improvements thanks to @AndrewR-L
  • Improved Dutch, German, Brazilian Portuguese and Spanish translations. Thanks to @buchen, @fede2cr, @ryevertigo, and @wtuemura.

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.

New boards since 5.4.0 Beta 1

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.
  • pulseio.PulseIn isn't reliable on SAMD21. #3049
  • Performance has dropped since 5.3.0 due to excessive background work. #2929
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, contributed since 5.4.0 Beta 1, helped out, and participated on GitHub and/or Discord, including @ansonhe97, @buchen, @DavePutz, @deshipu, @dhalbert, @fede2cr, @florin-trutiu, @hierophect, @jepler, @jerryneedell, @kamtom480, @kattni, @k0d, @ladyada, @PTS93, @rhooper, @sommersoft, @v923z, @wtuemura 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) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 5.4.0 Beta 1

08 Jun 23:20
@tannewt tannewt
5.4.0-beta.1
0ba541d
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.4.0 Beta 1 Pre-release
Pre-release

This is the second beta release of CircuitPython 5.4.0. This release adds basic lower power support when in time.sleep(). The lower power work changed time keeping and may have introduced bugs. Please use 5.3.0 if you need a stable version of CircuitPython.

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.4.0 Beta 0

  • New port for the ESP32-S2. Thanks to @tannewt, @jerryneedell, @jepler
  • New countio module to count pulses. Thanks to @LearnWeaver
  • New watchdog module to control built in WatchDog. Only on nRF52840 currently. Thanks to @xobs
  • New vectorio module for native displayio shapes. Thanks to @WarriorOfWire
  • New pre-commit hooks. Thanks to @Flameeyes
  • Native module docs are now Python stubs. Thanks to @dherrada, @sommersoft and @tannewt
  • Add one directional UART support to iMX RT. Thanks to @hierophect
  • Add negative step support to PixelBuf. Thanks to @dunkmann00
  • Add support for anonymous BLE advertising. Thanks to @xobs
  • Add support for REPL over debug UART. Only on STM32. Thanks to @k0d
  • Add bytearray.decode() for improved CPython compatibility. Thanks to @theacodes
  • Fix garbled audio playback when voice 0 is stopped. Thanks to @jepler
  • Fix timekeeping on Spresence. Thanks to @kamtom480
  • Fix exception when no bus is found to match other ports (and be compatible with find pin combo scripts.) Thanks to @arturo182
  • Fix pulseio deinit issue on SAMD. Thanks to @DavePutz
  • Fix USB race condition on SAMD. Thanks to @hathach
  • Fix microcontroller.cpu.temperature crash on iMX RT. Thanks to @arturo182
  • Fix gamepad and gamepadshift after lower power changes. Thanks to @jepler
  • Increase max SPI speed on iMX RT. Thanks to @arturo182
  • Allow setting RGBW pixels with RGB value. Thanks to @rhooper
  • Update ulab. Thanks to @jepler and @v923z
  • Clock configuration improvements on STM and iMX RT. Thanks to @hierophect
  • Add support for GD25S512MD flash chip. Thanks to @bd34n
  • New translations for Czech (cs) and Dutch (nl). Thanks to @DustinWatts, @vooralfred, @dronecz and @jepler.
  • Improved German, French and Swedish translations. Thanks to @bergdahl, @aberwag, @dglaude, Thomas Friehoff, @PTS93, and @jepler.

Full commit log is here.

New boards since 5.4.0 Beta 0

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 since 5.4.0 Beta 0, helped out, and participated on GitHub and/or Discord, including @aberwag, @arturo182, @bd34n, @BradChan, @DavePutz, @deshipu, @dglaude, @dhalbert, @dunkmann00, @Flameeyes, @hathach, @hierophect, @jepler, @jerryneedell, @JoeBakalor, @jpecor, @kamtom480, @kattni, @k0d, @ladyada, @LearnWeaver, @maholli, @mew-cx, @Nicell, @PTS93, @rhooper, @sommersoft, @spkuehl, @Teknikio, @theacodes, Thomas Friehoff, @v923z, @WarriorOfWire, @xiongyihui, @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).

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 5.4.0 Beta 0

12 May 00:31
@tannewt tannewt
5.4.0-beta.0
62b835a
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.4.0 Beta 0 Pre-release
Pre-release

This is the first beta release of CircuitPython 5.4.0. This release adds basic lower power support when in time.sleep(). The lower power work changed time keeping and may have introduced bugs. Please use 5.3.0 if you need a stable version of CircuitPython.

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

  • Add sleep support while time.sleep() on ports except CXD56 and LiteX. Thanks to @tannewt
  • ujson.load can now use mp_stream objects like busio.UART. Thanks to @WarriorOfWire
  • rgbmatrix now supported on STM32F4. Thanks to @jepler
  • aesio added for C level AES. Thanks to @xobs
  • displayio enabled on STM32H7 boards. Thanks to @hierophect
  • One directional SPI now supported on IMX RT. Thanks to @hierophect and @arturo182
  • Added empty Swedish translations. (Try our new Weblate site to add and improve translations.) Thanks @jepler
  • _pixelbuf.colorwheel color order fixed. Thanks to @kattni
  • PacketBuffer reliability improved. Thanks to @dhalbert
    • packet_size is deprecated in favor of incoming_packet_length.
    • outpoing_packet_length added so calling code can split input appropriately.
  • ulab updated. Removed from espruino_pico and espruino_pico due to space. Thanks to @v923z and @jepler
    • Adds ulab.compare.clip.
  • os and pulseio enabled on STM32F7. Thanks to @k0d
  • Pinout of Teknikio Bluebird pinout updated for newer rev. Thanks to @JoeBakalor
  • Itaca uChip now has .bin files as well as .uf2. Thanks to @mew-cx
  • STATUS2 is no longer read for SPI Flashes with single status bytes. Thanks to @bd34n
  • Doc fixes. Thanks to @rhooper and @spkuehl

Full commit log is here.

New boards since 5.3.0

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 since 5.3.0, helped out, and participated on GitHub and/or Discord, including @arturo182, @bd34n, @DavePutz, @dhalbert, @hathach, @hierophect, @jepler, @JoeBakalor, @kattni, @k0d, @ladyada, @mew-cx, @rhooper, @spkuehl, @Teknikio, @theacodes, @TG-Techie, @v923z, @WarriorOfWire, @xiongyihui, @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).

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

Check out this guide for info on common problems with CircuitPython. If you are still having issues, then post to the Adafruit Support Forums and join Discord.

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 5.3.0

29 Apr 18:46
@jepler jepler
5.3.0
51dbe91
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.3.0

This is CircuitPython 5.3.0, the first 5.3.x stable release. This release adds support for 3 new boards, and 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

Full commit log is here.

3 New boards since 5.2.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.

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.

Assets 2
Loading

CircuitPython 5.3.0-rc.0

21 Apr 20:03
@jepler jepler
5.3.0-rc.0
51dbe91
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.3.0-rc.0 Pre-release
Pre-release

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

Full commit log is here.

3 New boards since 5.2.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.

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.

Assets 2
Loading

CircuitPython 5.2.0

09 Apr 19:22
@tannewt tannewt
5.2.0
b3b8b5c
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.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

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.

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 arrays
  • ulab can give erroneous results with expressions like a[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.

Assets 2
Loading