Skip to content

Releases: adafruit/circuitpython

CircuitPython 6.2.0 Release Candidate 0

01 Apr 02:35
@dhalbert dhalbert
6.2.0-rc.0
d0ba75e
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0 Release Candidate 0 Pre-release
Pre-release

This release, 6.2.0-rc.0, is the first release candidate for the stable release of CircuitPython 6.2.0. Notable changes since 6.2.0-beta.4 include displayio and vectorio fixes and improvements, many i.MX fixes and additions, and RP2040 I2C improvement. See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, cxd56 (Spresense), nrf, and stm for the F4 family are stable. esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.2.0-beta.4

Full commit log is here.

Fixes and enhancements

  • Turn off remote wakeup in USB configuration descriptor. #4517. Thanks @dhalbert.
  • Correct TypeError message in time. #4509. Thanks @lesamouraipourpre.
  • Allow memoryview() to be used for RGBMatrix. #4501. Thanks @
  • bitbangio.SPI enhancements. #4497. Thanks @jepler.
  • displayio and vectorio internal improvements. Thanks @kmatch98.
  • Correct vectorio.Rectangle sizes. #4484. Thanks @kmatch98.
  • Correct displayioredrawing when using TileGrid.transform_xy. #4464. Thanks @kmatch98.
  • Fix support for MS25R1635F chip. #4460. Thanks @lyusupov.
  • Handle 4-bit colors in bitmaptools properly. #4454, #4455. Thanks @jepler and @kmatch98.
  • Improve handling of dirty areas in displayio.Bitmap. #4432. Thanks @jepler.
  • Mark bitmap area as dirty in bitmaptools.arrayblit(). #4430. Thanks @jepler.
  • display.BitMap can be a memoryview(). #4429. Thanks @jepler.
  • Add reverse_rows capability to bitmaptools.readinto(). #4428. Thanks @kmatch98.

Port and board-specific changes

  • ESP32-S2
    • Use correct byte order for recvfrom_into() port. #4465. Thanks @anecdata.
  • i.MX
  • Fix assertion in busio.UART. #4518. Thanks @jepler.
  • Fix UART pin checking. #4513. Thanks @jepler.
  • Fix SPI gaps. #4487. Thanks @jepler.
  • Correct SPI baudrate. #4474. Thanks @jepler.
  • Fix reset to bootloader. #4442. Thanks @jepler.
  • nRF
    • Fix BLE remote service list crash; fix central pairing. #4437. Thanks @tannewt.
  • RP2040
    • Allow mpconfigboard.mk to override additional build flags. #4519. Thanks @jepler.
    • Calculate I2C SDA hold time, fixing I2C problems with several devices.  #4508, #4499. Thanks @fivdi and @dhalbert.
    • Use nvm.toml for flash settings. #4446. Thanks @tannewt.
  • Spresense
  • STM32
  • i.MX1010 EVK
    • Delete pins that are not connected. #4443. Thanks @jepler.
  • Metro M7 1011
    • Fix flash capacity. #4441. Thanks @jepler.
    • Enable USB MIDI, change flash chip, fix compiler warnings. #4435. Thanks @jepler.
  • QT Py RP2040

Build and infrastructure changes

  • Remove problematic sentence from bug issue template. #4511. Thanks @jepler.
  • List modules for alias boards. #4507. Thanks @Neradoc.
  • Use allowed language list when building circuitpython.org information. #4483. Thanks @Neradoc.
  • Use nvm.toml data for flash device information. #4481. Thanks @tannewt.
  • Use gcc @file mechanism to shorten linker command line. #4480. Thanks @tannewt.
  • Correct USB mount checking so that CIRCUITPY_USB_MSC = 0 will compile. #4462. Thanks @jepler.

Documentation

  • (no PRs in this category)

Translation Additions and Improvements

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly.
  • _bleio.ConnectionError has been removed. Code will now raise the native ConnectionError instead.

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.4, including @anecdata, @bergdahl, @d-c-d, @deshipu, @dhalbert, @FoamyGuy, @gamblor21, @garethhcoleman, @hexthat, @hierophect, @hugodahl, @jepler, @jposada202020, @kmatch98, @ladyada, @lesamouraipourpre, @lyusupov, @miclooking, @microdev1, @Neradoc, @tannewt, @tyomitch, @WarriorOfWire, @weblate, @wtuemura, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

