Releases: adafruit/circuitpython
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
- Update frozen crickit library. Thanks @dhalbert.
- Fix pull setting for DigitalInOut. Thanks @cater, @kattni, @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
- 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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewtsamd.clockadded to enable low level clock tuning. Thanks @notrosupervisor.reload()now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper- Add
board.I2C(),board.SPI()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land - 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
- Support for the Pirkey M0. Thanks @dhalbert
- Add
rotaryioto support rotary encoders. Thanks to @tannewt and @dhalbert - Auto-pause PulseIn during high frequency input thanks to @tannewt, @dhalbert and @jerryneedell
- ESP8266 is now auto-built by Travis thanks to @jepler
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto match CPython.ucollectionshas been replaced withcollectionsto match CPython. Thanks @bildzeitung.ubinasciiis renamedbinasciito 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor multiple samples.PDMIn'sfrequencyproperty has been renamed tosample_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.
3.0.0 Release Candidate 1
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
- Fix M4 RTC. Thanks @mrmcwethy and @notro
- Fix / mounting. Thanks @dhalbert
- Freeze in crickit library. Thanks @dhalbert, @jerryneedell and @papahabla
- Fix one wire. Thanks @dhalbert, @caternuson, @sommersoft, Bill_R, and hotcarrier
- Add D3 and D4 definitions to Itsy Bitsy M4. Thanks @jerryneedell
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
- 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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewtsamd.clockadded to enable low level clock tuning. Thanks @notrosupervisor.reload()now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper- Add
board.I2C(),board.SPI()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land - 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
- Support for the Pirkey M0. Thanks @dhalbert
- Add
rotaryioto support rotary encoders. Thanks to @tannewt and @dhalbert - Auto-pause PulseIn during high frequency input thanks to @tannewt, @dhalbert and @jerryneedell
- ESP8266 is now auto-built by Travis thanks to @jepler
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto match CPython.ucollectionshas been replaced withcollectionsto match CPython. Thanks @bildzeitung.ubinasciiis renamedbinasciito 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor multiple samples.PDMIn'sfrequencyproperty has been renamed tosample_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.
3.0.0 Release Candidate 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.
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.PulseInandpulseio.PulseOutare now supported on ESP8266. Thanks @nickzoicaudiobusio.PDMInno 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
- 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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewtsamd.clockadded to enable low level clock tuning. Thanks @notrosupervisor.reload()now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper- Add
board.I2C(),board.SPI()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land - 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
- Support for the Pirkey M0. Thanks @dhalbert
- Add
rotaryioto support rotary encoders. Thanks to @tannewt and @dhalbert - Auto-pause PulseIn during high frequency input thanks to @tannewt, @dhalbert and @jerryneedell
- ESP8266 is now auto-built by Travis thanks to @jepler
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto match CPython.ucollectionshas been replaced withcollectionsto match CPython. Thanks @bildzeitung.ubinasciiis renamedbinasciito 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor multiple samples.PDMIn'sfrequencyproperty has been renamed tosample_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.
CircuitPython 3.0.0 Beta 1!
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
gamepadfixes thanks to @deshipu- Support for the Pirkey M0. Thanks @dhalbert
- Feather M4 Express refinements. Thanks @dhalbert
- Add
samd.clocksupport to the SAMD51 thanks to @notro - Add back safe mode support after brown out. Thanks to @tannewt
- Add
rotaryioto support rotary encoders. Thanks to @tannewt and @dhalbert - Improve OSError messages in low-memory builds thanks to @godlygeek
- Add back external crystal support to SAMD21 builds. thanks to @tannewt
- Stack related crash fix thanks to @jepler
- String and doc refinements thanks to @kattni, @dhalbert, @dglaude and @SConaway
- Fix for PDMIn freezes thanks to @dhalbert
- Auto-pause PulseIn during high frequency input thanks to @tannewt, @dhalbert and @jerryneedell
- ESP8266 is now auto-built by Travis thanks to @jepler
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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewtsamd.clockadded to enable low level clock tuning. Thanks @notrosupervisor.reload()now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper- Add
board.I2C(),board.SPI()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land - 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
- Support for the Pirkey M0. Thanks @dhalbert
- Add
rotaryioto support rotary encoders. Thanks to @tannewt and @dhalbert - Auto-pause PulseIn during high frequency input thanks to @tannewt, @dhalbert and @jerryneedell
- ESP8266 is now auto-built by Travis thanks to @jepler
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto match CPython.ucollectionshas been replaced withcollectionsto match CPython. Thanks @bildzeitung.ubinasciiis renamedbinasciito 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor multiple samples.PDMIn'sfrequencyproperty has been renamed tosample_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.
CircuitPython 3.0.0 Beta 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.
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.PDMInwithfrequencyrenamed tosample_rate. Thanks @tannewt microcontroller.cpu.temperatureimplemented on SAMD21 and SAMD51. Thanks @dhalbertubinasciiis renamedbinasciito match CPython. Thanks @jeplersamd.clockadd to enable low level clock tuning. Thanks @notro- CPU cache enabled on SAMD51 leading to 1-2x speed improvement. Thanks @dhalbert and @WestfW
AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewt- Support kwargs in bitbangio. Thanks @deanm1278
- nRF52 build now includes
framebuf,binasciiandhashlibthanks 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
ucollectionshas been replaced withcollectionsto 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()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land bitbangio.I2Cnow hastimeoutkwarg 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
- 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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt AudioOutandI2SOutnow supportpauseandresumewhile playing back a sample. Thanks @tannewtsamd.clockadded to enable low level clock tuning. Thanks @notrosupervisor.reload()now available to reload the VM. It no longer uses KeyboardInterruptException but rather its own ReloadException. Thanks to @rhooper- Add
board.I2C(),board.SPI()andboard.UART()as singleton objects for default buses as defined on the board. Thanks to @matt-land - 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
- Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto match CPython.ucollectionshas been replaced withcollectionsto match CPython. Thanks @bildzeitung.ubinasciiis renamedbinasciito 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor multiple samples.PDMIn'sfrequencyproperty has been renamed tosample_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...
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.
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:
- Do not rewrite
boot_out.txtif the version information in it will not change and there is noboot.py. - If the version information has changed, or there is a
boot.pyfile, wait 1.5 seconds to ensure power is stable before starting to writeboot_out.txtand runboot.py. - 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.
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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt - atmel-samd: usb_hid now includes Gamepad support. Thanks @dhalbert.
- Re-enable
nvm. Thanks @tannewt - Fix
tick_delayto 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.I2SOutsupport and split samples intoaudioio.RawSampleandaudioio.WaveFile. Thanks @tannewt - Code has been reorganized to ease sharing main code across ports.
Breaking Changes!
ustructhas been replaced withstructto 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.AudioOutnow takes the sample to playback inplayrather than in the constructor. (This enables playback through other outputs such asaudiobusio.I2SOut.) It also means you only need oneAudioOutfor 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
gamepadcrash 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!
ustructhas been replaced withstructto 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
gamepadin 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!
ustructhas been replaced withstructto 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.