From the GitHub release page:
This is CircuitPython 8.0.0-beta.4, a beta release for 8.0.0. It is relatively stable, but there will be further additions and fixes before final release.
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 since 8.0.0-beta.3
- ESP32-C3 builds now work again.
- Raspberry Pi Pico W can act as a server, and can use static IP addresses.
Notable changes to 8.0.0 since 7.3.0
Functionality additions
- Added WiFi workflow with browser-based device discovery, filesystem browsing, upload, download, file editing, serial/REPL connection (available only on Espressif for now).
- Added 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. Support for status bar display is also being added to the Mu and Thonny editors.
.env
file in CIRCUITPY specifies WiFI connection parameters, BLE name, and other startup values.dotenv
support:os.getenv()
values are set by values in.env
file. Values can be fetched from otherdotenv
-format files.- 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.
- Enabled
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. - Added
TileGrid.contains()
. - Added
os.utime()
. - Added
coproc
module, for running programs on an on-chip co-processor. Currently available for the RISC-V core on the ESP32-S2 and ESP32-S3.
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
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.3
Fixes and enhancements
- Fix wake alarm saving. #7154. Thanks @dhalbert.
- Fix
_asyncio
ticks. #7138. Thanks @jepler. - Fix missing
_bleio.Characteristic.descriptors
. #7130. Thanks @dhalbert. - Fix assigning attributes of
GeneratorExit
singleton. #7103. Thanks @jepler. - Enhance
coproc
module, includingCoproc Alarm
. #7102, #7091. Thanks @MicroDev1. - Fix
usb_cdc.Serial.read()
if not connected. #7100. Thanks @tannewt.
Port and board-specific changes
Broadcom
Espressif
- Set correct architecture for ESP32-C3 builds and reorganize
mpconfigport.mk
. #7143, #7094. Thanks @MicroDev1. - Fix setup of Espressif
PinAlarm
. #7125. Thanks @dhalbert. - Fix error code for
Socket.recv_into()
. #7123. Thanks @georgboe.
i.MX
nRF
RP2040
- Use correct pin count value. #7089. Thanks @jepler.
SAMx
STM
Individual boards
- Espressif ESP32-S3-BOX: correct SPIRAM settings. #7140. Thanks @dhalbert.
- LOLIN S3: fix and add pin definitions. #7145. Thanks @chukwon.
- Raspberry Pi Pico W:
- Implement
sslsocket
bind
,listen
, andaccept
. #7122. Thanks @jepler. - Enable and use
SOF_REUSEADDR
. #7119. Thanks @jepler. - Allow static IP settings. #7088. Thanks @jepler.
- Implement
- Raspberry Pi Pico and Pico W: add
board.STEMMA_I2C()
for use with Cowbell add-on boards. #7116. Thanks @kattni.
Documentation changes
- Document port and board limitations for built-in modules. #7129, #7097. Thanks @dhalbert.
- Remove
MpyError
. #7104. Thanks @jepler.
Build and infrastructure changes
Translation additions and improvements
- Change phrasing of boot button message so it stands alone as a sentence, making translation easier. #7150. Thanks @Neradoc.
- Thanks for translations:
- @bergdahl (Swedish)
- @Senuros (German)
- @wtuemura (Portugese – Brazil)
New boards since 8.0.0-beta.2
- Frood 42. Keebs. #7124. Thanks @piit79.
- M5Stack ATOM Lite. #7142. Thanks @CDarius.
- M5Stack Core Basic: #7144, #7133, #7120. Thanks @CDarius.
- M5Stack Core Fire: #7113. Thanks @CDarius.
- M5Stack Stamp C3: #7099. Thanks @CDarius.
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.3, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.