Skip to content

Releases: adafruit/circuitpython

CircuitPython 3.0.2

14 Sep 12:50
@dhalbert dhalbert
3.0.2
2dd9407
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 3.0.2

This is the a bug fix and minor feature release for the 3.x stable series. There are a few important fixes and some additions to busio.UART. Please check out the 3.0.0 release notes for full details on what's new in 3.0.0.

Changes since 3.0.1

  • Adjust neopixel write timings on the M4: On-board NeoPixel stopped working on M4 boards in 3.0.1. Thanks to @jerryneedell for the fix and testing, and @ash0x1b for the issue.
  • Handle USB output buffer >255 characters. Thanks @daguitarguy for the issue, initially noticed in the REPL, and thanks @dhalbert for the fix.
  • Allocate PWMOut timer channels correctly. Previously some TCC timer channels were being incorrectly reused in multiple PWMOut objects. Thanks @deshipu for the issue and @dhalbert for the fix.
  • When UART timeout of zero is given, make UART.read() return available data. Thanks to @PaulKierstead for the fix.
  • Re-initialize default board busses on soft reset (board.SPI, board.I2C, board.UART). Thanks @dhalbert.
  • Add UART.in_waiting and UART.reset_input_buffer(), which mirror functionality in PySerial. Thanks @dhalbert, and thanks to @ladyada for the suggestions.

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

All builds are available as both UF2 and bin files here along with test builds.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 3.0.0.

This release is based on MicroPython 1.9.3. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).

mpy-cross

Pre-built mpy-cross executables are available above for MacOS, Windows, Ubuntu, and Raspbian.

Troubleshooting

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

Loading

CircuitPython 3.0.1

21 Aug 02:06
@tannewt tannewt
3.0.1
182a8d7
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 3.0.1

This is the first bug fix release for the 3.x stable series. It brings a few important fixes and support for the Hallowing M0 Express. Please check out the 3.0.0 release notes for full details on whats new in 3.0.0.

Changes since 3.0.0

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

All builds are available as both UF2 and bin files here along with test builds.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 3.0.0.

This release is based on MicroPython 1.9.3. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).

mpy-cross

Pre-built mpy-cross executables are available above for MacOS, Windows, Ubuntu, and Raspbian.

Troubleshooting

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

Loading

3.0.0

09 Jul 22:43
@dhalbert dhalbert
3.0.0
85a5276
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

General release

We believe this release is stable and relatively bug free. So, please try this before trying 2.x. If you find issues please file an issue.

Changes since Release Candidate 1

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

All builds are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.
  • PDMIn's frequency property has been renamed to sample_rate.
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Auto-reload no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub, sprinted with us at PyCon and/or chatted with us on Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover, @larsks, @WestfW, @rhooper, @khawley, @godlygeek, @bildzeitung, @matt-land, @wickedchicken, @margaret, sdw_nj, @ntoll, @SConaway, @dglaude, @nickzoic, MikeBarela, Josh, Les, @cefn, papahabla, hotcarrier, Bill_R, and from PyCon sprints: Dylan W, Anders, David, Dylan H, Adam, John, Chris, Lady Red, Craig, Aaron, John, Boris, Drew and Kathryn and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.3.1.

This release is based on MicroPython 1.9.3. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).

mpy-cross

Pre-built mpy-cross executables are available above for MacOS, Windows, Ubuntu, and Raspbian.

Troubleshooting

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

Loading

3.0.0 Release Candidate 1

03 Jul 22:39
@tannewt tannewt
3.0.0-rc.1
ff0a6f4
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0 Release Candidate 1 Pre-release
Pre-release

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

Release Candidate

We believe this release is stable and relatively bug free. So, please try this before trying 2.x. If you find issues please file an issue. If no major bugs are found, then we'll release this as 3.0.0 stable.

Changes since Release Candidate 0

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

