Skip to content

CircuitPython 9.0.0 Alpha 2

Pre-release
Pre-release
Compare
Choose a tag to compare
@dhalbert dhalbert released this 27 Oct 02:05
· 3404 commits to main since this release
9.0.0-alpha.2
4ecc51e
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.

This is CircuitPython 9.0.0-alpha.2, an alpha release for 9.0.0. It has significant known bugs, and will have further additions and fixes before the final release of 9.0.0.

WARNING for nRF52 boards only: If your board has an nRF52 UF2 bootloader whose version is before 0.6.1, you will not be able to load CircuitPython 8.2.0 and later, due to increased size of the firmware. See these instructions for updating your bootloader.

Notable changes to 9.0.0

  • Merge updates from MicroPython v1.19.1, v1.20.0, and v1.21.0.
  • Espressif: update to ESP-IDF v5.1.
  • Remove 8.x.x deprecations: displayio.*.show(), I2CPeripheral: now I2CTarget.
  • Add repl.py, which runs just before the REPL starts up.
  • Add OrderedDict.move_to_end().
  • Add synthio.Synthesizer.note_state.
  • Further USB host support, on i.MX and RP2040.
  • Reorganize and split displayio.
  • Add warnings module, similar to what is in CPython.

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

Documentation

Documentation is available in readthedocs.io.

Port status

CircuitPython has a number of "ports" that are the core implementations for different microcontroller families. Stability varies on a per-port basis. As of this release, these ports are consider stable (but see Known Issues below):

  • atmel-samd: Microchip SAMD21, SAMx5x
  • cxd56: Sony Spresense
  • espressif: Espressif ESP32, ESP32-S2, ESP32-S3, ESP32-C3
  • nrf: Nordic nRF52840, nRF52833
  • raspberrypi: Raspberry Pi RP2040
  • stm: ST STM32F4 chip family

These ports are considered alpha and will have bugs and missing functionality:

  • broadcom: Raspberry Pi boards such as RPi 4, RPi Zero 2W
  • litex: fomu
  • mimxrt10xx: NXP i.MX RT10xxx
  • silabs: Silicon Labs MG24 family
  • stm: ST non-STM32F4 chip families

Changes since 8.2.x split from main

Note: The tags 9.0.0-alpha.0 and 9.0.0-alpha.1 exist, but there are no releases for those tags because their .mpy file formats differ from 9.0.0-alpha.2 and later. 9.0.0-alpha.0 tags the first commit after 8.2.x was branched from main.

