CircuitPython 4.0.2

4.0.2 is our second bugfix release of 4.x. Download it now from circuitpython.org. See here for the full release notes.

4.x features a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio), extensive new support for pixel-based displays (displayio) (guide here), which will show CircuitPython output on the display, USB MIDI support and messages translated into multiple languages. Current languages are Chinese (Pinyin), English, French, German, Indonesian, Italian, Polish, Spanish, and Tagalog (Filipino). Thank you to the many contributors who make CircuitPython excellent!

Over 50 boards are now supported by CircuitPython 4.0.2. Check out the new circuitpython.org/downloads page for full list of all available versions.

It's not too late to contribute to CircuitPython! Check out this guide for details. We're always looking to improve and expect many stable releases in the 4.x line to happen through the summer. Subscribe to the Python for Microcontrollers newsletter on adafruitdaily.com for the latest news for all things Python.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

Installation

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

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

New Fixes since 4.0.1

• Fix incorrect gc of root display group that leads to crash. Thanks to @dhalbert and @ATMakersBill
• Fix gamepadshift to work when read quickly. Thanks to @deshipu and @kattni
• Fix nrf NeoPixel write for short strands. Thanks to @dhalbert and @bmeisels
• Fix crash on import of corrupt .mpy. Thanks to @tannewt and @jnalezny
• Update frozen libraries. Thanks to @dhalbert
• Doc updates thanks to @jpecor

New Boards

• Electronut Labs Blip (was unstable only) Thanks @ntavish

Breaking Changes from 3.x!

• ESP8266 and nRF52832 no longer supported. With 4.x we've chosen to focus on microcontrollers with built-in USB to ensure a consistent CircuitPython experience across all boards we support.
• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.
• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.
• bytearray, array.array, and int.to_bytes() now check for values that are too large to fit. This matches CPython behavior. Thanks to @godlygeek.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @bmeisels, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @erikriver, @FezTheDev, @furlaneto, @gcvasconcelos, @glennrub, @godlygeek, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @jnalezny, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @katlings, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @matt-land, @mattyt, @mchobby, @mchua, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @osterwood, @penguindustin, @PhredFL, @platipo, @ptorrone, @rafa-gould, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @saxenanurag, @schmarty, @scottbelden, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @terriko, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wallarug, @wawachief, 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.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.

Zoom zoom!

4.1.0's biggest feature is speed! General execution of Python should be 2-5x faster and display refreshing will be faster as well.

This is the first beta version for testing. It shouldn't break any code compatible with previous 4.x releases. Please use the latest 4.x stable release (available from the new website!) when first starting with CircuitPython. It is stable.

Download it now from circuitpython.org. See here for the full release notes.

Over 50 boards are now supported by CircuitPython 4.1.0. Check out the new circuitpython.org/downloads page for full list of all available versions.

It's not too late to contribute to CircuitPython! Check out this guide for details. We're always looking to improve and expect many stable releases in the 4.x line to happen through the summer. Subscribe to the Python for Microcontrollers newsletter on adafruitdaily.com for the latest news for all things Python.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

Installation

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

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

New Fixes and Features since 4.0.1

• 2-5x execution speedup thanks to MicroPython configuration change. Thanks to @dhalbert and @shazz
• Display refresh now tracks dirty areas and only refreshes them. This drastically reduces the amount of data to send to displays and therefore speeds them up. Thanks to @tannewt
• Added ps2io module for SAMD51s. Thanks to @elvis-epx
• Group objects are now iterable and have index and remove methods. Thanks to @tannewt
• make stubs can now be used to make pyi stubs for native modules. Thanks to @jreese
• Enable WaveFile sample rates above 2 ** 16. Thanks to @C47D
• Fix mistaken Group GC. Thanks to @ATMakersBill and @dhalbert
• Fix button miss with gamepadshift. Thanks to @kattni, @makermelissa and @deshipu
• Doc updates. Thanks to @jpecor and @tannewt

New Boards

• Electronut Labs Blip. Thanks @ntavish

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @ATMakersBill, @baorepo, @C47D, @deshipu, @dhalbert, @elvis-epx, @jpecor, @jreese, @kattni, @ladyada, @madbodger, @makermelissa, @matt-land, @Mikebarela, @mr. Certainly, @mrmcwethy, @ntavish, @ptorrone, @shazz, @siddacious, @sommersoft, @tannewt, 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.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.

CircuitPython 4.0.1

4.0.1 is our first bugfix release of 4.x and features fixes for two bugs. Download it now from circuitpython.org. See here for the full release notes.

4.x features a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio), extensive new support for pixel-based displays (displayio) (guide here), which will show CircuitPython output on the display, USB MIDI support and messages translated into multiple languages. Current languages are Chinese (Pinyin), English, French, German, Indonesian, Italian, Polish, Spanish, and Tagalog (Filipino). Thank you to the many contributors who make CircuitPython excellent!

Over 50 boards are now supported by CircuitPython 4.0.1. Check out the new circuitpython.org/downloads page for full list of all available versions.

It's not too late to contribute to CircuitPython! Check out this guide for details. We're always looking to improve and expect many stable releases in the 4.x line to happen through the summer. Subscribe to the Python for Microcontrollers newsletter on adafruitdaily.com for the latest news for all things Python.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

Installation

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

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

New Fixes since 4.0.0

• The stage library has been updated to 1.0.2 to fix a new OverflowError with read_palette introduced in 4.0.0-rc.3. Thanks to @deshipu
• Enable round() which was enabled in 3.1.2. Thanks to @dhalbert

Breaking Changes from 3.x!

• ESP8266 and nRF52832 no longer supported. With 4.x we've chosen to focus on microcontrollers with built-in USB to ensure a consistent CircuitPython experience across all boards we support.
• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.
• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.
• bytearray, array.array, and int.to_bytes() now check for values that are too large to fit. This matches CPython behavior. Thanks to @godlygeek.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @erikriver, @FezTheDev, @furlaneto, @gcvasconcelos, @glennrub, @godlygeek, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @katlings, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @matt-land, @mattyt, @mchobby, @mchua, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @osterwood, @penguindustin, @PhredFL, @platipo, @ptorrone, @rafa-gould, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @saxenanurag, @schmarty, @scottbelden, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @terriko, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wallarug, @wawachief, 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.

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.

CircuitPython 4.0.0!

4.0.0 is the latest major revision of CircuitPython and a new stable release!

It features a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio), extensive new support for pixel-based displays (displayio) (guide here), which will show CircuitPython output on the display, USB MIDI support and messages translated into multiple languages. Current languages are Chinese (Pinyin), English, French, German, Indonesian, Italian, Polish, Spanish, and Tagalog (Filipino). Thank you to the many contributors who make CircuitPython excellent!

Many new boards are now supported by CircuitPython 4.0.0. Check out the new circuitpython.org/downloads page for full list of all available versions.

It's not too late to contribute to CircuitPython! Check out this guide for details. We're always looking to improve and expect many stable releases in the 4.x line to happen through the summer. Subscribe to the Python for Microcontrollers newsletter on adafruitdaily.com for the latest news for all things Python.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

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

Breaking Changes from 3.x!

• ESP8266 is no longer supported. With 4.x we've chosen to focus on microcontrollers with built-in USB to ensure a consistent CircuitPython experience across all boards we support.
• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.
• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.
• bytearray, array.array, and int.to_bytes() now check for values that are too large to fit. This matches CPython behavior. Thanks to @godlygeek.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @erikriver, @FezTheDev, @furlaneto, @gcvasconcelos, @glennrub, @godlygeek, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @katlings, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @matt-land, @mattyt, @mchobby, @mchua, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @osterwood, @penguindustin, @PhredFL, @platipo, @ptorrone, @rafa-gould, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @saxenanurag, @schmarty, @scottbelden, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @terriko, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wallarug, @wawachief, 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.1.2.
Here are all the changes since 4.0.0-rc.3.

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.

CircuitPython 4.0.0 Release Candidate 3!

This release candidate includes a few minor fixes. We think this is stable but want you to test it out to be sure. If we don't find anything major, then this will be the 4.0.0 release. If there are any fixes to make we'll follow up with another release candidate.

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

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

4.0.0

4.0.0 is the latest major revision of CircuitPython. It features:

• extensive new support for pixel-based displays (displayio)
• a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio)
• USB MIDI support
• messages translated into multiple languages

Installation

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

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

New Features, Updates, and Fixes since Release Candidate 2

• Fixes to size checking when setting bytearray values. Thanks to @dhalbert and @godlygeek
• Bump frozen stage library to 1.0.1. Thanks to @deshipu
• Documentation improvements. Thanks to @matt-land

New Boards

• Capable Robot USB Hub

Breaking Changes from 3.x!

• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.

• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.
• bytearray, array.array, and int.to_bytes() now check for values that are too large to fit. This matches CPython behavior. Thanks to @godlygeek.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @erikriver, @FezTheDev, @furlaneto, @gcvasconcelos, @glennrub, @godlygeek, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @katlings, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @matt-land, @mattyt, @mchobby, @mchua, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @osterwood, @penguindustin, @PhredFL, @platipo, @ptorrone, @rafa-gould, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @saxenanurag, @schmarty, @scottbelden, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @terriko, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wallarug, @wawachief, 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-rc.2.
Here are all the changes since 3.1.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.

CircuitPython 4.0.0 Release Candidate 2!

This is it (again)! We added a number of last minute fixes and improvements due to PyCon 2019 sprints. We think this is stable but want you to test it out to be sure. If we don't find anything major, then this will be the 4.0.0 release. If there are any fixes to make we'll follow up with another release candidate.

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

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

4.0.0

4.0.0 is the latest major revision of CircuitPython. It features:

• extensive new support for pixel-based displays (displayio)
• a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio)
• USB MIDI support
• messages translated into multiple languages

Installation

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

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

New Features, Updates, and Fixes since Release Candidate 1

• Auto-complete now omits private variables until an _ has been typed. Thanks to @katlings and @deshipu
• Auto-complete inserts spaces when no matches are found. Thanks to @scottbelden
• Reduce M0 Express build size by removing double float math. Thanks to @dhalbert
• Status LED is blue on MPY version mismatch. Thanks to @terriko
• ReloadExceptions no longer show a traceback. Thanks to @tannewt
• on_next_reset now works with safe mode again. Thanks to @tannewt and @hexthat
• Fix crash on nRF boards with internal flash. Thanks to @tannewt and @jerryneedell
• Check int packing into bytes. Thanks to @godlygeek
• Fix displayio.Group scaling. Thanks to @tannewt and @caternuson
• Network fixes thanks to @nickzoic and @gvcp
• Doc updates thanks to @saxenanurag and @mchua

New and Updated Translations

• More Italian translations. Thanks to @FezTheDev
• Spanish translation improvements. Thanks to @rafa-gould, @erikriver, and @sabas1080

New Boards

• Electronic Cats Escornabot Makech. Thanks @sabas1080
• Adafruit PyGamer. Thanks to @ladyada
• Robotics Masters Robo HAT MM1. Thanks to @wallarug

Breaking Changes from 3.x!

• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.

• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @erikriver, @FezTheDev, @furlaneto, @gcvasconcelos, @glennrub, @godlygeek, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @katlings, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @mattyt, @mchobby, @mchua, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @penguindustin, @PhredFL, @platipo, @ptorrone, @rafa-gould, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @saxenanurag, @schmarty, @scottbelden, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @terriko, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wallarug, @wawachief, 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-rc.1.
Here are all the changes since 3.1.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.

CircuitPython 4.0.0 Release Candidate 1!

This is it! We think this is stable but want you to test it out to be sure. If we don't find anything major, then this will be the 4.0.0 release. If there are any fixes to make we'll follow up with another release candidate.

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

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

4.0.0

4.0.0 is the latest major revision of CircuitPython. It features:

• extensive new support for pixel-based displays (displayio)
• a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio)
• USB MIDI support
• messages translated into multiple languages

Installation

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

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

New Features, Updates, and Fixes since Beta 7

• nrf: Added nvm support. Thanks to @nickzoic and @dhalbert
• Add USER_C_MODULE support. Thanks to @dmazzella.
• Added gamepadshift for buttons connected to a shift register. Thanks to @deshipu and @tannewt
• Refreshed the README and fixed PDF build. Thanks to @tannewt
• Clarified I2SOut error messages. Thanks to @C47D and @tannewt
• Fixed backlight flickering. Thanks to @dhalbert
• Update pybadge pinout for production revision. Thanks to @ladyada
• Numerous crash fixes. Thanks to @tannewt

