Releases: adafruit/circuitpython
CircuitPython 3.0.0 Alpha 6!
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
- Support atmel-samd real-time clock (RTC) as main time source. Thanks @notro!
- Add
audiobusio.I2SOut
support and split samples intoaudioio.RawSample
andaudioio.WaveFile
. Thanks @tannewt - atmel-samd: usb_hid now includes Gamepad support. Thanks @dhalbert.
- Re-enable
nvm
. Thanks @tannewt - Fix
tick_delay
to work without interrupts (and correctly too). Fixes DHT22. Thanks @jerryneedell and @sommersoft - Add ItsyBitsy M4 initial support. Thanks @tannewt
- Fix status neopixel flashes. Thanks @tannewt
- Fix nrf52 build on Windows. Thanks @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
- Support for SAMD51 based M4 boards from Adafruit. Thanks @tannewt, @dhalbert, @siddacious and all the M4 testers.
- Preliminary support for nRF52 BLE capable boards. Thanks @glennrub, @tralamazza, @microbuilder, @arturo182, @hathach and @jerryneedell.
- Long-lived heap allocations are better compacted. (Video) Thanks @tannewt and @dhalbert.
- Read the microcontroller's unique id through
microcontroller.cpu.uid
. Thanks @sommersoft! - UART can now be created with only one direction. Thanks @dhalbert!
- Files to prevent mac from indexing the drive are created automatically. Thanks @jepler!
*
and*=
implemented forarray.array
. Thanks @jepler!- Implemented seeking to non-zero locations. Thanks @aykevl and @jepler.
- Detect when USB has been plugged in with
supervisor.runtime.serial_connected
. Thanks @sommersoft and @dhalbert. - Change file system label (CIRCUITPY by default) using
storage.getmount("/").label
. - Add
storage.erase_filesystem()
to make erasing the file system easy. Thanks @dhalbert! - atmel-samd: usb_hid support include Consumer Controls (aka multimedia keys) and Gamepad. Thanks @dhalbert.
- Support atmel-samd real-time clock (RTC) as main time source. Thanks @notro!
- Add
audiobusio.I2SOut
support and split samples intoaudioio.RawSample
andaudioio.WaveFile
. Thanks @tannewt - Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustruct
has been replaced withstruct
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 inplay
rather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut
.) It also means you only need oneAudioOut
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!
CircuitPython 3.0.0 Alpha 4!
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 3
- A host of potential crashes were fixed by @jepler.
- Files to prevent mac from indexing the drive are created automatically. Thanks @jepler!
*
and*=
implemented forarray.array
. Thanks @jepler!- Implemented seeking to non-zero locations. Thanks @aykevl and @jepler.
- Detect when USB has been plugged in with
supervisor.runtime.serial_connected
. Thanks @sommersoft and @dhalbert. - Non-standard array types inherited from MicroPython are no longer supported in favor of matching CPython. Thanks to @jepler.
- Change file system label (CIRCUITPY by default) using
storage.getmount("/").label
. - Add
storage.erase_filesystem()
to make erasing the file system easy. Thanks @dhalbert! - atmel-samd: Fix status DotStar on Gemma M0. Thanks @jerryneedell!
- atmel-samd: Add digital pin names for CircuitPlayground Express. Thanks @kattni!
- atmel-samd: Can now paste more than 128 characters into REPL thanks to @sommersoft .
- atmel-samd: I2C now checks for the presence of pull up resistors and throws an exception if they weren't detected. Thanks to @kattni, @dhalbert and @tannewt.
- atmel-samd: Fix unique id read on SAMD. Thanks @jepler.
- atmel-samd: Fixed
gamepad
crash when given objects of the wrong type. Thanks @deshipu! - atmel-samd: Fixed resetting to bootloader. Thanks @jepler!
- atmel-samd: Add usb_hid support to 3.0 including Consumer Controls (aka multimedia keys). Thanks @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 except ESP8266 are available as both UF2 and bin files here along with test builds.
New Features in 3.0.0
- Support for SAMD51 based M4 boards from Adafruit. Thanks @tannewt, @dhalbert, @siddacious and all the M4 testers.
- Preliminary support for nRF52 BLE capable boards. Thanks @glennrub, @tralamazza, @microbuilder, @arturo182, @hathach and @jerryneedell.
- Long-lived heap allocations are better compacted. (Video) Thanks @tannewt and @dhalbert.
- Read the microcontroller's unique id through
microcontroller.cpu.uid
. Thanks @sommersoft! - UART can now be created with only one direction. Thanks @dhalbert!
- Files to prevent mac from indexing the drive are created automatically. Thanks @jepler!
*
and*=
implemented forarray.array
. Thanks @jepler!- Implemented seeking to non-zero locations. Thanks @aykevl and @jepler.
- Detect when USB has been plugged in with
supervisor.runtime.serial_connected
. Thanks @sommersoft and @dhalbert. - Change file system label (CIRCUITPY by default) using
storage.getmount("/").label
. - Add
storage.erase_filesystem()
to make erasing the file system easy. Thanks @dhalbert! - atmel-samd: usb_hid support include Consumer Controls (aka multimedia keys). Thanks @dhalbert.
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustruct
has been replaced withstruct
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.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @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.
CircuitPython 3.0.0 Alpha 3!
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 2
- Fix DotStar support so user code can access it. Thanks @siddacious!
- Update the driver guide page! Thanks @sommersoft, @tannewt and @kattni.
- Use DMA for SPI transactions including those to SPI Flash. Thanks @tannewt and @dhalbert.
- Enable
gamepad
in 3.0.0. Thanks @deshipu and @dhalbert. - Correct timer definitions on SAMD21 so that pins are picked correctly. Thanks to @kattni, @hukuzatuna, @tannewt and @dhalbert.
- Squash a USB concurrency bug which led to incorrectly loaded data and connection instability. Thanks @jerryneedell and @siddacious for finding the issue and @tannewt and @dhalbert for fixing it.
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
- Support for SAMD51 based M4 boards from Adafruit. Thanks @tannewt, @dhalbert, @siddacious and all the M4 testers.
- Preliminary support for nRF52 BLE capable boards. Thanks @glennrub, @tralamazza, @microbuilder, @arturo182, @hathach and @jerryneedell.
- Long-lived heap allocations are better compacted. (Video) Thanks @tannewt and @dhalbert.
- Read the microcontroller's unique id through
microcontroller.cpu.uid
. Thanks @sommersoft! - UART can now be created with only one direction. Thanks @dhalbert!
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustruct
has been replaced withstruct
to match CPython.- The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @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 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 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.
CircuitPython 2.2.4
Another small release for new boards! This release adjusts the status LED brightness. The newer Itsy Bitsy M0 Express, Gemma M0 and Trinket M0 have a new rev of DotStar that changes the brightness curve to be much dimmer at the minimum. The fix finds a middle ground that's not too bright on old ones and not too dim on new ones.
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.
Use the mpy-cross
executables below to pre-compile .py
files to .mpy
files. You might need to do this if your .py
file is too large to compile on the board. Details here. The 2.2.0 mpy-cross
versions are still compatible with this new release.
Changes since 2.2.3
- @tannewt and @dhalbert tweaked the status LED brightness.
- @tuupola, @tannewt, @ladyada and @kattni improved the documentation.
Thanks
Thank you to all who used, tested, contributed helped out, and participated on GitHub and/or discord:
@dhalbert, @tannewt, @kattni, @tuupola, @jerryneedell and @ladyada 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 2.2.3.
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.
CircuitPython 3.0.0 Alpha 2!
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 the first 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.
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
- Support for SAMD51 based M4 boards from Adafruit. Thanks @tannewt, @dhalbert, @siddacious and all the M4 testers.
- Preliminary support for nRF52 BLE capable boards. Thanks @glennrub, @tralamazza, @microbuilder, @arturo182, @hathach and @jerryneedell.
- Long-lived heap allocations are better compacted. (Video) Thanks @tannewt and @dhalbert.
- Read the microcontroller's unique id through
microcontroller.cpu.uid
. Thanks @sommersoft! - UART can now be created with only one direction. Thanks @dhalbert!
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustruct
has been replaced withstruct
to match CPython.- The mpy format has changed so make sure and use a 3.0.0 bundle for libraries.
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@ladyada, @dhalbert, @tannewt, @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 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 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.1 was tagged long ago to give builds a number so we're already on alpha 2! Yay free numbers!
CircuitPython 2.2.3
Another small release for new boards! This has one fix for the ItsyBitsy M0 and pIRkey upcoming boards. Other boards don't actually need to be updated.
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.
Use the mpy-cross
executables below to pre-compile .py
files to .mpy
files. You might need to do this if your .py
file is too large to compile on the board. Details here. The 2.2.0 mpy-cross
versions are still compatible with this new release.
Changes since 2.2.1
Thanks
Thank you to all who used, tested, contributed helped out, and participated on GitHub and/or discord:
@ladyada, @dhalbert, 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 2.2.1.
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.
Note: 2.2.2 was incorrectly tagged so we've moved onto 2.2.3! Yay free numbers!
CircuitPython 2.2.1
This release is identical to 2.2.0 with a couple additional supported boards and a doc 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 except ESP8266 are available as both UF2 and bin files here along with test builds.
Changes since 2.2.0
- @tdicola added Feather M0 RFM69 and Feather M0 RFM9x boards to accompany the new RFM69 driver. RFM9x is not yet supported with a driver.
- @ladyada added support for the upcoming ItsyBitsy M0 Express.
- @deshipu corrected the
gamepad
example code.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 2.2.0.
This release is based on MicroPython 1.9.2. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
Thanks
Thank you to all who used, tested, contributed helped out, and participated on GitHub and/or discord:
@deshipu, @kattni, @ladyada, @tdicola, and surely more we have missed. Join us on the Discord chat to collaborate.
CircuitPython 2.2.0
Fresh for the 2018 New Year, we are pleased to announce the release of CircuitPython 2.2.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.
Changes since 2.1.0
- Frozen modules in the Circuit Playground Express builds are updated to their latest releases (including tap support on LIS3DH). The frozen modules include library version info in
<module>.__version__
. round()
was always returning0
. Fixed to return correct value.- CircuitPython now writes out version information to
boot_out.txt
, beforeboot.py
runs when you hard-reset the board or plug it in. - Intermittent power (e.g., bobbling the battery connector) could cause CircuitPython to think that the CIRCUITPY filesystem was damaged and erase it. Now, it waits two seconds before erasing, and double-checks just before erasing to see if filesystem still appears to be damaged.
audiobusio.PDMIn
: MEMS microphone support is much improved. (There is a MEMS microphone on the Circuit Playground Express.) We fixed several bugs that could cause hard crashes. The minimum and default sampling frequency is now 16 kHz (16000). The microphone is clocked all the time to avoid having to wait for it to start up, which can take up to 0.1 seconds. When you first create aPDMIn
object, CircuitPython waits forstartup_delay
seconds (default 0.11 seconds) so that the first data from the microphone will be useful. The digital filter used to convert microphone data into PCM data is now much faster. Thanks @ladyada!busio.SPI
now has an additional operationSPI.write_readinto()
which does bidirectional input/output. Certain SPI devices use this technique for communication.- Allow zero-length reads and writes for
busio.SPI
.busio.I2C
still disallows empty reads. Thanks @deshipu! AnalogIn.value
is now much faster. It now uses the native 12-bit ADC resolution instead of doing 16-bit via oversampling. Range is still 0-65535. Also uses a faster clock rate.microcontroller.on_next_reset()
: Change the behavior of what happens when the reset button is pressed: whether a normal reboot occurs, whether to go into safe mode, or whether to go directly to the bootloader. Seemicrocontroller.RunMode
.- Add missing Feather M0 Adalogger pin names and correct documentation. Thanks @stewmystre!
- Fix Arduino bootloader support so that a 1200 baud reset will be noticed and Arduino IDE will be able to upload.
- Enable
framebuf
module in ESP8266 port. Thanks @jerryneedell! - Add
_stage
module, to support the CircuitPython Stage game library. Gracefully resetgamepad
module after soft reset. Add board definition for the uGame handheld console. Thanks @deshipu! - Add support for future products. Thanks @ladyada!
- Update USB PID for Feather M0 Express.
- Add board definition for Feather M0 Express with larger SPI flash chip. Thanks @dastels!
- Document resetting CIRCUITPY using flash erase programs and .uf2's.
- Improve readthedocs documentation generation.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 2.1.0.
This release is based on MicroPython 1.9.2. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or discord:
@mrmcwethy, @stewmystre, @deshipu, @jerryneedell, @dastels, @kattni, @ladyada, @tannewt, @dhalbert, @tdicola, Andon, NorthernPike, willingc, brad, Kurt H, hukuzatuna, Janisku7, cater, onebeartoe, JohnPark, Teevo, process1183, siddacious, Cruadeium, adafruit, microwattbott, cyrborg5, Factory Factory, jramsdale, Pedro, pcurryinahurry, adamwolf, Olanskyl, HappyDay, Raiden, TechGuy12, dobra-dobra, MattBoston, donalus, cartere, Azure Skies, CGrover, ntoll, petroochio, donalus, mpalemuse, BravoDelta, ogredrew, cascade, Darragh, BWingZero, histo, TG-Techie, ericwertz, Jack, Dao20, fede2, oldcrow, waldo, ryespy, nis, chalkers, Skr0d, Billy, Dad, Instinctive, ATMakers, Cat, sommersoft, Coldreactor, BillOwens, tastemakerchuck, CrimsonKringle, Al Bee, vj pussycat, Daikojun, rocketcoder, Ringo, and surely more we have missed. Join us on the Discord chat to collaborate.
2.2.0 Release Candidate 2
Happy New Year! We're almost ready for a 2.2 release of CircuitPython. Here's 2.2.0-rc.2, the next candidate release. Thank you if you can test it.
Installation
To install follow the instructions in our new Welcome to CircuitPython! guide. To install the latest libraries, see this page in that guide.
All builds except ESP8266 are available as both UF2 and bin files here along with test builds.
Changes since 2.2.0-rc1
audiobusio.PDMIn
: (Microphone support.) Fix error in digital filter loop, which was generating quite inaccurate sample values. Fix crashes caused by buffers of certain sizes.- Fix Arduino bootloader support so that a 1200 baud reset will be noticed and Arduino IDE will be able to upload.
- Intermittent power (e.g., bobbling the battery connector) could cause CircuitPython to think that the CIRCUITPY filesystem was damaged and erase it. Now, it waits two seconds before erasing, and doublechecks just before erasing to see if filesystem still appears to be damaged.
- Update CPX frozen libraries to their latest versions (including tap support on LIS3DH). Include library version info (
__version__
). Don't include example directories. - Fix readthedocs documentation build.
Changes since 2.1.0
- Frozen modules in the Circuit Playground Express builds are updated to their latest releases.
round()
was always returning `0'. Fixed to return correct value.- CircuitPython now writes out version information to
boot_out.txt
, beforeboot.py
runs when you hard-reset the board or plug it in. audiobusio.PDMIn
: MEMS microphone support is improved. (There is a MEMS microphone on the Circuit Playground Express.) We fixed several bugs that could cause hard crashes. The minimum and default sampling frequency is now 16 kHz (16000). The microphone is clocked all the time to avoid having to wait for it to start up, which can take up to 0.1 seconds. When you first create aPDMIn
object, CircuitPython waits forstartup_delay
seconds (default 0.11 seconds) so that the first data from the microphone will be useful. The digital filter used to convert microphone data into PCM data is now much faster. Thanks @ladyada!busio.SPI
now has an additional operationSPI.write_readinto()
which does bidirectional input/output. Certain SPI devices need this.AnalogIn.value
is now much faster. It now uses the native 12-bit ADC resolution instead of doing 16-bit via oversampling. Range is still 0-65535. Also uses a faster clock rate.microcontroller.on_next_reset()
: Change the behavior of what happens when the reset button is pressed: whether a normal reboot occurs, whether to go into safe mode, or whether to go directly to the bootloader. Seemicrocontroller.RunMode
.- Add missing Feather M0 Adalogger pin names and correct documentation. Thanks @stewmystre!
- Enable
framebuf
module in ESP8266 port. Thanks @jerryneedell! - Add support for future products. Thanks @ladyada!
- Add
_stage
module, to support the CircuitPython Stage game library. Thanks @deshipu! - Gracefully reset
gamepad
module after soft reset. Thanks @deshipu! - Update USB PID for Feather M0 Express.
- Allow zero-length reads and writes for
busio.SPI
.busio.I2C
still disallows empty reads. Thanks @deshipu! - Add board definition for the uGame handheld console. Thanks @deshipu!
- Add board definition for Feather M0 Express with larger SPI flash chip. Thanks @dastels!
- Document resetting CIRCUITPY using flash erase programs and .uf2's.
Documentation
Documentation is available in readthedocs.io.
Here are all the changes since 2.1.0.
This release is based on MicroPython 1.9.2. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or discord:
@mrmcwethy, @stewmystre, @deshipu, @jerryneedell, @dastels, @kattni, @ladyada, @tannewt, @dhalbert, @tdicola, Andon, NorthernPike, willingc, brad, Kurt H, hukuzatuna, Janisku7, cater, onebeartoe, JohnPark, Teevo, process1183, siddacious, Cruadeium, adafruit, microwattbott, cyrborg5, Factory Factory, jramsdale, Pedro, pcurryinahurry, adamwolf, Olanskyl, HappyDay, Raiden, TechGuy12, dobra-dobra, MattBoston, donalus, cartere, Azure Skies, CGrover, ntoll, petroochio, donalus, mpalemuse, BravoDelta, ogredrew, cascade, Darragh, BWingZero, histo, TG-Techie, ericwertz, Jack, Dao20, fede2, oldcrow, waldo, ryespy, nis, chalkers, Skr0d, Billy, Dad, Instinctive, ATMakers, Cat, sommersoft, Coldreactor, BillOwens, tastemakerchuck, CrimsonKringle, Al Bee, vj pussycat, Daikojun, rocketcoder, Ringo, and surely more we have missed. Join us on the Discord chat to collaborate.
2.2.0 Release Candidate 1
We're almost ready for a 2.2 release of CircuitPython. Thank you if you can test this release candidate!
Changes since 2.1.0
- Frozen modules in the Circuit Playground Express builds are updated to their latest releases.
round()
was always returning `0'. Fixed to return correct value.- CircuitPython now writes out version information to
boot_out.txt
, beforeboot.py
runs when you hard-reset the board or plug it in. audiobusio.PDMIn
: MEMS microphone support is improved. (There is a MEMS microphone on the Circuit Playground Express.) We fixed several bugs that could cause hard crashes. The minimum and default sampling frequency is now 16 kHz (16000). The microphone is clocked all the time to avoid having to wait for it to start up, which can take up to 0.1 seconds. When you first create aPDMIn
object, CircuitPython waits forstartup_delay
seconds (default 0.11 seconds) so that the first data from the microphone will be useful. The digital filter used to convert microphone data into PCM data is now much faster. Thanks @ladyada!busio.SPI
now has an additional operationSPI.write_readinto()
which does bidirectional input/output. Certain SPI devices need this.AnalogIn.value
is now much faster. It now uses the native 12-bit ADC resolution instead of doing 16-bit via oversampling. Range is still 0-65535. Also uses a faster clock rate.microcontroller.on_next_reset()
: Change the behavior of what happens when the reset button is pressed: whether a normal reboot occurs, whether to go into safe mode, or whether to go directly to the bootloader. Seemicrocontroller.RunMode
.- Add missing Feather M0 Adalogger pin names and correct documentation. Thanks @stewmystre!
- Enable
framebuf
module in ESP8266 port. Thanks @jerryneedell! - Add support for future products. Thanks @ladyada!
- Add
_stage
module, to support the CircuitPython Stage game library. Thanks @deshipu! - Gracefully reset
gamepad
module after soft reset. Thanks @deshipu! - Update USB PID for Feather M0 Express.
- Allow zero-length reads and writes for
busio.SPI
.busio.I2C
still disallows empty reads. Thanks @deshipu! - Add board definition for the uGame handheld console. Thanks @deshipu!
- Add board definition for Feather M0 Express with larger SPI flash chip. Thanks @dastels!
- Document resetting CIRCUITPY using flash erase programs and .uf2's.
Documentation
Documentation is available here.
Here are all the changes since 2.1.0.
This release is based on MicroPython 1.9.2. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here).
Thanks
Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or discord:
@mrmcwethy, @stewmystre, @deshipu, @jerryneedell, @dastels, @kattni, @ladyada, @tannewt, @dhalbert, @tdicola, Andon, NorthernPike, willingc, brad, Kurt H, hukuzatuna, Janisku7, cater, onebeartoe, JohnPark, Teevo, process1183, siddacious, Cruadeium, adafruit, microwattbott, cyrborg5, Factory Factory, jramsdale, Pedro, pcurryinahurry, adamwolf, Olanskyl, HappyDay, Raiden, TechGuy12, dobra-dobra, MattBoston, donalus, cartere, Azure Skies, CGrover, ntoll, petroochio, donalus, mpalemuse, BravoDelta, ogredrew, cascade, Darragh, BWingZero, histo, TG-Techie, ericwertz, Jack, Dao20, fede2, oldcrow, waldo, ryespy, nis, chalkers, Skr0d, Billy, Dad, Instinctive, ATMakers, Cat, sommersoft, Coldreactor, BillOwens, tastemakerchuck, CrimsonKringle, Al Bee, vj pussycat, Daikojun, rocketcoder, Ringo, and surely more we have missed. Join us on the Discord chat to collaborate.
Installation
Have a Feather M0 Express, Metro M0 Express, Gemma M0, Trinket M0 or Circuit Playground Express? Download a .uf2 and follow these instructions. To install our libraries:
- For Express boards, simply download the bundle for your release and copy the
lib
folder onto yourCIRCUITPY
drive. New bundle release are created whenever the included libraries are updated. - For Gemma M0 and Trinket M0, the library bundle is too large. These are the 2.0.0 libraries and files that are shipped with the boards: Gemma M0 files; Trinket M0 files. You will probably want to update the library
.mpy
files with the ones from the latest bundle.
To install on legacy boards, download a .bin file and follow the guide here for M0 and here for ESP8266. All builds except ESP8266 are available as both UF2 and bin files here along with test builds.