Primary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

1.9 KiB

.. 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.