From the GitHub release page:
This is CircuitPython 8.0.0-beta.6, a beta release for 8.0.0. It is relatively stable, but there will be further additions, fixes, and changes before final release.
NOTE: The file for specifying startup values for WiFi, etc., is now called settings.toml
instead of .env
, and uses slightly different syntax. Use double quotes instead of single quotes. Further documentation is here.
WARNING: The flash partitioning for 2MB and 4MB flash ESP32 and ESP32-C3 boards has changed since 8.0.0-beta.2. When you load 8.0.0-beta.3 or later over beta.2 (or vice versa), on these boards, CIRCUITPY will be erased and reformatted.
WARNING: The flash partitioning for the Raspberry Pi Pico W has changed since 8.0.0-beta.1. When you load 8.0.0-beta.2 or later over beta.1 (or vice versa), on the Pico W, CIRCUITPY will be erased and reformatted.
Notable changes to 8.0.0 since 7.3.0
Functionality additions
- Add WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection (available on Espressif and Pi Pico W).
- Add a one-line status bar, which displays connection status, last exception, and version on a terminal window title or on the top line of an attached display. Mu 1.2.0 and Thonny 4.0.x and later are able to suppress status bar information in the REPL output.
- A
settings.toml
file in CIRCUITPY provides environment variable values. Some value names are read by CircuitPython to specify WiFi connection parameters, BLE name, and other startup values. But you can also usesettings.toml
to specify your own parameters for your programs. Values fromsettings.toml
can be retrieved usingos.getenv()
. More details here. - WiFi functionality implemented on the Raspberry Pi Pico W.
- Revised Espressif camera support, now available on ESP32, ESP32-S2, and ESP32-S3.
- Bulk analog input:
analogbufio
(available only on RP2040 for now). - Pin state can be preserved during deep sleep (available only on Espressif for now).
- Allow setting USB VID, PID, manufacturer, and product ids at runtime.
- Enable
collections.deque
on most builds. MP3Decoder
andWaveFile
can now take a filename instead of an open file.AnalogIn
values are full range from 0 to 65535, instead of having zeros on low-order bits.- In-place firmware update (
dualbank
) capability may be disabled in favor of a larger CIRCUITPY drive. - Add
TileGrid.contains()
. - Add
os.utime()
. - Add
espulp
module, for running programs on the ULP RISC-V co-processor Espressif chips. - Add
memorymap
module for general though limited access to various memory regions. - A serial “break” on the USB or UART REPL serial connection will cause a
KeyboardInterrupt
, like ctrl-C. The advantage over ctrl-C is that the break interrupts even if the input buffer is full. - Add
hidden
property tovectorio
shapes. - Add native
_pixelmap.PixelMap
support, for speed. - Chained exceptions are now implemented.
- Add
VfsFat.readonly
property.
Compatibility changes
PulseOut
no longer accepts aPWMOut
. Use aPin
instead.- Auto-brightness support in
displayio
andframebufferio
has been removed. It was never implemented completely. OneWire
is only inonewireio
, and is no longer inbusio
orbitbangio
.gamepadshift
has been removed: usekeypad.ShiftRegisterKeys
instead.- Print out whole-number floats exactly and correctly.
- Restored
rainbowio
andonewireio
to a number of boards. Some boards still haverainbowio
turned off for space reasons. i2ctarget.I2CTarget
is the new name fori2cperipheral.I2CPeripheral
. Accept both for now.I2CPeripheral
is deprecated and will be removed in 9.0.0.- Allow
display.root_group
to be set, instead of usingdisplay.show()
.display.show()
is deprecated and will be removed in 9.0.0. - The property
supervisor.runtime.ble_workflow
replacessupervisor.disable_ble_workflow()
. - The property
supervisor.runtime.next_stack_limit
replacessupervisor.set_next_stack_limit()
. - The property
supervisor.runtime.rgb_status_brightness
replacessupervisor.set_rgb_status_brightness()
.
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:
atmel-samd
: Microchip SAMD21, SAMx5xcxd56
: Sony Spresenseespressif
: Espressif ESP32-S2nrf
: Nordic nRF52840, nRF52833raspberrypi
: Raspberry Pi RP2040stm
: 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 2Wespressif
: ESP32, ESP32-S3, ESP32-C3litex
: fomumimxrt10xx
: NXP i.MX RT10xxxstm
: ST non-STM32F4 chip families
Changes since 8.0.0-beta.5
- Fix errors in DEBUG=1 Cortex-M4 builds. #7368. Thanks @dhalbert.
- Fix
wifi.Authmode
printing. #7349. Thanks @dhalbert. - Update network code to use
gaierror
consistently. #7344. Thanks @jepler. - Replace
.env
withsettings.toml
. Removedotenv
module. #7321. Thanks @jepler. displayio
: setin_group
to false when removing a layer from a group. #7327. Thanks @pypewpew (@deshipu).- Add
VfsFat.readonly
property. #7317. Thanks @s-ol.
Fixes and enhancements
Port and board-specific changes
Broadcom
Espressif
- Support for ULP co-processor by
espulp
andmemorymap
modules. Replacescoproc
. #7359. Thanks @tannewt and thanks to @MicroDev1 for the originalcoproc
module. - Make
master_clock_pin
optional foresp32_camera
, to support boards with built-in clocks. #7355. Thanks @pypewpew (@deshipu).
i.MX
- Fix i.MX builds by redoing pin reset logic. #7345. Thanks @dhalbert.
nRF
RP2040
SAMx
STM
Individual boards
- BananaPi BPI-PicoW-S3: add status LED. #7315. Thanks @RetiredWizard.
- CRCibernetica IdeaBoard: add frozen modules, change flash size. #7356. Thanks @CRCibernetica.
- Invector Labs Challenger 840: update definition. #7331. Thanks @PontusO.
- Raspberry Pi Pico: use on-board LED for status. #7362. Thanks @Neradoc.
- Seeed XIAO nRF52840: add charge rate pin. #7320. Thanks @dhalbert and @PheebeUK.
Documentation changes
- Remove MicroPython
asyncio
documentation; improve libraries page and links. #7324. Thanks @dhalbert.
Build and infrastructure changes
- Fix
unix
build. #7364. Thanks @jepler. - Fix devcontainer (GitHub codespaces) support. #7350. Thanks @bablokb.
- Revert update to
protomatter
library due to regression. #7353. Thanks @jepler. - Fix stub generation. #7341. Thanks @jepler.
- Temporary fix for
tj-actions/changed-files
problem. #7329. Thanks @MicroDev1.
Translation additions and improvements
- Thanks for translations:
- @bergdahl (Swedish)
- @wtuemura (Portugese – Brazil)
New boards since 8.0.0-beta.5
- Invector Labs Challenger RP2040 SD/RTC. #7336. Thanks @PontusO.
Known issues
- See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
Thanks
Thank you to all who used, tested, and contributed since 8.0.0-beta.4, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.