zephyr

History

Benjamin Cabé 7c4ff77bf3 doc: zbus: samples: Use new Sphinx extension to document samples Use the new code-sample directive and roles to document the zbus samples so that they show up as "Related samples" when browsing zbus API. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>		2023-09-11 19:56:57 +02:00
..
src	…
CMakeLists.txt	…
README.rst	doc: zbus: samples: Use new Sphinx extension to document samples	2023-09-11 19:56:57 +02:00
prj.conf	…
sample.yaml	tests: cleanup metadata and filtering	2023-06-13 09:38:27 -04:00

README.rst

.. zephyr:code-sample:: zbus-dyn-channel
   :name: Dynamic channel
   :relevant-api: zbus_apis

   Use zbus channels with dynamically allocated messages.

Overview
********
This sample implements an application using zbus to illustrate the way zbus supports dynamically allocated channels.

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/dyn_channel
   :host-os: unix
   :board: qemu_x86
   :goals: run

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

.. code-block:: console

    W: size=01
    W: Content
    W: 00                      |.
    W: size=02
    W: Content
    W: 01 01                   |..
    W: size=03
    W: Content
    W: 00 00 00                |...
    W: size=04
    W: Content
    W: 03 03 03 03             |....
    W: size=05
    W: Content
    W: 00 00 00 00 00          |.....
    W: size=06
    W: Content
    W: 05 05 05 05 05 05       |......
    W: size=07
    W: Content
    W: 00 00 00 00 00 00 00    |.......
    W: size=08
    W: Content
    W: 07 07 07 07 07 07 07 07 |........
    W: size=09
    W: Content
    W: 00 00 00 00 00 00 00 00 |........
    W: 00                      |.
    W: size=10
    W: Content
    W: 09 09 09 09 09 09 09 09 |........
    W: 09 09                   |..
    W: size=11
    W: Content
    W: 00 00 00 00 00 00 00 00 |........
    W: 00 00 00                |...
    W: size=12
    W: Content
    W: 0b 0b 0b 0b 0b 0b 0b 0b |........
    W: 0b 0b 0b 0b             |....
    W: size=13
    W: Content
    W: 00 00 00 00 00 00 00 00 |........
    W: 00 00 00 00 00          |.....
    W: size=14
    W: Content
    W: 0d 0d 0d 0d 0d 0d 0d 0d |........
    W: 0d 0d 0d 0d 0d 0d       |......
    W: size=15
    W: Content
    W: 00 00 00 00 00 00 00 00 |........
    W: 00 00 00 00 00 00 00    |.......
    W: size=16
    W: Content
    W: 0f 0f 0f 0f 0f 0f 0f 0f |........
    W: 0f 0f 0f 0f 0f 0f 0f 0f |........

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