Thread certification

Thread certification options
Thread Test Harness integration
- Thread Test Harness with nRF52840 DK

Thread Group requires certification for devices using the Thread protocol. You can follow different scenarios to assure that your Nordic Semiconductor device based on nRF Connect SDK becomes a Thread-certified product.

For general information about the certification process, check the Thread Group’s certification information.

Thread certification options 

The OpenThread pre-built libraries, which are available in the nrfxlib repository, are certified by Thread Group for various Nordic Semiconductor devices.

You can find the certification information for the chip that you are using in the Nordic Semiconductor Infocenter. Navigate to the compatibility matrix for your chip and select Thread CIDs.

Depending on your development approach, you have several certification options when using Nordic Semiconductor devices.

Certification by inheritance without modifications to binaries 

If you are developing a Thread product with nRF Connect SDK, you can apply for certifying this product by inheritance as an official Thread certified product. As long as you do not modify the functionality of the certified binary libraries, your product is eligible for certification by inheritance.

This scenario offers the most simplified and potentially the shortest certification process at the lowest cost. It is available to Thread Group members at Implementer tier or higher.

Certification by inheritance with modifications to binaries 

If your solution uses the same version of the OpenThread stack as the one used in the precompiled, certified binaries, but you made modifications within the operating parameters defined by Thread Group, you need to contact Thread Group to check if certification by inheritance is still possible.

You must officially list all changes with a detailed explanation in your application. Based on this list, Thread Group can accept or reject your application for certification by inheritance.

Certification at ATL 

If your solution modifies the certified functionality of the stack, or if Thread Group rejects your application for certification by inheritance, you need to undergo the full certification procedure at an Authorized Test Lab (ATL). Only Contributor and Sponsor tier members of Thread Group can apply for certification by an ATL.

Thread Test Harness integration 

To certify a Thread product, all certification test cases must be run on the Thread Test Harness software.

A detailed description of how to assemble and configure a Thread Test Bed and run the Thread Test Harness can be found on the Thread Group’s Confluence wiki page. Access to this information is only available to members of the Thread Group, and access to the Thread Test Harness depends on the membership tier.

Note

The following procedure references the nRF52840 Development Kit. The same procedure can be used to run the certification using other development kits.

Complete the following steps to prepare for the certification tests:

Build the certification image.

Use the Thread: CLI sample as a base, and apply the overlay-ci.conf and overlay-multiprotocol.conf overlay files.
- If building on the command line, use the following command:
```
cd ncs/nrf/samples/openthread/cli/
west build -b nrf52840dk_nrf52840 -- -DOVERLAY_CONFIG="overlay-ci.conf;overlay-multiprotocol.conf" -DCONFIG_OPENTHREAD_LIBRARY=y
```
- If building using Visual Studio Code, you must first create and build the application using the CLI sample. Select the overlay-ci.conf and overlay-multiprotocol.conf overlay files in the Kconfig fragment drop-down menu and add the following lines to the Additional CMake arguments text field:
```
CONFIG_OPENTHREAD_LIBRARY=y
```
Note

The configuration option selects the precompiled OpenThread libraries. The overlay-multiprotocol.conf overlay file enables multiprotocol support with Bluetooth® LE advertising.

Note

The overlay-multiprotocol.conf overlay file is not supported with nrf52833dk_nrf52833.

Prepare Thread Test Harness.

Copy the provided ncs/modules/lib/openthread/tools/harness-thci/OpenThread.py file into C:\GRL\Thread1.2\Thread_Harness\THCI\nRF_Connect_SDK.py.
Copy the provided ncs/nrf/samples/openthread/cli/harness-thci-1-3/nRF_Connect_SDK_1_3.py file into C:\GRL\Thread1.2\Thread_Harness\THCI\nRF_Connect_SDK_1_3.py.
Copy images of your choice to C:\GRL\Thread1.2\Web\images\nRF_Connect_SDK.jpg and C:\GRL\Thread1.2\Web\images\nRF_Connect_SDK_1_3.jpg.

You can use the same image for both.

Edit C:\GRL\Thread1.2\Thread_Harness\THCI\nRF_Connect_SDK.py as follows:

>> Thread Host Controller Interface
>> Device : OpenThread THCI
>> Class : OpenThread

to

>> Thread Host Controller Interface
>> Device : nRF_Connect_SDK THCI
>> Class : nRF_Connect_SDK

and

class OpenThread(OpenThreadTHCI, IThci):

to

class nRF_Connect_SDK(OpenThreadTHCI, IThci):

Edit C:\GRL\Thread1.2\Web\data\deviceInputFields.xml and prepend the following code:

<DEVICE name="nRF Connect SDK" thumbnail="nRF_Connect_SDK.jpg" description = "Nordic Semiconductor: NCS Baudrate:115200" THCI="nRF_Connect_SDK">
   <ITEM label="Serial Line"
      type="text"
      forParam="SerialPort"
      validation="COM"
      hint="eg: COM1">COM
   </ITEM>
   <ITEM label="Speed"
      type="text"
      forParam="SerialBaudRate"
      validation="baud-rate"
      hint="eg: 115200">115200
   </ITEM>
</DEVICE>
<DEVICE name="nRF Connect SDK 1.3" thumbnail="nRF_Connect_SDK_1_3.jpg" description = "Nordic Semiconductor: NCS Baudrate:115200" THCI="nRF_Connect_SDK_1_3">
   <ITEM label="Serial Line"
      type="text"
      forParam="SerialPort"
      validation="COM"
      hint="eg: COM1">COM
   </ITEM>
   <ITEM label="Speed"
      type="text"
      forParam="SerialBaudRate"
      validation="baud-rate"
      hint="eg: 115200">115200
   </ITEM>
</DEVICE>

The device with name “nRF Connect SDK” is intended to be used for Thread 1.1 and Thread 1.2 Certification Programs tests. The device with name “nRF Connect SDK 1.3” is intended to be used for Thread 1.3 Certification Program tests.

See the following links for more information on OpenThread:

Thread Test Harness with nRF52840 DK 

Thread Test Harness does not correctly identify the nRF52840 DK (PCA10056) out-of-the-box.

Due to a collision of USB PID:VID with another vendor, Nordic devices are not automatically added to the device list. This is valid only for Nordic Semiconductor development kits with a J-Link virtual COM port.

To add an nRF52840 DK, drag the nRF52840 DK and drop it on the test bed configuration page. After that, the device is configured and the proper baud rate (115200) and COM port are set.

Thread certification