New boards since 6.2.0-beta.4

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly.
  • _bleio.ConnectionError has been removed. Code will now raise the native ConnectionError instead.

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.4, including [[FILLIN]], and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Assets 2
Loading

CircuitPython 6.2.0 beta 4

18 Mar 20:32
@dhalbert dhalbert
6.2.0-beta.4
e3c54b0
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0 beta 4 Pre-release
Pre-release

This release, 6.2.0-beta.4, is the fifth beta release of CircuitPython 6.2.0. Notable changes since 6.2.0-beta.3 include new RP2040 fixes and features, enhancements to bitmaptools, and turning off usb_cdc by default (it can still be enabled in a custom build). See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, cxd56 (Spresense), nrf, and stm for the F4 family are stable. esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.2.0-beta.3

Full commit log is here.

Fixes and enhancements

  • Mark bitmaptools.arrayblit() destination as dirty. #4430. Thanks @jepler.
  • Add displayio.Palette.is_transparent(palette_index). #4426. Thanks @kmatch98.
  • Add uniform board.LED pin names for several boards. More later. #4421. Thanks @kattni.
  • Add bitmaptools.readinto() and bitmaptools.arrayblit(). #4403. Thanks @jepler.
  • Disable usb_cdc, the second USB serial port, by default. it was on by default in 6.2.0-beta.3. It is still available to use in a custom build. #4384. Thanks @dhalbert.
  • Save ~1500 bytes of firmware space via slight changes in vm execution with a minor speed penalty. #4344. Thanks @jepler.
  • Refactor displayio set_pixel for use in bitmap_tools. #4357. Thanks @kmatch98.
  • Update TinyUSB. #4327. Thanks @hathach.
  • Fix regression of TinyUSB version. #4365. Thanks @tannewt.
  • Fix incorrect 16-bit signedness in displayio.TileGrid. #4287. Thanks @deshipu.
  • Fix TileGrid.transpose_xy crash. #4331. Thanks @dhalbert.
  • Update ulab to fix matrix vetor multiplication issue. #4250. Thanks @jepler.
  • Code and documentation cleanups. #4335. #4337, #4338, #4351, #4391. Thanks @tyomitch.

Board- and port-specific changes

Build and infrastructure changes

  • Run code-formatting over source code based and add to pre-commit. #4362, #4415. Thanks @microdev1 and @jepler.
  • Shrink some builds, using optimization flags. #4333. Thanks @dhalbert.
  • Avoid secondary build failure when a test fails. #4340. Thanks @jepler and thanks @microdev1 for the original inspiration PR.
  • Automatically count EXTERNAL_FLASH_DEVICES. #4358. Thanks @jepler.

Documentation

New boards since 6.2.0-beta.3

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly.
  • _bleio.ConnectionError has been removed. Code will now raise the native ConnectionError instead.

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.3, including @ajs256, @askpatrickw, @bergdahl, @caternuson, @danielwarnersmith, @DavePutz, @dglaude, @dhalbert, @dpgeorge, @Edrig, @falkenad, @FBSeletronica, @fede2cr, @FoamyGuy, @hathach, @hexthat, @hierophect, @hugodahl, @ismael-miguel, @jamesbowman, @jepler, @jerryneedell, @jposada202020, @kamtom480, @kattni, @kevinjwalters, @kmatch98, @ladyada, @makermelissa, @microdev1, @mintakka, @MisterD66, @nitz, @Padanian, @siehputz, @skieast, @spe2, @tannewt, @tylercrumpton, @tyomitch, @v923z, @weblate, @wtuemura, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets 2
Loading

CircuitPython 6.2.0 beta 3

04 Mar 02:14
@dhalbert dhalbert
6.2.0-beta.3
dca2989
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0 beta 3 Pre-release
Pre-release

