Thread and Thread+BLE examples

Table of Contents

• Testing
• Command Line Interface support
• Thread BSP LED reference

This information applies to the nRF52840 SoC only.

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

Before running the examples, see Running precompiled examples.

• Thread multiprotocol examples demonstrate the usage of Thread and BLE within the same example application.
• Thread-only examples demonstrate the usage of applications based only on Thread.

SoftDevice usage

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

Thread example parameters

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

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.7.2 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 support

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/RCP Example
• BLE UART and Thread MTD CoAP Client Example
• BLE Scanner and Thread SED 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.