1.. zephyr:code-sample:: mbox
2   :name: MBOX
3   :relevant-api: mbox_interface
4
5   Perform inter-processor mailbox communication using the MBOX API.
6
7Overview
8********
9
10This sample demonstrates how to use the :ref:`MBOX API <mbox_api>`.
11
12Building and Running
13********************
14
15The sample can be built and executed on boards supporting MBOX.
16
17Building the application for nrf5340dk_nrf5340_cpuapp
18*****************************************************
19
20.. zephyr-app-commands::
21   :zephyr-app: samples/drivers/mbox/
22   :board: nrf5340dk_nrf5340_cpuapp
23   :goals: debug
24
25Open a serial terminal (minicom, putty, etc.) and connect the board with the
26following settings:
27
28- Speed: 115200
29- Data: 8 bits
30- Parity: None
31- Stop bits: 1
32
33Reset the board and the following message will appear on the corresponding
34serial port, one is the application (APP) core another is the network (NET)
35core:
36
37.. code-block:: console
38
39   *** Booting Zephyr OS build zephyr-v3.1.0-2383-g147aee22f273  ***
40   Hello from APP
41   Pong (on channel 0)
42   Ping (on channel 1)
43   Pong (on channel 0)
44   Ping (on channel 1)
45   Ping (on channel 1)
46   Pong (on channel 0)
47   Ping (on channel 1)
48   Pong (on channel 0)
49   Ping (on channel 1)
50   ...
51
52
53.. code-block:: console
54
55   *** Booting Zephyr OS build zephyr-v3.1.0-2383-g147aee22f273  ***
56   Hello from NET
57   Ping (on channel 0)
58   Pong (on channel 1)
59   Ping (on channel 0)
60   Pong (on channel 1)
61