Zephyr 3.4.0
We are pleased to announce the release of Zephyr version 3.4.0.
Major enhancements with this release include:
Input subsystem: handles input events from various types of input devices and distributes them to other threads in the application.
Barrier API: added architecture agnostic API for data memory barriers.
USB Device support:
USB device controller API (UDC API) and nRF USBD controller driver.
USB device stack implementation using new UDC API.
Added Power Delivery Source Support to the USB-C Stack.
Bluetooth: Added support for Periodic Advertising with Responses (PAwR).
Cache API functions are now fully in-lined by compilers.
Added an API for real-time clocks (RTC).
Added Retention subsystem.
Added initial support for MMU on Xtensa.
SMBus (System Management Bus) API.
Various improvements to the testing framework and twister:
Introduction of 3 new test harnesses into twister supporting pyTest, GoogleTest and Robot Framework.
Transitioning to new Ztest API was completed and legacy Ztest was deprecated.
Added Snippets: Support common configuration settings that can be used across platforms.
The following sections provide detailed lists of changes by component.
API Changes
Changes in this release
Any applications using the mcuboot image manager (
CONFIG_MCUBOOT_IMG_MANAGER) will now need to also selectCONFIG_FLASH_MAPandCONFIG_STREAM_FLASH, this prevents a cmake dependency loop if the image manager Kconfig is enabled manually without also manually enabling the other options.Including hawkbit in an application now requires additional Kconfig options to be selected, previously these options would have been selected automatically but have changed from
selectoptions in Kconfig files todepends on:Including updatehub in an application now requires additional Kconfig options to be selected, previously these options would have been selected automatically but have changed from
selectoptions in Kconfig files todepends on:The sensor driver API clarified
sensor_trigger_set()to state that the user-allocated sensor trigger will be stored by the driver as a pointer, rather than a copy, and passed back to the handler. This enables the handler to useCONTAINER_OFto retrieve a context pointer when the trigger is embedded in a larger struct and requires that the trigger is not allocated on the stack. Applications that allocate a sensor trigger on the stack need to be updated.Converted few drivers to the Input subsystem.
gpio_keys: moved out ofgpio, replaced the custom API to use input events instead, thezephyr,gpio-keysbinding is unchanged but now requireszephyr,codeto be set.ft5336: moved from Keyboard Scan to Input, renamed the Kconfig options fromCONFIG_KSCAN_FT5336,CONFIG_KSCAN_FT5336_PERIODandKSCAN_FT5336_INTERRUPTtoCONFIG_INPUT_FT5336,CONFIG_INPUT_FT5336_PERIODandCONFIG_INPUT_FT5336_INTERRUPT.kscan_sdl: moved from Keyboard Scan to Input, renamed the Kconfig option fromKSCAN_SDLtoCONFIG_INPUT_SDL_TOUCHand the compatible fromzephyr,sdl-kscantozephyr,input-sdl-touch.nuvoton,npcx-kscanmoved to Input, renamed the Kconfig option names fromKSCAN_NPCX_...toINPUT_NPCX_KBD...and the compatible fromnuvoton,npcx-kscantonuvoton,npcx-kbd.Touchscreen drivers converted to use the input APIs can use the
zephyr,kscan-inputdriver to maintain Kscan compatibility.
The declaration of
main()has been changed fromvoid main(void)toint main(void). The main function is required to return the value zero. All other return values are reserved. This aligns Zephyr with the C and C++ language specification requirements for “hosted” environments, avoiding compiler warnings and errors. These compiler messages are generated when applications are built in “hosted” mode (which means without the-ffreestandingcompiler flag). As the-ffreestandingflag is currently enabled unless the application is using picolibc, only applications using picolibc will be affected by this change at this time.The following network interface APIs now take additional,
struct net_if * ifaceparameter:MCUmgr transports now need to set up the struct before registering it by setting the function pointers to the function handlers, these have been moved to a
functionsstruct object of typesmp_transport_api_t. Because of these changes, the legacy transport registration function and object are no longer available. The registration function now returns a value which is 0 for success or a negative error code if an error occurred.Added a new flag
dac_channel_cfgbufferedfor DAC channels indac_channel_cfgto allow the configuration of the output buffer. The actual interpretation of this depends on the hardware and is so far only implemented for the STM32 DAC driver. Implicitly for this driver this changes the default from being buffered to unbuffered.MCUmgr fs_mgmt group’s file access hook is now called for all fs_mgmt group functions (adding support for file status and file hash/checksum). In addition, if the file access state is not lost, it will now only be called once for the file access instead of each time a command is received. Note that the structure for the notification has changed, the
uploadbool has been replaced with an enum to indicate what function is used, seefs_mgmt_file_accessfor the new structure definition.Iterable sections API is now available at include/zephyr/sys/iterable_sections.h. LD linker snippets are available at include/zephyr/linker/iterable_sections.h.
Cache API functions are now fully inlined by compilers.
The Bluetooth HCI headers have been reworked, with
hci.hnow containing only the function prototypes and the newhci_types.hdefining all HCI-related macros and structs. The previoushci_err.hhas been merged intohci_types.h.
Removed APIs in this release
Pinmux API has been removed. Pin control needs to be used as its replacement, refer to Pin Control for more details.
Deprecated in this release
Configuring applications with
prj_<board>.conffiles has been deprecated, this should be replaced by using a prj.conf with the common configuration and board-specific configuration in board Kconfig fragments in theboardsfolder of the application.On nRF51 and nRF52-based boards, the behavior of the reset reason being provided to
sys_reboot()and being set in the GPREGRET register has been dropped. This function will now just reboot the device without changing the register contents. The new method for setting this register uses the boot mode feature of the retention subsystem, see the boot mode API for details. To restore the deprecated functionality, enableCONFIG_NRF_STORE_REBOOT_TYPE_GPREGRET.Deprecated
PTHREAD_BARRIER_DEFINEin favor of the standardizedpthread_barrier_init()On all STM32 targets except STM32F2 series, Ethernet drivers implementation based on STM32Cube Ethernet API V1 (
CONFIG_ETH_STM32_HAL_API_V1) is now deprecated in favor of implementation based on more reliable and performant STM32Cube Ethernet API V2.Legacy Ztest API was deprecated. All new tests shall use the new Ztest API.
Stable API changes in this release
Removed bt_set_oob_data_flag and replaced it with two new API calls: *
bt_le_oob_set_sc_flag()for setting/clearing OOB flag in SC pairing *bt_le_oob_set_legacy_flag()for setting/clearing OOB flag in legacy paringSYS_INITcallback no longer requires adeviceargument. The new callback signature isint f(void). A utility script to automatically migrate existing projects can be found in scripts/utils/migrate_sys_init.py.Changed
spi_configcs(spi_cs_control) from pointer to struct member. This allows using the existing SPI dt-spec macros in C++. SPI controller drivers doingNULLchecks on thecsfield to check if CS is GPIO-based or not, must now usespi_cs_is_gpio()orspi_cs_is_gpio_dt()calls.
New APIs in this release
Introduced
flash_ex_op()function. This allows to perform extra operations on flash devices, defined by Zephyr Flash API or by vendor specific header files. Support for extra operations is enabled byCONFIG_FLASH_EX_OP_ENABLEDwhich depends onCONFIG_FLASH_HAS_EX_OPselected by driver.Introduced Real-Time Clock (RTC) API which adds experimental support for real-time clock devices. These devices previously used the Counter API combined with conversion between unix-time and broken-down time. The new API adds the mandatory functions
rtc_set_time()andrtc_get_time(), the optional functionsrtc_alarm_get_supported_fields(),rtc_alarm_set_time(),rtc_alarm_get_time(),rtc_alarm_is_pending()andrtc_alarm_set_callback()are enabled withCONFIG_RTC_ALARM, the optional functionrtc_update_set_callback()is enabled withCONFIG_RTC_UPDATE, and lastly, the optional functionsrtc_set_calibration()andrtc_get_calibration()are enabled withCONFIG_RTC_CALIBRATION.Introduced Auxiliary Display (auxdisplay) for auxiliary (alphanumeric-based) displays.
Introduced Barriers API for barrier operations.
Added
CAN_FRAME_ESICAN-FD Error State Indicator flag.
Kernel
Removed absolute symbols
___cpu_t_SIZEOF,_STRUCT_KERNEL_SIZE,K_THREAD_SIZEOFand_DEVICE_STRUCT_SIZEOF
Architectures
ARC
Added MPUv8 support
Add support of virtual UART over ARC hostlink channel
Improved ARCv2 HS4x processors handling - added proper Kconfig options, provided default mcpu
Improved ARCMWDT toolchain handling:
added rollback to check METAWARE_ROOT if ARCMWDT_TOOLCHAIN_PATH missing
reworked extra warnings options handling in twister so it can be used with ARCMWDT
used 64bit MDB binary by default
Fixed excessive ROM memory consumption if MPU is enabled and ROM & RAM are located in different memory regions
Fixed DSP registers handling in case of ARCMWDT
Improved SMP handling:
Fixed potential livelock in thread abort due to exception
Fixed IDU mask setup
Removed absolute symbols
___callee_saved_t_SIZEOFand_K_THREAD_NO_FLOAT_SIZEOF
ARM
Removed absolute symbols
___basic_sf_t_SIZEOF,_K_THREAD_NO_FLOAT_SIZEOF,___cpu_context_t_SIZEOFand___thread_stack_info_t_SIZEOFEnabled fp16 for Cortex-M55
Fixed a compilation issue with arm-clang and TrustZone
Implemented a new cache-management API
Added support for generating zImage headers
Introduced a new
z_arm_on_enter_cpu_idle()hook on CPU idle
ARM64
Removed absolute symbol
___callee_saved_t_SIZEOFEnabled FPU and FPU_SHARING for v8r aarch64
Fixed the STACK_INIT logic during the reset
Introduced and enabled safe exception stack
Fixed possible deadlock on SMP with FPU sharing
Added ISBs after SCTLR Modifications
NIOS2
Removed absolute symbol
_K_THREAD_NO_FLOAT_SIZEOF
POSIX:
Added
Z_SPIN_DELAYto allow to conditionally compile a k_busy_wait() for this arch in tests and samples.
RISC-V
Added
CONFIG_PMP_NO_TOR,CONFIG_PMP_NO_NA4, andCONFIG_PMP_NO_NAPOTto allow disabling unsupported PMP range modes.Removed unused symbols:
_thread_offset_to_tp,_thread_offset_to_priv_stack_start,_thread_offset_to_user_sp.Added support for setting PMP granularity with
CONFIG_PMP_GRANULARITY.Switched from accessing CSRs from inline assembly to using the
csr_read()helper function.Enabled single-threading support.
SPARC
Removed absolute symbol
_K_THREAD_NO_FLOAT_SIZEOF
Xtensa
Fixed the cross stack call mechanism during nested interrupts where stack would be corrupted under certain conditions.
Added initial support for MMU on Xtensa.
Now supports building with
CONFIG_MULTITHREADINGdisabled so target can run in single thread only operations.Added C structs to represent interrupt frames to help with debugging.
Bluetooth
General
Moved all logging symbols together in a new
Kconfig.loggingfile.Deprecated the
BT_DEBUG_LOGoption. InsteadBT_LOGshould be used.Made the
BT_LOGandBT_LOG_LEGACYoptions hidden.Removed
BT_DEBUGentirely.
Audio
Implemented the CAP initiator broadcast audio start, stop and metadata update procedures.
Implemented the CAP unicast audio start, stop and metadata update procedures.
Implemented the Telephony and Media Audio Service (TMAS).
Added additional validation for MCC and MCS, including opcodes, values, etc.
Refactored and extended the scan delegator implementation, including integration with broadcast sink.
Added support for creating a broadcast sink from a PA sink.
Added support for optional characteristics in CSIP.
Implemented discovery by UUID instead of reading by UUID for multiple characteristics.
Added support for long reads and writes for multiple profiles.
Added support for long BAP ASE notifications and optimized long notify reads.
Offloaded MCS notifications to the system workqueue.
Added the CAP initiator cancel procedure.
Direction Finding
Host
Updated the Host to the v5.4 specification.
The GATT DB Hash is now recalculated upon loading settings.
Added experimental support for SMP keypress notifications.
Downgraded the severity of select log messages to avoid log flooding.
Separated the handling of LE SC OOB pairing from the legacy OOB logic.
Implemented the Encrypted Advertising Data feature.
Added support for the new Periodic Advertising with Responses (PAwR), both as an advertiser and as a scanner.
Added support for initiating connections from PAwR, as well as receiving connections while synced.
Clarified the behavior that is enabled by the
BT_PRIVACYKconfig option.Introduced a new
seg_recvL2CAP API for an application to receive segments directly and manage credits explicitly.
Mesh
Added experimental support for Mesh Protocol d1.1r18 specification, gated by a new configuration option. This includes:
Enhanced Provisioning Authentication support.
Mesh Remote Provisioning support including:
Remote Provisioning Server and Client models.
Composition Data Page 128 and Models Metadata Page 128 support.
Large Composition Data support including:
Large Composition Data Server and Client models.
Models Metadata Page 0 support.
New Transport Segmentation and Reassembly (SAR) implementation including:
SAR Configuration Server and Client models.
Mesh Private Beacons support including:
Mesh Private Beacon Server and Client models.
Opcodes Aggregator support including:
Opcodes Aggregator Server and Client models.
Proxy Solicitation support including:
Solicitation PDU RPL Configuration Server and Client models.
On-Demand Private Proxy Server and Client models.
Composition Data Page 1 support.
Other Mesh Profile Enhancements.
Added experimental support for Mesh Binary Large Object Transfer Model d1.0r04_PRr00 specification.
Added experimental support for Mesh Device Firmware Update Model d1.0r04_PRr00 specification.
Fixed multiple profile errata.
Added experimental support for the PSA crypto APIs.
Added a new work queue to store mesh settings, including a new API for storing user data.
Disabled the models initialization macros for C++ as they use the compound literal feature from C99.
Deprecated Health Client and Configuration Client API have been removed.
Controller
Implemented support for the central with multiple CIS usecase.
Implemented support for multiple peripheral CIS establishment.
Updated the Controller to the v5.4 specification.
Added support for coexistence with other transceivers.
Added support for multiple CIS/CIG setup/connect and teardown procedures in sequence.
Extended the ticker API to return expiration info.
Re-implemented Extended and Periodic Advertising, as well as and Broadcast ISO, using the new ticket expiration info feature.
Modified the ticker implementation to reschedule unreserved tickers that use
ticks_slot_window. Implement continuous scanning with it.Added support for considering the SDU interval, along with the packet sequence number and time stamps, in SDU fragmentation.
Added a new
BT_CTRL_TX_PWR_DBMoption to set the TX power directly in dBm.Optimized the RX path with support for piggy-backing notifications on already-allocated RX nodes.
HCI Driver
Boards & SoC Support
Added support for these SoC series:
STM32C0 series are now supported (with introduction of STM32C031 SoC).
STM32H5 series are now supported (with introduction of STM32H503 and STM32H573 SoCs).
Added support for STM32U599 SoC variants
Nordic Semiconductor nRF9161
Removed support for these SoC series:
Made these changes in other SoC series:
Added support for these ARC boards:
DesignWare ARC HS4x/HS4xD Development Kit (HSDK4xD) - ARCv2 HS47D, SMP 4 cores
nsim_hs3x_hostlink - simulation (nSIM-based) platform with hostlink UART
Added support for these ARM boards:
Aconno ACN52832
Alientek STM32L475 Pandora
Arduino GIGA R1 Wi-Fi
BeagleConnect Freedom
Infineon PSoC™ 6 BLE Prototyping Kit (CY8CPROTO-063-BLE)
Infineon PSoC™ 6 Wi-Fi BT Prototyping Kit (CY8CPROTO-062-4343W)
Infineon XMC4700 Relax Kit
MXChip AZ3166 IoT DevKit
Nordic Semiconductor nRF9161 DK
NXP MIMXRT1040-EVK
NXP MIMXRT1062 FMURT6
PHYTEC PhyBOARD Polis (NXP i.MX8M Mini)
PHYTEC PhyBOARD Pollux (NXP i.MX8M Plus)
Raspberry Pi Pico W
Raytac MDBT50Q-DB-33
Raytac MDBT50Q-DB-40
Seeed Studio Wio Terminal
Seeed Studio XIAO BLE Sense
Silicon Labs BRD2601B
Silicon Labs BRD4187C
Silicon Labs EFR32 Thunderboard-style boards
ST Nucleo C031C6
ST Nucleo F042K6
ST Nucleo H563ZI
ST STM32H573I-DK Discovery
Xilinx KV260 (Cortex-R5)
Added support for these ARM64 boards:
PHYTEC phyCORE-AM62x A53
NXP i.MX93 EVK A55 (SOF variant)
Added support for these RISC-V boards:
Intel FPGA Nios® V/m
ITE IT82XX2 EV-Board
Added support for these X86 boards:
Added support for these Xtensa boards:
ESP32S3-DevKitM
Made these changes for ARC boards:
Added ARC MWDT toolchain support for qemu_arc_hs
Improved emsdp platform support:
Added DFSS driver support
Added pinctrl support
Made these changes for ARM boards:
atsamc21n_xpro: Enable support to CAN.atsame54_xpro: Read Ethernet MAC from I2C.Changed the default board revision to 0.14.0 for the Nordic boards
nrf9160dk_nrf9160andnrf9160dk_nrf52840. To build for an older revision of the nRF9160 DK without external flash, specify that older board revision when building.nrf9160dk_nrf52840: Enabled external_flash_pins_routing switch by default.nrf9160dk_nrf9160: Changed the order of buttons and switches on the GPIO expander to match the order when using GPIO directly on the nRF9160 SoC.STM32H747i_disco: Enabled support for ST B-LCD40-DSI1 display extensionqemu_cortex_m0: Fixed prescaler of the system timer so that its frequency is actually 1 MHz, not 2 MHz.
Made these changes for ARM64 boards:
FVP revc_2xaemv8a / aemv8r: Added ethernet, PHY and MDIO nodes
Made these changes to POSIX boards:
nrf52_bsim now includes support and models for:
802.15.4 in the RADIO.
EGU.
FLASH (NVMC & UICR).
TEMP.
UART connected to a host ptty.
Many more minor CMSIS API and nRF APIs and drivers.
Made these changes for RISC-V boards:
gd32vf103: No longer requires special OpenOCD version.
Made these changes for X86 boards:
Made these changes for Xtensa boards:
Removed support for these ARC boards:
Removed support for these ARM boards:
Removed support for these RISC-V boards:
BeagleV Starlight JH7100
Removed support for these X86 boards:
Removed support for these Xtensa boards:
Made these changes in other boards:
Added support for these following shields:
Adafruit Data Logger Shield
nPM1300 EK (Power Management Integrated Circuit (PMIC))
Panasonic Grid-EYE Shields
ST B_LCD40_DSI1_MB1166
Build system and infrastructure
Fixed an issue whereby older versions of the Zephyr SDK toolchain were used instead of the latest compatible version.
Fixed an issue whereby building an application with sysbuild and specifying mcuboot’s verification to be checksum only did not build a bootable image.
Fixed an issue whereby if no prj.conf file was present then board configuration files would not be included by emitting a fatal error. As a result, prj.conf files are now mandatory in projects.
Introduced support for extending/replacing the signing mechanism in zephyr, see West extending signing for further details.
Fixed an issue whereby when using
*_ROOTvariables with Sysbuild, these were lost for images.Enhanced
zephyr_getCMake helper function to optionally support merging of scoped variables into a list.Added a new CMake helper function for setting/updating sysbuild CMake cache variables:
sysbuild_cache_set.Enhanced
zephyr_getCMake helper function to lookup multiple variables and return the result in a variable of different name.Introduced
EXTRA_CONF_FILE,EXTRA_DTC_OVERLAY_FILE, andEXTRA_ZEPHYR_MODULESfor better naming consistency and uniform behavior for applying extra build settings in addition to Zephyr automatic build setting lookup.EXTRA_CONF_FILEreplacesOVERLAY_CONFIG.EXTRA_ZEPHYR_MODULESreplacesZEPHYR_EXTRA_MODULES.EXTRA_DTC_OVERLAY_FILEis new, see Set devicetree overlays for further details.Twister now supports
gtestharness for running tests written in gTest.Added an option to validate device initialization priorities at build time. To use it, enable
CONFIG_CHECK_INIT_PRIORITIES, see scripts/build/check_init_priorities.py for more details.Added a new option to disable tracking of macro expansion when compiling,
CONFIG_COMPILER_TRACK_MACRO_EXPANSION. This option may be disabled to reduce compiler verbosity when errors occur during macro expansions, e.g. in device definition macros.Twister now supports loading test configurations from alternative root folder/s by using
--alt-config-root. When a test is found, Twister will check if a test configuration file exist in any of the alternative test configuration root folders. For example, given$test_root/tests/foo/testcase.yaml, Twister will use$alt_config_root/tests/foo/testcase.yamlif it exists.Twister now uses native YAML lists for fields that were previously defined using space-separated strings. For example:
platform_allow: foo bar
can now be written as:
platform_allow: - foo - bar
This applies to the following properties:
arch_excludearch_allowdepends_onextra_argsextra_sectionsplatform_excludeplatform_allowtagstoolchain_excludetoolchain_allow
Note that the old behavior is kept as deprecated. The scripts/utils/twister_to_list.py script can be used to automatically migrate Twister configuration files.
When MCUboot image signing is enabled, a warning will now be emitted by cmake if no signing key is set in the project, this warning can be safely ignored if signing is performed manually or outside of zephyr. This warning informs the user that the generated image will not be bootable by MCUboot as-is.
Babblesim is now included in the west manifest. Users can fetch it by enabling the
babblesimgroup with west config.west sign now uses DT labels, of “fixed-partition” compatible nodes, to identify application image slots, instead of previously used DT node label properties. If you have been using custom partition layout for MCUboot, you will have to label your MCUboot slot partitions with proper DT node labels; for example partition with “image-0” label property will have to be given slot0_partition DT node label. Label property does not have to be removed from partition node, but will not be used.
DT node labels used are listed below
Partition with label property
Required DT node label
“image-0”
slot0_partition
“image-1”
slot1_partition
Fixed an issue whereby relative paths supplied for the
BOARD_ROOTvalue might wrongly emit a warning about aboardsdirectory not being found.Fixed an issue whereby relative paths did not work for sysbuild images.
Drivers and Sensors
Device model
Devices that do not require an initialization routine can now pass
NULLto theDEVICE_*_DEFINE()macros.
Auxiliary display
New auxiliary display (auxdisplay) peripheral has been added, this allows for interfacing with simple alphanumeric displays that do not feature graphic capabilities. This peripheral is marked as unstable.
HD44780 driver added.
Noritake Itron driver added.
Grove LCD driver added (ported from existing sample).
ADC
MCUX LPADC driver now uses the channel parameter to select a software channel configuration buffer. Use
zephyr,input-positiveandzephyr,input-negativedevicetree properties to select the hardware channel(s) to link a software channel configuration to.MCUX LPADC driver
voltage-refandpower-leveldevicetree properties were shifted to match the hardware as described in reference manual instead of matching the NXP SDK enum identifers.Added support for STM32C0 and STM32H5.
Added DMA support for STM32H7.
STM32: Resolutions are now listed in the device tree for each ADC instance
STM32: Sampling times are now listed in the device tree for each ADC instance
Added driver for Atmel SAM family ADC.
Added driver for Gecko Incremental ADC.
Added driver for Infineon CAT1 ADC.
Added driver for TI ADS7052.
Added driver for TI ADS114S0x family.
Added drivers for Renesas SmartBond GPADC and SDADC.
Battery-backed RAM
Added MCP7940N battery-backed RTC SRAM driver.
CAN
The CAN statistics are now reset when calling
can_start().Renamed the NXP FlexCAN devicetree binding compatible from
nxp,kinetis-flexcantonxp,flexcan.Added support for the CAN-FD variant of the NXP FlexCAN controller using devicetree binding
nxp,flexcan-fd.Added support for the NXP NXP S32 CANEXCEL controller using devicetree binding
nxp,s32-canxl.Added support for the Atmel SAM0 CAN controller using devicetree binding
atmel,sam0-can.Refactored the Bosch M_CAN controller driver backend to allow for per-instance configuration via devicetree.
Now supports STM32H5 series.
Clock control
Atmel SAM/SAM0: Introduced peripheral clock control.
Atmel SAM0: Improved
samd20/samd21/samr21clocking mechanism.STM32F4: Added support for PLL I2S
Console:
The native_posix and bsim console drivers have been merged into one generic driver usable by all POSIX arch based boards.
Counter
Added support on timer based counter on STM32H7 and STM32H5
Added support on RTC based counter on STM32C0 and STM32H5
Crypto
Added support for STM32H5 AES
DAC
Added support on STM32H5 series.
Disk
SDMMC STM32L4+: Now compatible with internal DMA
NVME disks are now supported using FATFS, with a single I/O queue enabled
Display
Improved MCUX ELCDIF and SSD16XX display controller drivers
Added support for ILI9342C display controller
Added support for OTM8009A panel
DMA
STM32C0: Added support for DMA
STM32H5: Added support for GPDMA
STM32H7: Added support for BDMA
Added DMA support for the RP2040 SoC
EEPROM
Switched from
atmel,at24to dedicatedzephyr,i2c-target-eepromfor I2C EEPROM target driver.
Entropy
Added support for STM32H5 series.
Flash
Introduced new flash API call
flash_ex_op()which callsec_op()callback provided by a flash driver. This allows to perform extra operations on flash devices, defined by Zephyr Flash API or by vendor specific header files.CONFIG_FLASH_HAS_EX_OPshould be selected by the driver to indicate that extra operations are supported. To enable extra operations user should selectCONFIG_FLASH_EX_OP_ENABLED.STM32F4: Now supports write protection and readout protection through new flash API call
flash_ex_op().nrf_qspi_nor: Replaced custom API function
nrf_qspi_nor_base_clock_div_forcewithnrf_qspi_nor_xip_enablewhich apart from forcing the clock divider prevents the driver from deactivating the QSPI peripheral so that the XIP operation is actually possible.flash_simulator:
A memory region can now be used as the storage area for the flash simulator. Using the memory region allows the flash simulator to keep its contents over a device reboot.
When building in native_posix, command line options have been added to select if the flash should be cleared at boot, the flash content kept in RAM, or the flash content file be deleted on exit.
spi_flash_at45: Fixed erase procedure to properly handle chips that have their initial sector split into two parts (usually marked as 0a and 0b).
STM32H5 now supports OSPI
GPIO
Converted the
gpio_keysdriver to the input subsystem.Added single-ended IO support for the RP2040 SoC
STM32: Supports newly introduced experimental API to enable/disable interrupts without re-config
I2C
Added support for STM32C0 and STM32H5 series
I2S
STM32: Domain clock should now be configured by device tree.
Input
Introduced the Input subsystem.
KSCAN
Added a
zephyr,kscan-inputinput to kscan compatibility driver.Converted the
ft5336andkscan_sdldrivers to the input subsystem.
MIPI-DSI
Added support on STM32H7
Misc
Added PIO support for the RP2040 SoC
PCIE
Enable filtering PCIe devices by class/revision.
PECI
Retained memory
Retained memory (retained_mem) driver has been added with backends for Nordic nRF GPREGRET, and uninitialised RAM.
Pin control
Added support for Infineon CAT1
Added support for TI K3
Added support for ARC emdsp
PWM
Added support for STM32C0.
STM32: Now supports 6-PWM channels
Added PWM driver for Microchip XEC BBLED.
Power domain
Regulators
The regulator API can now be built without thread-safe reference counting by using
CONFIG_REGULATOR_THREAD_SAFE_REFCNT. This feature can be useful in applications that do not enableCONFIG_MULTITHREADING.Added support for ADP5360 PMIC
Added support for nPM1300 PMIC
Added support for Raspberry Pi Pico core supply regulator
SDHC
Support was added for using CPOL/CPHA SPI clock modes with SD cards, as some cards require the SPI clock switch to low when not active
Sensor
Added generic voltage measurement sample
Removed STM32 Vbat measurement sample (replaced by a generic one)
Added STM32 Vref sensor driver
Added STM32 Vref/Vbat measurement through the new generic voltage measurement sample
Added temperature measurement driver for STM32C0 and STM32F0x0
Removed STM32 temperature measurement sample (replaced by a generic one)
Added STM32 temperature measurement through the generic temperature measurement sample
Serial
Added UART3 and UART4 configuration for
gd32vf103SoCs.uart_altera: added new driver for Altera Avalon UART.
uart_emul: added new driver for emulated UART.
uart_esp32: * Added support for ESP32S3 SoC. * Added support for RS-485 half duplex mode.
uart_hostlink: added new driver for virtual UART via Synopsys ARC hostlink channels.
uart_ifx_cat1: added new driver for Infineon CAT1 UART.
uart_mcux: added power management support.
uart_mcux_flexcomm: added support for asynchronous operations.
uart_mcux_lpuart: added support for parity.
uart_ns16550: now supports per instance hardware access mode instead of one access mode for all instances.
uart_pl011: fixed interrupt support.
uart_rpi_pico_pio: added new driver to support UART via Programmable Input/Output (PIO) on Raspberry Pi Pico.
uart_xmc4xxx: added support for asynchronous operations.
uart_stm32: Now support driver enable mode
Added hardware flow control support for the RP2040 SoC
SPI
Added support on STM32H5 series.
Timer
Support added for stopping Nordic nRF RTC system timer, which fixes an issue when booting applications built in prior version of Zephyr.
STM32: Now supports a prescaler at the input of clock (default not divided). Prescaler allows to achieve higher LPTIM timeout (up to 256s when lptim clocked by LSE) and consequently higher core sleep durations but impacts the tick precision. To be used with caution.
USB
Added remote wakeup support for the RP2040 SoC
Added Battery Charging (BC12) API and PI3USB9201 driver implementation.
Added new USB device controller drivers (using usb_dc API) for ITE IT82xx2 and smartbond platforms.
Added USB device controller driver skeleton for UDC API.
Reworked DWC2 driver and added support for STM32F4 SoC family
W1
Added DS2482-800 1-Wire master driver. See the
maxim,ds2482-800devicetree binding for more information.Added
CONFIG_W1_NET_FORCE_MULTIDROP_ADDRESSINGwhich can be enabled force the 1-Wire network layer to use multidrop addressing.
Watchdog
Added support for STM32C0 and STM32H5 series
Networking
CoAP:
Added
coap_append_descriptive_block_option()andcoap_get_block1_option()APIs to facilitate block transfer handling.Added a CoAP client helper library, based on the existing CoAP APIs.
Fixed missing token length validation in
coap_header_get_token().Fixed missing response check in
coap_response_received().
Connection Manager:
Extended the library with a generic L2 connectivity API.
Refactored library internals significantly.
Improved thread safety in the library.
Reworked how Connection Manager events are notified - they are no longer raised for each interface individually, but instead:
NET_EVENT_L4_CONNECTEDis called only once after the first interface gains connectivity.NET_EVENT_L4_DISCONNECTEDis called only after connectivity is lost on all interfaces.
Improved Connection Manager test coverage.
DHCPv4:
Fixed a potential packet leak in DHCPv4 input handler.
Fixed a potential NULL pointer dereference in
dhcpv4_create_message().Added a mechanism to register a callback for handling DHCPv4 options.
Modified
dhcpv4_clientsample to trigger DHCP on all network interfaces in the system.
DNS:
Fixed a possible crash on NULL pointer as a query callback.
Added a check on existing DNS servers before reconfigure.
Improved debug logging in DNS SD.
Fixed IPv4/IPv6 address handling in mDNS responder, if both are IPv4 and IPv6 are enabled.
Removed dead code in DNS SD query parsing.
Ethernet:
Fixed double packet dereference in case of ARP request transmission errors.
Fixed a possible slist corruption in case Ethernet interface went up before LLDP initialization.
HTTP:
Added HTTP service and resource iterable sections.
ICMPv6:
Implemented IPv6 RA Recursive DNS Server option handling.
IEEE802154:
Fixed a corner case with 6LoWPAN IP Header Compression and fragmentation, where for a short range of packet sizes, fragmentation did not work correctly after IPHC.
Added new radio API function to start continuous carrier wave transmission.
Several improvements/fixes in IEEE802154 L2 security.
Fixed a packet leak when handling beacon/command frames.
Deprecated
CONFIG_IEEE802154_2015Kconfig option.Added simple Babblesim echo test over IEEE802154 L2.
Improved IEEE802154 L2 test coverage.
Multiple other minor IEEE802154 L2 and documentation improvements/fixes.
IPv4:
Implemented a fallback to IPv4 Link Local address if no other address is available.
Fixed
net_ipv4_is_ll_addr()helper function to correctly identify LL address.Fixed possible NULL pointer dereference in IPv4 fragmentation.
LwM2M:
Added new
LWM2M_RD_CLIENT_EVENT_REG_UPDATEevent.Added missing
constqualifier in the APIs, where applicable.Fixed socket error handling on packet transmission.
Improved LwM2M context cleanup when falling back to regular Registration.
Added possibility to register a callback function for FW update cancel action.
Added possibility to register a callback function for LwM2M send operation.
Added ISPO voltage sensor object support.
Fixed stopping of the LwM2M client when it’s suspended.
Fixed a minor CoAP RFC incompatibility, where it should not be assumed that consecutive data blocks in block transfer will carry the same token.
Added block transfer support on TX.
Fixed a possible out-of-bounds memory access when creating FW update object.
Added possibility to override default socket option configuration with a dedicated callback function (
set_socketoptions).Improved LwM2M test coverage.
Several other minor improvements and cleanups.
Misc:
Added generic
OFFLOADED_NETDEV_L2for offloaded devices to allow offloaded implementations to detect when interface is brought up/down.Factored out
net_buf_simpleroutines to a separate source file.Fixed possible NULL pointer dereference in
net_pkt_cursor_operate().Reimplemented
net_mgmtto use message queue internally. This also fixed a possible event loss with the old implementation.Fixed error handling in
net pingshell command to avoid shell freeze.Improved Ethernet error statistics logging in
net statsshell command.Moved SLIP TAP implementation into a separate file, to prevent build warnings about missing sources for Ethernet drivers.
Fixed crashes in
echo_serverandecho_clientsamples, when userspace is enabled.Fixed IPv6 support in
mqtt_sn_publishersample.Fixed build issues with arm-clang in the networking stack.
Added new
NET_IF_IPV6_NO_NDandNET_IF_IPV6_NO_MLDinterface flags, which allow to disable ND/MLD respectively on an interface.Reworked network interface mutex protection, to use individual mutex for each interface, instead of a global one.
Added new AWS IoT Core MQTT Sample.
Added a few missing NULL pointer checks in network interface functions.
OpenThread:
Implemented the following OpenThread platform APIs:
otPlatRadioSetMacFrameCounterIfLarger(),otPlatCryptoEcdsaGenerateAndImportKey(),otPlatCryptoEcdsaExportPublicKey(),otPlatCryptoEcdsaVerifyUsingKeyRef(),otPlatCryptoEcdsaSignUsingKeyRef().
Added
CONFIG_OPENTHREAD_CSL_TIMEOUToption.Removed no longer needed
CONFIG_OPENTHREAD_EXCLUDE_TCPLP_LIB.Added simple Babblesim echo test over OpenThread.
SNTP:
Switched to use
zsock_*functions internally.
Sockets:
Fixed
SO_RCVBUFandSO_SNDBUFsocket options handling, so that they configure TCP window sizes correctly.Fixed
SO_SNDTIMEOsocket option handling - the timeout value was ignored and socket behaved as in non-blocking mode when used.Reworked TLS sockets implementation, to allow parallel TX/RX from different threads.
Implemented TLS handshake timeout.
Added support for asynchronous connect for TCP sockets.
Fixed blocking
recv()not being interrupted on socket close.Fixed blocking
accept()not being interrupted on socket close.Improved sockets test coverage.
TCP:
Fixed incorrect TCP stats by improving packet processing result reporting.
Added
CONFIG_NET_TCP_PKT_ALLOC_TIMEOUTto allow to configure packet allocation timeout.Improved TCP test coverage.
Fixed TCP MSS calculation for IPv6.
Fixed possible double acknowledgment of retransmitted data.
Fixed local address setting for incoming connections.
Fixed double TCP context dereferencing in certain corner cases.
TFTP:
Added
tftp_put()API to support TFTP write request.Introduced
tftp_callback_tcallback to allow to read large files.Reworked
struct tftpcclient context structure, to allow for parallel communication from several contexts.
UDP:
CONFIG_NET_UDP_MISSING_CHECKSUMis now enabled by default.
Websockets:
Implemented proper timeout handling in
websocket_recv_msg().Fixed implicit type conversion when parsing length field, which could lead to data loss.
Wi-Fi:
Display TWT (Target Wake Time) configuration response status in Wi-Fi shell.
Added more detailed TWT response parameters printout in Wi-Fi shell.
Added new
NET_EVENT_WIFI_TWT_SLEEP_STATEevent to notify TWT sleep status.Fixed an issue where not all security modes were displayed correctly on scan.
Added connection status and AP capabilities verification before initiating TWT operation.
TWT intervals are changed from milliseconds to microseconds, interval variables are also renamed.
Extended Power Saving configuration parameters with listening interval and wake up mode.
Added
CONFIG_WIFI_MGMT_RAW_SCAN_RESULTSoption, which enables providing of RAW (unprocessed) scan results to the application withNET_EVENT_WIFI_CMD_RAW_SCAN_RESULTevent.Several other minor fixes/cleanups in the Wi-Fi management/shell modules.
zperf
Added an extra parameter to disable Nagle’s algorithm with TCP benchmarks.
Added support for handling multiple incoming TCP sessions.
Made zperf thread priority and stack size configurable.
Several minor cleanups in the module.
USB
USB device support
Fixed control endpoint handling with MPS of 8 bytes.
New experimental USB support
Various improvements for new device support, better string descriptor support, implemented usbd_class_shutdown API.
Added USB Mass Storage class and CDC ECM class implementations for the new device support.
Libraries / Subsystems
File systems
Added
CONFIG_FS_FATFS_REENTRANTto enable the FAT FS reentrant option.With LittleFS as backend,
fs_mount()return code was corrected toEFAULTwhen called withFS_MOUNT_FLAG_NO_FORMATand the designated LittleFS area could not be mounted because it has not yet been mounted or it required reformatting.The FAT FS initialization order has been updated to match LittleFS, fixing an issue where attempting to mount the disk in a global function caused FAT FS to fail due to not being registered beforehand. FAT FS is now initialized in POST_KERNEL.
Added
CONFIG_FS_LITTLEFS_FMP_DEVto enable possibility of using LittleFS for block devices only, e.g. without Flash support. The option is set to ‘y’ by default in order to keep previous behaviour.
IPC
ipc_service_close_instance()now only acts on bounded endpoints.ICMSG: removed race condition during bonding.
ICMSG: removed internal API for clearing shared memory.
ICMSG: added mutual exclusion access to SHMEM.
Fixed CONFIG_OPENAMP_WITH_DCACHE.
Management
Added optional input expiration to shell MCUmgr transport, this allows returning the shell to normal operation if a complete MCUmgr packet is not received in a specific duration. Can be enabled with
CONFIG_MCUMGR_TRANSPORT_SHELL_INPUT_TIMEOUTand timeout set withCONFIG_MCUMGR_TRANSPORT_SHELL_INPUT_TIMEOUT_TIME.MCUmgr fs_mgmt upload and download now caches the file handle to improve throughput when transferring data, the file is no longer opened and closed for each part of a transfer. In addition, new functionality has been added that will allow closing file handles of uploaded/downloaded files if they are idle for a period of time, the timeout is set with
MCUMGR_GRP_FS_FILE_AUTOMATIC_IDLE_CLOSE_TIME. There is a new command that can be used to close open file handles which can be used after a file upload is complete to ensure that the file handle is closed correctly, allowing other transports or other parts of the application code to use it.A new version of the SMP protocol used by MCUmgr has been introduced in the header, which is used to indicate the version of the protocol being used. This updated protocol allows returning much more detailed error responses per group, see the MCUmgr SMP protocol specification for details.
MCUmgr has now been marked as a stable Zephyr API.
The MCUmgr UDP transport has been refactored to resolve some concurrency issues and fixes a potential issue whereby an application might call the open transport function whilst it is already open, causing an endless log output loop.
The MCUmgr fs_mgmt group Kconfig
Insecuretext has been replaced with a CMake warning which triggers if fs_mgmt hooks are not enabled, as these hooks can be used to ensure security of file access allowed by MCUmgr clients.Fixed an issue with MCUmgr fs_mgmt file download not checking if the offset parameter was provided.
Fixed an issue with MCUmgr fs_mgmt file upload notification hook not setting upload to true.
Fixed an issue with MCUmgr img_mgmt image upload
upgradefield wrongly checking if the new image was the same version of the application and allowing it to be uploaded if it was.MCUmgr img_mgmt group will only verify the SHA256 hash provided by the client against the uploaded image (if support is enabled) if a full SHA256 hash was provided.
MCUmgr Kconfig options have changed from
selecttodepends onwhich means that some additional Kconfig options may now need to be selected by applications.CONFIG_NET_BUF,CONFIG_ZCBORandCONFIG_CRCare needed to enable MCUmgr support,CONFIG_BASE64is needed to enable shell/UART/dummy MCUmgr transports,CONFIG_NET_SOCKETSis needed to enable the UDP MCUmgr transport,CONFIG_FLASHis needed to enable MCUmgr fs_mgmt,CONFIG_FLASHandCONFIG_IMG_MANAGERare needed to enable MCUmgr img_mgmt.MCUmgr img_mgmt group now uses unsigned integer values for image and slot numbers, these numbers would never have been negative and should have been unsigned.
POSIX API
Improved the locking strategy for
eventfd_read()andeventfd_write(). This eliminated a deadlock scenario that was present since the initial contribution and increased performance by a factor of 10x.Reimplemented POSIX threads, mutexes, condition variables, and barriers using native Zephyr counterparts. POSIX synchronization primitives in Zephyr were originally implemented separately and received less maintenance as a result. Unfortunately, this opened POSIX up to unique bugs and race conditions. Going forward, POSIX will benefit from all improvements to Zephyr’s synchronization and threading API and race conditions have been mitigated.
Retention
Retention subsystem has been added which adds enhanced features over retained memory drivers allowing for partitioning, magic headers and checksum validation. See retention API for details. Support for the retention subsystem is experimental.
Boot mode retention module has been added which allows for setting/checking the boot mode of an application, initial support has also been added to MCUboot to allow for applications to use this as an entrance method for MCUboot serial recovery mode. See boot mode API for details.
RTIO
Added policy that every
sqewill generate acqe(previously an RTIO_SQE_TRANSACTION entry would only trigger acqeon the lastsqein the transaction.
Power management
Added a new policy event API that can be used to register expected events that will wake the system up in the future. This can be used to influence the system on which low power states can be used.
Added a new device tree property
zephyr,pm-device-runtime-autoto automatically enable device runtime power management on a device after its initialization.
HALs
Nordic
Updated nrfx to version 3.0.0.
STM32
stm32cube: updated STM32F0 to cube version V1.11.4.
stm32cube: updated STM32F3 to cube version V1.11.4
stm32cube: updated STM32L0 to cube version V1.12.2
stm32cube: updated STM32U5 to cube version V1.2.0
stm32cube: updated STM32WB to cube version V1.16.0
Raspberry Pi Pico
Updated hal_rpi_pico to version 1.5.0
MCUboot
Relocated the MCUboot Kconfig options from the main
Kconfig.zephyrfile to a newmodules/Kconfig.mcubootmodule-specific file. This means that, for interactive Kconfig interfaces, the MCUboot options will now be located underModulesinstead of underBoot Options.Added
CONFIG_MCUBOOT_CMAKE_WEST_SIGN_PARAMSthat allows to pass arguments to west sign when invoked from cmake.
Storage
Added
CONFIG_FLASH_MAP_LABELS, which will enable runtime access to the labels property of fixed partitions. This option is implied if kconfig:option:CONFIG_FLASH_MAP_SHELL is enabled. These labels will be displayed in a separate column when using theflash_map listshell command.
Trusted Firmware-M
Enable routing of PSA Crypto API calls from NS to S, thanks to separating MbedTLS into three distinct libraries at build time (crypto, TLS, X.509). This also resolves header conflicts with earlier integrations of TF-M and MbedTLS.
Added psa_crypto sample back.
zcbor
Updated from 0.6.0 to 0.7.0. Among other things, this update brings:
C++ improvements
float16 support
Improved docs
-Wall and -Wconversion compliance
Tests and Samples
Two Babblesim based networking (802.15.4) tests have been added, which are run in Zephyr’s CI system. One of them including the OpenThread stack.
For native_posix and the nrf52_bsim: Many tests have been fixed and enabled.
LittleFS sample has been given SPI example configuration for nrf52840dk_nrf52840.
Migrated all tests to new Ztest API and deprecated legacy Ztest.