All builds are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.
  • PDMIn's frequency property has been renamed to sample_rate.
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Auto-reload no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub, sprinted with us at PyCon and/or chatted with us on Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover, @larsks, @WestfW, @rhooper, @khawley, @godlygeek, @bildzeitung, @matt-land, @wickedchicken, @margaret, sdw_nj, @ntoll, @SConaway, @dglaude, @nickzoic, MikeBarela, Josh, Les, @cefn, papahabla, hotcarrier, Bill_R, and from PyCon sprints: Dylan W, Anders, David, Dylan H, Adam, John, Chris, Lady Red, Craig, Aaron, John, Boris, Drew and Kathryn and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.3.1.

This release is based on MicroPython 1.9.3. 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, then post to the Adafruit Support Forums and join Discord.

Loading

3.0.0 Release Candidate 0

18 Jun 23:08
@tannewt tannewt
3.0.0-rc.0
f5fab35
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0 Release Candidate 0 Pre-release
Pre-release

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

Release Candidate

We believe this release is stable and relatively bug free. So, please try this before trying 2.x. If you find issues please file an issue. If no major bugs are found, then we'll release this as 3.0.0 stable.

Changes since Beta 1

  • pulseio.PulseIn and pulseio.PulseOut are now supported on ESP8266. Thanks @nickzoic
  • audiobusio.PDMIn no longer hangs in some cases. Thanks to @dhalbert
  • Wave file playback works from SD card (but is a bit scratchy). Thanks to @dhalbert
  • GPIO12 (MTDI) pin on ESP8266 is now usable. Thanks to @sommersoft
  • Fix file listing when current directory is '/'. Thanks to @dhalbert
  • Can no longer mount an SD file system over an existing file or folder. Thanks to @dhalbert

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

All builds are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.
  • PDMIn's frequency property has been renamed to sample_rate.
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Auto-reload no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub, sprinted with us at PyCon and/or chatted with us on Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover, @larsks, @WestfW, @rhooper, @khawley, @godlygeek, @bildzeitung, @matt-land, @wickedchicken, @margaret, sdw_nj, @ntoll, @SConaway, @dglaude, @nickzoic, MikeBarela, Josh, Les, @cefn, (from PyCon sprints) Dylan W, Anders, David, Dylan H, Adam, John, Chris, Lady Red, Craig, Aaron, John, Boris, Drew and Kathryn and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.3.1.

This release is based on MicroPython 1.9.3. 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, then post to the Adafruit Support Forums and join Discord.

Loading

CircuitPython 3.0.0 Beta 1!

11 Jun 21:57
@tannewt tannewt
3.0.0-beta.1
85c5e88
Compare
Choose a tag to compare
CircuitPython 3.0.0 Beta 1! Pre-release
Pre-release

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

Beta!

This is an beta release of 3.0.0. It has the full functionality of 2.x on M0 boards but has API changes and potentially bugs. Please use the latest stable release when first starting with CircuitPython. It is stable.

When you find a bug please check the current known issues and file an issue if something isn't already known.

Changes since Beta 0

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

All builds except ESP8266 are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.
  • PDMIn's frequency property has been renamed to sample_rate.
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Auto-reload no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub, sprinted with us at PyCon and/or chatted with us on Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover, @larsks, @WestfW, @rhooper, @khawley, @godlygeek, @bildzeitung, @matt-land, @wickedchicken, @margaret, sdw_nj, @ntoll, @SConaway, @dglaude, MikeBarela, Josh, Les, @cefn, (from PyCon sprints) Dylan W, Anders, David, Dylan H, Adam, John, Chris, Lady Red, Craig, Aaron, John, Boris, Drew and Kathryn and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.3.1.

This release is based on MicroPython 1.9.3. 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, then post to the Adafruit Support Forums and join Discord.

Loading

CircuitPython 3.0.0 Beta 0!

23 May 20:58
@tannewt tannewt
3.0.0-beta.0
65cfbda
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 3.0.0 Beta 0! Pre-release
Pre-release

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

Beta!

This is an beta release of 3.0.0. It has the full functionality of 2.x on M0 boards but has API changes and potentially bugs. Please use the latest stable release when first starting with CircuitPython. It is stable.

When you find a bug please check the current known issues and file an issue if something isn't already known.

