Thread examples

This information applies to the nRF52840 SoC only.

The following examples demonstrate different features of a Thread stack running on the nRF52840 SoC.

• Multiprotocol examples show the usage of Thread and BLE within the same example application.
• Thread Secure DFU Example demonstrates how to run a secure Device Firmware Update (DFU) process over a Thread network.
• Thread CLI Example demonstrates a minimal OpenThread application that enables user interaction through built-in CLI.
• Thread CoAP Examples demonstrate interaction between nodes performing different Thread roles with the use of OpenThread and built-in CoAP protocol.
• Thread Cloud CoAP Client Example demonstrates interaction between the development kit and a remote Cloud service.
• Thread MQTT-SN Example demonstrates interaction between nodes with the use of OpenThread and built-in MQTT-SN protocol.
• Thread NCP Example demonstrates an OpenThread application that can serve as a low-power wireless Network Co-Processor (NCP) to communicate with Userspace WPAN Network Daemon (wpantund).
• Thread NFC MeshCoP Example demonstrates Thread native commissioning using NFC with use of OpenThread and Border Router.
• Thread PER Measurement Example demonstrates measurement of Packet Error Rate (PER) between a transmitter node and a receiver node.

Note

Thread examples do not use the SoftDevice, with the exception of multiprotocol examples.

For your convenience, all Thread examples, except for the Thread NFC MeshCoP Example, have been precommissioned with the following parameters:

Radio Channel: 11
PAN ID: 0xABCD
Network Master Key: 0x00112233445566778899AABBCCDDEEFF
Mesh-Local Prefix: FDDE:AD00:BEEF::/64

In an end product, precommissioning must NOT be used. Use the commissioning procedure to obtain network credentials.

Testing

You can find the source code and the project file of the examples in the following folder: <InstallFolder>\examples\thread\experimental

Use the following steps to test the Thread examples:

1. Build the example according to the instructions in Building examples.
2. Use nrfjprog (from nRF5x Command Line Tools v9.2.0 or newer) to program the .hex file that was created in the _build folder to the board.
3. Use an RTT viewer to see the log messages produced by the application.

Command Line Interface

Most examples expose a Command Line Interface (CLI) over a serial port. Refer to OpenThread CLI Reference for details of the available commands. The following examples do not expose a CLI:

• MTD CoAP Client
• Thread NCP Example
• BLE UART and Thread MTD CoAP Client Example

Thread BSP LED reference

All Thread examples use the same LED assignments:

• LED 1 (BSP_LED_0): Network connection state:
  • Disabled – Node is disconnected and is not currently connecting to a Thread mesh network.
  • Blinking (period of 200 ms) – Node is currently connecting to a Thread mesh network.
  • Solid – Node is connected to a Thread mesh network.
• LED 2 (BSP_LED_1) – Commissioning state:
  • Disabled – Example does not support commissioning.
  • Slow blinking (200 ms on, 800 ms off) – Node supports commissioning but is not commissioned.
  • Rapid blinking (200 ms period) – Node is currently in the commissioning procedure.
  • Solid – Node is commissioned.
• LED 1 and LED 2 blinking four times synchronously (400 ms period): Node received an ICMPv6 Ping Request message.