Multiple instance of RPMsg¶
Overview¶
Multiple instance of RPMsg is an abstraction created over OpenAMP. It simplifies the initialization and endpoint creation process. This sample demonstrates how to use multi-instance RPMsg in Zephyr.
Building the application for nrf5340dk_nrf5340_cpuapp¶
# From the root of the zephyr repository
west build -b nrf5340dk_nrf5340_cpuapp samples/subsys/ipc/rpmsg_multi_instance
west debug
Open a serial terminal (for example Minicom or PuTTY) and connect the board with the following settings:
Speed: 115200
Data: 8 bits
Parity: None
Stop bits: 1
When you reset the development kit, the following messages (one for master and one for remote) will appear on the corresponding serial ports:
*** Booting Zephyr OS build zephyr-v2.5.0-3564-gf89886d69a8c ***
Starting application thread!
RPMsg Multiple instance [master no 1] demo started
RPMsg Multiple instance [master no 2] demo started
Master [no 1] core received a message: 1
Master [no 2] core received a message: 1
Master [no 1] core received a message: 3
Master [no 2] core received a message: 3
Master [no 1] core received a message: 5
Master [no 2] core received a message: 5
...
Master [no 1] core received a message: 99
RPMsg Multiple instance [no 1] demo ended.
Master [no 2] core received a message: 99
RPMsg Multiple instance [no 2] demo ended.
*** Booting Zephyr OS build zephyr-v2.5.0-3564-gf89886d69a8c ***
Starting application thread!
RPMsg Multiple instance [remote no 1] demo started
RPMsg Multiple instance [remote no 2] demo started
Remote [no 1] core received a message: 0
Remote [no 2] core received a message: 0
Remote [no 1] core received a message: 2
Remote [no 2] core received a message: 2
Remote [no 1] core received a message: 4
Remote [no 2] core received a message: 4
...
Remote [no 1] core received a message: 98
RPMsg Multiple instance [no 1] demo ended.
Remote [no 2] core received a message: 98
RPMsg Multiple instance [no 2] demo ended.
Building the application for bl5340_dvk_cpuapp¶
# From the root of the zephyr repository
west build -b bl5340_dvk_cpuapp samples/subsys/ipc/rpmsg_multi_instance
west debug
# From the root of the zephyr repository
west build -b bl5340_dvk_cpunet samples/subsys/ipc/rpmsg_multi_instance/remote
west debug
Open a serial terminal (for example Minicom or PuTTY) and connect to the board with the following settings on both serial ports:
Speed: 115200
Data: 8 bits
Parity: None
Stop bits: 1
When you reset the development kit after having flashed both the application and network core images, the following messages (one for master and one for remote) will appear on the corresponding serial ports:
*** Booting Zephyr OS build v2.7.0-rc1-103-ge19875c88916 ***
Starting application thread!
RPMsg Multiple instance [master no 1] demo started
RPMsg Multiple instance [master no 2] demo started
Master [no 1] core received a message: 1
Master [no 2] core received a message: 1
Master [no 1] core received a message: 3
Master [no 2] core received a message: 3
Master [no 1] core received a message: 5
Master [no 2] core received a message: 5
...
Master [no 1] core received a message: 99
RPMsg Multiple instance [no 1] demo ended.
Master [no 2] core received a message: 99
RPMsg Multiple instance [no 2] demo ended.
*** Booting Zephyr OS build v2.7.0-rc1-103-ge19875c88916 ***
Starting application thread!
RPMsg Multiple instance [remote no 1] demo started
RPMsg Multiple instance [remote no 2] demo started
Remote [no 1] core received a message: 0
Remote [no 2] core received a message: 0
Remote [no 1] core received a message: 2
Remote [no 2] core received a message: 2
Remote [no 1] core received a message: 4
Remote [no 2] core received a message: 4
...
Remote [no 1] core received a message: 98
RPMsg Multiple instance [no 1] demo ended.
Remote [no 2] core received a message: 98
RPMsg Multiple instance [no 2] demo ended.