@dhalbert dhalbert released this Jan 7, 2019 · 1803 commits to master since this release

Assets 28

Changes since 3.1.1

  • All frozen libraries have been updated to their latest versions as of 2019-01-05.
  • Added runtime.serial_bytes_available. Returns True if any bytes are available to read on the USB serial input. Allows for polling to see whether to call the built-in input() or wait. (read-only). Thanks to @ATMakersBill.
  • nRF52840-related builds were removed from 3.x as of 3.1.2 because certain software downloads that 3.x depends on were removed from Nordic's website. It is no longer possible to build these on the 3.x branch. But see the 4.0 (master) branch for viable and better support for nRF52840. Note also that nRF52832 builds from commits before 3.1.2 will no longer build due to changed download locations on the Nordic website. 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.

Documentation

Documentation is available on readthedocs.io.

Here are all the changes since 3.1.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. For MacOS, Ubuntu, and Raspbian, you must make the mpy-cross download executable by doing. Then you can compile a .py file to .mpy:

$ chmod +x mpy-cross-whatever-you-downloaded         # you only need to do this once
$ ./mpy-cross-whatever-you-downloaded yourfile.py    # this will generate yourfile.mpy

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.

Pre-release

@tannewt tannewt released this Dec 11, 2018

Assets 247

This release includes a number of excellent enhancements since Alpha 3 including more reliable USB, better safe mode and Particle Mesh board support. This gets us closer to beta!

This is alpha release number 5 of 4.0.0. Alpha releases do not have the complete API from 3.x on the nRF builds and are only meant for testing. (Beta release will have the full existing API but still need work.) Please use the latest 3.x 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.

4.0.0

4.0.0 is the latest major revision of CircuitPython and features support for the nRF52840 BLE chipset and translated messages.

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

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

New Features, Updates, and Fixes since Alpha 3

  • busio.UART breaking changes to match PySerial. Thanks to @dhalbert
    • busio.UART constructor timeout parameter is now in seconds instead of milliseconds
    • UART.readinto(buf) now does not allow an optional length parameter UART.readinto(buf, len)
    • UART.write(...) no longer allows strings to be written. The bytes written must be bytes or bytearray or an array.array.
  • Improved safe mode and added it to nRF52 boards. Thanks to @tannewt
    • 700 millisecond period at start up where a reset will go into safe mode. RGB status is yellow and the single status LED will blink three times.
    • The stack growing to overwrite the heap will reset into safe mode.
    • nRF boards will reset into safe mode on brownout.
  • Fixes to USB. Thanks to @hathach and @tannewt.
  • Documentation improvements. Thanks to @C47D, @sommersoft .
  • Spanish translation updates. Thanks to @yeyeto2788, @C47D and @sabas1080 .

New Boards

Breaking Changes from 3.x!

  • busio.UART breaking changes to match PySerial. Thanks to @dhalbert
    • busio.UART constructor timeout parameter is now in seconds instead of milliseconds
    • UART.readinto(buf) now does not allow an optional length parameter UART.readinto(buf, len)
    • UART.write(...) no longer allows strings to be written. The bytes written must be bytes or bytearray or an array.array.
  • framebuf has been removed. displayio is its replacement, and will be enhanced after 4.0 to include framebuf's functionality.

Known Issues

None

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @hathach, @arturo182, @nickzoic, @glennrub, @siddacious, @deshipu, @sommersoft, @jerryneedell, @brentru, @caternuson, @jepler, @urish, @sajattack,, @notro, @Jahor, @Makdaam, @mrmcwethy, @jepler, @notro, @mattyt, @furlaneto, @ATMakersBill, @Klowner, @klardotsh, @C47D, @carlosperate, @platipo, @xpecex, @gcvasconcelos, @saspa, @uhrheber, @nickzoic, @sabas1080, @sajattack, @JoshuaLowe1002, @Senuros, @mchobby, @Retoc, @CedarGroveStudios, @bwshockley, @yeyeto2788 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 4.0.0-alpha.3.
Here are all the changes since 3.1.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, then post to the Adafruit Support Forums and join Discord.

Note: alpha.4 was briefly released but USB didn't work on nRF52840 so it was pulled. This release has it fixed.

Dec 7, 2018
Merge pull request #1294 from tannewt/stack_check
Add stack validity check and raise an error when it happens.
Pre-release

