Thread certification

Thread Group requires certification for devices using the Thread protocol. You can follow different scenarios to assure that your Nordic Semiconductor device based on the 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 SoC or the SiP you are using in the relevant Compatibility Matrix’s “Thread CIDs” section.

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 the 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:

  1. Build the certification image.

    Use the Thread: CLI sample as a base and apply the ci and multiprotocol Snippets. If you are building for the nrf5340dk/nrf5340/cpuapp target, also set the additional FILE_SUFFIX CMake option to ble. See Custom configurations and Providing CMake options for more information.

    • If building on the command line, use the following command:

      cd ncs/nrf/samples/openthread/cli/
      west build -b nrf52840dk/nrf52840 -- -Dcli_SNIPPET="ci;multiprotocol"  -DCONFIG_OPENTHREAD_LIBRARY=y
      
    • If building using Visual Studio Code, you must first create and build the application using the CLI sample. Add the following lines to the Additional CMake arguments text field:

      -Dcli_SNIPPET="ci;multiprotocol"
      -DCONFIG_OPENTHREAD_LIBRARY=y
      

    Note

    The configuration option selects the precompiled OpenThread libraries. The multiprotocol snippet and the FILE_SUFFIX CMake option set to ble enables the multiprotocol support with Bluetooth® LE advertising.

  2. Prepare Thread Test Harness.

    1. 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.

    2. 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.

    3. 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.

    1. 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):
      
    2. 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.