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
- ba
- bbr
- br
- bufferinfo
- ccathreshold
- channel
- child
- childip
- childmax
- childsupervision
- childtimeout
- coap
- coaps
- commissioner
- contextreusedelay
- counters
- csl
- dataset
- delaytimermin
- diag
- discover
- dns
- domainname
- dua
- eidcache
- eui64
- extaddr
- extpanid
- factoryreset
- fake
- fem
- ifconfig
- ipaddr
- ipmaddr
- joiner
- joinerport
- keysequence
- leaderdata
- leaderweight
- linkmetrics
- linkquality
- log
- mac
- macfilter
- mliid
- mlr
- mode
- multiradio
- neighbor
- netdata
- netstat
- networkdiagnostic
- networkidtimeout
- networkkey
- networkname
- networktime
- panid
- parent
- parentpriority
- partitionid
- ping
- pollperiod
- preferrouterid
- prefix
- promiscuous
- pskc
- rcp
- region
- releaserouterid
- reset
- rloc16
- route
- router
- routerdowngradethreshold
- routereligible
- routerselectionjitter
- routerupgradethreshold
- scan
- service
- singleton
- sntp
- state
- srp
- thread
- txpower
- udp
- unsecureport
- version
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|coap-code> [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 or COAP code.
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
- 160: COAP code 5.00
> bbr mgmt dua 1 2f7c235e5025a2fd
Done
> bbr mgmt dua 160
Done
bbr mgmt mlr listener
Show the Multicast Listeners.
Only for testing/reference Backbone Router device.
> bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
bbr mgmt mlr listener add <ipaddr> [<timeout>]
Add a Multicast Listener with a given IPv6 multicast address and timeout (in seconds).
Only for testing/reference Backbone Router device.
> bbr mgmt mlr listener add ff04::1
Done
> bbr mgmt mlr listener add ff04::2 300
Done
> bbr mgmt mlr listener
ff04:0:0:0:0:0:0:2 261
ff04:0:0:0:0:0:0:1 3522
Done
bbr mgmt mlr listener clear
Removes all the Multicast Listeners.
Only for testing/reference Backbone Router device.
> bbr mgmt mlr listener clear
Done
> bbr mgmt mlr listener
Done
bbr mgmt mlr response <status>
Configure the response status for the next MLR.req.
Only for testing/reference device.
Known status values:
- 0: ST_MLR_SUCCESS
- 2: ST_MLR_INVALID
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_RESOURCES
- 5: ST_MLR_BBR_NOT_PRIMARY
- 6: ST_MLR_GENERAL_FAILURE
> bbr mgmt mlr response 2
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
ba
Show current Border Agent information.
ba port
Print border agent service port.
> ba port
49152
Done
ba state
Print border agent state.
> ba state
Started
Done
br
Enbale/disable the Border Routing functionality.
> br enable
Done
> br disable
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
coap secure: 0 0
application coap: 0 0
Done
ccathreshold
Get the CCA threshold in dBm measured at antenna connector per IEEE 802.15.4 - 2015 section 10.1.4.
> ccathreshold
-75 dBm
Done
ccathreshold <ccathreshold>
Set the CCA threshold measured at antenna connector per IEEE 802.15.4 - 2015 section 10.1.4.
> ccathreshold -62
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 manager
Get channel manager state.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
is required.
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
channel manager change <channel>
Initiate a channel change with the channel manager.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
is required.
> channel manager change 11
channel manager change 11
Done
channel manager select <skip quality check (boolean)>
Request a channel selection with the channel manager.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager select 1
channel manager select 1
Done
channel manager auto <enable (boolean)>
Enable/disable the auto-channel-selection functionality.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager auto 1
channel manager auto 1
Done
channel manager delay <delay>
Set the channel change delay (in seconds).
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager delay 120
channel manager delay 120
Done
channel manager interval <interval>
Set the auto-channel-selection interval (in seconds).
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager interval 10800
channel manager interval 10800
Done
channel manager supported <mask>
Set the supported channel mask for the auto-channel-selection.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
channel manager favored <mask>
Set the favored channel mask for the auto-channel-selection.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
and OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
are required.
> channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
channel monitor
Get current channel monitor state and channel occupancy.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
is required.
> channel monitor
channel monitor
enabled: 1
interval: 41000
threshold: -75
window: 960
count: 10552
occupancies:
ch 11 (0x0cb7) 4.96% busy
ch 12 (0x2e2b) 18.03% busy
ch 13 (0x2f54) 18.48% busy
ch 14 (0x0fef) 6.22% busy
ch 15 (0x1536) 8.28% busy
ch 16 (0x1746) 9.09% busy
ch 17 (0x0b8b) 4.50% busy
ch 18 (0x60a7) 37.75% busy
ch 19 (0x0810) 3.14% busy
ch 20 (0x0c2a) 4.75% busy
ch 21 (0x08dc) 3.46% busy
ch 22 (0x101d) 6.29% busy
ch 23 (0x0092) 0.22% busy
ch 24 (0x0028) 0.06% busy
ch 25 (0x0063) 0.15% busy
ch 26 (0x058c) 2.16% busy
Done
channel monitor start
Start the channel monitor.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
is required.
> channel monitor start
channel monitor start
Done
channel monitor stop
Stop the channel monitor.
OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
is required.
> channel monitor stop
channel monitor stop
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|D|N|Ver|CSL|QMsgCnt| Extended MAC |
+-----+--------+------------+------------+-------+------+-+-+-+---+---+-------+------------------+
| 1 | 0xc801 | 240 | 24 | 3 | 131 |1|0|0| 3| 0 | 0 | 4ecede68435358ac |
| 2 | 0xc802 | 240 | 2 | 3 | 131 |0|0|0| 3| 1 | 0 | a672a601d2ce37d8 |
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: rn
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
childsupervision interval
Get the Child Supervision Interval value.
Child supervision feature provides a mechanism for parent to ensure that a message is sent to each sleepy child within the supervision interval. If there is no transmission to the child within the supervision interval, OpenThread enqueues and sends a supervision message (a data message with empty payload) to the child. This command can only be used with FTD devices.
> childsupervision interval
30
Done
childsupervision interval <interval>
Set the Child Supervision Interval value. This command can only be used with FTD devices.
> childsupervision interval 30
Done
childsupervision checktimeout
Get the Child Supervision Check Timeout value.
If the device is a sleepy child and it does not hear from its parent within the specified check timeout, it initiates the re-attach process (MLE Child Update Request/Response exchange with its parent).
> childsupervision checktimeout
30
Done
childsupervision checktimeout <timeout>
Set the Child Supervision Check Timeout value.
> childsupervision checktimeout 30
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
ip
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 ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
counters <countername> reset
Reset the counter value.
> counters mac reset
Done
> counters mle reset
Done
> counters ip reset
Done
csl
Get the CSL configuration.
> csl
Channel: 11
Period: 1000 (in units of 10 symbols), 160ms
Timeout: 1000s
Done
csl channel <channel>
Set CSL channel.
> csl channel 20
Done
csl period <period>
Set CSL period in units of 10 symbols. Disable CSL by setting this parameter to 0
.
> csl period 3000
Done
csl timeout <timeout>
Set the CSL timeout in seconds.
> csl timeout 10
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 config
Get the default query config used by DNS client.
The config includes the server IPv6 address and port, response timeout in msec (wait time to rx response), maximum tx attempts before reporting failure, boolean flag to indicate whether the server can resolve the query recursively or not.
> dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
>
dns config [DNS server IP] [DNS server port] [response timeout (ms)] [max tx attempts] [recursion desired (boolean)]
Set the default query config.
> dns config fd00::1 1234 5000 2 0
Done
> dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
We can leave some of the fields as unspecified (or use value zero). The unspecified fields are replaced by the corresponding OT config option definitions OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{}
to form the default query config.
> dns config fd00::2
Done
> dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done
dns resolve <hostname> [DNS server IP] [DNS server port] [response timeout (ms)] [max tx attempts] [recursion desired (boolean)]
Send DNS Query to obtain IPv6 address for given hostname.
The parameters after hostname
are optional. Any unspecified (or zero) value for these optional parameters is replaced by the value from the current default config (dns config
).
> dns resolve ipv6.google.com
> DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns browse <service-name> [DNS server IP] [DNS server port] [response timeout (ms)] [max tx attempts] [recursion desired (boolean)]
Send a browse (service instance enumeration) DNS query to get the list of services for given service-name.
The parameters after service-name
are optional. Any unspecified (or zero) value for these optional parameters is replaced by the value from the current default config (dns config
).
> dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=6531, b=6c12] TTL:7300
instance2
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=1234] TTL:7300
Done
dns service <service-instance-label> <service-name> [DNS server IP] [DNS server port] [response timeout (ms)] [max tx attempts] [recursion desired (boolean)]
Send a service instance resolution DNS query for a given service instance. Service instance label is provided first, followed by the service name (note that service instance label can contain dot '.' character).
The parameters after service-name
are optional. Any unspecified (or zero) value for these optional parameters is replaced by the value from the current default config (dns config
).
dns compression [enable|disable]
Enable/Disable the "DNS name compression" mode.
By default DNS name compression is enabled. When disabled, DNS names are appended as full and never compressed. This is applicable to OpenThread's DNS and SRP client/server modules.
This is intended for testing only and available under REFERENCE_DEVICE
config.
Get the current "DNS name compression" mode.
> dns compression
Enabled
Set the "DNS name compression" mode.
> dns compression disable
Done
>
>
> dns compression
Disabled
Done
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
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d 2000 cache canEvict=1 transTime=0 eid=fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7f fffe retry canEvict=1 timeout=10 retryDelay=30
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
fake
Send fake Thread messages.
Note: Only for certification test.
fake /a/an <dst-ipaddr> <target> <meshLocalIid>
> fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done
fem
Get external FEM parameters.
> fem
LNA gain 11 dBm
Done
fem lnagain
Get the Rx LNA gain in dBm of the external FEM.
> fem lnagain
11
Done
fem lnagain <LNA gain>
Set the Rx LNA gain in dBm of the external FEM.
> fem lnagain 8
Done
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 llatn
Get the Link-Local All Thread Nodes multicast address.
> ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0: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
ipmaddr rlatn
Get the Realm-Local All Thread Nodes multicast address.
> ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
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
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
linkmetrics mgmt <ipaddr> enhanced-ack clear
Send a Link Metrics Management Request to clear an Enhanced-ACK Based Probing.
- ipaddr: Peer address (SHOULD be link local address of the neighboring device).
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
linkmetrics mgmt <ipaddr> enhanced-ack register [qmr][r]
Send a Link Metrics Management Request to register an Enhanced-ACK Based Probing.
- ipaddr: Peer address.
- qmr: This specifies what metrics to query. At most two options are allowed to select (per spec 4.11.3.4.4.6).
- q: Layer 2 LQI.
- m: Link Margin.
- r: RSSI.
- r: This is optional and only used for reference devices. When this option is specified, Type/Average Enum of each Type Id Flags would be set to
reserved
. This is used to verify the Probing Subject correctly handles invalid Type Id Flags. This is only available whenOPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
is enabled.
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
linkmetrics mgmt <ipaddr> forward <seriesid> [ldraX][pqmr]
Send a Link Metrics Management Request to configure a Forward Tracking Series.
- ipaddr: Peer address.
- seriesid: The Series ID.
- ldraX: This specifies which frames are to be accounted.
- l: MLE Link Probe.
- d: MAC Data.
- r: MAC Data Request.
- a: MAC Ack.
- X: This represents none of the above flags, i.e., to stop accounting and remove the series. This can only be used without any other flags.
- pqmr: This specifies what metrics to query.
- p: Layer 2 Number of PDUs received.
- q: Layer 2 LQI.
- m: Link Margin.
- r: RSSI.
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
linkmetrics probe <ipaddr> <seriesid> <length>
Send a MLE Link Probe message to the peer.
- ipaddr: Peer address.
- seriesid: The Series ID for which this Probe message targets at.
- length: The length of the Probe message, valid range: [0, 64].
> linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
linkmetrics query <ipaddr> single [pqmr]
Perform a Link Metrics query (Single Probe).
- ipaddr: Peer address.
- pqmr: This specifies what metrics to query.
- p: Layer 2 Number of PDUs received.
- q: Layer 2 LQI.
- m: Link Margin.
- r: RSSI.
> linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
linkmetrics query <ipaddr> forward <seriesid>
Perform a Link Metrics query (Forward Tracking Series).
- ipaddr: Peer address.
- seriesid: The Series ID.
> linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
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
mliid <iid>
Set the Mesh Local IID.
It must be used before Thread stack is enabled.
Only for testing/reference device.
> mliid 1122334455667788
Done
mlr reg <ipaddr> ... [timeout]
Register Multicast Listeners to Primary Backbone Router, with an optional timeout
(in seconds).
Omit timeout
to use the default MLR timeout on the Primary Backbone Router.
Use timeout = 0
to deregister Multicast Listeners.
NOTE: Only for Thread 1.2 Commissioner FTD device.
> mlr reg ff04::1
status 0, 0 failed
Done
> mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
> mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
> mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done
mode
Get the Thread Device Mode value.
- -: no flags set (rx-off-when-idle, minimal Thread device, stable network data)
- r: rx-on-when-idle
- d: Full Thread Device
- n: Full Network Data
> mode
rdn
Done
mode [rdn]
Set the Thread Device Mode value.
- -: no flags set (rx-off-when-idle, minimal Thread device, stable network data)
- r: rx-on-when-idle
- d: Full Thread Device
- n: Full Network Data
> mode rdn
Done
> mode -
Done
multiradio
Get the list of supported radio links by the device.
This command is always available, even when only a single radio is supported by the device.
> multiradio
[15.4, TREL]
Done
multiradio neighbor list
Get the list of neighbors and their supported radios and their preference.
This command is only available when device supports more than one radio link.
> multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
multiradio neighbor <ext address>
Get the radio info for specific neighbor with a given extended address.
This command is only available when device supports more than one radio link.
> multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
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|D|N| Extended MAC |
+------+--------+-----+----------+-----------+-+-+-+------------------+
| C | 0xcc01 | 96 | -46 | -46 |1|1|1| 1eb9ba8a6522636b |
| R | 0xc800 | 2 | -29 | -29 |1|1|1| 9a91556102c39ddb |
| R | 0xf000 | 3 | -28 | -28 |1|1|1| 0ad7ed6beaa6016d |
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:0]:49152 | [0: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:0]:19788 | [0: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
networkkey
Get the Thread Network Key value.
> networkkey
00112233445566778899aabbccddeeff
Done
networkkey <key>
Set the Thread Network Key value.
> networkkey 00112233445566778899aabbccddeeff
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
partitionid
Get the Thread Network Partition ID.
> partitionid
4294967295
Done
partitionid preferred
Get the preferred Thread Leader Partition ID.
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
is required.
> partitionid preferred
4294967295
Done
partitionid preferred <partitionid>
Set the preferred Thread Leader Partition ID.
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
is required.
> partitionid preferred 0xffffffff
Done
ping [-I source] <ipaddr> [size] [count] [interval] [hoplimit] [timeout]
Send an ICMPv6 Echo Request.
- source: The source IPv6 address of the 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.
- timeout: Time in seconds to wait for the final ICMPv6 Echo Reply after sending out the request. The value may have fractional form, for example
3.5
.
> ping fd00:db8:0:0:76b:6a05:3ae9:a61a
> 16 bytes from fd00:db8:0:0:76b:6a05:3ae9:a61a: icmp_seq=5 hlim=64 time=0ms
1 packets transmitted, 1 packets received. Packet loss = 0.0%. Round-trip min/avg/max = 0/0.0/0 ms.
Done
> ping -I fd00:db8:0:0:76b:6a05:3ae9:a61a ff02::1 100 1 1 1
> 108 bytes from fd00:db8:0:0:f605:fb4b:d429:d59a: icmp_seq=4 hlim=64 time=7ms
1 packets transmitted, 1 packets received. Round-trip min/avg/max = 7/7.0/7 ms.
Done
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 meshlocal
Get the mesh local prefix.
> prefix meshlocal
fdde:ad00:beef:0::/64
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.
region
Set the radio region, this can affect the transmit power limit.
> region US
Done
> region
US
Done
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 | Link |
+----+--------+----------+-----------+-------+--------+-----+------------------+------+
| 22 | 0x5800 | 63 | 0 | 0 | 0 | 0 | 0aeb8196c9f61658 | 0 |
| 49 | 0xc400 | 63 | 0 | 3 | 3 | 0 | faa1c03908e2dbf2 | 1 |
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] [channel]
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
> scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 | -82 |
Done
service
Module for controlling service registration in Network Data. Each change in service registration must be sent to leader by netdata register
command before taking effect.
service add <enterpriseNumber> <serviceData> <serverData>
Add service to the Network Data.
- enterpriseNumber: IANA enterprise number
- serviceData: hex-encoded binary service data
- serverData: hex-encoded binary server data
> service add 44970 112233 aabbcc
Done
> netdata register
Done
service remove <enterpriseNumber> <serviceData>
Remove service from Network Data.
- enterpriseNumber: IANA enterprise number
- serviceData: hext-encoded binary service data
> service remove 44970 112233
Done
> netdata register
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 in dBm.
> 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
version api
Print API version number.
> version api
28
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
mac send <op>
Instruct an Rx-Off-When-Idle device to send a mac frame to its parent. The mac frame could be either a mac data request or an empty mac data frame. Use datarequest
to send a mac data request and data
to send an empty mac data. This feature is for certification, it can only be used when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
is enabled.
> mac send datarequest
Done
> mac send emptydata
Done
macfilter
List the macfilter status, including address and received signal strength filter settings.
> macfilter
Address Mode: Allowlist
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
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done
macfilter addr disable
Disable address filter mode.
> macfilter addr disable
Done
macfilter addr allowlist
Enable allowlist address filter mode.
> macfilter addr allowlist
Done
macfilter addr denylist
Enable denylist address filter mode.
> macfilter addr denylist
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.