@tannewt tannewt released this Nov 16, 2018 · 295 commits to master since this release

Assets 212

This release puts the "alpha" in our alpha releases. It features a brand-new bleio API that will definitely change over time and swaps the atmel-samd USB stack to the same one used by the nrf chips.

This is alpha release number 3 of 4.0.0. Alpha releases do not have the complete API from 3.x on the nRF builds and are only meant for testing (especially this one). (Beta release will have the full existing API but still need work.) Please use the latest 3.x 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.

4.0.0

4.0.0 is the latest major revision of CircuitPython and features support for the nRF52840 BLE chipset, display support and translated messages.

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

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

New Features, Updates, and Fixes since Alpha 2

New Boards

Breaking Changes from 3.x!

  • framebuf has been removed. displayio is its replacement, and will be enhanced as 4.0 progresses to include framebuf's functionality.

Known Issues

  • On nRF52840, using ubluepy with first allocated busio.SPI object will cause a reset. The first SPI object created is always be the high speed 32MHz SPIM3 peripheral. To avoid this, if you need SPI, create but do not use the first SPI object, and create subsequent SPI objects to use. The second and later objects will run at a maximum of 8MHz.
  • Due to a bug, the SPIM3 peripheral is not allocated. Only one SPI peripheral, running at 8MHz, is available. This accidentally works around the problem above.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @hathach, @arturo182, @nickzoic, @glennrub, @siddacious, @deshipu, @sommersoft, @jerryneedell, @brentru, @caternuson, @jepler, @urish, @sajattack,, @notro, @Jahor, @Makdaam, @mrmcwethy, @jepler, @notro, @mattyt, @furlaneto, @ATMakersBill, @Klowner, @klardotsh, @C47D, @carlosperate, @platipo, @xpecex, @gcvasconcelos, @saspa, @uhrheber, @nickzoic, @sabas1080, @sajattack, @JoshuaLowe1002, @Senuros, @mchobby, @Retoc, @CedarGroveStudios 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 4.0.0-alpha.2.
Here are all the changes since 3.1.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, then post to the Adafruit Support Forums and join Discord.

@dhalbert dhalbert released this Nov 2, 2018 · 11 commits to 3.x since this release

Assets 29

Changes since 3.0.3

  • All frozen libraries have been updated to their latest versions as of 2018-11-01.

  • The default value of sys.path has been changed.
    OLD:

    ['', '/', '/lib', '.frozen']
    

    NEW:

    ['', '/', '.frozen', '/lib']
    

    This change causes the frozen library of a library to be found and loaded on import, instead of any non-frozen version in /lib. Previously, to make sure the frozen version of a library was used, you had to remove that library from /lib. Whenever you updated /lib with a new library bundle, this had to be repeated.

    When frozen libraries are imported they use up much less heap space (in RAM) than compiled .mpy libraries in /lib or elsewhere. This helps prevent running out of RAM when importing several modules or allocating large amounts of storage. This was a common support issue. Thanks to @kattni for advocating for this change, to @caternuson for discussion, and @dhalbert for implementation.

    If you need to override a frozen library with a different version, simply place it in /, instead of in /lib. The version in / will be found first and will be used instead.

Note that .frozen is not a real directory. It represents all the frozen modules. You cannot list it with os.listdir().

The following builds include frozen libraries and are affected by this change: circuit_playground_express, circuit_playground_express_crickit, feather_m0_express_crickit, hallowing_m0_express, pirkey_m0.

Note: Release 3.1.0 is being skipped: the tag was created on the wrong commit. The tag has been deleted, but we're skipping to avoid confusion.

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

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. For MacOS, Ubuntu, and Raspian, you must make the mpy-cross download executable by doing. Then you can compile a .py file to .mpy:

$ chmod +x mpy-cross-whatever-you-downloaded         # you only need to do this once
$ ./mpy-cross-whatever-you-downloaded yourfile.py    # this will generate yourfile.mpy

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.

Pre-release

@dhalbert dhalbert released this Oct 17, 2018 · 467 commits to master since this release

Assets 152

4.0.0 is the latest major revision of CircuitPython and features support for the nRF52840 BLE chipset, display support and translated messages.

Alpha!

This is alpha release number 2 of 4.0.0. Alpha releases do not have the complete API from 3.x on the nRF builds and are only meant for testing. (Beta release will have the full existing API but still need work.) Please use the latest 3.x 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.

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

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