This release, 6.2.0-beta.3, is the fourth beta release of CircuitPython 6.2.0. Across most ports it adds a second USB serial (CDC) channel, adds a bitmaptool module for help with displayio, and removes the limitation on displayio.Group size. The RP2040 port has many enhancements and fixes, and the Spresense port has several improvements as well. See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, cxd56 (Spresense), nrf, and stm for the F4 family are stable. esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.2.0-beta.2

Fixes and enhancements

  • Add bitmaptools for bitmap blit operations. #4268, #4278. Thanks @kmatch98.
  • Add second USB CDC serial channel. #4215. Thanks @dhalbert.
  • displayio.Group now uses a Python list internally. Its size is no longer limited, and it can be sorted. #4233, #4322. Thanks @deshipu and thanks @dhalbert for a fix.
  • Fix compile-time disabling of USB MSC. #4283. Thanks @deshipu.
  • Fix typos for CIRCUITPY_USB_HID_SYS_CONTROL. #4249. Thanks @dhalbert.
  • Avoid pulling in unneeded float/uint64 routines. #4238. Thanks @dhalbert.
  • _pixelbuf: increase performance of brightness scaling. #4258. Thanks @jepler.
  • Add memoryview.cast(). #4231. Thanks @jepler.
  • Add bitops.transpose() function to support piopixl8. #4219. Thanks @jepler.
  • Allow memoryview as argument to exec(). #4206. Thanks @iot49.
  • Remove unneeded adafruit_bus_device.SPIDevice.spi property. #4179. Thanks @dhalbert.
  • Update ulab to 1.7.5. #4229. Thanks @jepler.
  • Fix ability to use the reset button to enter safe mode when .reset_reason is not implemented. #4306. Thanks @Neradoc.

Board- and port-specific changes

Build and infrastructure changes

  • Set SUPEROPT_VM = 0 on most non-Express SAMD21 boards. #4248. Thanks @dhalbert.
  • Shrink flash storage needed for USB descriptor serial number. #4243. Thanks @jepler.
  • Add directory for manually-run tests; add Socket tests. #4187. Thanks @hierophect.
  • Only build translations listed in an allow list. #4298. Thanks @jepler.

Documentation

New boards since 6.2.0-beta.2

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly.
  • _bleio.ConnectionError has been removed. Code will now raise the native ConnectionError instead.

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.2, including @ajs256, @anecdata, @arturo182, @bergdahl, @caternuson, @DavePutz, @deshipu, @dglaude, @dhalbert, @ecasadod, @gamblor21, @hathach, @hexthat, @hierophect, @hugodahl, @iot49, @jamesbowman, @jedgarpark, @jepler, @jerryneedell, @jfabernathy, @joelburton, @jposada202020, @kamtom480, @kattni, @kevinjwalters, @kmatch98, @ladyada, @lesamouraipourpre, @microdev1, @MisterD66, @Neradoc, @rodrigoargumedo, @siehputz, @tannewt, @tawez, @TG-Techie, @UnexpectedMaker, @weblate, @wtuemura, @ZodiusInfuser, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.2.0 beta 2

11 Feb 02:21
@dhalbert dhalbert
6.2.0-beta.2
2061097
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0 beta 2 Pre-release
Pre-release

This is the third beta release of CircuitPython 6.2.0. This release, 6.2.0-beta.2, contains fixes and improvements, most notably for RP2040 and ESP32-S2. See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.2.0-beta.1

Fixes and enhancements

  • pew.tick() now does its own time-keeping. #3536. Thanks @deshipu
  • Fix write_then_readinto() in native adafruit_bus_device I2CDevice. #4146. Thanks @gamblor21.
  • Ensure tud_task() is run on auto-reload to finish USB writes. #4122. Thanks @hathach.
  • Add WEBUSB serial support (turned off by default). #4126. Thanks @FiriaCTO.
  • Clarify I2C pullup error message. #4118. Thanks @BiffoBear.
  • Fix native adafruit_bus_device for boards without longint. #4112. Thanks @gamblor21.
  • Update ulab to 1.7.2. #4089. Thanks @jepler.
  • RGBMatrix: change default to serpentine=True. #4084. Thanks @jepler.

