adafruit/circuitpython 8.0.0-rc.0

CircuitPython 8.0.0 Release Candidate 0

on GitHub

This is CircuitPython 8.0.0-rc.0, a release candidate for 8.0.0. We believe it is stable, and are making a release candidate for further testing before final release.

NOTE: Since 8.0.0-beta.6, 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 use settings.toml to specify your own parameters for your programs. Values from settings.toml can be retrieved using os.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.
• 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 at runtime in favor of a larger CIRCUITPY drive. This is the default.
• Add TileGrid.contains().
• Add os.utime().
• Add espulp module, for running programs on the ULP co-processor in 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 to vectorio shapes.
• Add native _pixelmap.PixelMap support, for speed.
• Chained exceptions are now implemented.
• Add VfsFat.readonly property.
• Add memorymap to allow access to raw memory locations (currently only on Espressif). #7359. Thanks @tannewt.

Compatibility changes

• PulseOut no longer accepts a PWMOut. Use a Pin instead.
• Auto-brightness support in displayio and framebufferio has been removed. It was never implemented completely.
• OneWire is only in onewireio, and is no longer in busio or bitbangio.
• gamepadshift has been removed: use keypad.ShiftRegisterKeys instead.
• MP3Decoder and WaveFile can now take a filename instead of an open file.
• Print out whole-number floats exactly and correctly.
• Restored rainbowio and onewireio to a number of boards. Some boards still have rainbowio turned off for space reasons.
• i2ctarget.I2CTarget is the new name for i2cperipheral.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 using display.show(). display.show() is deprecated and will be removed in 9.0.0.
• The property supervisor.runtime.ble_workflow replaces supervisor.disable_ble_workflow().
• The property supervisor.runtime.next_stack_limit replaces supervisor.set_next_stack_limit().
• The property supervisor.runtime.rgb_status_brightness replaces supervisor.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, SAMx5x
• cxd56: Sony Spresense
• espressif: Espressif ESP32-S2
• 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
• espressif: ESP32, ESP32-S3, ESP32-C3
• litex: fomu
• mimxrt10xx: NXP i.MX RT10xxx
• stm: ST non-STM32F4 chip families

Changes since 8.0.0-beta.6

Fixes and enhancements

• Update frozen libraries. #7491. Thanks @dhalbert.
• bitmaptools: Allow drawing lines with ends outside of bitmap. #7467. Thanks @matemaciek.
• Handle ctrl-c interrupts in BLE workflow serial input. #7465. Thanks @tannewt.
• Allow access to web workflow mDNS object. #7461, #7445. Thanks @tannewt.
• Have start and end keywords respect element size. #7444. Thanks @tannewt.
• Improve argument type validation messages, especially for pins. #7437. Thanks @dhalbert.
• Do not chain exceptions to themselves. #7415. Thanks @jepler.
• Update ulab to version 6.0.2. #7413. Thanks @jepler.
• Use random volume IDs when a UID is not available. #7410. Thanks @jepler.
• Fix settings.toml fetching of integer values. #7395. Thanks @jepler.
• Handle settings.toml files that don't end with a newline. #7381. Thanks @jepler.
• Use specified SPI flash maximum baudrate when identifying chip. #7371. Thanks @PontusO.
• Make sure registers are preserved in Thumb version of nlr_push(). #7368. Thanks @dhalbert.
• Improve error message for read-only attributes. #7358. Thanks @dhalbert.
• Revert update to protomatter library due to regression. #7353. Thanks @jepler.
• Fix printing of AuthMode names. #7349. Thanks @dhalbert.
• Fix socketpool.gaierror usages. #7344. Thanks @jepler.

Port and board-specific changes

Broadcom

• Add simulated RTC support. #7474. Thanks @RetiredWizard.

Espressif

• Rename esp32_camera to espcamera, for consistency. #7492. Thanks @MicroDev1.
• Update ESP-IDF to latest release/v4.4 commits. #7486. Thanks @dhalbert.
• espulp.ULP: add support for ULP Finite State Machine. #7473. Thanks @MicroDev1.
• Fix sockets to always be non-blocking internally. #7455. Thanks @dhalbert.
• Do not use deep sleep wakeup cause when light sleeping. #7441. Thanks @tannewt.
• Limit PulseIn values to 65535 or less. #7378. Thanks @DavePutz.
• Rework espulp API. #7359. Thanks @tannewt.
• Add memorymap to allow access to raw memory locations (currently only on Espressif). #7359. Thanks @tannewt.
• Make master_clock_pin really optional. #7355. Thanks @pypewpew (@deshipu).

