tree: 330d298a136394693a95fe8b45017ef01ae1bd34 [path history] [tgz]

src/cli/README.md

OpenThread CLI Reference

The OpenThread CLI exposes configuration and management APIs via a command line interface. Use the CLI to play with OpenThread, which can also be used with additional application code. The OpenThread test scripts use the CLI to execute test cases.

Separator and escaping characters

The whitespace character (' ') is used to delimit the command name and the different arguments, together with tab ('\t') and new line characters ('\r', '\n').

Some arguments might require to accept whitespaces on them. For those cases the backslash character ('\') can be used to escape separators or the backslash itself.

Example:

> networkname Test\ Network
Done
> networkname
Test Network
Done
>

OpenThread Command List

OpenThread Command Details

bbr

Show current Primary Backbone Router information for Thread 1.2 device.

> bbr
BBR Primary:
server16: 0xE400
seqno:    10
delay:    120 secs
timeout:  300 secs
Done

> bbr
BBR Primary: None
Done

bbr mgmt dua <status> [meshLocalIid]

Configure the response status for DUA.req with meshLocalIid in payload. Without meshLocalIid, simply respond any coming DUA.req next with the specified status.

Only for testing/reference device.

known status value:

0: ST_DUA_SUCCESS
1: ST_DUA_REREGISTER
2: ST_DUA_INVALID
3: ST_DUA_DUPLICATE
4: ST_DUA_NO_RESOURCES
5: ST_DUA_BBR_NOT_PRIMARY
6: ST_DUA_GENERAL_FAILURE

> bbr mgmt dua 1 2f7c235e5025a2fd
Done

bbr state

Show local Backbone state ([Disabled,Primary, Secondary]) for Thread 1.2 FTD.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr state
Disabled
Done

> bbr state
Primary
Done

> bbr state
Secondary
Done

bbr enable

Enable Backbone Router Service for Thread 1.2 FTD. SRV_DATA.ntf would be triggerred for attached device if there is no Backbone Router Service in Thread Network Data.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr enable
Done

bbr disable

Disable Backbone Router Service for Thread 1.2 FTD. SRV_DATA.ntf would be triggerred if Backbone Router is Primary state. o OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr disable
Done

bbr register

Register Backbone Router Service for Thread 1.2 FTD. SRV_DATA.ntf would be triggerred for attached device.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr register
Done

bbr config

Show local Backbone Router configuration for Thread 1.2 FTD.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr config
seqno:    10
delay:    120 secs
timeout:  300 secs
Done

bbr config [seqno <seqno>] [delay <delay>] [timeout <timeout>]

Configure local Backbone Router configuration for Thread 1.2 FTD. bbr register should be issued explicitly to register Backbone Router service to Leader for Secondary Backbone Router. SRV_DATA.ntf would be initiated automatically if BBR Dataset changes for Primary Backbone Router.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr config seqno 20 delay 30
Done

bbr jitter

Show jitter (in seconds) for Backbone Router registration for Thread 1.2 FTD.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr jitter
20
Done

bbr jitter <jitter>

Set jitter (in seconds) for Backbone Router registration for Thread 1.2 FTD.

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE is required.

> bbr jitter 10
Done

bufferinfo

Show the current message buffer information.

> bufferinfo
total: 40
free: 40
6lo send: 0 0
6lo reas: 0 0
ip6: 0 0
mpl: 0 0
mle: 0 0
arp: 0 0
coap: 0 0
Done

channel

Get the IEEE 802.15.4 Channel value.

> channel
11
Done

channel <channel>

Set the IEEE 802.15.4 Channel value.

> channel 11
Done

channel preferred

Get preferred channel mask.

> channel preferred
0x7fff800
Done

channel supported

Get supported channel mask.

> channel supported
0x7fff800
Done

child list

List attached Child IDs.

> child list
1 2 3 6 7 8
Done

child table

Print table of attached children.

> child table
| ID  | RLOC16 | Timeout    | Age        | LQ In | C_VN |R|S|D|N| Extended MAC     |
+-----+--------+------------+------------+-------+------+-+-+-+-+------------------+
|   1 | 0xe001 |        240 |         44 |     3 |  237 |1|1|1|1| d28d7f875888fccb |
|   2 | 0xe002 |        240 |         27 |     3 |  237 |0|1|0|1| e2b3540590b0fd87 |
Done

child <id>

Print diagnostic information for an attached Thread Child. The id may be a Child ID or an RLOC16.

> child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rsn
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done

childip

Get the list of IP addresses stored for MTD children.

> childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done

childip max

Get the maximum number of IP addresses that each MTD child may register with this device as parent.

> childip max
4
Done

childip max <count>

Set the maximum number of IP addresses that each MTD child may register with this device as parent. 0 to clear the setting and restore the default.

OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is required.

> childip max 2
Done

childmax

Get the Thread maximum number of allowed children.

> childmax
5
Done

childmax <count>

Set the Thread maximum number of allowed children.

> childmax 2
Done

childtimeout

Get the Thread Child Timeout value.

> childtimeout
300
Done

childtimeout <timeout>

Set the Thread Child Timeout value.

> childtimeout 300
Done

contextreusedelay

Get the CONTEXT_ID_REUSE_DELAY value.

> contextreusedelay
11
Done

contextreusedelay <delay>

Set the CONTEXT_ID_REUSE_DELAY value.

> contextreusedelay 11
Done

counters

Get the supported counter names.

> counters
mac
mle
Done

counters <countername>

Get the counter value.

> counters mac
TxTotal: 10
    TxUnicast: 3
    TxBroadcast: 7
    TxAckRequested: 3
    TxAcked: 3
    TxNoAckRequested: 7
    TxData: 10
    TxDataPoll: 0
    TxBeacon: 0
    TxBeaconRequest: 0
    TxOther: 0
    TxRetry: 0
    TxErrCca: 0
    TxErrBusyChannel: 0
RxTotal: 2
    RxUnicast: 1
    RxBroadcast: 1
    RxData: 2
    RxDataPoll: 0
    RxBeacon: 0
    RxBeaconRequest: 0
    RxOther: 0
    RxAddressFiltered: 0
    RxDestAddrFiltered: 0
    RxDuplicated: 0
    RxErrNoFrame: 0
    RxErrNoUnknownNeighbor: 0
    RxErrInvalidSrcAddr: 0
    RxErrSec: 0
    RxErrFcs: 0
    RxErrOther: 0
Done
> counters mle
Role Disabled: 0
Role Detached: 1
Role Child: 0
Role Router: 0
Role Leader: 1
Attach Attempts: 1
Partition Id Changes: 1
Better Partition Attach Attempts: 0
Parent Changes: 0
Done

counters <countername> reset

Reset the counter value.

> counters mac reset
Done
> counters mle reset
Done

networktime

Get the Thread network time and the time sync parameters.

> networktime
Network Time:     21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold:   300ppm
Done

networktime <timesyncperiod> <xtalthreshold>

Set time sync parameters

timesyncperiod: The time synchronization period, in seconds.
xtalthreshold: The XTAL accuracy threshold for a device to become Router-Capable device, in PPM.

> networktime 100 300
Done

delaytimermin

Get the minimal delay timer (in seconds).

> delaytimermin
30
Done

delaytimermin <delaytimermin>

Set the minimal delay timer (in seconds).

> delaytimermin 60
Done

discover [channel]

Perform an MLE Discovery operation.

channel: The channel to discover on. If no channel is provided, the discovery will cover all valid channels.

> discover
| J | Network Name     | Extended PAN     | PAN  | MAC Address      | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread       | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

dns resolve <hostname> [DNS server IP] [DNS server port]

Send DNS Query to obtain IPv6 address for given hostname. The latter two parameters have following default values:

DNS server IP: 2001:4860:4860::8888 (Google DNS Server)
DNS server port: 53

> dns resolve ipv6.google.com
> DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300

domainname

Get the Thread Domain Name for Thread 1.2 device.

> domainname
Thread
Done

domainname <name>

Set the Thread Domain Name for Thread 1.2 device.

> domainname Test\ Thread
Done

dua iid

Get the Interface Identifier mannually specified for Thread Domain Unicast Address on Thread 1.2 device.

> dua iid
0004000300020001
Done

dua iid <iid>

Set the Interface Identifier mannually specified for Thread Domain Unicast Address on Thread 1.2 device.

> dua iid 0004000300020001
Done

dua iid clear

Clear the Interface Identifier mannually specified for Thread Domain Unicast Address on Thread 1.2 device.

> dua iid clear
Done

eidcache

Print the EID-to-RLOC cache entries.

> eidcache
fdde:ad00:beef:0:bb1:ebd6:ad10:f33 ac00
fdde:ad00:beef:0:110a:e041:8399:17cd 6000
Done

eui64

Get the factory-assigned IEEE EUI-64.

> eui64
0615aae900124b00
Done

extaddr

Get the IEEE 802.15.4 Extended Address.

> extaddr
dead00beef00cafe
Done

extaddr <extaddr>

Set the IEEE 802.15.4 Extended Address.

> extaddr dead00beef00cafe
dead00beef00cafe
Done

extpanid

Get the Thread Extended PAN ID value.

NOTE The current commissioning credential becomes stale after changing this value. Use pskc to reset.

> extpanid
dead00beef00cafe
Done

extpanid <extpanid>

Set the Thread Extended PAN ID value.

> extpanid dead00beef00cafe
Done

factoryreset

Delete all stored settings, and signal a platform reset.

> factoryreset

ifconfig

Show the status of the IPv6 interface.

> ifconfig
down
Done

ifconfig up

Bring up the IPv6 interface.

> ifconfig up
Done

ifconfig down

Bring down the IPv6 interface.

> ifconfig down
Done

ipaddr

List all IPv6 addresses assigned to the Thread interface.

> ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

ipaddr add <ipaddr>

Add an IPv6 address to the Thread interface.

> ipaddr add 2001::dead:beef:cafe
Done

ipaddr del <ipaddr>

Delete an IPv6 address from the Thread interface.

> ipaddr del 2001::dead:beef:cafe
Done

ipaddr linklocal

Print Thread link-local IPv6 address.

> ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

ipaddr mleid

Print Thread Mesh Local EID address.

> ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done

ipaddr rloc

Print Thread Routing Locator (RLOC) address.

> ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done

ipmaddr

List all IPv6 multicast addresses subscribed to the Thread interface.

> ipmaddr
ff05:0:0:0:0:0:0:1
ff33:40:fdde:ad00:beef:0:0:1
ff32:40:fdde:ad00:beef:0:0:1
Done

ipmaddr add <ipaddr>

Subscribe the Thread interface to the IPv6 multicast address.

> ipmaddr add ff05::1
Done

ipmaddr del <ipaddr>

Unsubscribe the Thread interface to the IPv6 multicast address.

> ipmaddr del ff05::1
Done

ipmaddr promiscuous

Get multicast promiscuous mode.

> ipmaddr promiscuous
Disabled
Done

ipmaddr promiscuous enable

Enable multicast promiscuous mode.

> ipmaddr promiscuous enable
Done

ipmaddr promiscuous disable

Disable multicast promiscuous mode.

> ipmaddr promiscuous disable
Done

joinerport <port>

Set the Joiner port.

> joinerport 1000
Done

keysequence counter

Get the Thread Key Sequence Counter.

> keysequence counter
10
Done

keysequence counter <counter>

Set the Thread Key Sequence Counter.

> keysequence counter 10
Done

keysequence guardtime

Get Thread Key Switch Guard Time (in hours)

> keysequence guardtime
0
Done

keysequence guardtime <guardtime>

Set Thread Key Switch Guard Time (in hours) 0 means Thread Key Switch imediately if key index match

> keysequence guardtime 0
Done

leaderpartitionid

Get the Thread Leader Partition ID.

> leaderpartitionid
4294967295
Done

leaderpartitionid <partitionid>

Set the Thread Leader Partition ID.

> leaderpartitionid 0xffffffff
Done

leaderdata

Show the Thread Leader Data.

> leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done

leaderweight

Get the Thread Leader Weight.

> leaderweight
128
Done

leaderweight <weight>

Set the Thread Leader Weight.

> leaderweight 128
Done

linkquality <extaddr>

Get the link quality on the link to a given extended address.

> linkquality 36c1dd7a4f5201ff
3
Done

linkquality <extaddr> <linkquality>

Set the link quality on the link to a given extended address.

> linkquality 36c1dd7a4f5201ff 3
Done

log filename <filename>

Note: Simulation Only, ie: OPENTHREAD_EXAMPLES_SIMULATION
Requires OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART

Specifies filename to capture otPlatLog() messages, useful when debugging automated test scripts on Linux when logging disrupts the automated test scripts.

log level

Get the log level.

> log level
1
Done

log level <level>

Set the log level.

> log level 4
Done

masterkey

Get the Thread Master Key value.

> masterkey
00112233445566778899aabbccddeeff
Done

masterkey <key>

Set the Thread Master Key value.

> masterkey 00112233445566778899aabbccddeeff
Done

mode

Get the Thread Device Mode value.

r: rx-on-when-idle
s: Secure IEEE 802.15.4 data requests
d: Full Thread Device
n: Full Network Data

> mode
rsdn
Done

mode [rsdn]

Set the Thread Device Mode value.

r: rx-on-when-idle
s: Secure IEEE 802.15.4 data requests
d: Full Thread Device
n: Full Network Data

> mode rsdn
Done

neighbor list

List RLOC16 of neighbors.

> neighbor list
0xcc01 0xc800 0xf000
Done

neighbor table

Print table of neighbors.

> neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|S|D|N| Extended MAC     |
+------+--------+-----+----------+-----------+-+-+-+-+------------------+
|   C  | 0xcc01 |  96 |      -46 |       -46 |1|1|1|1| 1eb9ba8a6522636b |
|   R  | 0xc800 |   2 |      -29 |       -29 |1|0|1|1| 9a91556102c39ddb |
|   R  | 0xf000 |   3 |      -28 |       -28 |1|0|1|1| 0ad7ed6beaa6016d |
Done

netdata steeringdata check <eui64>|<discerner>

Check whether the steering data includes a joiner.

eui64: The IEEE EUI-64 of the Joiner.
discerner: The Joiner discerner in format number/length.

> netdata steeeringdata check d45e64fa83f81cf7
Done
> netdata steeeringdata check 0xabc/12
Done
> netdata steeeringdata check 0xdef/12
Error: NotFound

netdataregister

Register local network data with Thread Leader.

> netdataregister
Done

netdatashow

Show Thread Leader network data.

> netdatashow
08040b020000
Done

netstat

List all UDP sockets.

> netstat
|                 Local Address                 |                  Peer Address                 |
+-----------------------------------------------+-----------------------------------------------+
| 0:0:0:0:0:0:0:0:49153                         | 0:0:0:0:0:0:0:0:*                             |
| 0:0:0:0:0:0:0:0:49152                         | 0:0:0:0:0:0:0:0:*                             |
| 0:0:0:0:0:0:0:0:61631                         | 0:0:0:0:0:0:0:0:*                             |
| 0:0:0:0:0:0:0:0:19788                         | 0:0:0:0:0:0:0:0:*                             |
Done

networkdiagnostic get <addr> <type> ..

Send network diagnostic request to retrieve tlv of <type>s.

If <addr> is unicast address, Diagnostic Get will be sent. if <addr> is multicast address, Diagnostic Query will be sent.

> networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6
> DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Leader Data:
    PartitionId: 0x640b0f67
    Weighting: 64
    DataVersion: 116
    StableDataVersion: 197
    LeaderRouterId: 0x03
Done

> networkdiagnostic get ff02::1 0 1
> DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: '3efcdb7e3f9eb0f2'
Rloc16: 0x1800
Done

networkdiagnostic reset <addr> <type> ..

Send network diagnostic request to reset <addr>'s tlv of <type>s. Currently only MAC Counters(9) is supported.

> diagnostic reset fd00:db8::ff:fe00:0 9
Done

networkidtimeout

Get the NETWORK_ID_TIMEOUT parameter used in the Router role.

> networkidtimeout
120
Done

networkidtimeout <timeout>

Set the NETWORK_ID_TIMEOUT parameter used in the Router role.

> networkidtimeout 120
Done

networkname

Get the Thread Network Name.

> networkname
OpenThread
Done

networkname <name>

Set the Thread Network Name.

NOTE The current commissioning credential becomes stale after changing this value. Use pskc to reset.

> networkname OpenThread
Done

panid

Get the IEEE 802.15.4 PAN ID value.

> panid
0xdead
Done

panid <panid>

Set the IEEE 802.15.4 PAN ID value.

> panid 0xdead
Done

parent

Get the diagnostic information for a Thread Router as parent.

Note: When operating as a Thread Router, this command will return the cached information from when the device was previously attached as a Thread Child. Returning cached information is necessary to support the Thread Test Harness - Test Scenario 8.2.x requests the former parent (i.e. Joiner Router's) MAC address even if the device has already promoted to a router.

> parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Done

parentpriority

Get the assigned parent priority value, -2 means not assigned.

> parentpriority
1
Done

parentpriority <parentpriority>

Set the assigned parent priority value: 1, 0, -1 or -2.

> parentpriority 1
Done

ping <ipaddr> [size][count] [interval][hoplimit]

Send an ICMPv6 Echo Request.

size: The number of data bytes to be sent.
count: The number of ICMPv6 Echo Requests to be sent.
interval: The interval between two consecutive ICMPv6 Echo Requests in seconds. The value may have fractional form, for example 0.5.
hoplimit: The hoplimit of ICMPv6 Echo Request to be sent.

> ping fdde:ad00:beef:0:558:f56b:d688:799
16 bytes from fdde:ad00:beef:0:558:f56b:d688:799: icmp_seq=1 hlim=64 time=28ms

> ping ff05::1 100 1 1 1

ping stop

Stop sending ICMPv6 Echo Requests.

> ping stop
Done

pollperiod

Get the customized data poll period of sleepy end device (milliseconds). Only for certification test

> pollperiod
0
Done

pollperiod <pollperiod>

Set the customized data poll period for sleepy end device (milliseconds >= 10ms). Only for certification test

> pollperiod 10
Done

pskc [-p] <key>|<passphrase>

With -p generate pskc from <passphrase> (UTF-8 encoded) together with current network name and extended PAN ID, otherwise set pskc as <key> (hex format).

> pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
> pskc -p 123456
Done

preferrouterid <routerid>

Prefer a Router ID when solicit router id from Leader.

> preferrouterid 16
Done

prefix

Get the prefix list in the local Network Data. Note: For the Thread 1.2 border router with backbone capability, the local Domain Prefix would be listed as well (with flag D), with preceeding - if backbone functionality is disabled.

> prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done

prefix add <prefix> [padcrosnD][prf]

Add a valid prefix to the Network Data.

Note: The Domain Prefix flag (D) is only available for Thread 1.2.

p: Preferred flag
a: Stateless IPv6 Address Autoconfiguration flag
d: DHCPv6 IPv6 Address Configuration flag
c: DHCPv6 Other Configuration flag
r: Default Route flag
o: On Mesh flag
s: Stable flag
n: Nd Dns flag
D: Domain Prefix flag
prf: Default router preference, which may be ‘high’, ‘med’, or ‘low’.

> prefix add 2001:dead:beef:cafe::/64 paros med
Done

> prefix add fd00:7d03:7d03:7d03::/64 prosD med
Done

prefix remove <prefix>

Invalidate a prefix in the Network Data.

> prefix remove 2001:dead:beef:cafe::/64
Done

promiscuous

Get radio promiscuous property.

> promiscuous
Disabled
Done

promiscuous enable

Enable radio promiscuous operation and print raw packet content.

> promiscuous enable
Done

promiscuous disable

Disable radio promiscuous operation.

> promiscuous disable
Done

rcp

RCP-related commands.

rcp version

Print RCP version string.

> rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun  4 2020 17:53:16
Done

releaserouterid <routerid>

Release a Router ID that has been allocated by the device in the Leader role.

> releaserouterid 16
Done

reset

Signal a platform reset.

> reset

rloc16

Get the Thread RLOC16 value.

> rloc16
0xdead
Done

route

Get the external route list in the local Network Data.

> route
2001:dead:beef:cafe::/64 s med
Done

route add <prefix> [s][prf]

Add a valid external route to the Network Data.

s: Stable flag
prf: Default Router Preference, which may be: ‘high’, ‘med’, or ‘low’.

> route add 2001:dead:beef:cafe::/64 s med
Done

route remove <prefix>

Invalidate a external route in the Network Data.

> route remove 2001:dead:beef:cafe::/64
Done

router list

List allocated Router IDs.

> router list
8 24 50
Done

router table

Print table of routers.

> router table
| ID | RLOC16 | Next Hop | Path Cost | LQ In | LQ Out | Age | Extended MAC     |
+----+--------+----------+-----------+-------+--------+-----+------------------+
| 21 | 0x5400 |       21 |         0 |     3 |      3 |   5 | d28d7f875888fccb |
| 56 | 0xe000 |       56 |         0 |     0 |      0 | 182 | f2d92a82c8d8fe43 |
Done

router <id>

Print diagnostic information for a Thread Router. The id may be a Router ID or an RLOC16.

> router 50
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 3
Done

> router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done

routerdowngradethreshold

Get the ROUTER_DOWNGRADE_THRESHOLD value.

> routerdowngradethreshold
23
Done

routerdowngradethreshold <threshold>

Set the ROUTER_DOWNGRADE_THRESHOLD value.

> routerdowngradethreshold 23
Done

routereligible

Indicates whether the router role is enabled or disabled.

> routereligible
Enabled
Done

routereligible enable

Enable the router role.

> routereligible enable
Done

routereligible disable

Disable the router role.

> routereligible disable
Done

routerselectionjitter

Get the ROUTER_SELECTION_JITTER value.

> routerselectionjitter
120
Done

routerselectionjitter <jitter>

Set the ROUTER_SELECTION_JITTER value.

> routerselectionjitter 120
Done

routerupgradethreshold

Get the ROUTER_UPGRADE_THRESHOLD value.

> routerupgradethreshold
16
Done

routerupgradethreshold <threshold>

Set the ROUTER_UPGRADE_THRESHOLD value.

> routerupgradethreshold 16
Done

scan [channel]

Perform an IEEE 802.15.4 Active Scan.

channel: The channel to scan on. If no channel is provided, the active scan will cover all valid channels.

> scan
| J | Network Name     | Extended PAN     | PAN  | MAC Address      | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread       | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

scan energy [duration]

Perform an IEEE 802.15.4 Energy Scan.

duration: The time in milliseconds to spend scanning each channel.

> scan energy 10
| Ch | RSSI |
+----+------+
| 11 |  -59 |
| 12 |  -62 |
| 13 |  -67 |
| 14 |  -61 |
| 15 |  -87 |
| 16 |  -86 |
| 17 |  -86 |
| 18 |  -52 |
| 19 |  -58 |
| 20 |  -82 |
| 21 |  -76 |
| 22 |  -82 |
| 23 |  -74 |
| 24 |  -81 |
| 25 |  -88 |
| 26 |  -71 |
Done

singleton

Return true when there are no other nodes in the network, otherwise return false.

> singleton
true or false
Done

sntp query [SNTP server IP] [SNTP server port]

Send SNTP Query to obtain current unix epoch time (from 1st January 1970). The latter two parameters have following default values:

NTP server IP: 2001:4860:4806:8:: (Google IPv6 NTP Server)
NTP server port: 123

> sntp query
> SNTP response - Unix time: 1540894725 (era: 0)

You can use NAT64 of OpenThread Border Router to reach e.g. Google IPv4 NTP Server:

> sntp query 64:ff9b::d8ef:2308
> SNTP response - Unix time: 1540898611 (era: 0)

state

Return state of current state.

> state
offline, disabled, detached, child, router or leader
Done

state

Try to switch to state detached, child, router or leader.

> state leader
Done

thread start

Enable Thread protocol operation and attach to a Thread network.

> thread start
Done

thread stop

Disable Thread protocol operation and detach from a Thread network.

> thread stop
Done

thread version

Get the Thread Version number.

> thread version
2
Done

txpower

Get the transmit power in dBm.

> txpower
-10 dBm
Done

txpower <txpower>

Set the transmit power.

> txpower -10
Done

unsecureport add <port>

Add a port to the allowed unsecured port list.

> unsecureport add 1234
Done

unsecureport remove <port>

Remove a port from the allowed unsecured port list.

> unsecureport remove 1234
Done

unsecureport remove all

Remove all ports from the allowed unsecured port list.

> unsecureport remove all
Done

unsecureport get

Print all ports from the allowed unsecured port list.

> unsecureport get
1234
Done

version

Print the build version information.

> version
OPENTHREAD/gf4f2f04; Jul  1 2016 17:00:09
Done

mac retries direct

Get the number of direct TX retries on the MAC layer.

> mac retries direct
3
Done

mac retries direct <number>

Set the number of direct TX retries on the MAC layer.

> mac retries direct 5
Done

mac retries indirect

Get the number of indirect TX retries on the MAC layer.

> mac retries indirect
3
Done

mac retries indirect <number>

Set the number of indirect TX retries on the MAC layer.

> mac retries indirect 5
Done

macfilter

List the macfilter status, including address and received signal strength filter settings.

> macfilter
Address Mode: Whitelist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss : -50 (lqi 3)
Done

macfilter addr

List the address filter status.

> macfilter addr
Whitelist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done

macfilter addr disable

Disable address filter mode.

> macfilter addr disable
Done

macfilter addr whitelist

Enable whitelist address filter mode.

> macfilter addr whitelist
Done

macfilter addr blacklist

Enable blacklist address filter mode.

> macfilter addr blacklist
Done

macfilter addr add <extaddr> [rss]

Add an IEEE 802.15.4 Extended Address to the address filter, and fixed the received singal strength for the messages from the address if rss is specified.

> macfilter addr add 0f6127e33af6b403 -95
Done

> macfilter addr add 0f6127e33af6b402
Done

macfilter addr remove <extaddr>

Remove the IEEE802.15.4 Extended Address from the address filter.

> macfilter addr remove 0f6127e33af6b402
Done

macfilter addr clear

Clear all the IEEE802.15.4 Extended Addresses from the address filter.

> macfilter addr clear
Done

macfilter rss

List the rss filter status

> macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

macfilter rss add <extaddr> <rss>

Set the received signal strength for the messages from the IEEE802.15.4 Extended Address. If extaddr is *, default received signal strength for all received messages would be set.

> macfilter rss add * -50
Done

> macfilter rss add 0f6127e33af6b404 -85
Done

macfilter rss add-lqi <extaddr> <lqi>

Set the received link quality for the messages from the IEEE802.15.4 Extended Address. Valid lqi range [0,3] If extaddr is *, default received link quality for all received messages would be set. Equivalent with ‘filter rss add’ with similar usage

> macfilter rss add-lqi * 3
Done

> macfilter rss add 0f6127e33af6b404 2
Done

macfilter rss remove <extaddr>

Removes the received signal strength or received link quality setting on the Extended Address. If extaddr is *, default received signal strength or link quality for all received messages would be unset.

> macfilter rss remove *
Done

> macfilter rss remove 0f6127e33af6b404
Done

macfilter rss clear

Clear all the received signal strength or received link quality settings.

> macfilter rss clear
Done

diag

Factory Diagnostics module is enabled only when building OpenThread with OPENTHREAD_CONFIG_DIAG_ENABLE=1 option. Go diagnostics module for more information.

service

Module for controlling service registration in Network Data. Each change in service registration must be sent to leader by netdataregister command before taking effect.

service add <enterpriseNumber> <serviceData> <serverData>

Add service to the Network Data.

> service add 44970 foo bar
Done
> netdataregister
Done
> ipaddr
fdde:ad00:beef:0:0:ff:fe00:fc10
fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:0:ff:fe00:7c00
fe80:0:0:0:1486:2f57:3c:6e10
fdde:ad00:beef:0:8ca4:19ed:217a:eff9
Done

service remove <enterpriseNumber> <serviceData>

Remove service from Network Data.

> service remove 44970 foo
Done
> netdataregister
Done
> ipaddr
fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:0:ff:fe00:7c00
fe80:0:0:0:1486:2f57:3c:6e10
fdde:ad00:beef:0:8ca4:19ed:217a:eff9
Done