Board- and port-specific changes

  • ESP32-S2:
  • raspberrypi:
    • Fix PWMOut idea of which channels are variable frequency. #4165. Thanks @DavePutz.
    • rp2pio: transfer up to 32 bytes before checking background tasks. Fixes use of short NeoPixel strips. #4155. Thanks @jepler, @gamblor21, and @jerryneedell.
    • neopixel_write: Set NeoPixel pin as output after PIO use, to avoid spurious signals. #4160. Thanks @gamblor21.
    • Initialize display for Lilygo TTGO T8 ESP32-S2. #4124. Thanks @m4tk.
    • Correct maximum allowed number of PIO instructions. #4154. Thanks @LuminousOwl.
    • Update to very latest pico-sdk. Fixes issues with GP15 and adds unique id support. #4141. Thanks @tannewt.
    • Add (internal-only) board.SMPS pin, which toggles internal regulator PWM mode. #4137. Thanks @ferret-guy.
    • Add (internal-only) board.A3/board.VOLTAGE_MONITOR pin. #4125. Thanks @xorbit.
    • Implement microcontroller.reset() and .reset_to_bootloader(). #4123. Thanks @jepler.
    • Support for RTC. #4110. Thanks @microdev1.
    • Support for watchdog timer. #4083. Thanks @microdev1.
    • Change microcontroller.cpu to refer to the current CPU, restoring .cpu.temperature, etc. Add microcontrollers.cpus[]. #4087. Thanks @DavePutz.
    • Enable Gameduino 3x Dazzler support. #4092. Thanks @jamesbowman.
  • mimxrt10xx:
  • nrf:
    • Add UART hardware flow control. #4018. Thanks @iot49.
  • Metro M4 Airlift Lite:

Build and infrastructure changes

  • Add bitmap_font to sys.path in a better place to fix builds. #4140. Thanks @FoamyGuy.
  • Update to actions/cache@v2. #4090. Thanks @jepler.
  • Fix circuitpython.org automatic PR new-languages list. #4080. Thanks @tannewt.

Documentation

New boards since 6.2.0-beta.1

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt.
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.1, including @ajs256, @anecdata, @Anton-2, @bergdahl, @BiffoBear, @bspsbee, @BumblebeeMan, @DavePutz, @dglaude, @dhalbert, @ecasadod, @fede2cr, @ferret-guy, @FiriaCTO, @FoamyGuy, @gamblor21, @hathach, @hexthat, @hierophect, @hugodahl, @jamesbowman, @jepler, @jerryneedell, @jfabernathy, @kamtom480, @ladyada, @LuminousOwl, @m4tk, @microdev1, @Neradoc, @netroy, @nichols10, @rpavlik, @siehputz, @skieast, @StarWitch, @tannewt, @tawez, @theacodes, @weblate, @wtuemura, @xorbit,, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.2.0-beta.1

27 Jan 21:35
@dhalbert dhalbert
6.2.0-beta.1
c1c1a5d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0-beta.1 Pre-release
Pre-release

This is the second beta release of CircuitPython 6.2.0. This release, 6.2.0-beta.1, contains fixes and improvements, most notably for RP2040, ESP32-S2, and Spresense. See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Firmware downloads are available from the downloads page on circuitpython.org. The site makes it easy to select the correct file and language for your board.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.2.0-beta.0

Fixes and enhancements

  • Re-enable native adafruit_bus_device, and enable it to support duck typing. #3936. Thanks @gamblor21.
  • EVE graphics library: change integer arguments to floating point, to match OpenGL. #4051. Thanks @jamesbowman.
  • Update protomatter library to support RGBMatrix tiling.. #4068. Thanks @jepler.

Board- and port-specific changes

  • ESP32-S2: Add initial displayio.ParallelBus support. #4047. Thanks @kmatch98.
  • Metro M4 Airlift Lite: Turn on EVE graphics library to support Gameduino 3X Dazzler. #4054. Thanks @dglaude.
  • raspberrypi:
    • Fix DigitalInOut.pull to return correct value. #4052. Thanks @tannewt.
    • Raise NotImplementedError when trying to use UART. #4071. Thanks @tannewt.
    • Add GP15 to available pins. #4063. Thanks @dhalbert.
  • Spresense: Update Spresense SDK and fix USB CDC after TinyUSB update. #4064. Thanks @kamtom48.