Changes since Alpha 6

  • A number of ESP8266 fixes. Thanks @sommersoft, @jerryneedell and @larsks!
  • CircuitPython and Blinka logos are now in logo. Thanks @tannewt and @deshipu
  • Improve RTC precision on SAMD21. Thanks @notro
  • Re-enable audiobusio.PDMIn with frequency renamed to sample_rate. Thanks @tannewt
  • microcontroller.cpu.temperature implemented on SAMD21 and SAMD51. Thanks @dhalbert
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • samd.clock add to enable low level clock tuning. Thanks @notro
  • CPU cache enabled on SAMD51 leading to 1-2x speed improvement. Thanks @dhalbert and @WestfW
  • AudioOut and I2SOut now support pause and resume while playing back a sample. Thanks @tannewt
  • Support kwargs in bitbangio. Thanks @deanm1278
  • nRF52 build now includes framebuf, binascii and hashlib thanks to @jepler
  • Makefile improvements around selecting Python build. Thanks @rhooper
  • Doc improvements thanks to @wickedchicken and @kattni
  • Top-level Makefile builds sphinx docs thanks to @khawley
  • OSErrors are now more human friendly thanks to @godlygeek
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • supervisor.reload() now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Add board.I2C(), board.SPI() and board.UART() as singleton objects for default buses as defined on the board. Thanks to @matt-land
  • bitbangio.I2C now has timeout kwarg to set max clock stretch wait time. Thanks to @jerryneedell
  • Longints are now supported on M0 Express boards (along with M4 boards). Thanks to @notro and @dhalbert
  • Add custom board for CircuitPlayground Crickit. Thanks to @dhalbert and @ladyada.

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

All builds except ESP8266 are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • ucollections has been replaced with collections to match CPython. Thanks @bildzeitung.
  • ubinascii is renamed binascii to match CPython. Thanks @jepler
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.
  • PDMIn's frequency property has been renamed to sample_rate.
  • Trinket M0 and Gemma M0 builds no longer include pin objects for all microcontroller pins. They only include those used by the board. Thanks to @rhooper
  • Auto-reload no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub, sprinted with us at PyCon and/or chatted with us on Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover, @larsks, @WestfW, @rhooper, @khawley, @godlygeek, @bildzeitung, @matt-land, @wickedchicken, @margaret, sdw_nj, @ntoll, MikeBarela, Josh, Les, @cefn, (from PyCon sprints) Dylan W, Anders, David, Dylan H, Adam, John, Chris, Lady Red, Craig, Aaron, John, Boris, Drew and Kathryn and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.3.1.

This release is based on MicroPython 1.9.3. Suppor...

Read more
Loading

CircuitPython 2.3.1

07 May 18:30
@dhalbert dhalbert
2.3.1
6e95c90
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 2.3.1

CircuitPython 2.3.1 fixes a regression introduced in 2.3.0: if boot.py changed the root filesystem permission to read/write using storage.remount(), that permission change would get undone. This bug would prevent some data logging code from working, for instance.

All other changes introduced in 2.3.0 are still present: battery power fix, storage.erase_filesystem(), and new frozen libraries for Circuit Playground express. Refer to the 2.3.0 release for details.

Thanks

Thanks to @jerryneedell for finding this issue and doing further testing! Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

Here are the changes since 2.3.0 and changes since 2.2.4.

This release is based on MicroPython 1.9.2. 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, then post to the Adafruit Support Forums and join Discord.

mpy-cross

The 2.2.0 mpy-cross executables in this release work fine with all 2.x releases.

Loading

CircuitPython 2.3.0

04 May 18:15
@dhalbert dhalbert
2.3.0
3814e97
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 2.3.0

Summary

This release fixes a longstanding issue of CIRCUITPY sometimes being erased when applying power or when batteries run down. It also adds the CircuitPlayground and HID libraries as frozen libraries on the Circuit Playground Express build. And finally, if CIRCUITPY becomes partially corrupted, you can now use storage.clear_filesystem() to erase and reformat it, and reset the board.

Details

Power-on CIRCUITPY corruption fix

