Bluetooth: Host for nRF RPC Bluetooth Low Energy
The nRF RPC Host sample demonstrates the Bluetooth® Low Energy (LE) stack with the Remote procedure call library (nRF RPC) library that exposes the stack’s interface to another device or CPU using Remote Procedure Calls (RPC). On an nRF53 device, this sample is supposed to run on the network core and it provides the Bluetooth LE functionality for the application core.
The sample supports the following development kits:
Currently, only a subset of Zephyr’s Bluetooth APIs is available over Bluetooth nRF RPC. For more details about the limitations, see the API documentation of the Bluetooth nRF RPC library.
The host (network core) is running the full Bluetooth LE stack. It receives serialized function calls that it decodes and executes, then sends response data to the client (application core).
When the sample starts, it displays the welcome prompt “Starting nRF RPC bluetooth host”.
You must program this sample to the nRF5340 network core.
This sample can be found under
samples/bluetooth/rpc_host in the nRF Connect SDK folder structure.
To build the sample with Visual Studio Code, follow the steps listed on the How to build an application page in the nRF Connect for VS Code extension documentation. See Building and programming an application for other building and programming scenarios and Testing and debugging an application for general information about testing and debugging in the nRF Connect SDK.
To build the sample with a debugging configuration, use the
-DOVERLAY_CONFIG=overlay-debugging.conf' flag in your build.
See Providing CMake options for instructions on how to add this option to your build. For example, when building on the command line, enter the following command:
west build samples/bluetooth/rpc_host -- -DOVERLAY_CONFIG=overlay-debugging.conf
The recommended way of building the nRF RPC Host sample is to use the multi-image feature of the build system, building the sample with the same Bluetooth configuration as the application core sample.
In this way, the sample is built automatically as a child image when the
CONFIG_BT_RPC_STACK option is enabled.
See Configuring your application for information about how to configure a sample.
Build the sample with the same Bluetooth configuration as the application core sample. For more details, see: Bluetooth Low Energy Remote Procedure Call.
Build the Bluetooth: Peripheral UART on the application core. This sample works out of the box and does not require configuration changes.
In the Peripheral UART sample directory, invoke:
west build -b nrf5340dk_nrf5340_cpuapp -- -DCONFIG_BT_RPC_STACK=y
You can also build the Bluetooth: Peripheral HIDS mouse sample using the above command.
This sample requires some additional configuration in the
You can take it as an example on how to create configuration for your own application.
After programming the example build to your development kit, complete the following steps to test it:
Connect the dual core development kit to the computer using a USB cable. The development kit is assigned a COM port (Windows) or ttyACM device (Linux), which is visible in the Device Manager.
Connect to the kit with a terminal emulator (for example, PuTTY). See How to connect with PuTTY for the required settings.
Reset the development kit.
Observe that the terminal connected to the network core displays “Starting nRF RPC Bluetooth host”.
On the terminal connected to the application core, you can observe your Bluetooth application is running.
This sample uses the following nRF Connect SDK library:
It uses the following sdk-nrfxlib library: