.. 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)
...
Hello from NET
Ping (on channel 0)
Pong (on channel 1)
Building the application for the simulated nrf5340bsim
******************************************************
:host-os: unix
:board: nrf5340bsim/nrf5340/cpuapp
:goals: build
Then you can execute your application using:
$ ./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.