The latest development version of this page may be more current than this released 4.0.0 version.

MBOX

Browse source code on GitHub

Overview

This sample demonstrates how to use the MBOX API.

Building and Running

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

Building the application for nrf5340dk/nrf5340/cpuapp

# From the root of the zephyr repository
west build -b nrf5340dk/nrf5340/cpuapp --sysbuild samples/drivers/mbox/
west debug

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:

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

# From the root of the zephyr repository
west build -b nrf5340bsim/nrf5340/cpuapp --sysbuild samples/drivers/mbox/

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.

See also

MBOX Interface