CircuitPython writes version information to boot_out.txt when it starts from a hard reset or power on. It also writes whatever boot.py (or settings.py, etc.) prints to boot_out.txt. If power failed while boot_out.txt was being written, CIRCUITPY could become severely corrupted. When power returned, CircuitPython would erase and reformat CIRCUITPY to fix the corruption. Several things were done to ameliorate this problem:

  1. Do not rewrite boot_out.txt if the version information in it will not change and there is no boot.py.
  2. If the version information has changed, or there is a boot.py file, wait 1.5 seconds to ensure power is stable before starting to write boot_out.txt and run boot.py.
  3. Raise the "brownout" voltage below which CircuitPython refuses to run from 1.7V to 2.8V. This ensures all chips on the board have proper voltage to run.

Additional frozen libraries added to CircuitPython image for Circuit Playground Express

The CircuitPlayground (aka Express or cpx) library and the HID librariy have been added as frozen libraries to the Circuit Playground Express firmware image. The CircuitPlayground library provides easy access to the built-in sensors and peripherals on the Circuit Playground Express (CPX) board. Using the frozen versions of these libraries can save RAM and allow you to run larger programs. Remove the versions in the lib/ directory if you want to use the frozen versions. (Or change sys.path to put .frozen first.)

storage.erase_filesystem()

Sometimes CIRCUITPY becomes partially corrupted, but not badly enough so that it is automatically reformatted. You can now use erase.filesystem() to reformat easily and quickly, without having to use a special erase .uf2 file and then reload CircuitPython. In the REPL, just do:

import storage
storage.erase_filesystem()

This will erase and reformat CIRCUITPY, and reset the board.

Other changes

The _stage module now uses 16-bit coordinates to support larger screens. Thanks @deshipu!

The esp8266 build now uses the latest version of the SDK toolchain. Thanks @jepler!

Thanks

Thanks to @dhalbert, @tannewt, @kattni, @jepler, @deshipu, @ladyada, and @croadfeldt (who helped greatly with testing the power fixes) for help with this release! Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

Here are all the changes since 2.2.4.

This release is based on MicroPython 1.9.2. 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, then post to the Adafruit Support Forums and join Discord.

mpy-cross

The 2.2.0 mpy-cross executables in this release work fine with 2.3.0.

Loading

CircuitPython 3.0.0 Alpha 6!

25 Apr 00:00
@tannewt tannewt
3.0.0-alpha.6
8cadcc8
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 3.0.0 Alpha 6! Pre-release
Pre-release

3.0.0 is the latest major revision of CircuitPython and features new support for the SAMD51 (aka M4) and preliminary support for the nRF52 BLE chipset. It also features better memory utilization so more can be loaded in the same amount of space.

Alpha!

This is an alpha release of 3.0.0. Alpha releases do not have the complete API from 2.x and are only meant for testing. (Beta release will have the full API but still need work.) Please use the latest stable release when first starting with CircuitPython. It is stable.

When you find a bug please check the current known issues and file an issue if something isn't already known.

Changes since Alpha 4

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

All builds except ESP8266 are available as both UF2 and bin files here along with test builds.

New Features in 3.0.0

Breaking Changes!

  • ustruct has been replaced with struct to match CPython.
  • The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
  • Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
  • audioio.AudioOut now takes the sample to playback in play rather than in the constructor. (This enables playback through other outputs such as audiobusio.I2SOut.) It also means you only need one AudioOut for multiple samples.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @jamesadevine, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @tdicola, @mrmcwethy, @willingc, @sommersoft, @deanm1278, @jerryneedell, @stewmystre, @boneskull, @Sigafoos, @brentru, @caternuson, @process1183, @Andon-A, @asherlie, adamwolf, dastels, @hukuzatuna, @KurticusMaximus, nis, BravoDelta, aj_nys, @wolf, @vesperk38, @jepler, @notro, CGrover and surely more we have missed. Join us on the Discord chat to collaborate.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 2.2.3.

This release is based on MicroPython 1.9.3. 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, then post to the Adafruit Support Forums and join Discord.

Note: 3.0.0-alpha.5 was incorrectly tagged on an older commit so we're already now alpha 6! Yay free numbers!

Loading