New Features, Updates, and Fixes

  • Add new audioio.Mixer class to provide multiple simultaneous sample playback. Thanks @tannewt.
  • Add pulseio.PWMOut and pulse.PulseOut to nrf port. Thanks @dhalbert.
  • Add busio.UART to nrf port. Thanks @hathach.
  • Add supervisor.runtime.serial_bytes_available to see if input is available to read. Thanks @ATMakersBill.
  • Add auto-reload for nrf port. Thanks @hathach.
  • framebuf has been removed. displayio is its replacement, and will be enhanced as 4.0 progresses to include framebuf's functionality
  • Fix storage.erase_filesystem() on nrf port. Thanks @jerryneedell.
  • Enable optional support for inline assembly. Thanks @urish.
  • Continued work on Spanish translation. Thanks @C47D and @carlosperate.
  • Italian translation. Thanks @platipo.
  • Brazilian Portuguese translation. Thanks @furlaneto, @xpecex, and @gcvasconcelos.
  • Travis build improvements. Thanks @sajattack and @jepler.
  • Fix bugs in nrf SPI and I2C. Thanks @dhalbert.
  • Frozen libraries updated to latest released versions. Thanks @dhalbert.
  • Merge latest fixes from 3.x. Thanks @tannewt.

Breaking Changes!

  • framebuf has been removed. displayio is its replacement, and will be enhanced as 4.0 progresses to include framebuf's functionality

Known Issues

  • On nRF52840, using ubluepy with first allocated busio.SPI object will cause a reset. The first SPI object created is always be the high speed 32MHz SPIM3 peripheral. To avoid this, if you need SPI, create but do not use the first SPI object, and create subsequent SPI objects to use. The second and later objects will run at a maximum of 8MHz.
  • Due to a bug, the SPIM3 peripheral is not allocated. Only one SPI peripheral, running at 8MHz, is available. This accidentally works around the problem above.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @hathach, @arturo182, @nickzoic, @glennrub, @siddacious, @deshipu, @sommersoft, @jerryneedell, @brentru, @caternuson, @jepler, @urish, @sajattack,, @notro, @Jahor, @Makdaam, @mrmcwethy, @jepler, @notro, @mattyt, @furlaneto, @ATMakersBill, @Klowner, @klardotsh, @C47D, @carlosperate, @platipo, @xpecex, @gcvasconcelos, @saspa, @uhrheber, 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 4.0.0-alpha.1.
Here are all the changes since 3.0.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, then post to the Adafruit Support Forums and join Discord.

Pre-release

@tannewt tannewt released this Sep 21, 2018 · 575 commits to master since this release

Assets 112

4.0.0 is the latest major revision of CircuitPython and features support for the nRF52840 BLE chipset, display support and translated messages.

Alpha!

This is the first alpha release of 4.0.0. Alpha releases do not have the complete API from 3.x on the nRF builds and are only meant for testing. (Beta release will have the full existing 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.

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

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

New Features

Breaking Changes!

None so far.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @kattni, @microbuilder, @arturo182, @tralamazza, @hathach, @glennrub, @siddacious, @deshipu, @sommersoft, @jerryneedell, @brentru, @caternuson, @dfarning, @jepler, @PaulKierstead, @notro, @Jahor, @Makdaam, @mrmcwethy 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 3.0.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, then post to the Adafruit Support Forums and join Discord.

@tannewt tannewt released this Oct 10, 2018 · 13 commits to 3.x since this release

Assets 31

This is the a bug fix and minor feature release for the 3.x stable series. There is one fix in this release. Please check out the 3.0.0 release notes for full details on what's new in 3.0.0.

Changes since 3.0.2

  • atmel-samd: Fix AudioOut playback on the SAMD21. Thanks to jct4764 on the forum for the bug report, @caternuson and @sommersoft for verifying it and @tannewt for the fix.

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

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. For MacOS, Ubuntu, and Raspian, you must make the mpy-cross download executable by doing. Then you can compile a a .py file to .mpy:

$ chmod +x mpy-cross-whatever-you-downloaded         # you only need to do this once
$ ./mpy-cross-whatever-you-downloaded yourfile.py    # this will generate yourfile.mpy

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.

@dhalbert dhalbert released this Sep 14, 2018 · 15 commits to 3.x since this release

Assets 26

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.