New and Updated Translations

• Tweaks to Polish translation. Thanks to @deshipu
• Additional Chinese (Pinyin) translations. Thanks to @hexthat
• Tweaks to French translation. Thanks to @arofarn

New Boards

• Electronut Labs Papyr. Thanks @ntavish and @ITACAInnovation

Breaking Changes from 3.x!

• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.

• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @alwayslinux2, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @dmazzella, @edspark, @eighthree, @emteeoh, @furlaneto, @gcvasconcelos, @glennrub, @gpshead, @gvcp, @hathach, @hexthat, @iraytrace, @ITACAInnovation, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @jreese, @Juanita, @KacperLa, @kattni, @kdb424, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @mattyt, @mchobby, @mgithubreq, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @ntavish, @OldCrow, @penguindustin, @PhredFL, @platipo, @ptorrone, @Rathmore, @rdagger, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @schmarty, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @TG-Techie, @ThomasRKirkland, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @wawachief, 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-beta.7.
Here are all the changes since 3.1.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.

Note: 4.0.0-rc.0 was tagged but not really released. We wanted to get pybadge changes into the RC that make it work with the production board.

CircuitPython 4.0.0 Release Candidate 0!

Please use 4.0.0 Release Candidate 1. It has a fix for pybadge.

CircuitPython 4.0.0 Beta 7

We are nearing the end of the betas of 4.0.0, and hope this will be the last beta. There are still a few issues to fix before stable. We think the API's are now stable. Please use the latest 3.x stable release (available from the new website!) 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.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

4.0.0

4.0.0 is the latest major revision of CircuitPython. It features:

• extensive new support for pixel-based displays (displayio)
• a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio)
• USB MIDI support
• messages translated into multiple languages

Installation

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

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

New Features, Updates, and Fixes since Beta 6

• Fixed missing rotaryio. Thanks @dhalbert
• nrf52840: Support rtc. Thanks @nickzoic and @dhalbert
• Fixed displayio.Group insert bug. Thanks @caternuson
• Fixed USB issues after disconnect. Thanks @hathach and @dhalbert
• Add data as command support to displayio. Thanks @makermelissa
• Add support for CS toggle every display command. Thanks @makermelissa
• Add input validation in displayio which fixes some crashes. Thanks @tannewt
• Add access do display bus on Display. Thanks @deshipu
• Fix crash when releasing displays multiple times. Thanks @tannewt
• Fix recursive background calls. Thanks @dhalbert
• Add support for board aliases (same bin, separate download). Thanks @tannewt

New and Updated Translations

• Added Chinese (Pinyin) as a new translation. Many thanks to @hexthat

New Boards

• Electronic Cats Bast Pro Mini M0. Thanks @sabas1080
• Adafruit Metro M4 Airlift Lite. Thanks @ladyada
• Kicksat sprite. Thanks @maholli
• CircuitPlayground Express 4H Edition (alias) Thanks @tannewt
• CircuitPlayground Express Digikey PyCon 2019 (alias) Thanks @tannewt
• Gemma M0 PyCon 2018 (alias) Thanks @tannewt
• PewPew 10.3 (alias) Thanks @tannewt

Breaking Changes from 3.x!

• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.

• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @edspark, @eighthree, @emteeoh, @furlaneto, @gcvasconcelos, @glennrub, @gpshead, @hathach, @iraytrace, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @Juanita, @KacperLa, @kattni, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @mattyt, @mchobby, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @OldCrow, @penguindustin, @PhredFL, @platipo, @Rathmore, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @schmarty, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @TG-Techie, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @jreese, @hexthat 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-beta.6.
Here are all the changes since 3.1.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.

CircuitPython 4.0.0 Beta 6!

We are nearing the end of the betas of 4.0.0, and hope to be issuing a release candidate soon. There are still a few issues to fix before stable. We think the API's are now stable. Please use the latest 3.x stable release (available from the new website!) 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.

circuitpython.org

Downloads are now available from circuitpython.org! This site makes it much easier to select the correct file and language for your board. The downloads page is here.

4.0.0

4.0.0 is the latest major revision of CircuitPython. It features:

• extensive new support for pixel-based displays (displayio)
• a port to the Nordic nRF52840 microcontroller, including support as a BLE beacon or peripheral (bleio)
• USB MIDI support
• messages translated into multiple languages

