patrick/zephyr
1
0
Fork 0
Code Issues Pull requests Actions 8 Packages Projects Releases Wiki Activity

doc: releases: v3.5.0: zbus release notes

Browse source 
Add the changes of zbus during the Zephyr v3.5.0 development.

Signed-off-by: Rodrigo Peixoto <rodrigopex@gmail.com>
This commit is contained in:
Rodrigo Peixoto 2023-10-16 12:22:38 -03:00 committed by Johan Hedberg
parent 1244f109ee
commit 475361b22c
1 changed files with 29 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
doc/releases/release-notes-3.5.rst
View file

@ -903,6 +903,30 @@ Libraries / Subsystems
is needed
* Removed unused Kconfig options for different executors
* ZBus
* Changed channels' and observers' metadata to comply with the data/config approach. ZBus stores
immutable config in iterable sections in Flash and the mutable portion of data in the RAM.
* The relationship between channels and observers is mapped using a new entity called
observation. The observation enables us to increase the granularity of masking observation.
Developers can mask individual observations, disable the observer, or use runtime observers.
* Added API :c:macro:`ZBUS_CHAN_ADD_OBS` macro for adding post-definition static observers of a
channel. That can replace the runtime observer feature, enabling developers to add static
observers after the channel definition in different files. It increases the composability of
the system using ZBus, making post-definition channel observation rely on the stack instead of
the heap.
* Added a new type of observer called Message Subscriber. ZBus' VDED will send a copy of the
message during the publication/notification process.
* Changed the VDED delivery sequence. Check the ref:`documentation<zbus delivery sequence>`.
* ZBus runtime observers now rely on the heap instead of a memory pool.
* Added new iterable section iterators APIs (for channels and observers) can now receive a
``user_data`` pointer to keep context between the function calls.
* Added APIs :c:macro:`ZBUS_LISTENER_DEFINE_WITH_ENABLE` and
:c:macro:`ZBUS_SUBSCRIBER_DEFINE_WITH_ENABLE` that allows developers to define observers'
statuses (enabled/disabled) programmatically. With the API, developers can create observers
initially disabled and enable them in runtime.
HALs
****
@ -1030,5 +1054,10 @@ Tests and Samples
* Created common sample for file systems (`fs_sample`). It originates from sample for FAT
(`fat_fs`) and supports both FAT and ext2 file systems.
* Created the zbus confirmed channel sample to demonstrate how to implement a delivery-guaranteed
channel using subscribers.
* Created the zbus message subscriber sample to demonstrate how to use message subscribers.
Known Issues
************