i.MX

• Use low power RTC. #7463. Thanks @RetiredWizard.
• Properly deinit GPIO pins. #7424. Thanks @RetiredWizard.
• Fix busio.UART parameter validation. #7390. Thanks @RetiredWizard.
• Fix pin resetting to never reset vital pins. #7345. Thanks @dhalbert.

nRF

• Fix microcontroller.on_next_reset(). #7468. Thanks @DavePutz.

RP2040

• Improve determination of reset reason. #7462. Thanks @tannewt.
• Update CYW43 driver. #7439. Thanks @jepler.
• Allow connection to open networks. #7439. Thanks @jepler.
• Clarify that MAC address on CYW43 is read-only #7358. Thanks @dhalbert.

SAMx

• Use memory fence when disabling cache. #7398. Thanks @dhalbert.

STM

Individual boards

• CRCibernetica IdeaBoard ESP32. #7356. Thanks @CRCibernetica.
• Lolin C3 Mini: update pins. #7392. Thanks @chukwon.
• Luatos Core-ESP32C3: update pins and flash mode. #7372. Thanks @evildave666.
• MicroDev microC3: do not expose pins used for external flash. #7458. Thanks @MicroDev1.
• PewPew M4: Re-enable usb_cdc; disable analogio. #7501. Thanks @pypewpew (@deshipu).
• Raspberry Pi Pico: add GP25 as status LED. #7362. Thanks @Neradoc.

Documentation changes

• Improve dualbank documentation. #7503. Thanks @MicroDev1.
• Improve TimeAlarm documentation. #7417. Thanks @tannewt.
• Fix stubs to remove empty imports. #7341. Thanks @jepler.

Build and infrastructure changes

• Allow control in CIRCUITPY_SKIP_SAFE_MODE_WAIT in mpconfigboard.mk. #7502. Thanks @Neradoc.
• Update issue notification workflow. #7493. Thanks @tekktrik.
• Espressif: Improve readability of Espressif partition tables. #7484. Thanks @MicroDev1.
• Improve CI builds in multiple ways. #7499, #7477, #7453, #7428, #7332. Thanks @MicroDev1.
• Fix some errors found by clang scan-build. #7407. Thanks @jepler.
• Ignore .devcontainer files. #7370. Thanks @bablokb.
• Fix unix port builds. #7364. Thanks @jepler.
• Fix devcontainer typo. #7350. Thanks @bablokb.

Translation additions and improvements

• Thanks for translations:
  • @Atalanttore (German)
  • @bergdahl (Swedish)
  • @hexthat (Chinese - Pinyin)
  • @jposada202020 (Spanish)
  • @ocaro (Spanish)
  • @Pixel-Clay (Russain)
  • @wtuemura (Portugese - Brazil)
  • @zaius0930 (Japanese)
• Improve translatability of a message. #7382. Thanks @jepler.

New boards since 8.0.0-beta.6

• 0xCB Helios. #7423. Thanks @0xCB-dev.
• Adafruit Feather ESP32-S2 Reverse TFT. #7478, #7216. Thanks @jepler.
• DoIt ESP32 Devkit V1. #7258. Thanks @m1cha1s.
• E-Fidget 2231puppy. #7412. Thanks @2231puppy.
• Espressif ESP32-S3 DevKitC-1-N32R8. #5999. Thanks @anecdata and @MicroDev1.
• Invector Labs Challenger RP2040 SD/RTC. #7336. Thanks @PontusO.
• M5Stack Atom Echo. #7402. Thanks @CDarius.
• M5Stack Atom Matrix. #7399. Thanks @CDarius.
• 5Stack Atom U. #7422. Thanks @CDarius.
• M5Stack Stick C. #7422. Thanks @CDarius.
• nullbits Bit-C PRO. #7373. Thanks @jaygreco.
• Waveshare Electronics RP2040-LCD-1.28. #7153. Thanks @fonix232.

Known issues

• ESP32-S3 has significant issues with I2C devices that sleep or use clock stretching. Retry operations on these devices as necessary, or use ESP32-S2 boards.
• Espressif boards have ESP-IDF storage leaks and occasionally crash after extended WiFi use.
• See https://github.com/adafruit/circuitpython/issues for other issues, including issues still to be addressed for:
  • 8.0.0
  • 8.x.x
  • long term

Thanks

Thank you to all who used, tested, and contributed since 8.0.0-beta.6, including the contributors above, and many others on GitHub and Discord. Join us on the Discord chat to collaborate.