Build and infrastructure changes

  • Add CIRCUITPY_* switches for binascii, errno, json, and re. Update documentation about those modules. #4060. Thanks @dhalbert.

Documentation

  • Update Design Guide for CO2 and eCO2 driver parameter names. #4070. Thanks @rpavlik.
  • Translation additions and improvements. Thanks:

New boards since 6.2.0-beta.0

(none)

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt.
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

Known issues

  • ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2. #3846.
  • Writing several larger files to CIRCUITPY when there is no serial connection to the board can take a long time or hang. To speed up copying, open a serial (REPL) connection. #3986.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.2.0-beta.0, including @bergdahl, @dglaude, @dhalbert, @gamblor21, @hexthat, @hierophect, @jamesbowman, @jepler, @kamtom480, @kmatch98, @ladyada, @rpavlik, @tannewt, @tawez, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.2.0 Beta 0

22 Jan 18:44
@dhalbert dhalbert
6.2.0-beta.0
0dfa9fb
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.2.0 Beta 0 Pre-release
Pre-release

This is the first beta release of CircuitPython 6.2.0. Most notably, this release, 6.2.0-beta.0, provides preliminary support for the Raspberry Pi RP2040 chip, including the Raspberry Pi Pico and Adafruit's own RP2040 boards. See Port status below for details on port stability for each port, and Known issues for known problems. If you find any issues with this release, please file an issue. If no significant issues are found within a few days, we'll release this version as stable.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, raspberrypi, and stm for other STM chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.1.0

Fixes and enhancements

Board- and port-specific changes

  • ESP32-S2:
    • Add TCP Server support. #3854. Thanks @hierophect.
    • Improve wifi checking about whether already connected when trying to connect. #4017. Thanks @anecdata.
    • Do not go into safe mode on watchdog reset. #4011. Thanks @dheera.
    • Initialize touch in proper order. Fixes TouchIn and TouchAlarm. #4021. Thanks @dhalbert.
    • Revert FeatherS2 status DotStar due to LDO2 issues. #4013. Thanks @jerryneedell.
  • STM32 BlackPill: Add additional board build that supports an external SPI chip. #4028. Thanks @djix123.
  • ItsyBitsy M4: Fix erroneous comment in mpconfigboard.h. #4019. Thanks @mrangen.
  • raspberrypi:

Build and infrastructure changes

(none)

Documentation

New boards since 6.1.0

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt.
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

