zephyr/samples/drivers/mbox
Gerard Marull-Paretas 752079a070 samples: drivers: mbox: fix nRF54H20 vevif/bellboard regexes
Both VEVIF and BELLBOARD test cases are unidirectional from the core
executing the test (cpuapp). For VEVIF, cpuapp pings, and for BELLBOARD,
cpuapp pongs.

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>
2024-03-14 09:47:31 +00:00
..
boards samples: drivers: mbox: use DT 2024-03-07 14:32:57 +00:00
remote drivers: mbox: update MBOX consumers to the new API 2024-03-07 14:32:57 +00:00
src drivers: mbox: update MBOX consumers to the new API 2024-03-07 14:32:57 +00:00
CMakeLists.txt samples: drivers: mbox: add support for nRF VEVIF 2024-03-05 16:50:36 +00:00
Kconfig samples: drivers: mbox: use DT 2024-03-07 14:32:57 +00:00
Kconfig.sysbuild samples: drivers: mbox: add support for nRF VEVIF 2024-03-05 16:50:36 +00:00
prj.conf
README.rst hwmv2: Introduce Hardware model version 2 and convert devices 2024-03-02 16:56:33 -05:00
sample.yaml samples: drivers: mbox: fix nRF54H20 vevif/bellboard regexes 2024-03-14 09:47:31 +00:00
sysbuild.cmake samples: drivers: mbox: fix hwmv2 issues 2024-03-05 16:50:36 +00:00

.. zephyr:code-sample:: mbox
   :name: MBOX
   :relevant-api: mbox_interface

   Perform inter-processor mailbox communication using the MBOX API.

Overview
********

This sample demonstrates how to use the :ref:`MBOX API <mbox_api>`.

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

The sample can be built and executed on boards supporting MBOX.

Building the application for nrf5340dk/nrf5340/cpuapp
*****************************************************

.. zephyr-app-commands::
   :zephyr-app: samples/drivers/mbox/
   :board: nrf5340dk/nrf5340/cpuapp
   :goals: debug
   :west-args: --sysbuild

Open a serial terminal (minicom, putty, etc.) and connect the board with the
following settings:

- Speed: 115200
- Data: 8 bits
- Parity: None
- Stop bits: 1

Reset the board and the following message will appear on the corresponding
serial port, one is the application (APP) core another is the network (NET)
core:

.. code-block:: console

   *** Booting Zephyr OS build zephyr-v3.1.0-2383-g147aee22f273  ***
   Hello from APP
   Pong (on channel 0)
   Ping (on channel 1)
   Pong (on channel 0)
   Ping (on channel 1)
   Ping (on channel 1)
   Pong (on channel 0)
   Ping (on channel 1)
   Pong (on channel 0)
   Ping (on channel 1)
   ...


.. code-block:: console

   *** Booting Zephyr OS build zephyr-v3.1.0-2383-g147aee22f273  ***
   Hello from NET
   Ping (on channel 0)
   Pong (on channel 1)
   Ping (on channel 0)
   Pong (on channel 1)


Building the application for the simulated nrf5340bsim
******************************************************

.. zephyr-app-commands::
   :zephyr-app: samples/drivers/mbox/
   :host-os: unix
   :board: nrf5340bsim_nrf5340_cpuapp
   :goals: build
   :west-args: --sysbuild

Then you can execute your application using:

.. code-block:: console

   $ ./build/zephyr/zephyr.exe -nosim
   # Press Ctrl+C to exit

You can expect a similar output as in the real HW in the invoking console.