Installation

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

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

New Features, Updates, and Fixes since Beta 5

• Fixed USB HID bug which caused memory corruption that caused a wide variety of issues, including connection issues on certain platforms. Thanks to @tannewt for the fix and @jerryneedell, @mgithubreq, @uhrheber, @tboie, and @emteeoh for a number of different issues that pointed to it.
• Prevent filesystem corruption by flushing data to flash filesystem before soft reboots and regularly during normal operation. Thanks to @dhalbert for the fixes and @kevinjwalters for the issue.
• Fixed a bug in TileGrid that caused memory corruption when pixel_shader was a ColorConverter, causing backgrounds to disappear and crashes. Thanks to @dhalbert for the fix and @jerryneedell for a good test case.
• Fixed USB CDC out buffering. Thanks to @tannewt and @hathach.
• Add reversed() to all builds. Thanks @dhalbert; thanks @ladyada for the suggestion.
• frequencyio is enabled only on SAMD51 for now; not tested yet on SAMD21. Thanks @dhalbert, @sommersoft.
• On nRF boards, allow NFC pins to be used for other purposes; thanks @dhalbert; thanks @uhrheber for the issue.
• Enable nvm for all SAMD boards. Thanks @jrcutler.
• New fontio builtin module for Glyph and BuiltinFont. Thanks @tannewt.
• Improve SPI display initialization. Thanks @makermelissa.
• Add socket.recv_into. Thanks @rhwlo.
• Allow display.Palette to support more than 255 colors. Thanks @deshipu.
• Calculate bpp properly for displayio.Bitmap. Thanks @deshipu.
• Work on ugame10 and pewpew boards. Thanks @deshipu.
• Build infrastructure improvements thanks to @tannewt.
• Fix nRF internal flash write logic. Thanks @dhalbert.
• Added better CPython compatibility to more builds. Thanks @dhalbert; thanks to @Singein for the issue.
• Updated frozen libraries. Thanks @dhalbert.
• Update status RGB LED more promptly. Thanks @tannewt.

New and Updated Translations

• Added Polish as a new translation. Many thanks to @deshipu.
• Updated Spanish translations. Thanks @yeyeto2788.
• Message cleanup thanks to @deshipu.

New Boards

• uChip SAMD21 board; thanks @ITACAInnovation.

Breaking Changes from 3.x!

• ure, ujson, and uerrno renamed to re, json, and errno to reflect that they are subsets of the CPython library modules. Thanks to @dhalbert.

• 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. Thanks to @tannewt.
• Improve struct compatibility with CPython by enforcing stricter types. This may break your code! Thanks to @dhalbert.

Thanks

Thank you to all who used, tested, contributed, helped out, and participated on GitHub and/or Discord:
@adafruit, @anecdata, @arofarn, @arturo182, @ATMakersBill, @barbudor, @brennen, @brentru, @bwshockley, @C47D, @CarlFK, @carlosperate, @caternuson, @CedarGroveStudios, @chalei, @charlesbunaford, @cpforbes, @craigf, @dastels, @deshipu, @dhalbert, @dsiee, @edspark, @eighthree, @emteeoh, @furlaneto, @gcvasconcelos, @glennrub, @gpshead, @hathach, @iraytrace, @Jahor, @jasonp, @jepler, @jay Doscher, @jerryneedell, @jimblom, @johnpark, @JoshuaLowe1002, @Juanita, @KacperLa, @kattni, @kevinjwalters, @klardotsh, @Klowner, @ladyada, @larsks, @madbodger, @maholli, @Makdaam, @makermelissa, @mattyt, @mchobby, @microbuilder, @Mikebarela, @mr. Certainly, @mrmcwethy, @nickzoic, @notro, @OldCrow, @penguindustin, @PhredFL, @platipo, @Rathmore, @Retoc, @rhooper, @sabas1080, @sajattack, @sajattack, @saspa, @schmarty, @Senuros, @ShawnHymel, @siddacious, @sommersoft, @SouthernDragon, @TangoJuliett, @tannewt, @Tasm-Devil, @TG-Techie, @uhrheber, @urish, @vgoodwinv, @xpecex, @yeyeto2788, @jreese 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-beta.5.
Here are all the changes since 3.1.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.