Thread: CoAP Client
The Thread CoAP Client sample demonstrates controlling light resources of other nodes within an OpenThread network. To show this interaction, the sample requires a server sample that is compatible with the OpenThread network and has a light resource available. The recommended server sample referenced on this page is Thread: CoAP Server.
The sample supports the following development kits:
You can use one or more of the development kits listed above as the Thread CoAP Client. You also need one or more compatible development kits programmed with the Thread: CoAP Server sample.
When built for an
_ns build target, the sample is configured to compile and run as a non-secure application.
Therefore, it automatically includes Trusted Firmware-M that prepares the required peripherals and secure services to be available for the application.
You can also configure it to use the Secure Partition Manager.
If you enable the Multiprotocol Bluetooth LE extension, make sure you have a phone with the nRF Toolbox application installed or an additional development kit programmed with Bluetooth: Central UART sample.
This sample demonstrates how to access resources available on a Thread server node. After the Thread network is established, the client node can control the state of LED 4 on server nodes. It can turn on the LED either on every server node in the network with a multicast message, or on a single specific server node that is paired with the client node.
The following CoAP resources are accessed on the server side:
/light- Used to control LED 4.
/provisioning- Used to perform provisioning.
This optional extension demonstrates the OpenThread stack and SoftDevice Controller working concurrently. It uses the Nordic UART Service (NUS) library to control the LED states over Bluetooth® LE in a Thread network. For more information about the multiprotocol feature, see Multiprotocol support.
The following LED and buttons of the client development kit are used by this sample:
- LED 1:
On when the OpenThread connection is established.
- Button 1:
Send a unicast
LIGHT_TOGGLEmessage to the
/lightresource on a paired device. If no device is paired with the specific client node, pressing the button has no effect.
- Button 2:
Send a multicast
LIGHT_OFFmessage (alternatively) to the
/lightresource. Sending this multicast message instead of
LIGHT_TOGGLEallows to synchronize the state of the LEDs on several server nodes.
- Button 4:
Send a multicast pairing request to the
When the device is working as Minimal Thread Device (MTD), the following LED and Button assignments are also available:
- LED 3:
The mode the device is working in:
On when in the Minimal End Device (MED) mode.
Off when in the Sleepy End Device (SED) mode.
- Button 3:
Toggle the power consumption between SED and MED.
For more information, see Device type options in the Thread user guide.
- LED 2:
On when Bluetooth LE connection is established.
- UART command assignments:
The following command assignments are configured and used in nRF Toolbox when Testing multiprotocol Bluetooth LE extension:
u- Send a unicast CoAP message over Thread (the same operation as Button 1).
m- Send a multicast CoAP message over Thread (the same operation as Button 2).
p- Send a pairing request as CoAP message over Thread (the same operation as Button 4).
See Configuring your application for information about how to permanently or temporarily change the configuration.
The sample provides predefined configuration files for typical use cases, and to activate sample extensions. You can find the configuration files in the root directory of the sample.
Specify the corresponding file names in the OVERLAY_CONFIG option when building. See Providing CMake options for instructions on how to add this option. For more information about using configuration overlay files, see Important Build System Variables in the Zephyr documentation.
The following configuration files are available:
overlay-mtd.conf- Enables the Minimal Thread Device variant.
overlay-multiprotocol_ble.conf- Enables the Multiprotocol Bluetooth LE extension.
You can add support for the nRF21540 front-end module to this sample by using one of the following options, depending on your hardware:
Build the sample for one board that contains the nRF21540 FEM, such as nrf21540dk_nrf52840.
Manually create a devicetree overlay file that describes how FEM is connected to the nRF5 SoC in your device. See Set devicetree overlays for different ways of adding the overlay file.
Provide nRF21540 FEM capabilities by using a shield, for example the nRF21540 EK shield that is available in the nRF Connect SDK. In this case, build the project for a board connected to the shield you are using with an appropriate variable included in the build command. This variable instructs the build system to append the appropriate devicetree overlay file. For example, to build the sample from the command line for an nRF52833 DK with the nRF21540 EK attached, use the following command within the sample directory:
west build -b nrf52833dk_nrf52833 -- -DSHIELD=nrf21540_ek
This command builds the application firmware. See Programming nRF21540 EK for information about how to program when you are using a board with a network core, for example nRF5340 DK.
Each of these options adds the description of the nRF21540 FEM to the devicetree. See Working with RF front-end modules for more information about FEM in the nRF Connect SDK.
To add support for other front-end modules, add the respective devicetree file entries to the board devicetree file or the devicetree overlay file.
Make sure to enable the OpenThread stack before building and testing this sample. See Thread for more information.
This sample can be found under
samples/openthread/coap_client in the nRF Connect SDK folder structure.
When built as a non-secure firmware image for the
_ns build target, the sample automatically includes the Trusted Firmware-M (TF-M).
You can configure it to use the Secure Partition Manager instead of TF-M.
See Building and programming an application for information about how to build and program the application and Testing and debugging an application for general information about testing and debugging in the nRF Connect SDK.
After building the sample and programming it to your development kit, test it by performing the following steps:
Program at least one development kit with Thread: CoAP Server and reset it.
Turn on the CoAP Client and at least one CoAP Server. They will create the Thread network.
It may take up to 15 seconds for nodes to establish the network. When the sample application is ready, the LED 1 starts blinking.
Press Button 2 on a client node to control LED 4 on all server nodes.
Pair a client with a server by completing the following steps:
Press Button 4 on a server node to enable pairing.
Press Button 4 on a client node to pair it with the server node in the pairing mode.
Press Button 1 on the client node to control the LED 4 on the paired server node.
Testing Minimal Thread Device
After building the MTD variant of this sample and programming it, the device starts in the SED mode with LED 3 off. This means that the radio is disabled when idle and the serial console is not working to decrease the power consumption. You can switch to the MED mode at any moment during the standard testing procedure.
To toggle MED, press Button 3 on the client node. LED 3 turns on to indicate the switch to the MED mode. At this point, the radio is enabled when it is idle and the serial console is operating.
Pressing Button 3 again will switch the mode back to SED. Switching between SED and MED modes does not affect the standard testing procedure, but terminal logs are not available in the SED mode.
Testing multiprotocol Bluetooth LE extension
To test the multiprotocol Bluetooth LE extension, you can use nRF Toolbox or the Bluetooth: Central UART sample. The steps below assume nRF Toolbox as the Bluetooth tester.
First, you need to set up nRF Toolbox as follows:
Tap UART to open the UART application in nRF Toolbox.
Tap the EDIT button in the top right corner of the application to configure the UART commands. The button configuration window appears.
Create the active application buttons by completing the following steps:
Bind the top left button to the
ucommand, with EOL set to LF and an icon of your choice. For this testing procedure, the > icon is used.
Bind the top middle button to the
mcommand, with EOL set to LF and an icon of your choice. For this testing procedure, the play button icon is used.
Bind the top right button to the
pcommand, with EOL set to LF and an icon of your choice. For this testing procedure, the settings gear icon is used.
Tap the DONE button in the top right corner of the application.
Tap CONNECT and select the
NUS_CoAP_clientdevice from the list to connect to the device.
Observe that LED 2 on your CoAP Multiprotocol Client node lights up, which indicates that the Bluetooth connection is established.
When you have set up nRF Toolbox, complete the following steps after the standard Testing procedure:
In nRF Toolbox, tap the middle button to control LED 4 on all CoAP server nodes.
To pair a client with a server, complete the following steps:
Press Button 4 on a server node to enable pairing.
In nRF Toolbox, tap the right button to pair the two nodes.
In nRF Toolbox, tap the left button to control LED 4 on the paired server node.
You can observe the sample logging output with a terminal emulator that supports VT100/ANSI escape characters. For more details, see How to connect with PuTTY.
This sample uses the following nRF Connect SDK libraries:
In addition, it uses the following Zephyr libraries:
The following dependencies are added by the optional multiprotocol Bluetooth LE extension: