zephyr

History

Rodrigo Peixoto 67d24b9e42 samples: zbus: Adjust runtime observers sample Reverse the changes the affected API and add adjust the sample to the new dynamic and static variations. Signed-off-by: Rodrigo Peixoto <rodrigopex@gmail.com>		2025-05-16 09:37:20 +02:00
..
src	samples: zbus: Adjust runtime observers sample	2025-05-16 09:37:20 +02:00
CMakeLists.txt
prj.conf
README.rst
sample.yaml	samples: zbus: Adjust runtime observers sample	2025-05-16 09:37:20 +02:00

README.rst

.. zephyr:code-sample:: zbus-runtime-obs-registration
   :name: Runtime observer registration
   :relevant-api: zbus_apis

   Use zbus' runtime observer registration to filter data generated by a producer.

Overview
********
The sample illustrates a way of using the runtime observer registration feature. The developer can understand how to use static and runtime observer registration with this sample.

In this sample, we have the threads producer and consumer. In the middle of the communication, we have the filter responsible for filtering the data generated by the producer. In a loop, the code activates the filter. After 5 seconds, the filter is disabled, and the filter bypass is enabled. At last, 5 seconds later, the filter bypass is disabled, and the loop repeats everything.

Building and Running
********************

This project outputs to the console.  It can be built and executed
on QEMU as follows:

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/zbus/runtime_obs_registration
   :host-os: unix
   :board: qemu_x86
   :goals: run

Sample Output
=============

.. code-block:: console

    I: System started
    I: Activating filter
    I:  >-- Raw data fetched
    I:  -|- Filtering data
    I:  --> Consuming data: Acc x=0, y=0, z=0
    I:  >-- Raw data fetched
    I:  -|- Filtering data
    I:  --> Consuming data: Acc x=2, y=2, z=2
    I:  >-- Raw data fetched
    I:  -|- Filtering data
    I:  --> Consuming data: Acc x=0, y=0, z=0
    I:  >-- Raw data fetched
    I:  -|- Filtering data
    I:  --> Consuming data: Acc x=4, y=4, z=4
    I:  >-- Raw data fetched
    I:  -|- Filtering data
    I:  --> Consuming data: Acc x=0, y=0, z=0
    I: Deactivating filter
    I: Bypass filter
    I:  >-- Raw data fetched
    I:  --> Consuming data: Acc x=6, y=6, z=6
    I:  >-- Raw data fetched
    I:  --> Consuming data: Acc x=7, y=7, z=7
    I:  >-- Raw data fetched
    I:  --> Consuming data: Acc x=8, y=8, z=8
    I:  >-- Raw data fetched
    I:  --> Consuming data: Acc x=9, y=9, z=9
    I:  >-- Raw data fetched
    I:  --> Consuming data: Acc x=10, y=10, z=10
    I: Disable bypass filter
    I:  >-- Raw data fetched
    I:  >-- Raw data fetched
    I:  >-- Raw data fetched
    I:  >-- Raw data fetched
    I:  >-- Raw data fetched

    <continues>

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.