Fixes and enhancements

  • Add warnings module and warn about displayio deprecations. #8524. Thanks @tannewt.
  • Merge MicroPython v1.21.0. #8523, #8508. Thanks @dhalbert and @tannewt.
  • Merge MicroPython v1.20.0. #8481. Thanks @dhalbert and @tannewt.
  • Merge MicroPython v1.19.1. #8310, #8281. Thanks @dhalbert and @jepler.
  • Fix subscript operator on subclasses of native classes. #8522. Thanks @tannewt.
  • Raise explanatory error when some_display.show() is used. #8517. Thanks @tannewt.
  • Support for GRB status LEDs. #8497. Thanks @Axeia.
  • Merge fixes from 8.2.x. #8494, #8395, #8342, #8317. Thanks @tannewt, @dhalbert, @jepler.
  • Split off parts of displayio into multiple modules: busdisplay, fourwire, epaperdisplay, i2cdisplaybus, paralleldisplaybus. The existing displayio hierarchy will still be available 9.x.x, but is deprecated, and will be removed in 10.0.0. #8493. Thanks @tannewt.
  • Add qrio.QRDecoder.fin() to locate QR codes without decoding. #8467. Thanks @deshipu.
  • Remove 8.x.x deprecations: displayio.*.show(), I2CPeripheral: now I2CTarget. #8456. Thanks @tannewt.
  • Add dotclock display support. #8440, #8430, #8401, #8351. Thanks @jepler.
  • Do not start web workflow if no password is given. #8367. Thanks @bill88t.
  • Do not add dotfiles to CIRCUITPY on boards without native USB. #8346. Thanks @bill88t.
  • Add repl.py, which runs just before the REPL starts up. #8344. Thanks @jepler.
  • Add .Trash-1000 file so Linux will not store trash files on CIRCUITPY. #8339. Thanks @bill88t.
  • Fix zlib gzip decompression. #8335. Thanks @BJap.
  • Fix FATFS support for non-512-byte block sizes. #8304. Thanks @ccattuto.
  • Fix displayio display layout when logo is disabled. #8300. Thanks @deshipu.
  • Reset current directory before running code.py and other files. #8295. Thanks @deshipu.
  • Update TinyUSb to improve abort handling. #8292. Thanks @tannewt.
  • Improve bitmaptools alphablend features. #8270. Thanks @makermelissa.
  • Add OrderedDict.move_to_end(). #8258. Thanks @jepler and @elpekenin.
  • Update ulab. #8256, #8126. Thanks @jepler.
  • Cache USB configuration descriptor. #8254. Thanks @tannewt.
  • Raise exception when creating a USB device when host isn't initalized. #8242. Thanks @tannewt.
  • Improve displayio error reporting about too many busses. #8231, #8229. Thanks @elpekenin.
  • Align FATFS window buffer for TinyUSB. #8222. Thanks @tannewt.
  • Update frozen modules. #8211. Thanks @FoamyGuy.
  • Fix ssl_context.load_verify_locations(cadata=None). #8192. Thanks @gaweng.
  • Add displayio.Bitmap.bits_per_value. #8191. Thanks @gaweng.
  • Add synthio.Synthesizer.note_state. #8186. Thanks @jepler.
  • Make usb_host.Port be a singleton. #8182. Thanks @tannewt.
  • Fix OrderedDict.fromkeys() to return correct type. #8175. Thanks @kbsriram.
  • Raise exception if os.getenv() is used when settings.toml is not supported. #8169. Thanks @jepler.
  • USB host keyboard map control and other improvements. #8161. Thanks @jepler.
  • More USB host support and keyboard workflow. #8155. Thanks @tannewt.
  • Suppoort multiple data pins with shared clock and latch in keypad.ShiftRegisterKeys. #8143. Thanks @kolkmvd.
  • Add bitmap.blit() skip_self_index parameter. #8136. Thanks @FoamyGuy.
  • Reimplement and improve watchdog. #7718. Thanks @microdev1.

Port and board-specific changes

Broadcom

Espressif

i.MX

nRF

RP2040

SAMx

  • Make it possible to enable async/await on SAMD21. #8338. Thanks @deshipu.
  • Handle RUNMODE_UF2. #8264. Thanks @bcr.
  • Support external clock sources on SAMx5x. #8183. Thanks @Qyriad.

SiLabs

  • Fix watchdog code crash. Add status LEDs. Add flash Makefile target. Reduce build verbosity. #8484. Thanks @tannewt.
  • Change system clock from 39 MHz to 78 MHz. #8458. Thanks @silabs-BelaV.

Spresense

STM

Individual boards

Documentation changes

  • Do not build the support matrix PDF: ReadTheDocs only wants one PDF. #8527. Thanks @tannewt.
  • Fix typo in test README. #8526. Thanks @daanzu.
  • Split support matrix out of PDF doc. #8493. Thanks @tannewt.
  • Improve rotaryio documentation. #8453. Thanks @heygauri.
  • Improve canio documentation. #8298. Thanks @jepler.
  • Fix synthio documentation. #8260. Thanks @jepler.
  • Fix bitmaptools.blit documentation. #8252. Thanks @jepler.
  • Redirect index.html to README.html. #8247. Thanks @jepler.
  • Add circuitpython_typing to intersphinx configuration. Resolve TypeAliased references. Thanks @kbsriram.
  • Note that wifi.radio.ipv4_address_ap is read-only. @8180. Thanks @anecdata.
  • Improve WiFi documentation. #8165. Thanks @anecdata.
  • Fix zlib.decompress documentation. #8125. Thanks @jimmo.

Build and infrastructure changes

Translation additions and improvements

New boards since 8.2.x split from main

Known issues

Thanks

Thank you to all who used, tested, and contributed since the start of 9.0.0, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.

Contributors

bcr, tannewt, and 54 other contributors
Assets 2
Loading