OpenThread Border Router (OTBR) includes a variety of tools and scripts that can be used for testing purposes.
pskc, available in ot-br-posix/tools,
generates a Pre-Shared Key for the Commissioner (PSKc). The
PSKc is used to authenticate an external Thread Commissioner to a Thread
network. Build and install OTBR to use this tool.
pskc is located at
The PSKc is generated from the following parameters:
- Commissioner Credential
- Thread Network Extended PAN ID
- Thread Network Name
pskc commissioner-credential extpanid network-name
./pskc J01NME 1234AAAA1234BBBB MyOTBRNetworkee4fb64e9341e13846bbe7e1c52b6785
To use this tool with
ot-ctl, refer to External
Steering data generator
steering-data, available in ot-br-posix/tools,
uses a Bloom filter to generate a hash of the set of Joiners
intended for commissioning. During commissioning, the Joiner only looks for
networks advertising steering data that includes the Joiner itself. Build and
install OTBR to use this tool.
steering-data is located at
The steering data is generated from the following parameters:
- Byte length of steering data (optional, default is 16)
- Joiner ID (EUI-64)
steering-data [length] joiner-id
Use multiple Joiner IDs to include them all in the steering data:
./steering-data 0000b57fffe15d68 0000c57fffe15d6800000000000080000020000000000500
length parameter to change the byte length of the resulting steering
./steering-data 8 0000b57fffe15d680020000000000100
By default, the Commissioner role is enabled on OTBR, similar to enabling the
Commissioner role on a device with the
-DOT_COMMISSIONER=ON flag. On the
platform running OTBR, use
ot-ctl commissioner to commission Joiners
from the command line.
help for a list of commands.
sudo ot-ctl commissioner help
sudo ot-ctl commissioner parameters
sudo ot-ctl commissioner startDone
sudo ot-ctl commissioner joiner add 2f57d222545271f1 J01NMEDone
OTBR provides a MeshCoP (Mesh Commissioning Protocol) test script that
uses OT Commissioner to test External Commissioning.
For usage information, refer to the
meshcop test script
standalone_ipv6 script to test IPv6 functionality if your test or
development environment does not have a full IPv6 infrastructure available (for
example, if your network is not connected to an upstream IPv6 provider).
This script installs extra features on the platform running OTBR to enable the device to serve IPv6 addresses.
This script is located at