Known issues

  • ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2. #3846.
  • Built-in adafruit_bus_device has been disabled due to issues (#3859, #3856), please install the version from the Library Bundle
  • Writing several larger files to CIRCUITPY when there is no serial connection to the board can take a long time or hang. To speed up copying, open a serial (REPL) connection. #3986.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.1.0, including @DavePutz, @dhalbert, @dheera, @djix123, @hierophect, @iot49, @jepler, @jerryneedell, @mrangen, @tannewt, and many others on Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.1.0

21 Jan 03:11
@dhalbert dhalbert
6.1.0
c4f0325
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.1.0

This is CircuitPython 6.1.0, the latest minor revision of CircuitPython, and is a new stable release. See Port status below for details on port stability, and Known Issues for known problems. If you find any issues with this release, please file an issue.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, and stm for other chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.0.1

The changes are extensive and too long to list here. Please see these releases for details:

New boards since 6.0.1

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

Known issues

  • FeatherS2: The DotStar status implementation causes issues with control of LDO2. See #4012. This change has been reverted builds beyond 6.1.0: please use an "Absolute Newest" build or a release later than 6.1.0.
  • ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2. #3846.
  • Built-in adafruit_bus_device has been disabled due to issues (#3859, #3856), please install the version from the Library Bundle
  • Writing several larger files to CIRCUITPY when there is no serial connection to the board can take a long time or hang. To speed up copying, open a serial (REPL) connection. #3986.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.0.1. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.1.0 Release Candidate 1

15 Jan 03:03
@dhalbert dhalbert
6.1.0-rc.1
c4f0325
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.1.0 Release Candidate 1 Pre-release
Pre-release

This is the second release candidate of CircuitPython 6.1.0. See Port status below for details on port stability, and Known Issues for known problems. If you find any issues with this release, please file an issue. If no significant issues are found within a few days, we'll release this version as stable.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, and stm for other chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

Changes since 6.1.0 Release Candidate 0

Fixes and enhancements

Board- and port-specific changes

  • atmel-samd and nrf: Tick counter was being truncated when copied. #3939. Thanks @dhalbert.
  • atmel-samd:
  • nrf:
    • Fix BLE timeout check for start_scan(). Round float BLE timing values instead of truncating. #3942, #2930. Thanks @dhalbert.
    • Don't check length on gattc write for remote characteristics or descriptors. #3993. Thanks @dhalbert.
  • MagTag:
  • ESP32-S2:
    • Implement I2SAudioOut. #3733. Thanks @jepler.
    • Convert README to .rst. #3945. Thanks @2bndy5.
    • Correct data length for socket.recvfrom_into(). #3955. Thanks @caiokat.
    • Add sys.platform. #3954. Thanks @anecdata.
    • FeatherS2: Use DotStar for status LED. #3930. Thanks @jerryneedell.
    • Add network.authmode. #3944. Thanks @BennyE.
    • Add debug logging for all WiFi events; remove unneeded WiFi setup call. #3903. Thanks @anecdata.
    • Reduce power consumption when TouchAlarm not in use; allow multiple TouchAlarm pins. #3969. Thanks @microdev1.
  • TG-Watch: Multiple revisions, including frozen modules. #3991. Thanks @TG-Techie.

Build and infrastructure changes

  • Pass DEBUG make flag into code with CIRCUITPY_DEBUG preprocessor macro. #3957. Thanks @dhalbert.
  • Shrink some German builds that no longer fit. #3983. Thanks @dhalbert.
  • ESP32-S2: Fix make flash. #3982. Thanks @jepler.
  • Add robots.txt so search engines won't crawl obsolete documentation in ReadTheDocs. #3291. Thanks @dhalbert.
  • Bump key for GitHub Actions cache to avoid bad cached data. #3997. Thanks @dhalbert.
  • Update uzlib to version 2.9.5, used in unix build. #4002. Thanks @jepler.
  • Fix parallel build problem for unix build. #4004. Thanks @jepler.

Documentation

New boards since 6.1.0 Release Candidate 0

  • Adafruit Feather ESP32-S2 mini module with and without TFT display. #3959. Thanks @ladyada.
  • Adafruit NeoPixel Trinkey. #3978. Thanks @ladyada.

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

Known issues

  • ESP32-S2: Crash when repeatedly creating and destroying busio.I2C object on ESP32-S2. #3846.
  • Built-in adafruit_bus_device has been disabled due to issues (#3859, #3856), please install the version from the Library Bundle
  • Writing several larger files to CIRCUITPY when there is no serial connection to the board can take a long time or hang. To speed up copying, open a serial (REPL) connection. #3986.
  • See https://github.com/adafruit/circuitpython/issues for other issues.

Thanks

Thank you to all who used, tested, and contributed since 6.1.0 Release Candidate 0, including @2bndy5, @anecdata, @BennyE, @BumblebeeMan, @caiokat, @caternuson, @dhalbert, @hugodahl, @jepler, @jerryneedell, @kattni, @ladyada, @microdev1, @sommersoft, @tannewt, @TG-Techie, @weblate, @wtuemura, and many others on Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.1.0 Release Candidate 0

06 Jan 02:42
@dhalbert dhalbert
6.1.0-rc.0
7e59ff3
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.1.0 Release Candidate 0 Pre-release
Pre-release

This is the first release candidate of CircuitPython 6.1.0. See Port status below for details on port stability, and Known Issues for known problems. If you find any issues with this release, please file an issue. If no issues are found within a few days, we'll release this version as stable.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, and stm for other chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality.

New features and improvements since 6.1.0 Beta 3

Fixes and enhancements

Board- and port-specific changes

Documentation

Full commit log is here.

Breaking changes since 5.x

  • i2cslave is now i2cperipheral and the class in it is changed as well.
  • The stop kwarg has been removed from I2C.writeto(). If no stop is desired, then use writeto_then_readfrom.
  • The default speed of busio.I2C and board.I2C is now 100khz, not 400khz as before. Use busio.I2C to set the speed explicitly. #3471 Thanks @caternuson, @ladyada, @hierophect and @tannewt
  • _bleio.ConnectionError has be removed. Code will now raise the native ConnectionError instead.

New boards since 6.1.0 Beta 3

(none)

Known issues

Thanks

Thank you to all who used, tested, and contributed since 6.1.0 Beta 3, including @askpatrickw, @bergdahl, @brrzap, @bwshockley, @DavePutz, @dglaude, @dhalbert, @hugodahl, @jepler, @kattni, @ladyada, @microdev1, @oonid, @tannewt, @UnexpectedMaker, @wtuemurua, and many others on Discord. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading

CircuitPython 6.1.0 Beta 3

30 Dec 22:40
@jepler jepler
6.1.0-beta.3
5698b8b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
CircuitPython 6.1.0 Beta 3 Pre-release
Pre-release

This is the Beta 3 release of CircuitPython 6.1. Please use 6.0.x if you need a stable version of CircuitPython on all ports except ESP32-S2. Please use this release or newer for the ESP32-S2. See port status below for more stability details.

Notable in this release are a number of ESP32-S2 additions and fixes, bringing us closer to a stable release for that port. There are 2 new boards and one new board revision included in this release.

Download from circuitpython.org

Downloads are available from circuitpython.org. The site makes it easy to select the correct file and language for your board. The downloads page is here. Downloads are no longer available from the GitHub release pages because of the large number of files for each release.

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

Port status

CircuitPython has a number of "ports" that are the core implementation for a variety of microcontroller families. Stability varies on a per-port basis. As of this release, atmel-samd, nrf, and stm for the F4 family are stable. cxd56, esp32s2, and stm for other chip families are being actively improved but may be missing functionality and have bugs. litex and mimxrt10xx are in an alpha state and will have bugs and missing functionality. For all unstable ports, please use the latest pre-release.

New features and improvements since 6.1.0-beta.2

All ports

ESP32-S2

SAMD21 ("M0")

  • Remove warning about lack of support on M0 from rotaryio (#3806), thanks @deshipu

SAMD51 ("M4")

  • SAMD51: change of DAC power setting (#3880), thanks @digixx
  • FrequencyIn: do not raise in interrupt handler (#3867), thanks @dhalbert

AirLift

  • Rename misnamed ESP UART pins on some boards. #3770. Thanks @dhalbert.

STM

Translations

fomu

New boards

Known issues

Thanks

Thank you to @Anton-2, @BennyE, @bergdahl, @cwalther, @deshipu, @dhalbert, @digixx, @djix123, @hierophect, @hugodahl, @jepler, @mcauser, @microdev1, @ryevertigo, @skerr92, @skieast, @StackRduino, @tannewt, @vkuthan, @wtuemura, @xobs, and all who used, tested, and contributed since 6.1.0-beta.2. Join us on the Discord chat to collaborate.

Documentation

Documentation is available in readthedocs.io.

This release is based on MicroPython 1.9.4 @25ae98f. Support upstream MicroPython by purchasing a PyBoard (from Adafruit here) or sponsoring MicroPython on GitHub.

Translations

One important feature of CircuitPython is translated control and error messages. With the help of fellow open source project Weblate, we're making it even easier to add or improve translations. Sign in with an existing account such as Github, Google or Facebook and start contributing through a simple web interface. No forks or pull requests needed!

Troubleshooting

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

Assets

Builds are no longer stored as assets on this release page, because there are too many of them. Please see the Download from circuitpython.org section above.

Assets 2
Loading