ba 暫時金鑰
指出臨時金鑰是否已啟用。
需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
。
參數
沒有參數。
示例
ba ephemeralkey
active
Done
CLI 和 API 參考資料
ba 暫時金鑰回呼 (啟用、停用)
設定 Border 代理程式使用的回呼函式,以通知任何與臨時金鑰使用相關的變更。
需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
。
對這個函式的後續呼叫將取代先前設定的任何回呼。
參數
沒有參數。
示例
ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive
CLI 和 API 參考資料
ba 暫時金鑰清除
取消使用中的臨時金鑰。
需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
。
可用於在逾時前取消先前設定的臨時金鑰。如果邊界代理程式未執行,或是沒有使用中的臨時金鑰,則呼叫此函式不會有任何作用。
如果委託方使用臨時金鑰連線,且目前處於有效狀態,則呼叫這個函式不會變更其狀態。在此情況下,
otBorderAgentIsEphemeralKeyActive()
將繼續傳回 TRUE
,直到佣金員中斷連線為止。
參數
沒有參數。
示例
ba ephemeralkey clear
Done
CLI 和 API 參考資料
ba 暫時金鑰集 [timeout-in-msec] [通訊埠]
設定指定逾時時間長度的暫時金鑰。
需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
。
當邊界代理程式已在執行中,且目前未連線至任何外部委託員 (即處於 OT_BORDER_AGENT_STATE_STARTED
狀態) 時,即可設定臨時金鑰。否則系統會傳回 OT_ERROR_INVALID_STATE
。
指定的 aKeyString
直接做為臨時 PSK (不包括結尾的空值 \0
字元)。aKeyString
的長度必須介於 OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH
和 OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH
之間 (含頭尾)。
如果在先前設定的金鑰逾時前再次設定臨時金鑰,將取代先前設定的金鑰並重設逾時。
雖然逾時間隔已生效,但臨時金鑰只能由外部調試者使用一次。一旦中斷連線,系統就會清除臨時金鑰,並將 Border Agent 還原為使用 PSKc。
參數
沒有參數。
示例
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
CLI 和 API 參考資料
ba ID (get,set)
取得或設定 16 個位元組的邊界路由器 ID,可在多個 BR 中識別裝置。
參數
ba id [border-agent-id]
使用選用的 border-agent-id
引數設定邊界服務專員 ID。
示例
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done
CLI 和 API 參考資料
Ba 通訊埠
取得執行緒邊界代理程式服務的 UDP 通訊埠。
參數
沒有參數。
示例
ba port
49153
Done
CLI 和 API 參考資料
Ba 狀態
取得執行緒邊界代理程式角色的 otBorderAgentState。
參數
沒有參數。
示例
ba state
Started
Done
CLI 和 API 參考資料
Bbr
傳回 Thread 裝置目前的主要骨幹路由器資訊。
參數
沒有參數。
示例
bbr
BBR Primary:
server16: 0xE400
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
bbr
BBR Primary: None
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
bbr 設定 (已設定)
設定本機 Backbone Router 設定 otBackboneRouterConfig。
如果主要骨幹路由器的 BBR 資料集變更,系統會自動啟動伺服器資料要求訊息 SRV_DATA.ntf
。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
應明確核發 bbr register
,以註冊次要骨幹路由器的 Backbone 路由器服務。
參數
bbr config [seqno seqno] [delay delay] [timeout timeout]
示例
bbr config seqno 20 delay 30
Done
CLI 和 API 參考資料
bbr 設定
取得本機 Backbone 路由器設定。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
CLI 和 API 參考資料
bbr 停用
啟用或停用 Backbone 功能。
啟用後,如果 Thread 網路資料中沒有反向路由器服務,連接的裝置就會觸發伺服器資料要求訊息 SRV_DATA.ntf
。
如果停用,如果 Backbone 路由器處於主要狀態,就會觸發 SRV_DATA.ntf
。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr disable
Done
CLI 和 API 參考資料
bbr 啟用
啟用或停用 Backbone 功能。
啟用後,如果 Thread 網路資料中沒有反向路由器服務,連接的裝置就會觸發伺服器資料要求訊息 SRV_DATA.ntf
。
如果停用,如果 Backbone 路由器處於主要狀態,就會觸發 SRV_DATA.ntf
。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr enable
Done
CLI 和 API 參考資料
bbr 時基誤差 (get,set)
取得或設定 Backbone 路由器註冊時的時基誤差 (以秒為單位)。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
bbr jitter [jitter]
示例
bbr jitter
20
Done
bbr jitter 10
Done
CLI 和 API 參考資料
bbr mgmt dua
加入 meshLocalIid
後,這個指令會設定下一個 DUA 註冊的回應狀態。不使用 meshLocalIid
時,請以指定的 status
或 coap-code
回應下一個 DUA.req。
啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
bbr mgmt dua status|coap-code [meshLocalIid]
如果是 status
或 coap-code
,請使用:
- 0:ST_DUA_SUCCESS
- 1:ST_DUA_REGISTER
- 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 代碼 5.00
示例
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
CLI 和 API 參考資料
bbr mgmt mlr 事件監聽器新增
新增設有逾時值的多點傳播事件監聽器 (以秒為單位)。
傳遞 0
即可使用預設的 MLR 逾時。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後即可使用。
參數
bbr mgmt mlr listener add ipaddress [timeout-seconds]
示例
bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done
CLI 和 API 參考資料
bbr mgmt mlr 事件監聽器
傳回使用 otBackboneRouterMulticastListenerInfomTimeout
(以秒為單位) 的多點傳播事件監聽器。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
和 OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
CLI 和 API 參考資料
bbr mgmt mlr 事件監聽器
清除多點傳播事件監聽器。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後即可使用。
參數
沒有參數。
示例
bbr mgmt mlr listener clear
Done
CLI 和 API 參考資料
bbr mgmt mlr 回應
設定下一個多點傳播事件監聽器註冊的回應狀態。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後即可使用。
參數
bbr mgmt mlr response status-code
如果是 status-code
,請使用:
- 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
CLI 和 API 參考資料
bbr 註冊
明確註冊本機 Backbone 路由器設定。
連接的裝置觸發伺服器資料要求訊息 SRV_DATA.ntf
。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr register
Done
CLI 和 API 參考資料
Bbr 狀態
取得 Backbone 路由器 otBackboneRouterState。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
示例
bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done
CLI 和 API 參考資料
br 停用
停用邊界路由管理員。
參數
沒有參數。
示例
br disable
Done
CLI 和 API 參考資料
br 啟用
啟用邊界路由管理員。
參數
沒有參數。
示例
br enable
Done
CLI 和 API 參考資料
Br init
初始化邊界路由管理員。
參數
br init infrastructure-network-index is-running
示例
br init 2 1
Done
CLI 和 API 參考資料
br nat64prefix
同時輸出本機和常用的 NAT64 前置字串。
參數
沒有參數。
示例
br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
CLI 和 API 參考資料
br nat64 前置字元偏好
取得目前偏好的 NAT64 前置字串。
您可以從基礎架構連結找到偏好的 NAT64 前置字串,或是這部裝置的本機 NAT64 前置字串。
參數
沒有參數。
示例
br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
CLI 和 API 參考資料
br nat64prefix 本地
取得邊界路由器的本機 NAT64 前置字串。
NAT64 前置字元可能無法在 Thread 網路中通告。
必須啟用 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
。
參數
沒有參數。
示例
br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done
CLI 和 API 參考資料
br omrprefix
同時輸出本機和偏好的 OMR 前置字串。
參數
沒有參數。
示例
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done
CLI 和 API 參考資料
br omrprefix 偏好
取得目前偏好使用的「異域傳遞 (OMR)」前置字串。
您可以從「網路資料」找到偏好的 OMR 前置字串,或是這部裝置的本機 OMR 前置碼。
參數
沒有參數。
示例
br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done
CLI 和 API 參考資料
br omrprefix 本機
取得本機的離線路由 (OMR) 前置字串,例如 fdfc:1ff5:1512:5622::/64
。
OMR 前置字串是隨機產生的 64 位元前置字串,如果沒有 OMR 前置字串,則會發布到 Thread 網路。您可透過本機 Wi-Fi 或乙太網路連線至這個前置字串。
參數
沒有參數。
示例
br omrprefix local
fdfc:1ff5:1512:5622::/64
Done
CLI 和 API 參考資料
br onlinkprefix
同時輸出本機和偏好連結的 on-link 前置字串。
參數
沒有參數。
示例
br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done
CLI 和 API 參考資料
br onlinkprefix 偏好
取得目前建議使用的「連結前置字串」。
常用的前置字串是基礎架構連結上發現的「連結」前置字串或本機「連結」前置字串。
參數
沒有參數。
示例
br onlinkprefix favored
2600::0:1234:da12::/64
Done
CLI 和 API 參考資料
br onlinkprefix 本地
取得相鄰基礎架構連結的本機 On-Link 前置字串。
「本機連結前置字元」是指一個 64 位元的前置字串,如果連結中還沒有要宣傳的使用中連結前置字元,可以在基礎架構連結上宣傳。
參數
沒有參數。
示例
br onlinkprefix local
fd41:2650:a6f5:0::/64
Done
CLI 和 API 參考資料
br 前置字元資料表
透過基礎架構連結取得邊界轉送管理員找到的前置字串。每個前置字串項目的資訊:
- 前置字串
- 前置字串為 on-link 或 route
- 上次收到路由器公告後經過的毫秒數,內含這個前置字串
- 前置字串生命週期 (以秒為單位)
- 偏好的生命週期 (以秒為單位),只有前置字元在連結時
- 路線偏好設定 (低、中、高) 僅用於路線為路徑 (而非在連結上)
- 通告這個前置字串的路由器 IPv6 位址
- 接收路由器公告標頭中的旗標:
- M:代管位址設定旗標
- O:其他設定旗標
- 虛設常式:虛設常式路由器旗標 (指出路由器是否為虛設常式路由器)
參數
沒有參數。
示例
br prefixtable
prefix:fd00:1234:5678:0::/64, on-link:no, ms-since-rx:29526, lifetime:1800, route-prf:med,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
prefix:1200:abba:baba:0::/64, on-link:yes, ms-since-rx:29527, lifetime:1800, preferred:1800,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
CLI 和 API 參考資料
br raoptions (集合,清除)
設定要在傳出路由器通告 (RA) 訊息結尾處附加的其他選項。
aOptions
的內容會在內部複製,因此可以是暫存緩衝區 (例如堆疊分配的陣列)。
日後對這個函式的呼叫會覆寫先前設定的值。
參數
br raoptions options|clear
br raoptions clear
會將 nullptr
傳遞至 otBorderRoutingSetExtraRouterAdvertOptions。否則,您可以將 options
位元組以十六進位資料的形式傳遞。
示例
br raoptions 0400ff00020001
Done
br raoptions clear
Done
CLI 和 API 參考資料
br PRprf (高,中,低)
在透過基礎架構連結傳送的路由器通告訊息中,明確設定用於廣告路徑資訊選項 (RIO) 時的偏好設定。
呼叫這個函式後,BR 會將指定的偏好設定用於所有通告的 RIO。呼叫
otBorderRoutingClearRouteInfoOptionPreference()
可清除偏好設定。
參數
br rioprf [high|med|low]
示例
br rioprf low
Done
CLI 和 API 參考資料
B Leprf
在透過基礎架構連結傳送的路由器通告訊息中,取得通告路徑資訊選項 (RIO) 目前的偏好設定。
RIO 偏好設定如下:
- 如果使用者藉由呼叫
otBorderRoutingSetRouteInfoOptionPreference()
明確設定,則會使用指定的偏好設定。 - 否則,裝置將根據裝置目前角色:路由器/主要角色中優先順序為中等,而在子項角色期間為低優先順序。
參數
沒有參數。
示例
br rioprf
med
Done
CLI 和 API 參考資料
Br Rioprf Clear
清除先前在通告路線資訊選項中設定的偏好設定值。
呼叫這個函式後,BR 將根據裝置角色來判斷 RIO 偏好設定:路由器/主要角色中為中度優先,而子項角色時則為低偏好設定。
參數
沒有參數。
示例
br rioprf clear
Done
CLI 和 API 參考資料
br routeprf (高、中、低)
在「網路資料」中明確設定已發布路徑的偏好設定。
呼叫這個函式後,BR 會使用指定的偏好設定。呼叫
otBorderRoutingClearRoutePreference()
可清除偏好設定。
參數
br routeprf [high|med|low]
示例
br routeprf low
Done
CLI 和 API 參考資料
Br routeprf
取得目前在網路資料中已發布路徑使用的偏好設定。
偏好設定的判斷依據如下:
- 如果使用者藉由呼叫
otBorderRoutingSetRoutePreference()
明確設定,則會使用指定的偏好設定。 - 否則,它會由
RoutingManager
根據裝置的角色和連結品質自動判斷。
參數
沒有參數。
示例
br routeprf
med
Done
CLI 和 API 參考資料
Br routeprf
清除先前在網路資料中已發布路徑的偏好設定值。
呼叫此函式後,BR 將根據裝置的角色和連結品質 (做為裝置用途時,導向父項) 自動判斷偏好設定。
參數
沒有參數。
示例
br routeprf clear
Done
CLI 和 API 參考資料
br 路由器
在基礎架構連結上取得由邊界路由管理員發現的路由器清單。每個路由器的資訊:
- 路由器 IPv6 位址
- 接收路由器公告標頭中的旗標:
- M:代管位址設定旗標
- O:其他設定旗標
- 虛設常式:虛設常式路由器旗標 (指出路由器是否為虛設常式路由器)
參數
沒有參數。
示例
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
CLI 和 API 參考資料
巴西狀態
取得邊界轉送管理員的目前狀態。
參數
沒有參數。
示例
br state
running
CLI 和 API 參考資料
bufferinfo
取得目前的訊息緩衝區資訊。
total
會顯示集區中的訊息緩衝區總數。free
會顯示免費訊息緩衝區的數量。max-used
會顯示自 OT 堆疊初始化或上次bufferinfo reset
以來,已使用的緩衝區數量上限。
接下來,CLI 會顯示 OpenThread 堆疊所使用的不同佇列相關資訊,例如 6lo send
。佇列後的每一行都代表佇列相關資訊:
- 第一個數字顯示佇列中的訊息數,
- 第二個數字則代表佇列中所有訊息使用的緩衝區數量。
- 第三點代表佇列中所有訊息的位元組總數,
參數
沒有參數。
示例
bufferinfo
total: 40
free: 40
max-used: 5
6lo send: 0 0 0
6lo reas: 0 0 0
ip6: 0 0 0
mpl: 0 0 0
mle: 0 0 0
coap: 0 0 0
coap secure: 0 0 0
application coap: 0 0 0
Done
CLI 和 API 參考資料
已重設 bufferinfo
重設訊息緩衝區資訊計數器,追蹤同時間使用的緩衝區數量上限。
這麼做會重設
otBufferInfo
中的 mMaxUsedBuffers
。
參數
沒有參數。
示例
bufferinfo reset
Done
CLI 和 API 參考資料
ccathreshold (get、set)
根據 IEEE 802.15.4 - 2015 第 10.1.4 節的規定,取得或設定 dBm 中 dBm 的 CCA 門檻。
參數
ccathreshold [CCA-threshold-dBm]
使用選用的 CCA-threshold-dBm
引數來設定 CCA 門檻。
示例
ccathreshold
-75 dBm
Done
ccathreshold -62
Done
CLI 和 API 參考資料
channel (get,set)
取得或設定 IEEE 802.15.4 頻道值。
參數
channel [channel-num]
使用 channel-num
設定頻道。
示例
channel
11
Done
channel 11
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
頻道管理員自動管理
啟用或停用聯播網頻道的自動頻道選取功能。
啟用後,ChannelManager
會定期叫用 RequestChannelSelect(false)
。
otChannelManagerSetAutoChannelSelectionInterval()
可以設定週期間隔。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager auto enable
1
是 enable
的布林值。
示例
channel manager auto 1
channel manager auto 1
Done
CLI 和 API 參考資料
頻道管理員變更
要求變更 Thread 網路通道。
聯播網會在指定延遲後,切換到指定頻道 (請參閱 otChannelManagerSetDelay())。管道變更會透過更新待處理作業資料集進行。
如後續呼叫,系統就會取消先前要求的進行頻道變更。
「OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
」為必填欄位。
參數
channel manager change channel-num
示例
channel manager change 11
channel manager change 11
Done
CLI 和 API 參考資料
頻道管理員
取得頻道管理員狀態。「OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
」或「OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
」為必填欄位。
參數
沒有參數。
示例
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
CLI 和 API 參考資料
頻道管理員延遲
設定網路頻道變更所使用的延遲時間 (以秒為單位)。
僅適用於 FTD。延遲時間最好比 Thread 網路中所有睡眠最終裝置使用的資料輪詢間隔時間還要長。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager delay delay-seconds
示例
channel manager delay 120
channel manager delay 120
Done
CLI 和 API 參考資料
頻道管理員已收藏
設定偏好的頻道遮罩。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager favored mask
示例
channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
CLI 和 API 參考資料
管道管理員間隔
設定自動頻道選取功能使用的週期間隔 (以秒為單位)。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager interval interval-seconds
示例
channel manager interval 10800
channel manager interval 10800
Done
CLI 和 API 參考資料
選取管道管理員
ChannelManager
會檢查並選取新頻道並發起頻道變更的要求。
不同於必須提供頻道做為參數的
otChannelManagerRequestChannelChange()
,這個函式會要求 ChannelManager
自行選取管道 (根據收集到的頻道品質資訊)。
呼叫後,頻道管理員將執行下列 3 個步驟:
1) ChannelManager
可判斷變更頻道是否有幫助。如果將 aSkipQualityCheck
設為 true,就可以略過這項檢查 (強制選取頻道並略過品質檢查)。這個步驟會使用裝置上收集的連結品質指標 (例如 CCA 失敗率、每個鄰點的影格和訊息錯誤率等),判斷目前的頻道品質是否達到頻道變更的合理等級。
2) 如果第一個步驟通過,則 ChannelManager
會選取成效更佳的管道。這個資訊主頁使用由 ChannelMonitor
模組收集到的頻道品質資料。這個步驟將使用支援和常用管道。(請參閱
otChannelManagerSetSupportedChannels()
和
otChannelManagerSetFavoredChannels()
)。
3) 如果新選取的頻道與目前的管道不同,ChannelManager
會要求/啟動頻道變更程序 (在內部叫用 RequestChannelChange()
)。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager select skip-quality-check
針對布林值 skip-quality-check
,請使用 1
或 0
。
示例
channel manager select 1
channel manager select 1
Done
CLI 和 API 參考資料
支援管道管理員
設定支援的管道遮罩。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager supported mask
示例
channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
CLI 和 API 參考資料
頻道管理員門檻
設定 CCA 失敗率門檻。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
為必要項目。
參數
channel manager threshold threshold-percent
使用 threshold-percent
的十六進位值。0
和 0xffff
分別對應到 0% 和 100%。
示例
channel manager threshold 0xffff
channel manager threshold 0xffff
Done
CLI 和 API 參考資料
頻道監控器
取得目前的通道監控狀態和通道使用狀況。「OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
」為必填欄位。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
- 沒有相關聯的 API
頻道監控器開始
啟動頻道監控器。OT CLI 將布林值 true
傳送至 otChannelMonitorSetEnabled。「OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
」為必填欄位。
參數
沒有參數。
示例
channel monitor start
channel monitor start
Done
CLI 和 API 參考資料
頻道監控停止
停止頻道監控器。OT CLI 將布林值 false
傳送至 otChannelMonitorSetEnabled。「OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
」為必填欄位。
參數
沒有參數。
示例
channel monitor stop
channel monitor stop
Done
CLI 和 API 參考資料
頻道偏好
取得裝置偏好使用的電台偏好頻道遮罩。
參數
沒有參數。
示例
channel preferred
0x7fff800
Done
CLI 和 API 參考資料
支援的頻道
取得可於裝置啟用的無線電支援頻道遮罩。
參數
沒有參數。
示例
channel supported
0x7fff800
Done
CLI 和 API 參考資料
子項 (id)
透過其子項 ID 或 RLOC16 取得附加子項的診斷資訊。
參數
child child-id
示例
child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rn
CSL Synchronized: 1
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done
CLI 和 API 參考資料
子清單
傳回附加的子 ID 清單。
參數
沒有參數。
示例
child list
1 2 3 6 7 8
Done
CLI 和 API 參考資料
子項資料表
列印附加子項的表格。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
Childip
取得為 MTD 子項儲存的 IP 位址清單。
參數
沒有參數。
示例
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done
CLI 和 API 參考資料
Childip max (設定)
設定或還原每個 MTD 子項可註冊為父項的 IP 位址數量上限。
傳遞 0
,即可清除設定並還原預設值。
啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
childip max count
示例
childip max 2
Done
CLI 和 API 參考資料
Childip max
取得每個 MTD 孩子可在此裝置註冊為父項的 IP 位址數量上限。
參數
沒有參數。
示例
childip max
4
Done
CLI 和 API 參考資料
submax (設定)
設定目前允許的兒童數量上限。
只能在 Thread 通訊協定作業停止時設定這個參數。
參數
childmax count
示例
childmax 2
Done
CLI 和 API 參考資料
Childmax
取得目前允許的兒童數量上限。
參數
沒有參數。
示例
childmax
5
Done
CLI 和 API 參考資料
subrouterlinks (get,set)
取得或設定 MLE_CHILD_ROUTER_LINKS 值。
參數
childrouterlinks [links]
示例
childrouterlinks
16
Done
childrouterlinks 16
Done
CLI 和 API 參考資料
兒童監督檢查逾時 (設定)
為子設定監督檢查逾時間隔 (以秒為單位)。
參數
childsupervision checktimeout timeout-seconds
示例
childsupervision checktimeout 30
Done
CLI 和 API 參考資料
兒童監督檢查逾時
取得子女的監督檢查逾時間隔 (以秒為單位)。
如果裝置是休眠的孩子,且裝置未在指定的檢查逾時期限內收到父項的回覆,就會啟動重新附加程序 (MLE 子項更新要求/回應與父項交換)。
參數
沒有參數。
示例
childsupervision checktimeout
30
Done
CLI 和 API 參考資料
子監控間隔 (設定)
為孩子設定孩子的監督間隔時間 (以秒為單位)。
參數
childsupervision interval interval-seconds
示例
childsupervision interval 30
Done
CLI 和 API 參考資料
子監控間隔
取得子項的子監督間隔時間 (以秒為單位)。
子監督功能可為家長提供機制,確保訊息傳送給在監督期間內每位有睡眠的孩子。如果未在監督期間內傳輸給兒童的傳輸內容,OpenThread 會排入佇列,並傳送孩童監督訊息給孩子。
參數
沒有參數。
示例
childsupervision interval
30
Done
CLI 和 API 參考資料
子項逾時 (設定)
設定在子項角色中作業時使用的執行緒子項逾時時間 (以秒為單位)。
參數
childtimeout timeout-seconds
示例
childtimeout 300
Done
CLI 和 API 參考資料
子項逾時
取得在子項角色中作業時使用的執行緒子項逾時時間 (以秒為單位)。
參數
沒有參數。
示例
childtimeout
300
Done
CLI 和 API 參考資料
取消
取消 CoAP 伺服器上遠端資源現有的觀察訂閱項目。
參數
沒有參數。
示例
coap cancel
Done
CLI 和 API 參考資料
Coap 刪除
刪除指定的 CoAP 資源。
參數
coap delete address uri-path [type] [payload]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)
payload
:CoAP 酬載字串。例如:hellothere
。
示例
coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
CANNOT TRANSLATE
取得 CoAP 伺服器上指定 CoAP 資源的相關資訊。
參數
coap get address uri-path [type]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:如果應該以區塊方式轉移回應,請使用這個選項,後面加上區塊相關值。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
示例
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
警察觀察
觸發訂閱要求,讓 CoAP 用戶端觀察 CoAP 伺服器上的指定資源,瞭解其狀態可能的變化。
參數
coap observe address uri-path [type]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)。
示例
coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
coap parameters(get,set)
在沒有選用參數的情況下執行指令,則會取得目前的 CoAP 參數值。
根據所選語法,將 CoAP 參數設為預設值或您指定的值。
參數
coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
type
:request
適用於 CoAP 要求,或response
代表 CoAP 回應。如果未提供其他參數,指令會列印目前設定。default
:將傳輸參數設為下列預設值:ack_timeout
:2000 毫秒ack_random_factor_numerator
:3ack_random_factor_denominator
: 2max_retransmit
:4
ack_timeout
:以毫秒為單位的ACK_TIMEOUT
(0-UINT32_MAX)。請參閱 RFC7252。ack_random_factor_numerator
:ACK_RANDOM_FACTOR
分子,可能的值為 0 至 255。請參閱 RFC7252。ack_random_factor_denominator
:ACK_RANDOM_FACTOR
分母,可能的值為 0 至 255。請參閱 RFC7252。max_retransmit
:MAX_RETRANSMIT
(0-255)。請參閱 RFC7252。
示例
coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
警探貼文
建立指定的 CoAP 資源。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定 (CoAP) 資源測試連線」。
參數
coap post address uri-path [type] [payload]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:使用此選項,後面加上區塊相關值,以便透過酬載中隨機產生的位元組數來傳送區塊。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAP 酬載要求,使用時可以是字串或整數,視type
而定。如果type
為con
或non-con
,則payload
參數為選用參數。如果您省略payload
參數,系統會傳送空白的酬載。不過,如果您使用payload
參數,該參數的值必須是字串,例如hellothere
。如果type
是block-
,payload
參數的值必須是整數,用來指定要傳送的區塊數量。block-
類型必須設定OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
。
示例
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
CANNOT TRANSLATE
修改指定的 CoAP 資源。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定 (CoAP) 資源測試連線」。
參數
coap put address uri-path [type] [payload]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:使用此選項,後面加上區塊相關值,以便透過酬載中隨機產生的位元組數來傳送區塊。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAP 酬載要求,使用時可以是字串或整數,視type
而定。如果type
為con
或non-con
,則payload
參數為選用參數。如果您省略payload
參數,系統會傳送空白的酬載。不過,如果您使用payload
參數,該參數的值必須是字串,例如hellothere
。如果type
是block-
,payload
參數的值必須是整數,用來指定要傳送的區塊數量。block-
類型必須設定OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
。
示例
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
Coap 資源 (取得、設定)
取得或設定 CoAP 伺服器資源的 URI 路徑。
參數
coap resource [uri-path]
示例
coap resource test-resource
Done
coap resource
test-resource
Done
CLI 和 API 參考資料
警察集合
設定 CoAP 伺服器上資源傳送的內容。如果 CoAP 用戶端正在觀察資源,系統會傳送通知給該用戶端。
參數
coap set new-content
示例
coap set Testing123
Done
CLI 和 API 參考資料
警察開始
啟動 CoAP 伺服器。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定 (CoAP) 資源測試連線」。
參數
沒有參數。
示例
coap start
Done
CLI 和 API 參考資料
CANNOT TRANSLATE
停止 CoAP 伺服器。
參數
沒有參數。
示例
coap stop
Done
CLI 和 API 參考資料
Coaps Connect
以對等點初始化 Datagram 傳輸層安全標準 (DTLS) 工作階段。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
coaps connect address
address
參數是對等點的 IPv6 位址。
示例
coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected
CLI 和 API 參考資料
Coaps 刪除
要刪除的 CoAPS 酬載字串。
參數
coaps delete uri-path [type] [payload]
uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)
payload
:CoAPS 酬載要求。
示例
coaps delete test-resource con hellothere
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
警察中斷連線
停止 DTLS 工作階段。
參數
沒有參數。
示例
coaps disconnect
coaps disconnected
Done
CLI 和 API 參考資料
coaps 拿走
取得 CoAPS 伺服器上指定 CoAPS 資源的相關資訊。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
coaps get uri-path [type]
uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:如果應該以區塊方式轉移回應,請使用這個選項,後面加上區塊相關值。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
示例
coaps get test-resource
Done
coaps get test-resource block-1024
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
眼鏡封閉
指出 CoAP Secure 服務是否已關閉。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
沒有參數。
示例
coaps isclosed
no
Done
CLI 和 API 參考資料
Coaps 尚可
指出 CoAP Secure 服務連線是否已啟用 (已連線或正在建立連線)。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
沒有參數。
示例
coaps isconnactive
yes
Done
CLI 和 API 參考資料
Coaps 已連線
指出是否已連結 CoAP Secure 服務。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
沒有參數。
示例
coaps isconnected
yes
Done
CLI 和 API 參考資料
警察貼文
建立指定的 CoAPS 資源。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
uri-path [type] [payload]
uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:使用此選項,後面加上區塊相關值,以便透過酬載中隨機產生的位元組數來傳送區塊。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAPS 酬載要求,使用時可以是字串或整數,視type
而定。如果type
為con
或non-con
,則酬載參數為選用。如果您省略酬載參數,系統會傳送空白的酬載。不過,如果您使用酬載參數,該參數的值必須是字串,例如hellothere
。如果type
是block-
,酬載參數的值必須是整數,用來指定要傳送的區塊數量。block-
類型必須設定OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
。
示例
coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
Coaps psk
設定預先共用金鑰 (PSK) 和加密套件 DTLS_PSK_WITH_AES_128_CCM_8。
參數
coaps psk psk-value psk-id
psk-value
:預先共用金鑰psk-id
:預先共用金鑰 ID。
示例
coaps psk 1234 key1
Done
CLI 和 API 參考資料
CANNOT TRANSLATE
修改指定的 CoAPS 資源。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
uri-path [type] [payload]
uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:不可確認 (預設)block-
:使用此選項,後面加上區塊相關值,以便透過酬載中隨機產生的位元組數來傳送區塊。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAPS 酬載要求,使用時可以是字串或整數,視type
而定。如果type
為con
或non-con
,則酬載參數為選用。如果您省略酬載參數,系統會傳送空白的酬載。不過,如果您使用酬載參數,該參數的值必須是字串,例如hellothere
。如果type
是block-
,酬載參數的值必須是整數,用來指定要傳送的區塊數量。block-
類型必須設定OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
。
示例
coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
目標資源 (get、set)
取得或設定 CoAPS 伺服器資源的 URI 路徑。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
coaps resource [uri-path]
示例
coaps resource test-resource
Done
coaps resource
test-resource
Done
CLI 和 API 參考資料
兄弟姊妹
設定 CoAPS 伺服器上的資源傳送的內容。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
coaps set new-content
示例
coaps set Testing123
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
警察開始
啟動 CoAP Secure 服務。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
coaps start [check-peer-cert | max-conn-attempts]
check-peer-cert
參數可決定要啟用 (預設) 或停用對等憑證檢查。max-conn-attempts
參數會設定連線至 CoAP Secure 伺服器的嘗試次數上限,無論成功或失敗。這個參數的預設值為 0
,表示沒有嘗試次數限制。雖然您只能指定一個引數,但 check-peer-cert
和 max-conn-attempts
參數會在下列組合中搭配運作:
- 未指定引數:使用預設值。
- 將
check-peer-cert
設為true
:效果與省略引數相同 (也就是check-peer-cert
值為true
,max-conn-attempts
值為 0)。 - 將
check-peer-cert
設為false
:check-peer-cert
值為false
,max-conn-attempts
值為 0。 - 指定數字:
check-peer-cert
為true
,而max-conn-attempts
值是引數中指定的數字。
示例
coaps start
Done
coaps start false
Done
coaps start 8
Done
CLI 和 API 參考資料
暫停點。
停止 CoAP Secure 服務。詳情請參閱「使用 OT CLI 對受限應用程式通訊協定安全 (CoAPS) 資源測試連線」。
參數
沒有參數。
示例
coaps stop
Done
CLI 和 API 參考資料
Coaps x509
使用 DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
設定本機裝置的 X509 憑證,以及 DTLS 工作階段的對應私密金鑰。
參數
沒有參數。
示例
coaps x509
Done
CLI 和 API 參考資料
委員通知
傳送「朗讀開始」訊息。
參數
commissioner announce mask count period destination
mask
:用來識別傳送 MLEAnnounce
訊息管道的位元遮罩。count
:每個通道的 MLEAnnounce
傳輸次數。period
:MLEAnnounce
連續傳輸之間的毫秒數。destination
:訊息的目標 IPv6 位址。這則訊息可能是多點傳播。
示例
commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done
CLI 和 API 參考資料
委員能源
傳送能源掃描查詢訊息。指令輸出內容會依收到的內容顯示。
參數
commissioner energy mask count period scanDuration destination
mask
:用於識別執行 IEEE 802.15.4 能源掃描管道的位元遮罩。count
:每個通道的 IEEE 802.15.4 能源掃描次數。period
:IEEE 802.15.4 連續掃描之間的毫秒數。scanDuration
:掃描 IEEE 802.15.4 能量掃描時長 (以毫秒為單位)。destination
:訊息的目標 IPv6 位址。這則訊息可能是多點傳播。
示例
commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0
CLI 和 API 參考資料
佣金者 ID (get,set)
取得或設定 OpenThread 佣金 ID 名稱。
參數
commissioner id name
示例
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
CLI 和 API 參考資料
補充佣金工具
新增彙整器項目。
參數
commissioner joiner add eui64|discerner pksd [timeout]
eui64
:加入器的 IEEE EUI-64如要比對任何彙整器,請使用*
。discerner
:彙整工具,格式為number/length
。pksd
:彙整器的預先共用金鑰。timeout
:聯結器逾時時間 (以秒為單位)。
示例
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
CLI 和 API 參考資料
移除佣金者彙整工具
移除彙整器項目。
參數
commissioner joiner remove eui64|discerner
eui64
:彙整器的 IEEE EUI-64。如要比對任何彙整器,請使用*
。discerner
:彙整函數,格式為number/length
。
示例
commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done
CLI 和 API 參考資料
佣金工具彙整工具表格
以表格格式列出所有彙整器項目。
參數
沒有參數。
示例
commissioner joiner table
| ID | PSKd | Expiration |
+-----------------------+----------------------------------+------------+
| * | J01NME | 81015 |
| d45e64fa83f81cf7 | J01NME | 101204 |
| 0x0000000000000abc/12 | J01NME | 114360 |
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
委員 mgmtget
傳送 MGMT_GET
(管理取得) 訊息給領導者。系統會傳回使用 commissioner mgmtset
指令設定的變數值。
參數
commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
locator
:邊界路由器 RLOC16。sessionid
:Commissioner 的工作階段 ID。steeringdata
:引導資料。joinerudpport
:聯結 UDP 通訊埠。TLVs
:要擷取的 TLV 組合。
示例
commissioner mgmtget locator sessionid
Done
CLI 和 API 參考資料
委託員管理
傳送 MGMT_SET
(管理集) 訊息給領導者,並將變數設為指定的值。
參數
commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
locator
:邊界路由器 RLOC16。sessionid
:Commissioner 的工作階段 ID。steeringdata
:引導資料。joinerudpport
:聯結 UDP 通訊埠。TLVs
:要擷取的 TLV 組合。
示例
commissioner mgmtset joinerudpport 9988
Done
CLI 和 API 參考資料
佣金員潘
傳送 PAN ID 查詢。收到指令後即會傳回指令輸出內容。
參數
commissioner panid panid mask destination
paind
:用於檢查衝突的永久帳號 ID。mask
;用來識別執行 IEEE 802.15.4 主動掃描管道的位元遮罩。destination
:訊息的 IPv6 目的地位址。這則訊息可能是多點傳播。
示例
commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800
CLI 和 API 參考資料
佣金工具佈建網址
設定佣金工具佈建網址。
參數
commissioner provisioningurl provisioningurl
示例
commissioner provisioningurl http://github.com/openthread/openthread
Done
CLI 和 API 參考資料
佣金員工作階段 ID
取得目前的委員工作階段 ID。
參數
沒有參數。
示例
commissioner sessionid
0
Done
CLI 和 API 參考資料
佣金工具起點
啟動 Thread 執行者角色。
參數
沒有參數。
示例
commissioner start
Commissioner: petitioning
Done
Commissioner: active
CLI 和 API 參考資料
委員州
傳回 Commissioner 的目前狀態。可能的值為 active
、disabled
或 petition
(向對方請款)。
參數
沒有參數。
示例
commissioner state
active
Done
CLI 和 API 參考資料
調試員停止
停止 Thread 執行者角色。
參數
沒有參數。
示例
commissioner stop
Done
CLI 和 API 參考資料
contextreusedelay (get,set)
取得或設定 CONTEXT_ID_REUSE_DELAY
值。
參數
contextreusedelay delay
使用選用的 delay
引數來設定 CONTEXT_ID_REUSE_DELAY
。
示例
contextreusedelay
11
Done
contextreusedelay 11
Done
CLI 和 API 參考資料
計數器 (Mac)
取得 MAC 層計數器。
參數
counters mac
示例
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
CLI 和 API 參考資料
計數器 (mle)
取得 Thread MLE 計數器。
參數
counters mle
示例
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
CLI 和 API 參考資料
計數器
取得支援的計數器名稱。
參數
沒有參數。
示例
counters
ip
mac
mle
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
計數器 IP
取得 IPv6 計數器。
參數
counters ip
示例
counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
CLI 和 API 參考資料
計數器 IP 重設
重設 IPv6 計數器。
參數
counters ip reset
示例
counters ip reset
Done
CLI 和 API 參考資料
計數器 mac 重設
重設 MAC 層計數器。
參數
counters mac reset
示例
counters mac reset
Done
CLI 和 API 參考資料
計數器 mle 重設
重設 Thread MLE 計數器。
參數
counters mle reset
示例
counters mle reset
Done
CLI 和 API 參考資料
CSL 管道
設定 CSL 頻道。
參數
csl channel channel
示例
csl channel 20
Done
CLI 和 API 參考資料
CSL
取得 CSL 設定。
參數
沒有參數。
示例
csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done
CLI 和 API 參考資料
CSL 期間
設定 CSL 週期 (以微秒為單位)。
將這項參數設為 0
即可停用 CSL。
CSL 週期必須是 OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
的倍數,否則會傳回 OT_ERROR_INVALID_ARGS
。
參數
csl period period
示例
csl period 3000000
Done
CLI 和 API 參考資料
CSL 逾時
設定 CSL 逾時 (以秒為單位)。
參數
csl timeout timeout
示例
cls timeout 10
Done
CLI 和 API 參考資料
資料集已啟用
取得有效作業資料集。
OT CLI 會使用 otOperationalDataset 成員將資料集值傳回控制台。
參數
dataset active [-x]
選用的 -x
引數會以十六進位編碼的 TLV 格式列印 Active Operational Dataset 值。
示例
dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done
dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
CLI 和 API 參考資料
資料集活動時間戳記 (get、set)
取得或設定 otOperationalDataset::mActiveTimestamp。
參數
dataset activetimestamp [timestamp]
傳遞選用的 timestamp
引數,以便設定使用中的時間戳記。
示例
dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集管道 (get、set)
取得或設定 otOperationalDataset::mChannel。
參數
dataset channel [channel-num]
使用選用的 channel-num
引數來設定管道。
示例
dataset channel
12
Done
dataset channel 12
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集管道遮罩 (get,set)
取得或設定 otOperationalDataset::mChannelMask
參數
dataset channelmask [channel-mask]
使用選用的 channel-mask
引數來設定管道遮罩。
示例
dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
清除資料集
重設作業資料集緩衝區。
參數
沒有參數。
示例
dataset clear
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
已啟用資料集修訂版本
將作業資料集緩衝區提交至使用中的作業資料集。
參數
沒有參數。
示例
dataset commit active
Done
CLI 和 API 參考資料
資料集修訂版本待處理
將作業資料集緩衝區提交至待處理的作業資料集。
參數
沒有參數。
示例
dataset commit pending
Done
CLI 和 API 參考資料
資料集延遲 (取得、設定)
取得或設定 otOperationalDataset::mDelay。
參數
dataset delay [delay]
您可以使用選用的 delay
引數設定延遲計時器值。
示例
dataset delay
1000
Done
dataset delay 1000
Done
CLI 和 API 參考資料
資料集範圍 (get,set)
取得或設定 otOperationalDataset::mExtendedPanId。
參數
dataset extpanid [extpanid]
使用選用的 extpanid
引數,即可設定延伸個人區域網路 ID。
示例
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
CLI 和 API 參考資料
資料集說明
取得 dataset
CLI 指令清單。詳情請參閱「使用 OT CLI 顯示及管理資料集」。
參數
沒有參數。
示例
dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
set
tlvs
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
Dataset init (有效、new、pending、tlvs)
OT CLI 會檢查 active
、pending
或 tlvs
,並傳回對應的值。否則,OT CLI 會建立新的隨機網路並傳回新的資料集。
參數
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
使用 new
初始化新資料集,然後輸入 dataset commit active
指令。如果是十六進位編碼的 TLV,請使用 tlvs
。
示例
dataset init new
Done
CLI 和 API 參考資料
資料集網格網路前置字串 (get,set)
取得或設定 otOperationalDataset::mMeshLocalPrefix。
參數
dataset meshlocalprefix [meshlocalprefix]
使用選用的 meshlocalprefix
引數來設定網格-本機前置字串。
示例
dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集 mgmtgetcommand
傳送 MGMT_ACTIVE_GET。
OT CLI 會傳送內含相關引數的 MGMT_ACTIVE_GET。如要進一步瞭解這些參數和引數對應,請參閱「使用 OT CLI 顯示及管理資料集」。
參數
dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
- 請使用
address
指定 IPv6 目的地;如果沒有,則使用領導者 ALOC。 - 針對
dataset-components
,您可以傳遞 otOperationalDatasetComponents 的任意組合,例如activetimestamp
、pendingtimestamp
或networkkey
。 - 選用的
-x
引數會指定要要求的原始 TLV。
示例
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done
CLI 和 API 參考資料
資料集 mgmtgetcommand 待處理
傳送 MGMT_PENDING_GET。
參數
dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]
如要進一步瞭解這些參數和引數對應,請參閱「使用 OT CLI 顯示及管理資料集」。
示例
dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done
CLI 和 API 參考資料
資料集 mgmtsetcommand 已啟用
傳送 MGMT_ACTIVE_SET。
參數
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
如要進一步瞭解這些參數和引數對應,請參閱「使用 OT CLI 顯示及管理資料集」。
示例
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done
CLI 和 API 參考資料
資料集 mgmtsetcommand 待處理
傳送 MGMT_PENDING_SET。
參數
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
如要進一步瞭解這些參數和引數對應,請參閱「使用 OT CLI 顯示及管理資料集」。
示例
dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done
CLI 和 API 參考資料
資料集網路索引鍵 (get,set)
取得或設定 otOperationalDataset::mNetworkKey。
參數
dataset networkkey [key]
使用選用的 key
引數來設定網路金鑰。
示例
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集網路名稱 (get,set)
取得或設定 otOperationalDataset::mNetworkName。
參數
dataset networkname [name]
使用選用的 name
引數設定網路名稱。
示例
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
CLI 和 API 參考資料
資料集 panid (get,set)
取得或設定 otOperationalDataset::mPanId。
參數
dataset panid [panid]
使用選用的 panid
引數設定 PAN ID。
示例
dataset panid
0x1234
Done
dataset panid 0x1234
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集待處理時間戳記 (get,set)
取得或設定 otOperationalDataset::mPendingTimestamp。
參數
dataset pendingtimestamp [timestamp]
使用選用的 timestamp
引數來設定待處理時間戳記的秒數。
示例
dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集 pskc (get,set)
取得或設定 otOperationalDataset::mPskc。
參數
dataset pskc [-p passphrase] | [key]
僅適用於 FTD,請將 -p
與 passphrase
引數搭配使用。-p
會根據您提供的 UTF-8 編碼 passphrase
、網路名稱和擴充 PAN ID 產生 pskc。如果設定,-p
會使用資料集緩衝區,否則會使用目前的堆疊。或者,您也可以將 pskc 設為 key
(十六進位格式)。
示例
dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集安全性政策 (get、set)
取得或設定資料集安全性政策。
參數
dataset securitypolicy [rotationtime [onrcCepR]]
- 針對
thrKeyRotation
使用rotationtime
,以小時為單位。 - 安全性政策指令使用
onrcCepR
引數對應來取得及設定 otSecurityPolicy 成員,例如o
代表 otSecurityPolicy::mObtainNetworkKeyEnabled。詳情請參閱「使用 OT CLI 顯示及管理資料集」。
示例
dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
資料集集 (有效、待處理)
設定使用中的作業資料集。
如果資料集不包含活動時間戳記,則資料集只算部分完整。
如果裝置有部分完整的 Active Dataset 已啟用 Thread,裝置會嘗試使用資料集中的任何現有資訊連接至現有的 Thread 網路。只有 Thread 網路金鑰才能連接至網路。
如果資料集內沒有通道,裝置會在不同管道傳送 MLE 公告訊息,找出其他管道的鄰居。
如果裝置成功連接至 Thread 網路,裝置就會從父項擷取完整的 Active 資料集。請注意,搭載路由器的裝置在取得完整的「有效資料集」後,才會改用路由器或領導者角色。
CLI dataset set
指令會使用十六進位編碼 TLV 設定 Active Operational Dataset。
參數
dataset set {active|pending} tlvs
示例
dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
CLI 和 API 參考資料
資料集 TLV
將指定的作業資料集轉換為
otOperationalDatasetTlvs
。
參數
沒有參數。
示例
dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done
CLI 和 API 參考資料
資料集更新工具取消
取消進行中的作業資料集更新要求 (如有)。
啟用 OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
後才能使用。
參數
沒有參數。
示例
@dataset updater cancel
Done
CLI 和 API 參考資料
資料集更新工具
指出是否有進行中的作業資料集更新要求。
啟用 OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
後才能使用。
參數
沒有參數。
示例
dataset updater
Enabled
Done
CLI 和 API 參考資料
資料集更新工具開始
要求更新作業資料集。
啟用 OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
後才能使用。
aDataset
應包含要更新的欄位及其新值。不可包含「有效」或「待處理時間戳記」欄位。「延遲」為選用欄位,如未提供預設值 (1000 毫秒),
參數
沒有參數。
示例
channel
19
Done
dataset clear
Done
dataset channel 15
Done
dataset
Channel: 15
Done
dataset updater start
Done
dataset updater
Enabled
Done
Dataset update complete: OK
channel
15
Done
CLI 和 API 參考資料
debug
執行一系列 CLI 指令,收集裝置和執行緒網路的相關資訊。這可用於偵錯。輸出內容會顯示每個執行的 CLI 指令 (前面加上 $
),後面接著對應指令產生的輸出內容。產生的輸出內容會包含下列資訊:
- 版本
- 目前狀態
- RLOC16,擴充 MAC 位址
- Unicast 和多點傳送 IPv6 位址清單
- 管道
- PAN ID 和延伸 PAN ID
- 網路資料
- 分區 ID
- 主管資料
如果裝置運作時為 FTD:
- 兒童和鄰居桌
- 路由器資料表和下一個躍點資訊
- 位址快取資料表
- 已註冊的 MTD 子 IPv6 位址
- 裝置屬性
如果裝置支援並擔任 SRP 用戶端:
- SRP 用戶端狀態
- SRP 客戶服務與主機資訊
如果裝置支援且本身為 SRP 伺服器:
- SRP 伺服器狀態和位址模式
- SRP 伺服器已註冊的主機與服務
如果裝置支援 TREL:
- TREL 狀態和同業資料表
如果裝置支援邊界路由器並做為邊界路由器使用:
- BR 狀態
- BR 前置字元 (OMR、on-link、NAT64)
- 系統搜尋到的前置字串資料表
參數
沒有參數。
示例
CLI 和 API 參考資料
- 沒有相關聯的 API
延遲 (設定)
設定最短延遲計時器 (以秒為單位)。
參數
delaytimermin delaytimermin
示例
delaytimermin 60
Done
CLI 和 API 參考資料
延遲
取得最短延遲計時器 (以秒為單位)。
參數
沒有參數。
示例
delaytimermin
30
Done
CLI 和 API 參考資料
detach async
啟動類似 detach
指令的安全卸離程序,而不必封鎖並等待回呼表示卸離完成。
參數
沒有參數。
示例
detach async
Done
CLI 和 API 參考資料
detach
如要啟動安全卸離程序,請先通知其他節點 (以路由器身分傳送位址釋出,或以子項的身分將子項逾時值設為零),然後停止 Thread 通訊協定作業。
參數
沒有參數。
示例
detach
Finished detaching
Done
CLI 和 API 參考資料
deviceprops (組)
設定裝置屬性。
參數
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply
:應設為「battery」、「external」、「external-stable」、「external-unstable」。
示例
deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply : battery
IsBorderRouter : no
SupportsCcm : no
IsUnstable : no
WeightAdjustment : -5
Done
CLI 和 API 參考資料
裝置道具
取得目前的裝置屬性。
需要 OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE
。
參數
沒有參數。
示例
deviceprops
PowerSupply : external
IsBorderRouter : yes
SupportsCcm : no
IsUnstable : no
WeightAdjustment : 0
Done
CLI 和 API 參考資料
discover
執行 MLE Discovery 作業。
參數
discover [channel]
channel
:要探索的頻道。如未提供頻道,探索功能會涵蓋所有有效的頻道。
示例
discover
| J | Network Name | Extended PAN | PAN | MAC Address | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
CLI 和 API 參考資料
探索回呼 (啟用、停用)
設定回呼來接收 MLE 探索要求資料。
參數
discover reqcallback enable|disable
示例
discover reqcallback enable
Done
CLI 和 API 參考資料
DNS 瀏覽
傳送瀏覽 (服務執行個體列舉) DNS 查詢,取得指定服務名稱的服務清單
service-name
之後的參數是選用項目。系統會將這些選用參數的任何未指定 (或零) 值,替換成目前預設設定 (dns config
) 的值。
參數
dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
示例
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 browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
Port:7000, Priority:0, Weight:0, TTL:10
Host:Mac-mini.default.service.arpa.
HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done
CLI 和 API 參考資料
dns 壓縮 (啟用、停用)
設定「DNS 名稱壓縮」模式。
系統預設會啟用 DNS 名稱壓縮。如果停用這項設定,DNS 名稱就會以完整形式附加,絕不會經過壓縮。這適用於 OpenThread 的 DNS 和 SRP 用戶端/伺服器模組。」「OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
」為必填欄位。
參數
dns compression [enable|disable]
示例
dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done
CLI 和 API 參考資料
DNS 壓縮
指出是否啟用「DNS 名稱壓縮」模式。
這僅供測試,必須啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
設定才能使用。
系統預設會啟用 DNS 名稱壓縮。如果停用這項設定,DNS 名稱就會以完整形式附加,絕不會經過壓縮。這適用於 OpenThread 的 DNS 和 SRP 用戶端/伺服器模組。」「OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
」為必填欄位。
參數
dns compression [enable|disable]
示例
dns compression
Enabled
CLI 和 API 參考資料
DNS 設定 (設定)
設定 DNS 用戶端的預設查詢設定。
在非空值的 aConfig
中,呼叫端可選擇將
otDnsQueryConfig
例項中的部分欄位留空 (值為零)。未指定的欄位會替換為對應的 OT 設定選項定義 OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}
,形成預設查詢設定。
啟用 OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE
後,DNS 用戶端會自動設定及更新預設設定中的伺服器 IPv6 位址。只有在使用者沒有明確設定或指定的情況下,系統才會執行此動作。需要啟用 SRP 用戶端及其自動開始功能,才能使用這項行為。接著,SRP 用戶端會監控 DNS/SRP 服務項目的 Thread 網路資料,以便選取 SRP 伺服器。在預設設定中,所選 SRP 伺服器位址也設為 DNS 伺服器位址。
可將部分欄位保留為未指定 (或使用 0 值)。未指定的欄位會替換為對應的 OT 設定選項定義 OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT
,形成預設查詢設定。「OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
」為必填欄位。
參數
dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode]
示例
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
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
CLI 和 API 參考資料
DNS 設定
取得 DNS 用戶端目前使用的預設查詢設定。
OpenThread 堆疊啟動時,預設的 DNS 查詢設定取決於一組 OT 設定選項,例如 OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS
、_DEFAULT_SERVER_PORT
、_DEFAULT_RESPONSE_TIMEOUT
等 (如需所有相關設定選項,請參閱 config/dns_client.h
)。
設定包含伺服器 IPv6 位址和連接埠、回應逾時 (以毫秒計)、報告失敗前的 tx 嘗試上限、布林值標記,指出伺服器是否可以遞迴解析查詢。「OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
」為必填欄位。
參數
沒有參數。
示例
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done
CLI 和 API 參考資料
DNS 解析
傳送特定主機名稱的 AAAA (IPv6) 記錄位址解析 DNS 查詢。
aConfig
可以是空值。在這種情況下,系統會使用預設設定 (來自
otDnsClientGetDefaultConfig()
) 做為這項查詢的設定。在非空值的 aConfig
中,某些欄位可以留空 (值為零)。接著,系統會將未指定的欄位替換為預設設定的值。
傳送 DNS 查詢,取得指定主機名稱的 IPv6 位址。
主機名稱之後的參數是選用項目。這些選用參數的任何未指定 (或零) 值,都會替換為目前預設設定 (DNS 設定) 的值。
DNS 伺服器 IP 可以是 IPv4 位址,系統會使用網路資料中偏好的 NAT64 前置字串,將這類位址合成為 IPv6 位址。
參數
dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
示例
dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done
CLI 和 API 參考資料
DNS 服務
啟動特定服務執行個體的 DNS 服務執行個體解析。
啟用 OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
後即可使用。
aConfig
可以是空值。在這種情況下,系統會使用預設設定 (來自
otDnsClientGetDefaultConfig()
) 做為這項查詢的設定。在非空值的 aConfig
中,某些欄位可以留空 (值為零)。接著,系統會將未指定的欄位替換為預設設定的值。
此函式可為指定服務執行個體的 SRV 和/或 TXT 記錄傳送查詢。
otDnsQueryConfig
中的 mServiceMode
欄位會決定要查詢哪些記錄 (僅限 SRV、僅限 TXT,或僅 SRV 和 TXT),以及如何執行查詢 (在同個訊息中一起同時進行,或在最佳化模式下分開處理,用戶端將先傳送同一則訊息,如果無法順利收到回應,則另外?)。
SRV 記錄提供服務通訊埠、優先順序和權重的相關資訊,以及與服務執行個體相關聯的主機名稱。這個函式「不會」針對 SRV 記錄中發現的主機名稱執行位址解析作業。伺服器/解析器可能會在 SRV/TXT 查詢的回應的「其他資料」部分,提供主機名稱的 AAAA/A 記錄。您可以在 otDnsServiceCallback
中使用
otDnsServiceResponseGetServiceInfo()
擷取這項資訊。這個 API 的使用者「不得」假設你一律可以從
otDnsServiceResponseGetServiceInfo()
取得主機位址。
傳送特定服務執行個體的服務執行個體解析 DNS 查詢。系統會先提供服務執行個體標籤,後面接著服務名稱 (請注意,服務執行個體標籤可以包含點號「.」字元)。
service-name
之後的參數是選用項目。系統會將這些選用參數的任何未指定 (或零) 值,替換成目前預設設定 (dns config
) 的值。
參數
dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
示例
CLI 和 API 參考資料
DNS 服務主機
啟動特定服務執行個體的 DNS 服務執行個體解析,其可能為服務執行個體找到的主機名稱後續解析位址解析。
啟用 OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
後即可使用。
aConfig
可以是空值。在這種情況下,系統會使用預設設定 (來自
otDnsClientGetDefaultConfig()
) 做為這項查詢的設定。在非空值的 aConfig
中,某些欄位可以留空 (值為零)。接著,系統會將未指定的欄位替換為預設設定的值。這個函式無法在設為 OT_DNS_SERVICE_MODE_TXT
的 DNS 設定中與 mServiceMode
搭配使用 (也就是說,僅查詢 TXT 記錄),且會傳回 OT_ERROR_INVALID_ARGS
。
與
otDnsClientResolveService()
傳送 SRV 和 TXT 記錄查詢的方式類似。不過,如果伺服器/解析器在 SRV 查詢的回應 (位於「其他資料」一節中) 未提供主機名稱的 AAAA/A 記錄,就會針對 SRV 記錄中發現的主機名稱執行主機名稱解析 (傳送 AAAA 查詢)。收到所有查詢的回應時 (即已完成服務和主機位址解析),系統會叫用 aCallback
回呼。
針對可能採取後續後續主機名稱解析的特定服務執行個體,傳送服務執行個體解析 DNS 查詢。系統會先提供服務執行個體標籤,後面接著服務名稱 (請注意,服務執行個體標籤可以包含點號「.」字元)。
service-name
之後的參數是選用項目。系統會將這些選用參數的任何未指定 (或零) 值,替換成目前預設設定 (dns config
) 的值。
參數
dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
示例
CLI 和 API 參考資料
網域名稱 (設定)
設定 Thread 網域名稱。
只有在 Thread 通訊協定停用時才會成功。
參數
domainname name
使用 backslash
逸出空格。
示例
domainname Test\ Thread
Done
CLI 和 API 參考資料
網域名稱
取得 Thread 網域名稱。
參數
沒有參數。
示例
domainname
Thread
Done
CLI 和 API 參考資料
dua iid (set,clear)
設定或清除手動指定的 Thread 網域 Unicast 位址介面 ID。
啟用 OPENTHREAD_CONFIG_DUA_ENABLE
後才能使用。
參數
dua iid iid|clear
dua iid clear
會將 nullptr
傳遞給 otThreadSetFixedDuaInterfaceIdentifier。否則,您可以傳遞 iid
。
示例
dua iid 0004000300020001
Done
dua iid clear
Done
CLI 和 API 參考資料
Dua iid
取得手動為 Thread 網域 Unicast 位址指定的介面 ID。
啟用 OPENTHREAD_CONFIG_DUA_ENABLE
後才能使用。
參數
沒有參數。
示例
dua iid
0004000300020001
Done
CLI 和 API 參考資料
eidcache
傳回 EID 對 RLOC 的快取項目。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
eui64
取得用於這個介面的原廠指派 IEEE EUI-64。
參數
沒有參數。
示例
eui64
0615aae900124b00
Done
CLI 和 API 參考資料
外部 (集合)
設定 IEEE 802.15.4 延伸地址。
參數
extaddr extaddr
示例
extaddr dead00beef00cafe
dead00beef00cafe
Done
CLI 和 API 參考資料
滅菌器
取得 IEEE 802.15.4 延伸地址。
參數
沒有參數。
示例
extaddr
dead00beef00cafe
Done
CLI 和 API 參考資料
滅菌 (設定)
設定 IEEE 802.15.4 擴充永久帳號 ID。
參數
extpanid extpanid
示例
extpanid dead00beef00cafe
Done
CLI 和 API 參考資料
滅菌
取得 IEEE 802.15.4 擴充永久帳號 ID。
參數
沒有參數。
示例
extpanid
dead00beef00cafe
Done
CLI 和 API 參考資料
恢復原廠設定
刪除儲存在非揮發性記憶體中的所有設定,並觸發平台重設作業。
參數
沒有參數。
示例
factoryreset
CLI 和 API 參考資料
假 (a,an)
傳送假的 Thread 訊息。
啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
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
CLI 和 API 參考資料
fem
取得外部 FEM 參數。
參數
沒有參數。
示例
fem
LNA gain 11 dBm
Done
CLI 和 API 參考資料
fem lnagain (get)
在 dBm 中取得外部 FEM 的 Rx LNA 增益。
參數
沒有參數。
示例
fem lnagain
11
Done
CLI 和 API 參考資料
fem lnagain (集合)
在 dBm 中設定外部 FEM 的 Rx LNA 增益。
參數
沒有參數。
示例
fem lnagain 8
Done
CLI 和 API 參考資料
歷史記錄 IP
以表格或清單格式顯示單點傳播 IPv6 位址記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
或Removed
。 - 地址/前置字元長度:包含前置字串長度的 Unicast 位址 (以位元為單位)。
- 來源:可能的值為
thread
、slaac
、dhcp6
或manual
。 - 範圍:IPv6 位址範圍。
- P:偏好標記。
- V:有效標記。
- RLOC (R):這個標記表示 IPv6 位址是否為路由定位器。
參數
history ipaddr [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history ipaddr
| Age | Event | Address / Prefix Length | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
| 00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:00:44.647 | Added | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:01:07.199 | Added | fd00:0:0:0:0:0:0:1/64 | manual | 14 | Y | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:fc00/64 | thread | 3 | N | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64 | thread | 3 | N | Y | N |
| 00:02:23.904 | Added | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64 | thread | 2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done
CLI 和 API 參考資料
搜尋記錄
以表格或清單格式顯示多點傳送 IPv6 位址記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Subscribed
或Unsubscribed
。 - 多點傳播位址
- 來源:可能的值為
Thread
或Manual
。
參數
history ipmaddr [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history ipmaddr
| Age | Event | Multicast Address | Origin |
+----------------------+--------------+-----------------------------------------+--------+
| 00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:25.353 | Subscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:54.953 | Subscribed | ff03:0:0:0:0:0:0:2 | Thread |
| 00:01:54.953 | Subscribed | ff02:0:0:0:0:0:0:2 | Thread |
| 00:01:59.329 | Subscribed | ff33:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:01:59.329 | Subscribed | ff32:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:fc | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff02:0:0:0:0:0:0:1 | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done
CLI 和 API 參考資料
歷史鄰居
以表格或清單格式顯示鄰點記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
Child
或Router
。 - 事件:可能的值為
Added
、Removed
或Changed
。 - 詳細地址
- RLOC16
- 模式:MLE 連結模式。可能的值包括:
-
:未設定任何旗標 (rx-off-when-idle、最小的 Thread 裝置、穩定的網路資料)。r
:rx-on-when-idled
:完整 Thread 裝置。n
:完整網路資料
- Ave RSS:記錄項目時,從鄰點接收的平均影格數 (以 dBm 為單位)。
參數
history neighbor [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done
CLI 和 API 參考資料
記錄 netinfo
以表格或清單格式顯示網路資訊記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 角色:裝置角色。可能的值包括
router
、child
、detached
或disabled
。 - 模式:MLE 連結模式。可能的值包括:
-
:未設定任何旗標 (rx-off-when-idle、最小的 Thread 裝置、穩定的網路資料)。r
:rx-on-when-idled
:完整 Thread 裝置。n
:完整網路資料
- RLOC16
- 分區 ID。
參數
history netinfo [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:02:05.451 | router | rdn | 0x6000 | 151029327 |
| 00:04:04.719 | child | rdn | 0x2001 | 151029327 |
Done
CLI 和 API 參考資料
歷史記錄前置字串
以表格或清單格式顯示網格前置字串記錄的網路資料。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
或Removed
。 - 前置字串
- 標記/意義:
p
:偏好標記a
:無狀態 IPv6 位址自動設定標記。d
:DHCPv6 IPv6 位址設定標記。c
:DHCPv6 其他設定標記。r
:預設路徑旗標。o
:在網格標記上。s
:穩定版標記。n
:Nd Dns 標記。D
:網域前置字串標記。
- 偏好設定:Preference。值可以是
high
、med
或low
。 - RLOC16
參數
history prefix [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history prefix
| Age | Event | Prefix | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:10.663 | Added | fd00:1111:2222:3333::/64 | paro | med | 0x5400 |
| 00:01:02.054 | Removed | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:21.136 | Added | fd00:abba:cddd:0::/64 | paos | med | 0x5400 |
| 00:01:45.144 | Added | fd00:dead:beef:1::/64 | paros | high | 0x3c00 |
| 00:01:50.944 | Added | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:59.887 | Added | fd00:dead:beef:1::/64 | paros | med | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done
CLI 和 API 參考資料
歷史路線
以表格或清單格式顯示網路資料外部路徑記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
或Removed
。 - 路徑
- 標記/意義:
s
:穩定版標記。n
:NAT64 旗標。
- 偏好設定:Preference。值可以是
high
、med
或low
。 - RLOC16
參數
history route [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history route
| Age | Event | Route | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:05.456 | Removed | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:29.310 | Added | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:42.822 | Added | fd00:1111:0::/48 | s | med | 0x5400 |
| 00:01:27.688 | Added | fd00:aaaa:bbbb:cccc::/64 | s | med | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done
CLI 和 API 參考資料
歷史記錄路由器
以表格或清單格式顯示路徑資料表記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
、Removed
、NextHopChanged
或CostChanged
。 - ID (RLOC16):路由器的路由器 ID 和 RLOC16。
- 下一個躍點:下一個躍點的路由器 ID 和 RLOC16。如果沒有下一個躍點,則會顯示
none
。 - 路徑費用:舊費用
->
新費用。inf
值表示無限路徑費用。
參數
history router [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history router
| Age | Event | ID (RLOC16) | Next Hop | Path Cost |
+----------------------+----------------+-------------+-------------+------------+
| 00:00:05.258 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:00:08.604 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:00:11.931 | Added | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 59 (0xec00) | none | inf -> inf |
| 00:00:14.948 | Removed | 54 (0xd800) | none | inf -> inf |
| 00:00:14.948 | Removed | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 7 (0x1c00) | none | inf -> inf |
| 00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) | 1 -> 5 |
| 00:02:33.735 | NextHopChanged | 54 (0xd800) | none | 15 -> inf |
| 00:03:10.915 | CostChanged | 54 (0xd800) | 34 (0x8800) | 13 -> 15 |
| 00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) | 15 -> 13 |
| 00:03:46.188 | CostChanged | 54 (0xd800) | 59 (0xec00) | 13 -> 15 |
| 00:04:19.124 | CostChanged | 54 (0xd800) | 59 (0xec00) | 11 -> 13 |
| 00:04:52.008 | CostChanged | 54 (0xd800) | 59 (0xec00) | 9 -> 11 |
| 00:05:23.176 | CostChanged | 54 (0xd800) | 59 (0xec00) | 7 -> 9 |
| 00:05:51.081 | CostChanged | 54 (0xd800) | 59 (0xec00) | 5 -> 7 |
| 00:06:48.721 | CostChanged | 54 (0xd800) | 59 (0xec00) | 3 -> 5 |
| 00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) | 1 -> 3 |
| 00:09:28.681 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:09:31.882 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf -> 1 |
| 00:09:54.204 | Added | 54 (0xd800) | none | inf -> inf |
| 00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
| 00:10:24.242 | Added | 34 (0x8800) | none | inf -> inf |
| 00:10:41.900 | NextHopChanged | 59 (0xec00) | none | 1 -> inf |
| 00:10:42.480 | Added | 3 (0x0c00) | 3 (0x0c00) | inf -> inf |
| 00:10:43.614 | Added | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done
CLI 和 API 參考資料
記錄 RX
以表格或清單格式顯示 IPv6 訊息 RX 記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
- 秒:指出是否已使用連結層安全性。
- Prio:訊息優先順序。可能的值為
low
、norm
、high
或net
(適用於執行緒控制訊息)。 - RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示
NA
(不適用)。 - 離子:顯示訊息是否已傳送 (
TX
) 或已收到 (RX
)。傳輸失敗時會以表格格式顯示「TX-F
」,或以清單格式顯示tx-success:no
。傳輸失敗的例子包括tx
遭到取消,以及任何訊息片段都沒有從對等點傳送ack
。 - 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以
bcast
或清單格式顯示為0xffff
。如果無法取得鄰點的短地址,會以表格格式顯示unknwn
,在清單格式中則會顯示0xfffe
。 - 電台:傳送/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果傳送至所有電台連結)。
參數
history rx [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history rx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xbd26 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x3f7d | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0x942c | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
| | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x2e37 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xe177 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0x82ee | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0x52df | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x5ccf | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
Done
history rx list 4
00:00:13.368
type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done
CLI 和 API 參考資料
歷史描述服務供應商
以表格或清單格式顯示合併的 IPv6 訊息 RX 和 TX 記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
- 秒:指出是否已使用連結層安全性。
- Prio:訊息優先順序。可能的值為
low
、norm
、high
或net
(適用於執行緒控制訊息)。 - RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示
NA
(不適用)。 - 離子:顯示訊息是否已傳送 (
TX
) 或已收到 (RX
)。傳輸失敗時會以表格格式顯示「TX-F
」,或以清單格式顯示tx-success:no
。傳輸失敗的例子包括tx
遭到取消,以及任何訊息片段都沒有從對等點傳送ack
。 - 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以
bcast
或清單格式顯示為0xffff
。如果無法取得鄰點的短地址,會以表格格式顯示unknwn
,在清單格式中則會顯示0xfffe
。 - 電台:傳送/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果傳送至所有電台連結)。
參數
history rxtx [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history rxtx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x6c6b | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0xc6a2 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
| | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0xc5a2 | yes | norm | NA | TX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
| | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xaa0d | yes | net | NA | TX | 0x0800 | 15.4 |
| 00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xc1d8 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x3cb1 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xeda0 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0xbdfa | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0x1c11 | no | net | NA | TX | 0x0800 | 15.4 |
| 00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0xedff | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0xd383 | no | net | NA | TX | bcast | 15.4 |
| 00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history rxtx list 5
00:00:02.100
type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done
CLI 和 API 參考資料
記錄 TTX
以表格或清單格式顯示 IPv6 訊息 TX 記錄。
每個資料表或清單項目會提供:
- 存在時間:從指令發出後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
- 秒:指出是否已使用連結層安全性。
- Prio:訊息優先順序。可能的值為
low
、norm
、high
或net
(適用於執行緒控制訊息)。 - RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示
NA
(不適用)。 - 離子:顯示訊息是否已傳送 (
TX
) 或已收到 (RX
)。傳輸失敗時會以表格格式顯示「TX-F
」,或以清單格式顯示tx-success:no
。傳輸失敗的例子包括tx
遭到取消,以及任何訊息片段都沒有從對等點傳送ack
。 - 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以
bcast
或清單格式顯示為0xffff
。如果無法取得鄰點的短地址,會以表格格式顯示unknwn
,在清單格式中則會顯示0xfffe
。 - 電台:傳送/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果傳送至所有電台連結)。
參數
history tx [list] [num-entries]
- 使用
list
選項,以清單格式顯示輸出內容。否則輸出結果會以表格格式顯示。 - 使用
num-entries
選項,將輸出限制為最近的指定項目數量。如果沒有使用此選項,所有儲存的項目都會顯示在輸出內容中。
示例
history tx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0x932c | yes | norm | NA | TX | 0x4800 | 15.4 |
| 00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
| | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xce87 | yes | net | NA | TX | 0x4800 | 15.4 |
| 00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0xf7ba | no | net | NA | TX | 0x4800 | 15.4 |
| 00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0x26d4 | no | net | NA | TX | bcast | 15.4 |
| 00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history tx list
00:00:23.957
type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[ff02:0:0:0:0:0:0:2]:19788
Done
CLI 和 API 參考資料
ifconfig (up、down)
上下調整 IPv6 介面。
呼叫即可啟用或停用 IPv6 通訊。
參數
ifconfig up|down
示例
ifconfig up
Done
ifconfig down
Done
CLI 和 API 參考資料
ifconfig
指出 IPv6 介面是否已啟用。
參數
沒有參數。
示例
ifconfig
down
Done
ifconfig
up
Done
CLI 和 API 參考資料
執行個體 ID
取得執行個體 ID。
建立執行個體時,執行個體 ID 會設為隨機值,其值在初始化後不會變更。
參數
沒有參數。
示例
instanceid
468697314
Done
CLI 和 API 參考資料
新增
將網路介面位址新增至 Thread 介面。
傳入的執行個體 aAddress
會由 Thread 介面複製。Thread 介面僅支援固定數量的外部單點傳播位址。查看《OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS
》。
參數
ipaddr add aAddress
示例
ipaddr add 2001::dead:beef:cafe
Done
CLI 和 API 參考資料
Iipaddr del
從 Thread 介面中移除網路介面位址。
參數
ipaddr del aAddress
示例
ipaddr del 2001::dead:beef:cafe
Done
CLI 和 API 參考資料
Paddr
取得指派給 Thread 介面的 IPv6 位址清單。
參數
ipaddr [-v]
使用 -v
即可取得更多有關地址的詳細資訊:
origin
:可以是thread
、slaac
、dhcp6
、manual
,表示地址起點plen
:前置長度preferred
:偏好標記 (布林值)valid
:有效標記 (布林值)
示例
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 -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done
CLI 和 API 參考資料
IPaddr linklocal
取得 Thread 連結 - 本機 IPv6 位址。
Thread 連結本機位址是以 IEEE802.15.4 擴充地址做為介面識別碼所產生。
參數
沒有參數。
示例
ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
CLI 和 API 參考資料
ipaddr mleid
取得網格本機 EID 位址。
參數
沒有參數。
示例
ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done
CLI 和 API 參考資料
ipaddr rloc
取得執行緒轉送定位器 (RLOC) 位址。
參數
沒有參數。
示例
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done
CLI 和 API 參考資料
新增
將 Thread 介面訂閱至網路介面多點傳播位址。
執行緒介面會複製傳入的執行個體 aAddress
。Thread 介面僅支援固定數量的外部多點傳播位址。查看《OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS
》。
參數
ipmaddr add aAddress
示例
ipmaddr add ff05::1
Done
CLI 和 API 參考資料
IPMaddr Del
取消訂閱網路介面多點傳播位址的 Thread 介面。
參數
ipmaddr del aAddress
示例
ipmaddr del ff05::1
Done
CLI 和 API 參考資料
IPMaddr
取得訂閱 Thread 介面的 IPv6 多點傳播位址清單。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
IPMaddr Latn
取得 Thread Link-Local 所有 Thread 節點的多點傳播位址。
此位址為連結本機 Unicast 前置字串式多點傳播位址 [RFC 3306],其中包含:
- flgs 設為 3 (P = 1,T = 1)
- Scop 已設為 2
- 將 PB 設為 64
- 網路前置字串已設為網格本機前置字串
- 群組 ID 已設為 1
參數
沒有參數。
示例
ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done
CLI 和 API 參考資料
ipmaddr Promiscuous (啟用、停用)
在 Thread 介面中啟用或停用多點傳播正常模式。
參數
ipmaddr promiscuous enable|disable
示例
ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done
CLI 和 API 參考資料
IPmaddr Promiscuous
檢查 Thread 介面是否已啟用多點傳播正常模式。
參數
沒有參數。
示例
ipmaddr promiscuous
Disabled
Done
CLI 和 API 參考資料
IPMaddr Rlatn
取得 Thread Realm-Local 所有 Thread 節點多點傳播位址。
位址為運作範圍本機的 Unicast 前置字串式多點傳播位址 [RFC 3306],其中包含:
- flgs 設為 3 (P = 1,T = 1)
- Scop 已設為 3
- 將 PB 設為 64
- 網路前置字串已設為網格本機前置字串
- 群組 ID 已設為 1
參數
沒有參數。
示例
ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done
CLI 和 API 參考資料
聯合系 (設定)
設定彙整器。
參數
joiner discerner discerner
- 請使用
{number}/{length}
設定discerner
。 joiner discerner clear
將aDiscerner
設為nullptr
。
示例
joiner discerner 0xabc/12
Done
CLI 和 API 參考資料
橡皮擦清除
清除「彙整工具」卡。
參數
沒有參數。
示例
joiner discerner clear
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
聯合系
取得合成器。
詳情請參閱 otJoinerSetDiscerner 的說明。
參數
沒有參數。
示例
joiner discerner
0xabc/12
Done
CLI 和 API 參考資料
彙整工具說明
列印 joiner
說明選單。
參數
沒有參數。
示例
joiner help
help
id
start
state
stop
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
彙整者 ID
取得彙整器 ID。
如果未設定彙整器 ID,聯結器 ID 是工廠指派的 IEEE EUI-64 計算結果,因此 SHA-256 的前 64 位元。否則,彙整器 ID 是根據「彙整器 ID」值計算。
在調試過程中,彙整工具 ID 也會用作裝置的 IEEE 802.15.4 延伸地址。
參數
沒有參數。
示例
joiner id
d65e64fa83f81cf7
Done
CLI 和 API 參考資料
彙整器開始
啟用「執行緒彙整者」角色。
參數
joiner start joining-device-credential [provisioning-url]
joining-device-credential
:組合通關密語。必須為所有大寫英數字元的字串 (0 至 9 和 A-Y,但 I、O、Q 和 Z 除外,可判讀),長度介於 6 至 32 個半形字元之間。provisioning-url
:彙整器的佈建網址 (選用)。
示例
joiner start J01NM3
Done
CLI 和 API 參考資料
彙整者狀態
取得彙整器狀態。
傳回下列其中一種狀態:
-
Idle
-
Discover
-
Connecting
-
Connected
-
Entrust
-
Joined
參數
沒有參數。
示例
joiner state
Idle
Done
CLI 和 API 參考資料
關掉停止
停用「執行緒彙整者」角色。
參數
沒有參數。
示例
joiner stop
Done
CLI 和 API 參考資料
Joinerport (組合)
設定彙整器 UDP 通訊埠。
參數
joinerport udp-port
示例
joinerport 1000
Done
CLI 和 API 參考資料
Joinerport
取得彙整器 UDP 通訊埠。
參數
沒有參數。
示例
joinerport
1000
Done
CLI 和 API 參考資料
Keysequence 計數器 (設定)
設定 thrKeySequenceCounter。
參數
keysequence counter counter
示例
keysequence counter 10
Done
CLI 和 API 參考資料
Keysequence 計數器
取得 thrKeySequenceCounter。
參數
沒有參數。
示例
keysequence counter
10
Done
CLI 和 API 參考資料
金鑰序列防護時間 (設定)
設定 thrKeySwitchGuardTime (以小時為單位)。
參數
keysequence guardtime guardtime-hours
如有索引鍵索引相符,立即使用 0
到 Thread Key Switch
。
示例
keysequence guardtime 0
Done
CLI 和 API 參考資料
金鑰序列防護時間
取得 thrKeySwitchGuardTime (以小時為單位)。
參數
沒有參數。
示例
keysequence guardtime
0
Done
CLI 和 API 參考資料
主管資料
可取得討論串領導者資料。
參數
沒有參數。
示例
leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done
CLI 和 API 參考資料
領先者 (組合)
設定以主要角色為主職時的 Thread 領導者權重。
將領導者權重直接設為新的值,並取代先前的值 (可能是根據目前的
otDeviceProperties
確定)。
參數
leaderweight weight
示例
leaderweight 128
Done
CLI 和 API 參考資料
領先者
取得在主要角色擔任領導者時使用的執行緒領導者權重。
參數
沒有參數。
示例
leaderweight
128
Done
CLI 和 API 參考資料
linkmetrics mgmt 強化確認
傳送連結指標管理要求,以清除強化型 ACK 型 Probing。
參數
linkmetrics mgmt peer-ipaddr enhanced-ack clear
peer-ipaddr
應為鄰近裝置的連結本機地址。
示例
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
CLI 和 API 參考資料
linkmetrics mgmt 加強確認註冊
傳送連結指標管理要求以註冊強化型 ACK 型探測器。
參數
linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]
[q
、m
和 r
] 對應至 otLinkMetricsValues。根據規格 4.11.3.4.4.6,一次最多只能使用兩個選項,例如 q
或 qm
。
q
:第 2 層 LQI。m
:連結利潤。r
:RSSI。
r
為選用項目,僅適用於參考裝置。指定此選項時,每個類型 ID 旗標的「類型/平均列舉」會設為保留狀態。這會用於驗證探測主體是否正確處理無效類型 ID 旗標,且必須啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
才能使用。
示例
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
CLI 和 API 參考資料
linkmetrics mgmt 正向
傳送 MLE 連結指標管理要求,以設定或清除轉送追蹤系列。
參數
linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
peer-ipaddr
:同儕地址。series-id
:系列叢書 ID。- [
l
、d
、r
和a
] 會對應至 otLinkMetricsSeriesFlags。X
代表不含otLinkMetricsSeriesFlags
,且會停止會計並移除系列。l
:MLE 連結探測器。d
:MAC 資料。r
:MAC 資料要求。a
:MAC Ack。X
:只能在沒有其他旗標的情況下使用。
- [
p
、q
、m
和r
] 會對應至 otLinkMetricsValues。p
:收到的第 2 層 PDU 數量。q
:第 2 層 LQI。m
:連結利潤。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
CLI 和 API 參考資料
連結指標探測器
傳送 MLE Link 探測訊息。
參數
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr
:同儕地址。series-id
:此探測訊息的目標系列 ID。length
:探測訊息的長度。有效的範圍為 [0, 64]。
示例
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
CLI 和 API 參考資料
linkmetrics 查詢 (前進)
執行連結指標查詢 (轉送追蹤系列)。
參數
linkmetrics query peer-ipaddr forward series-id
peer-ipaddr
:同儕地址。series-id
:系列叢書 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)
CLI 和 API 參考資料
linkmetrics 查詢單個
執行連結指標查詢 (單一探測)。
參數
linkmetrics query peer-ipaddr single [pqmr]
peer-ipaddr
:同儕地址。- [
p
、q
、m
和r
] 會對應至 otLinkMetrics。p
:收到的第 2 層 PDU 數量。q
:第 2 層 LQI。m
:連結利潤。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)
CLI 和 API 參考資料
linkmetricsmgr (啟用、停用)
啟用或停用連結指標管理工具。
參數
linkmetricsmgr enable|disable
示例
linkmetricmgr enable
Done
linkmetricmgr disable
Done
CLI 和 API 參考資料
linkmetricsmgr 節目
根據延伸地址取得相鄰位置的連結指標資料。
參數
沒有參數。
示例
linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done
CLI 和 API 參考資料
定位 (設定)
找出任一傳播位址最近的目的地 (也就是找出目的地的網狀網路 EID 和 RLOC16)。
系統會依據目前的路徑資料表和 Thread 網格中的路徑費用,決定最接近目的地的目的地。
啟用 OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
後才能使用。
參數
locate anycastaddr
示例
locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done
CLI 和 API 參考資料
定位
取得任意投放定位器目前的狀態 (In Progress
或 Idle
)。
啟用 OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
後才能使用。
參數
沒有參數。
示例
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
CLI 和 API 參考資料
記錄檔名稱
指定擷取
otPlatLog()
訊息的檔案名稱。當記錄對自動化測試指令碼造成中斷時,Linux 上的自動測試指令碼偵錯時非常實用。
需要 OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
和 OPENTHREAD_POSIX
。
參數
log filename filename
示例
CLI 和 API 參考資料
記錄檔層級 (設定)
設定記錄層級。
參數
log level level
示例
log level 4
Done
CLI 和 API 參考資料
記錄檔層級
取得記錄層級。
參數
沒有參數。
示例
log level
1
Done
CLI 和 API 參考資料
mac 直接重試 (get,set)
取得或設定 MAC 層的直接重試次數。
參數
mac retries direct [number]
使用選用的 number
引數,即可設定直接重試的 TX 次數。
示例
mac retries direct
3
Done
mac retries direct 5
Done
CLI 和 API 參考資料
mac 間接重試 (get,set)
取得或設定 MAC 層的間接 TX 重試次數。
參數
mac retries indirect [number]
使用選用的 number
引數,即可設定間接重試次數。
示例
mac retries indirect
3
Done
max retries indirect 5
Done
CLI 和 API 參考資料
mac send
指示 Rx-Off-When-Idle
裝置傳送 MAC 影格給父項。這個指令僅供認證,只有在啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
時才可使用。
參數
mac send datarequest | emptydata
必須選擇下列其中一個引數:
datarequest
:將 IEEE 802.15.4 資料要求訊息加入佇列中以供傳輸。emptydata
:指示裝置傳送空白的 IEEE 802.15.4 資料頁框。
示例
mac send datarequest
Done
mac send emptydata
Done
CLI 和 API 參考資料
macfilter addr 新增
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定,才能使用這個選單。
將 IEEE 802.15.4 擴充位址新增至 MAC 篩選器清單。如果您指定選用的 rss
引數,這會修正該地址傳送郵件的訊號強度。如果您不使用 rss
選項,地址就會使用您設定的任何預設值。如果沒有設定預設訊號,訊號強度就會是無線訊號。
參數
macfilter addr add extaddr [rss]
示例
macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done
CLI 和 API 參考資料
macfilter 新增者許可清單
啟用 allowlist
MAC 篩選器模式,表示只能存取 MAC 篩選器清單中的 MAC 位址。
參數
沒有參數。
示例
macfilter addr allowlist
Done
CLI 和 API 參考資料
清除 macfilter Addr
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定才能使用這項功能。
這個指令會清除 MAC 篩選器清單中所有延伸位址。
參數
沒有參數。
示例
macfilter addr clear
Done
CLI 和 API 參考資料
macfilter 新增者拒絕清單
啟用 denylist
MAC 篩選器模式,代表 MAC 篩選器清單中的所有 MAC 位址將遭到拒絕。
參數
沒有參數。
示例
macfilter addr denylist
Done
CLI 和 API 參考資料
停用 macfilter addr 停用
停用 MAC 篩選器模式。
參數
沒有參數。
示例
macfilter addr disable
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
macfilter addr
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定才能使用這項功能。
提供下列資訊:
- MAC 篩選器清單目前的模式:
AllowList
、DenyList,
或Disabled
- 篩選器中所有延伸地址的清單。如果傳送的值與預設值不同,接收到的訊號強度 (rs) 和連結品質指標 (lqi) 就會顯示在地址旁邊。
參數
沒有參數。
示例
macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done
CLI 和 API 參考資料
從 macfilter addr 移除
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定才能使用這項功能。
這個指令會從 MAC 篩選器清單中移除指定的延伸位址。
參數
macfilter addr remove extaddr
示例
macfilter addr remove 0f6127e33af6b402
Done
CLI 和 API 參考資料
Macfilter
提供下列資訊:
Address Mode
:MAC 篩選器的目前模式:AllowList
、DenyList,
或Disabled
- MAC 篩選器清單中所有延伸位址的清單。如果傳送的值與預設值不同,接收到的訊號強度 (rs) 和連結品質指標 (lqi) 就會顯示在地址旁邊。
- 獨立的清單 (
RssIn List
),顯示所有將rss
設為與預設值不同的延伸地址。 Default rss
:顯示rss
和lqi
設定的預設值 (如適用)。
參數
沒有參數。
示例
macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI 和 API 參考資料
macfilter rss 新增
將指定的擴充地址加入 RssIn
清單 (或修改 RssIn
清單中的現有地址),並為來自該地址的郵件設定接收信號強度 (dBm)。
參數
macfilter rss add extaddr rss
如要設定所有接收訊息的接收信號強度預設值,請將 *
用於 extaddr
引數。
示例
macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done
CLI 和 API 參考資料
macfilter rss add-lqi
將指定的延伸地址加入 RssIn
清單 (或修改 RssIn
清單中的現有地址),並為來自該地址的郵件設定固定連結品質指標。「延伸地址」不一定要位於 address allowlist/denylist
篩選器中,才能設定 lqi
。
這項功能會在 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定啟用時提供。
參數
macfilter rss add-lqi extaddr lqi
如要設定所有收到訊息的連結品質指標預設值,請使用 *
做為 extaddr
引數。允許的範圍介於 0 至 3 之間。
示例
macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done
CLI 和 API 參考資料
MACfilter rss 清除
清除 RssIn
清單中所有接收的訊號強度 (rss
) 和連結品質指標 (lqi
) 項目 (包括預設值)。
執行這項動作後,所有「延伸地址」都將使用現場訊號。
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定才能使用這項功能。
參數
沒有參數。
示例
macfilter rss clear
Done
CLI 和 API 參考資料
Macfilter rss
提供下列資訊:
- 列出所有接收訊號強度 (
rss
) 與預設值不同的延伸地址。以及連結品質指標 (lqi
)。rss
和lqi
設定會相互對應。設定其中一種時,系統會自動設定另一個廣告的值。此地址清單稱為RssIn List
。設定rsi
或lqi
會將對應的延伸地址新增至RssIn
清單。 Default rss
:顯示rss
和lqi
設定的預設值 (如適用)。
參數
沒有參數。
示例
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI 和 API 參考資料
macfilter rss 移除
從 RssIn
清單中移除指定的延伸地址。
從 RssIn
清單移除後,這個 MAC 位址將改用預設的 rss
和 lqi
設定 (假設已設定預設值)。(如未設定預設值,系統會使用無線訊號)。
必須啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定才能使用這項功能。
如果 RssIn
清單中沒有任何與指定延伸地址相符的項目,則不會執行任何動作。
參數
macfilter rss remove extaddr
如要移除預設的接收信號強度和連結品質指標設定,請使用 *
做為 extaddr
。這項操作會取消設定預設值,但不會移除 RssIn
清單中的項目。
示例
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
CLI 和 API 參考資料
網格 6
傳送查詢給父項,擷取其所有 MTD 子項的 IPv6 位址。
參數
meshdiag childip6 parent-rloc16
示例
meshdiag childip6 0xdc00
child-rloc16: 0xdc02
fdde:ad00:beef:0:ded8:cd58:b73:2c21
fd00:2:0:0:c24a:456:3b6b:c597
fd00:1:0:0:120b:95fe:3ecc:d238
child-rloc16: 0xdc03
fdde:ad00:beef:0:3aa6:b8bf:e7d6:eefe
fd00:2:0:0:8ff8:a188:7436:6720
fd00:1:0:0:1fcf:5495:790a:370f
Done
CLI 和 API 參考資料
網狀去子桌
針對具有指定 RLOC16 的路由器啟動子資料表查詢。輸出內容會列出所有子項目。每位孩子的資訊:
- RLOC16
- 擴充 MAC 位址
- 執行緒版本
- 逾時 (以秒為單位)
- 存在時間 (距離上次聆聽後經過的秒數)
- 監督時間間隔 (秒)
- 已排入佇列的訊息數量 (避免兒童昏昏欲睡)
- 裝置模式
- RSS (普通和最後一頁)
- 錯誤率:Frame tx (位於 MAC 層)、IPv6 訊息 tx (高於 MAC)
- 連線時間 (連結建立時間
{dd}d.{hh}:{mm}:{ss}
格式至今的秒數) - CSL 資訊:
- 如果已同步
- 時間範圍 (以 10 符號表示時間為單位)
- 逾時 (以秒為單位)
參數
沒有參數。
示例
meshdiag childtable 0x6400
rloc16:0x6402 ext-addr:8e6f4d323bbed1fe ver:4
timeout:120 age:36 supvn:129 q-msg:0
rx-on:yes type:ftd full-net:yes
rss - ave:-20 last:-20 margin:80
err-rate - frame:11.51% msg:0.76%
conn-time:00:11:07
csl - sync:no period:0 timeout:0 channel:0
rloc16:0x6403 ext-addr:ee24e64ecf8c079a ver:4
timeout:120 age:19 supvn:129 q-msg:0
rx-on:no type:mtd full-net:no
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.73% msg:0.00%
conn-time:01:08:53
csl - sync:no period:0 timeout:0 channel:0
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
鄰近網狀網路路由器
針對具備指定 RLOC16 的路由器,開始查詢路由器的鄰點資料表。輸出內容會列出所有路由器相鄰的項目。每個項目的資訊:
- RLOC16
- 擴充 MAC 位址
- 執行緒版本
- RSS (平均值和最後一個值) 和連結邊界
- 錯誤率、影格 tx (位於 MAC 層)、IPv6 訊息 tx (高於 MAC)
- 連線時間 (連結建立時間
{dd}d.{hh}:{mm}:{ss}
格式至今的秒數)
參數
meshdiag routerneighbortable router-rloc16
示例
meshdiag routerneighbortable 0x7400
rloc16:0x9c00 ext-addr:764788cf6e57a4d2 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:1.38% msg:0.00%
conn-time:01:54:02
rloc16:0x7c00 ext-addr:4ed24fceec9bf6d3 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.72% msg:0.00%
conn-time:00:11:27
Done
CLI 和 API 參考資料
網狀診斷拓撲
探索網路拓撲 (路由器及其連線清單)。參數是選用項目,用於指定要探索的其他項目。可依任何順序加入。
ip6-addrs
:找出每個路由器的 IPv6 位址清單。children
:找出每個路由器的子項資料表。
每個路由器的資訊:
- 路由器 ID
- RLOC16
- 擴充 MAC 位址
- 執行緒版本 (如果知道的話)
- 路由器是否為這部裝置本身 (
me
) - 當裝置是子項時,路由器是否為這部裝置的父項 (
parent
) - 路由器是否為「
leader
」 - 路由器是否做為提供外部連線的邊界路由器 (
br
) - 這個路由器含有連結的路由器清單:
3-links
:這個路由器與這個路由器的連入連結,連結品質 32-links
:這個路由器擁有連結品質 2 的連入連結路由器 ID1-links
:這個路由器有一個連入連結的路由器 ID,連結品質 1- 如果清單空白,系統會省略該清單。
- 如果設為
ip6-addrs
,則路由器的 IPv6 位址清單 - 如果設為
children
,則路由器的所有子項清單。每位孩子提供的資訊:- RLOC16
- 從父項到子項的連入連結品質 (零表示不明)
- 子項裝置模式 (
r
rx-on-when-idle、d
Full Thread 裝置、n
完整網路資料,-
未設定標記) - 孩子是否為這部裝置本身 (
me
) - 子項是否充當提供外部連線的邊界路由器 (
br
)
參數
meshdiag topology [ip6-addrs] [children]
示例
meshdiag topology
id:02 rloc16:0x0800 ext-addr:8aa57d2c603fe16c ver:4 - me - leader
3-links:{ 46 }
id:46 rloc16:0xb800 ext-addr:fe109d277e0175cc ver:4
3-links:{ 02 51 57 }
id:33 rloc16:0x8400 ext-addr:d2e511a146b9e54d ver:4
3-links:{ 51 57 }
id:51 rloc16:0xcc00 ext-addr:9aab43ababf05352 ver:4
3-links:{ 33 57 }
2-links:{ 46 }
id:57 rloc16:0xe400 ext-addr:dae9c4c0e9da55ff ver:4
3-links:{ 46 51 }
1-links:{ 33 }
Done
CLI 和 API 參考資料
Mleadvimax
取得廣告秘訣計時器目前使用的間隔最大值。
這個 API 需要 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
,僅供測試。
參數
沒有參數。
示例
mleadvimax
12000
Done
CLI 和 API 參考資料
mliid
設定網格本機 IID (供測試用途)。
需要 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
。
必須在啟用 Thread 堆疊前使用這項設定。
僅供測試/參照裝置使用。
參數
mliid iid
示例
mliid 1122334455667788
Done
CLI 和 API 參考資料
毫升
將多點傳播事件監聽器註冊至主要骨幹路由器。
必須啟用 OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE
和 OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
。
省略逾時,使用主要骨幹路由器上的預設 MLR 逾時。
使用 timeout = 0 取消註冊多點傳播事件監聽器。
參數
mlr reg ipaddr [timeout]
示例
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
CLI 和 API 參考資料
模式 (get,set)
進行 MLE 連結模式設定。
參數
mode [rdn]
-
:未設定任何旗標 (rx-off-when-idle、最小的 Thread 裝置、穩定的網路資料)r
:rx-on-when-idled
:完整 Thread 裝置n
:完整網路資料
示例
mode rdn
Done
mode -
Done
CLI 和 API 參考資料
多無線電
取得裝置支援的圓形按鈕清單。
即使裝置僅支援單一無線電,仍可隨時使用這項指令。
參數
沒有參數。
示例
multiradio
[15.4, TREL]
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
多無線電鄰點清單
取得與指定延伸地址相鄰的多重無線電連結資訊。
必須啟用 OPENTHREAD_CONFIG_MULTI_RADIO
。
參數
沒有參數。
示例
multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
CLI 和 API 參考資料
多無線電鄰居
取得與指定延伸地址相鄰的多重無線電連結資訊。
必須啟用 OPENTHREAD_CONFIG_MULTI_RADIO
。
參數
multiradio neighbor ext-address
示例
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
CLI 和 API 參考資料
nat64 (啟用、停用)
啟用或停用 NAT64 函式。
如果啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
,如果設為停用,系統會重設翻譯工具中的對應資料表,
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
或 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
後才能使用。
參數
nat64 enable|disable
示例
nat64 enable
Done
nat64 disable
Done
CLI 和 API 參考資料
nat64 cidr
參數
沒有參數。
示例
nat64 cidr 192.168.255.0/24
Done
CLI 和 API 參考資料
nat64 蘋果酒
取得 NAT64 翻譯器中設定的 IPv4 CIDR。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
示例
nat64 cidr
192.168.255.0/24
Done
CLI 和 API 參考資料
nat64 計數器
取得 NAT64 轉譯器封包和錯誤計數器。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
示例
nat64 counters
| | 4 to 6 | 6 to 4 |
+---------------+-------------------------+-------------------------+
| Protocol | Pkts | Bytes | Pkts | Bytes |
+---------------+----------+--------------+----------+--------------+
| Total | 11 | 704 | 11 | 704 |
| TCP | 0 | 0 | 0 | 0 |
| UDP | 0 | 0 | 0 | 0 |
| ICMP | 11 | 704 | 11 | 704 |
| Errors | Pkts | Pkts |
+---------------+-------------------------+-------------------------+
| Total | 8 | 4 |
| Illegal Pkt | 0 | 0 |
| Unsup Proto | 0 | 0 |
| No Mapping | 2 | 0 |
Done
CLI 和 API 參考資料
nat64 對應
取得下一個 AddressMapping 資訊 (使用疊代器)。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
示例
nat64 mappings
| | Address | | 4 to 6 | 6 to 4 |
+----------+---------------------------+--------+--------------+--------------+
| ID | IPv6 | IPv4 | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 | 7196s | 6 | 456 | 11 | 1928 |
| | TCP | 0 | 0 | 0 | 0 |
| | UDP | 1 | 136 | 16 | 1608 |
| | ICMP | 5 | 320 | 5 | 320 |
CLI 和 API 參考資料
nat64 狀態
取得 NAT64 函式的狀態。
啟用 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
時,即可使用 PrefixManager
狀態。啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
時,即可使用 Translator
狀態。
如果啟用 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
,PrefixManager
會傳回下列其中一種狀態:
Disabled
:NAT64 前置字串管理員已停用。NotRunning
:NAT64 前置字串管理員已啟用,不過目前並未執行。這可能代表該轉送管理員已停用。Idle
:NAT64 前置字串管理員已啟用且正在執行,但尚未發布 NAT64 前置字串。如果另一個邊界路由器發布了優先順序較高的 NAT64 前置字串,就有可能發生這種情況。Active
:NAT64 前置字串管理員已啟用、執行及發布 NAT64 前置字串。
如果啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
,Translator
會傳回下列其中一種狀態:
Disabled
:NAT64 翻譯器已停用。NotRunning
:NAT64 翻譯器已啟用,但尚未翻譯封包。這可能表示翻譯器未設定 NAT64 前置字串或 NAT64 的 CIDR。Active
:NAT64 翻譯器已啟用且正在翻譯封包。
參數
沒有參數。
示例
nat64 state
PrefixManager: Active
Translator: Active
Done
CLI 和 API 參考資料
鄰點連續時間清單
顯示鄰點的連線時間和年齡。這個指令與 neighbor conntime
類似,但會以清單格式顯示資訊。年齡與連線時間都會顯示以秒為單位。
參數
沒有參數。
示例
neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done
CLI 和 API 參考資料
鄰點
顯示鄰點的連線時間和年齡。每個鄰點的資訊:
- RLOC16
- 延伸 MAC
- 最後收集到的 (存在時間):從鄰居上次聽到後經過的秒數。
- 連線時間:與鄰國連結建立關係的秒數。如果時間長度少於一天,時間長度間隔的格式為
{hh}:{mm}:{ss}
,代表小時、分鐘和秒。如果時間長度超過一天,格式為{dd}d.{hh}:{mm}:{ss}
。
參數
沒有參數。
示例
neighbor conntime
| RLOC16 | Extended MAC | Last Heard (Age) | Connection Time |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 | 00:00:13 | 00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 | 00:00:03 | 00:11:27 |
| 0xe800 | ce53628a1e3f5b3c | 00:00:02 | 00:00:15 |
Done
CLI 和 API 參考資料
鄰近連結品質
列印所有鄰點的連結品質資訊。
參數
沒有參數。
示例
neighbor linkquality
| RLOC16 | Extended MAC | Frame Error | Msg Error | Avg RSS | Last RSS | Age |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db | 0.00 % | 0.00 % | -46 | -48 | 1 |
| 0xc001 | 0ad7ed6beaa6016d | 4.67 % | 0.08 % | -68 | -72 | 10 |
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
鄰點清單
列出每個鄰點的 RLOC16。
參數
沒有參數。
示例
neighbor list
0xcc01 0xc800 0xf000
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
鄰點桌
以表格格式列印所有鄰點的相關資訊。
如果是 Role
,這個資料表可能的值只有 C
(子項) 或 R
(路由器)。
下列資料欄提供鄰居的裝置模式資訊。每一欄的值包括 0
(關閉) 或 1
(開啟)。
R
:閒置時開啟 RXD
:完整 Thread 裝置N
:完整網路資料
參數
沒有參數。
示例
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
CLI 和 API 參考資料
淨數據已滿
列印「yes」或「no」,指示在 Thread 作業開始之後,或上次使用 netdata full reset
重設標記之後,是否已叫用「淨資料完整」回呼。這個指令需要 OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL
。每當以下情況,都會叫用「淨資料已滿」回呼:
- 該裝置已擔任領先者,並從邊界路由器 (BR) 接收「網路資料」註冊,但該裝置無法新增至「網路資料」(空間不足)。
- 裝置做為 BR,無法將新項目新增至當地的網路資料。
- 裝置做為 BR 並嘗試向領導者註冊其區域網路資料項目,但會判斷其本機輸入的項目不符。
參數
沒有參數。
示例
netdata full
no
Done
CLI 和 API 參考資料
netdata 完整重設
重設標記追蹤是否叫用「淨資料完整」。
參數
沒有參數。
示例
netdata full reset
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
netdata 長度
取得分區執行緒網路資料目前的長度 (位元組數)。
參數
沒有參數。
示例
netdata length
23
Done
CLI 和 API 參考資料
netdata maxlength
取得從 OT 堆疊初始化或上次呼叫
otNetDataResetMaxLength()
以來觀察到的 Thread 網路資料長度上限。
參數
沒有參數。
示例
netdata maxlength
40
Done
CLI 和 API 參考資料
重設 netdata maxlength
重設追蹤的 Thread 網路資料長度上限。
參數
沒有參數。
示例
netdata maxlength reset
Done
CLI 和 API 參考資料
netdata 發布 DNSsrp Anycast
發布含有序號的 DNS/SRP 服務 Anycast 位址。系統會移除透過先前的 publish dnssrp{anycast|unicast}
指令發布的任何目前 DNS/SRP 服務項目,並以新引數取代。
必須啟用 OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
。
參數
netdata publish dnssrp anycast seq-num
示例
netdata publish dnssrp anycast 1
Done
CLI 和 API 參考資料
- netdata 發布 dnssrp unicast (新增、通訊埠)
- netdata 發布 dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
netdata publish dnssrp unicast (新增、通訊埠)
發布含有位址和通訊埠號碼的 DNS/SRP 服務 Unicast 位址。服務 TLV 資料中包含地址和通訊埠資訊。系統會移除透過先前的 publish dnssrp{anycast|unicast}
指令發布的任何目前 DNS/SRP 服務項目,並以新引數取代。
必須啟用 OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
。
參數
netdata publish dnssrp unicast address port
示例
netdata publish dnssrp unicast fd00::1234 51525
Done
CLI 和 API 參考資料
netdata 發布 DNS 單點傳播 (mle)
以通訊埠編號發布裝置的網格-本機 EID。伺服器 TLV 資料中包含 MLE 和通訊埠資訊。如要使用其他 Unicast 位址,請使用 netdata publish dnssrp unicast (addr,port)
指令。
系統會移除透過先前的 publish dnssrp{anycast|unicast}
指令發布的任何目前 DNS/SRP 服務項目,並以新引數取代。
必須啟用 OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
。
參數
netdata publish dnssrp unicast port
示例
netdata publish dnssrp unicast 50152
Done
CLI 和 API 參考資料
- netdata 發布 dnssrp unicast (新增、通訊埠)
- netdata 發布 dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
netdata 發布前置字串
發布位於網狀網路的前置字串項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」。
參數
netdata publish prefix prefix [padcrosnD] [high|med|low]
OT CLI 會使用對應的引數來設定 otBorderRouterConfig 值。詳情請參閱 OpenThread CLI 總覽。
示例
netdata publish prefix fd00:1234:5678::/64 paos med
Done
CLI 和 API 參考資料
Netdata 發布替換
取代先前發布的外部路徑項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」。
參數
netdata publish replace oldprefix prefix [sn] [high|med|low]
OT CLI 會使用對應的引數來設定 otExternalRouteConfig 值。詳情請參閱 OpenThread CLI 總覽。
示例
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
CLI 和 API 參考資料
netdata 發布路徑
發布外部路徑項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」。
參數
publish route prefix [sn] [high|med|low]
OT CLI 會使用對應的引數來設定 otExternalRouteConfig 值。詳情請參閱 OpenThread CLI 總覽。
示例
netdata publish route fd00:1234:5678::/64 s high
Done
CLI 和 API 參考資料
網路資料暫存器
向領導者註冊設定的前置字串、路徑和服務。
針對 OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
的 OT CLI 檢查。如果已啟用 OTBR,則向領導者註冊本機網路資料。否則,會呼叫 CLI 函式 otServerRegister
。詳情請參閱「使用 OT CLI 顯示及管理網路資料」。
參數
沒有參數。
示例
netdata register
Done
CLI 和 API 參考資料
netdata 導引資料檢查 (較學)
檢查導引資料是否包含具有指定離散值的彙整器。
參數
netdata steeringdata check discerner
discerner
:格式為{number}/{length}
的彙整卡。
示例
netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound
CLI 和 API 參考資料
netdata 導引資料檢查 (eui64)
檢查導引資料是否包含彙整器。
參數
netdata steeringdata check eui64
eui64
:彙整器的 IEEE EUI-64。
示例
netdata steeringdata check d45e64fa83f81cf7
Done
CLI 和 API 參考資料
netdata unpublish (前置字元)
取消發布先前發布的「網格」或「外部路徑前置字串」。
必須啟用 OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
。
詳情請參閱「使用 OT CLI 顯示及管理網路資料」。
參數
netdata unpublish prefix
示例
netdata unpublish fd00:1234:5678::/64
Done
CLI 和 API 參考資料
netdata unpublish dnssrp
取消發布 Thread 網路資料中任何先前新增的 DNS/SRP (Anycast 或 Unicast) 服務項目。
必須啟用 OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
。
參數
沒有參數。
示例
netdata unpublish dnssrp
Done
CLI 和 API 參考資料
淨統計資料
取得 UDP 通訊端連結清單的標題。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
網路診斷取得
傳送網路診斷要求,以擷取指定地址的指定類型長度值 (TLV)。
參數
networkdiagnostic get addr type(s)
對於 addr
,單點傳播位址會觸發 Diagnostic Get
。多點傳播位址會觸發 Diagnostic Query
。可以指定的 TLV 值 (如果您指定多個 TLV,請以空格分隔):
0
:MAC 擴充位址 TLV1
:Address16 TLV2
:模式 TLV3
:逾時 TLV (SED 的輪詢時間範圍上限)4
:連線 TLV5
:Route64 TLV6
:主要資料領袖7
:網路資料 TLV8
:IPv6 位址清單 TLV9
:MAC 計數器 TLV14
:電池電量 TLV15
:供應電壓 TLV16
:子項資料表 TLV17
:頻道頁面 TLV19
:子項逾時上限 TLV23
:EUI64 TLV24
:TLV 版本 (通訊協定和功能的版本號碼)25
:供應商名稱 TLV26
:廠商型號 TLV27
:供應商軟體版本 TLV28
:執行緒堆疊版本 TLV (Thread 堆疊程式碼集/修訂版本/版本的版本 ID 為 UTF-8 字串)29
:子項 TLV34
:MLE 計數器重點摘要35
:供應商應用程式網址 TLV
示例
networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
PartitionId: 0x640b0f67
Weighting: 64
DataVersion: 116
StableDataVersion: 197
LeaderRouterId: 0x03
EUI64: 18b4300000000004
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
CLI 和 API 參考資料
重設網路診斷
傳送網路診斷要求,重設指定位址上的指定類型長度值 (TLV)。這個指令僅支援下列 TLV 值:9
(MAC 計數器 TLV) 或 34
(MLE 計數器 TLV)
參數
networkdiagnostic reset addr type(s)
示例
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
CLI 和 API 參考資料
networkidtimeout (get,set)
取得或設定 NETWORK_ID_TIMEOUT
參數。
參數
networkidtimeout [timeout]
使用選用的 timeout
引數來設定 NETWORK_ID_TIMEOUT
參數值。
示例
networkidtimeout 120
Done
networkidtimeout
120
Done
CLI 和 API 參考資料
網路金鑰 (金鑰)
設定 Thread 網路金鑰。
只有在 Thread 通訊協定停用時才會成功。成功呼叫這個函式後,會在非揮發性記憶體中撤銷有效和待處理作業資料集。
參數
networkkey key
示例
networkkey 00112233445566778899aabbccddeeff
Done
CLI 和 API 參考資料
網路金鑰
取得 Thread 網路金鑰。
參數
沒有參數。
示例
networkkey
00112233445566778899aabbccddeeff
Done
CLI 和 API 參考資料
網路名稱 (名稱)
設定 Thread 網路名稱。
只有在 Thread 通訊協定停用時才會成功。成功呼叫這個函式後,會在非揮發性記憶體中撤銷有效和待處理作業資料集。
參數
networkname name
示例
networkname OpenThread
Done
CLI 和 API 參考資料
網路名稱
取得 Thread 網路名稱。
參數
沒有參數。
示例
networkname
OpenThread
Done
CLI 和 API 參考資料
網路時間 (設定)
設定時間同步處理參數。
timesyncperiod
:時間同步處理期間,以秒為單位。xtalthreshold
:在 PPM 中成為裝置成為路由器支援的 XTAL 準確度門檻。
參數
networktime timesyncperiod xtalthreshold
示例
networktime 100 300
Done
CLI 和 API 參考資料
網路時間
取得 Thread 網路時間和時間同步參數。
參數
沒有參數。
示例
networktime
Network Time: 21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold: 300ppm
Done
CLI 和 API 參考資料
Nexthop (取得)
取得到達指定 RLOC16 目的地的下一個躍點和路徑費用。
可與 aNextHopRloc16
或 aPathCost
搭配使用時為 NULL,表示呼叫端不想取得這個值。
參數
nexthop rloc16
示例
nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done
CLI 和 API 參考資料
下一個躍點
各個路由器的已分配路由器 ID 及目前下一個躍點和路徑費用的輸出資料表。
參數
沒有參數。
示例
nexthop
| ID |NxtHop| Cost |
+------+------+------+
| 9 | 9 | 1 |
| 25 | 25 | 0 |
| 30 | 30 | 1 |
| 46 | - | - |
| 50 | 30 | 3 |
| 60 | 30 | 2 |
Done
CLI 和 API 參考資料
panid (panid)
設定 IEEE 802.15.4 PAN ID。
只有在 Thread 通訊協定停用時才會成功。如果對這個函式成功呼叫,也會在非揮發性記憶體中,撤銷「運作中」和「待處理」作業資料集。
參數
panid panid
示例
panid 0xdead
Done
CLI 和 API 參考資料
恐慌遊戲
取得 IEEE 802.15.4 PAN ID。
參數
沒有參數。
示例
panid
0xdead
Done
CLI 和 API 參考資料
parent
取得 Thread 路由器的診斷資訊 (做為父項)。
在 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 啟用的情況下以 Thread 路由器運作時,這個指令會傳回之前以 Thread 子項形式連接裝置時的快取資訊。系統必須傳回快取資訊才能支援 Thread 測試硬性。測試情境 8.2.x 會要求先前的父項 (即彙整器路由器) MAC 位址,即使裝置已升級為路由器也一樣。
參數
沒有參數。
示例
parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done
CLI 和 API 參考資料
家長搜尋
啟動孩子搜尋更適合的父項,同時與目前父項保持連結狀態。
連接裝置做為孩童時必須使用。
參數
沒有參數。
示例
parent search
Done
CLI 和 API 參考資料
parentPriority (get,set)
取得或設定指派的父項優先順序值:1、0、-1 或 -2。-2 表示未指派。
參數
parentpriority [parentpriority]
示例
parentpriority
1
Done
parentpriority 1
Done
CLI 和 API 參考資料
分區
取得 Thread 網路分區 ID。
參數
沒有參數。
示例
partitionid
4294967295
Done
CLI 和 API 參考資料
優先使用分區 (get,set)
「OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
」為必填欄位。
參數
partitionid preferred partitionid
示例
partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done
CLI 和 API 參考資料
platform
列印目前的平台
參數
沒有參數。
示例
platform
NRF52840
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
輪詢週期 (get,set)
取得或設定休眠端裝置 (毫秒) 的自訂資料輪詢期間。僅適用於認證測試。
參數
沒有參數。
示例
pollperiod
0
Done
pollperiod 10
Done
CLI 和 API 參考資料
偏好路線
指定主要路由器 ID。
參數
preferrouterid routerid
示例
preferrouterid 16
Done
CLI 和 API 參考資料
前置字元新增
將有效的前置字串加入「網路資料」。
參數
prefix add prefix [padcrosnD] [high|med|low]
OT CLI 會使用對應的引數來設定 otBorderRouterConfig 值。詳情請參閱 OpenThread CLI 總覽。
示例
prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done
CLI 和 API 參考資料
前置字串網狀本機
取得網格本機前置字串。
參數
沒有參數。
示例
prefix meshlocal
fdde:ad00:beef:0::/64
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
前置字串
取得區域網路資料中的前置字串清單。
如要進一步瞭解 otBorderRouterConfig 旗標,請參閱「OpenThread CLI 總覽」。
參數
沒有參數。
示例
prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done
CLI 和 API 參考資料
移除前置字元
從區域網路資料中移除邊界路由器設定。
參數
沒有參數。
示例
prefix remove 2001:dead:beef:cafe::/64
Done
CLI 和 API 參考資料
混雜 (啟用、停用)
啟用或停用連結層普立模式。
參數
promiscuous enable|disable
示例
promiscuous enable
Done
promiscuous disable
Done
CLI 和 API 參考資料
混雜
指出連結圖層是否已啟用普立模式。
參數
沒有參數。
示例
promiscuous
Disabled
Done
CLI 和 API 參考資料
pskc (設定)
設定 pskc 十六進位格式。
參數
pskc key
示例
pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
PSK-P
使用通關密語 (以 UTF-8 編碼編碼) 產生 pskc,以及目前的網路名稱和擴充的 PAN ID。
參數
pskc -p passphrase
示例
pskc -p 123456
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
PSKC
取得 Thread PSKc。
參數
沒有參數。
示例
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI 和 API 參考資料
pskcref (設定)
將金鑰參照設為 Thread PSKc。
必須啟用建構時間功能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
。
只有在 Thread 通訊協定停用時才會成功。成功執行時,這麼做也會使記憶體位於非可變記憶體中的「有效」和「待處理」作業資料集。
參數
pskc keyref
示例
pskc 0x20017
Done
CLI 和 API 參考資料
普斯科夫
取得已儲存的 Thread PSKc 金鑰參照。
必須啟用建構時間功能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
。
參數
沒有參數。
示例
pskcref
0x80000000
Done
CLI 和 API 參考資料
無線電 (啟用、停用)
啟用或停用無線電。
參數
radio enable|disable
示例
radio enable
Done
radio disable
Done
CLI 和 API 參考資料
清除電台統計資料
重設無線電統計資料。
所有時間都會重設為 0。
參數
沒有參數。
示例
radio stats clear
Done
CLI 和 API 參考資料
電台統計資料
取得無線電統計資料。
無線電統計資料包括電台處於 TX/RX/睡眠狀態的時間。這些時間以微秒為單位。所有時間都是從上次重設無線電統計資料計算。
參數
沒有參數。
示例
radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done
CLI 和 API 參考資料
rcp 版本
取得無線電版本字串。
參數
沒有參數。
示例
rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun 4 2020 17:53:16
Done
CLI 和 API 參考資料
區域 (設定)
設定區碼。
無線電區域格式為 ISO 3166 alpha-2 代碼的 2 位元組 ASCII 表示法。
變更這項設定可能會影響傳輸功率限制。
參數
沒有參數。
示例
region US
Done
CLI 和 API 參考資料
地區
取得區碼。
無線電區域格式為 ISO 3166 alpha-2 代碼的 2 位元組 ASCII 表示法。
參數
沒有參數。
示例
region
US
Done
CLI 和 API 參考資料
Releaserouterid (routerid)
釋出裝置成為主要角色角色的路由器 ID。
參數
releaserouterid [routerid]
示例
releaserouterid 16
Done
CLI 和 API 參考資料
rloc16
取得 RLOC16。
參數
沒有參數。
示例
rloc16
0xdead
Done
CLI 和 API 參考資料
新增路線
參數請使用:
- s:穩定版標記
- n:NAT64 標記
- prf:預設路由器偏好設定,[high, med, low]。
為「網路資料」新增有效的外部路徑。
參數
route add prefix [sn] [high|med|low]
示例
route add 2001:dead:beef:cafe::/64 s med
Done
CLI 和 API 參考資料
移除路線
從本機網路資料中移除外部路徑設定。
參數
route remove [prefix]
示例
route remove 2001:dead:beef:cafe::/64
Done
CLI 和 API 參考資料
路徑
取得區域網路資料中的外部路徑清單。
參數
沒有參數。
示例
route
2001:dead:beef:cafe::/64 s med
Done
CLI 和 API 參考資料
路由器 (ID)
函式會保留指定 Thread 路由器的診斷資訊。
列印 Thread 路由器的診斷資訊。ID 可以是路由器 ID 或 RLOC16。
參數
router [id]
示例
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
CLI 和 API 參考資料
路由器清單
列出分配的路由器 ID。
參數
沒有參數。
示例
router list
8 24 50
Done
CLI 和 API 參考資料
路由器表格
以表格格式列印路由器清單。
參數
沒有參數。
示例
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
CLI 和 API 參考資料
路由器降級門檻 (取得、設定)
取得或設定 ROUTER_DOWNGRADE_THRESHOLD 值。
參數
routerdowngradethreshold [threshold]
示例
routerdowngradethreshold
23
Done
routerdowngradethreshold 23
Done
CLI 和 API 參考資料
路由器符合資格 (啟用、停用)
啟用或停用路由器角色。
參數
routereligible [enable|disable]
示例
routereligible enable
Done
routereligible disable
Done
CLI 和 API 參考資料
符合路由器資格
指出路由器角色已啟用或已停用。
參數
沒有參數。
示例
routereligible
Enabled
Done
CLI 和 API 參考資料
路由器選擇機
取得或設定 ROUTER_SELECTION_JITTER 值。
參數
routerselectionjitter [jitter]
示例
routerselectionjitter
120
Done
routerselectionjitter 120
Done
CLI 和 API 參考資料
路由器升級門檻 (取得、設定)
取得或設定 ROUTER_UPGRADE_THRESHOLD 值。
參數
routerupgradethreshold [threshold]
示例
routerupgradethreshold
16
Done
routerupgradethreshold 16
Done
CLI 和 API 參考資料
掃描能量
執行 IEEE 802.15.4 能源掃描,並顯示掃描每個通道所花費的時間 (以毫秒為單位)。除非你使用頻道選項指定特定頻道,否則系統會顯示所有頻道。
參數
scan energy [duration] [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
CLI 和 API 參考資料
掃描
執行 IEEE 802.15.4 掃描。如果沒有指定頻道,掃描作業就會涵蓋所有頻道;否則,跨距僅涵蓋指定的頻道。
參數
scan [channel]
示例
scan
| PAN | MAC Address | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
CLI 和 API 參考資料
服務新增
將服務新增至網路資料。
- enterpriseNumber:IANA 企業編號
- serviceData:十六進位編碼的二進位服務資料
- ServerData:十六進位編碼的二進位伺服器資料
參數
service add enterpriseNumber serviceData serverData
示例
service add 44970 112233 aabbcc
Done
netdata register
Done
CLI 和 API 參考資料
服務移除
從網路資料中移除服務。
- enterpriseNumber:IANA 企業編號
- serviceData:十六進位編碼的二進位服務資料
參數
service remove enterpriseNumber serviceData
示例
service remove 44970 112233
Done
netdata register
Done
CLI 和 API 參考資料
單例模式
表示節點是否為網路上唯一的路由器。傳回 true
或 false
。
參數
沒有參數。
示例
singleton
true
Done
CLI 和 API 參考資料
Sntp 查詢
傳送 SNTP 查詢,取得目前的 Unix Epoch 紀元時間 (自 1970 年 1 月 1 日起)。
- SNTP 伺服器預設 IP 位址:
2001:4860:4806:8::
(Google IPv6 NTP 伺服器) - SNTP 伺服器預設通訊埠:
123
參數
sntp query [SNTP server IP] [SNTP server port]
示例
sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done
CLI 和 API 參考資料
RSA 用戶端自動啟動 (取得)
指出自動開始模式目前的狀態 (啟用或停用)。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp client autostart
Disabled
Done
CLI 和 API 參考資料
Srp 用戶端自動啟動停用
停用自動開始模式。
停用自動開始模式不會讓執行中的用戶端停止。但 SRP 用戶端會停止監控 Thread 網路資料。
參數
沒有參數。
示例
srp client autostart disable
Done
CLI 和 API 參考資料
啟用 TLS 用戶端自動啟動功能
啟用自動開始模式。
自動開始啟用後,SRP 用戶端會監控 Thread 網路資料,找出 SRP 伺服器、選取偏好的伺服器,以及在偵測到 SRP 伺服器時自動啟動及停止用戶端。
三個類別的網路資料項目代表是否有 SRP 伺服器,且優先順序如下:
- 服務資料中包含伺服器位址的 Unicast 項目。如果有多個選項,建議您選擇數值最低的 IPv6 位址。
- 每個播送項目都有序號。建議採用 RFC-1982 中由序號演算法指定的最大序號。
- 伺服器資料中包含伺服器位址資訊的 Unicast 項目。如果有多個選項,建議您選擇數值最低的 IPv6 位址。
參數
沒有參數。
示例
srp client autostart enable
Done
CLI 和 API 參考資料
srp 用戶端回呼 (get、enable、停用)
從 SRP 用戶端取得或啟用/停用列印回呼事件。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client callback [enable|disable]
示例
srp client callback enable
Done
srp client callback
Enabled
Done
CLI 和 API 參考資料
RSA 用戶端主機位址 (取得)
指出自動地址模式是否已啟用。如果未啟用自動地址模式,系統會傳回 SRP 用戶端主機位址清單。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp client host address
auto
Done
srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done
CLI 和 API 參考資料
Srp 用戶端主機位址 (設定)
啟用自動主機位址模式或明確設定主機位址清單。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client host address [auto|address...]
- 使用
auto
參數啟用自動主機位址模式。啟用後,用戶端會自動使用所有偏好的 Threadnetif
單點傳播位址,但連結本機和網格本機位址除外。如果沒有有效的位址,系統會新增網狀本機 EID 位址。如果 Threadnetif
上的地址新增或移除,或標示為不偏好,SRP 用戶端會自動重新註冊。 - 明確指定主機位址清單,以空格分隔每個位址。您可以在用戶端執行時設定這份清單。這麼做也會停用自動主機位址模式。
示例
srp client host address auto
Done
srp client host address fd00::cafe
Done
CLI 和 API 參考資料
清除 HTTP 用戶端主機
清除所有主機資訊和所有服務。
參數
沒有參數。
示例
srp client host clear
Done
CLI 和 API 參考資料
RSA 用戶端主機名稱 (get,set)
取得或設定 SRP 用戶端的主機名稱。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client host name [name]
如要在主機移除或尚未向伺服器註冊後,設定用戶端主機名稱,請使用 name
參數。
示例
srp client host name dev4312
Done
srp client host name
dev4312
Done
CLI 和 API 參考資料
移除 TLS 用戶端主機
從 SRP 伺服器中移除 SRP 用戶端主機資訊和所有服務。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client host remove [removekeylease] [sendunregtoserver]
removekeylease
參數是選用的布林值,表示是否也應移除主機金鑰釋出 (預設為false
)。sendunregtoserver
參數是選用的布林值,指出用戶端主機是否應該向伺服器傳送「update」訊息,即使用戶端主機資訊尚未向伺服器註冊 (預設值為false
)。只有在指令中先指定removekeylease
參數後,才能指定這個參數。
示例
srp client host remove 1
Done
CLI 和 API 參考資料
RSA 用戶端主機
取得主機資訊。
參數
沒有參數。
示例
srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done
CLI 和 API 參考資料
TLS 用戶端主機狀態
傳回 SRP 用戶端主機的狀態。可能的狀態:
ToAdd
:要新增/註冊的項目。Adding
:正在新增/註冊項目。ToRefresh
:為了租借而重新整理項目。Refreshing
:已重新整理項目。ToRemove
:要移除的項目。Removing
:正在移除項目。Registered
:項目已在伺服器註冊。Removed
:已移除項目。
參數
沒有參數。
示例
srp client host state
Registered
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
srp 用戶端 keyleaseinterval (get,set)
取得或設定金鑰的釋出間隔秒數。
參數
srp client keyleaseinterval [interval]
示例
srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done
CLI 和 API 參考資料
srp 用戶端租賃間隔 (get,set)
取得或設定租用間隔 (以秒為單位)。
參數
srp client leaseinterval [interval]
示例
srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done
CLI 和 API 參考資料
RSA 用戶端伺服器位址
傳回伺服器的 IPv6 位址。
參數
沒有參數。
示例
srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
Srp 用戶端伺服器通訊埠
傳回伺服器的通訊埠號碼。
參數
沒有參數。
示例
srp client server port
4724
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
RSA 用戶端伺服器
取得 SRP 用戶端目前使用的 SRP 伺服器通訊端位址 (IPv6 位址和通訊埠號碼)。如果用戶端並未執行,系統會未指定位址 (所有零),通訊埠號碼為 0。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done
CLI 和 API 參考資料
RSA 客戶服務新增
新增具有特定執行個體名稱、服務名稱及通訊埠編號的服務。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client service add instancename servicename port [priority] [weight] [txt]
servicename
參數可選擇加入以半形逗號分隔的服務子類型標籤清單。此處的範例使用一般的命名方式。priority
和 weight
(兩者皆為 uint16_t
值) 參數為選用,如未提供零,系統會使用零。選用的 txt
參數會設定與服務相關聯的 TXT 資料。txt
值必須使用十六進位字串格式,且系統會將其視為已編碼的 TXT 資料位元組序列。
示例
srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done
CLI 和 API 參考資料
srp 用戶端服務金鑰 (get、set)
取得或設定 SRP 用戶端中的服務金鑰記錄納入模式。這個指令僅供測試,且必須啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp client service key enable
Done
srp client service key
Enabled
Done
CLI 和 API 參考資料
清除 RSA 客戶服務名稱
清除服務,立即從用戶端服務清單中移除,且沒有與 SRP 伺服器互動。
參數
srp client service clear instancename servicename
示例
srp client service clear ins2 _test2._udp
Done
CLI 和 API 參考資料
移除 RSA 客戶服務
要求向 SRP 伺服器取消註冊服務。
參數
srp client service remove instancename servicename
示例
srp client service remove ins2 _test2._udp
Done
CLI 和 API 參考資料
RSA 客戶服務
取得用戶端管理的服務清單。
參數
沒有參數。
示例
srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done
CLI 和 API 參考資料
TLS 用戶端開始
啟動 SRP 用戶端作業。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp client start serveraddr serverport
示例
srp client start fd00::d88a:618b:384d:e760 4724
Done
CLI 和 API 參考資料
TLS 用戶端狀態
指出 SRP 用戶端是否正在執行。
參數
沒有參數。
示例
srp client state
Enabled
Done
CLI 和 API 參考資料
RSA 用戶端停止
停止 SRP 用戶端作業。
停止與 SRP 伺服器的任何進一步互動。請注意,系統不會移除或清除主機資訊和/或服務清單。這會在用戶端啟動 (重新啟動) 後,再次新增/移除所有服務。
參數
沒有參數。
示例
srp client stop
Done
CLI 和 API 參考資料
srp 用戶端 ttl (get,set)
以秒為單位取得或設定 ttl
(存留時間) 值。
參數
srp client ttl [value]
示例
srp client ttl 3600
Done
srp client ttl
3600
Done
CLI 和 API 參考資料
srp 伺服器 (啟用、停用)
啟用或停用 SRP 伺服器。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp server [enable|disable]
示例
srp server disable
Done
CLI 和 API 參考資料
srp 伺服器 addrmode (get,set)
取得或設定 SRP 伺服器所使用的地址模式。
位址模式會指示 SRP 伺服器如何判斷位址和通訊埠號碼,並發布在 Thread 網路資料中。
參數
srp server addrmode [anycast|unicast]
示例
srp server addrmode anycast
Done
srp server addrmode
anycast
Done
CLI 和 API 參考資料
srp 伺服器自動 (啟用、停用)
啟用或停用 SRP 伺服器上的自動啟用模式。
啟用此模式時,邊界轉送管理員會控制要啟用或停用 SRP 伺服器的時機和情況。
必須啟用 OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE
,才能使用這個指令。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
srp server auto [enable|disable]
示例
srp server auto enable
Done
srp server auto
Enabled
Done
CLI 和 API 參考資料
srp 伺服器網域 (get,set)
取得或設定 SRP 伺服器的網域名稱。
參數
srp server domain [domain-name]
示例
srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done
CLI 和 API 參考資料
RSA 伺服器主機
傳回所有已註冊主機的相關資訊。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp server host
srp-api-test-1.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
CLI 和 API 參考資料
srp 伺服器租賃 (get,set)
取得或設定 SRP 伺服器釋出值 (以秒數為單位)。
參數
srp server lease [min-lease max-lease min-key-lease max-key-lease]
示例
srp server lease 1800 7200 86400 1209600
Done
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done
CLI 和 API 參考資料
srp 伺服器 Seqnum (get,set)
取得或設定 Anycast 位址模式使用的序號。序號包含在發布於「網路資料」的「DNS/SRP 服務任意傳播位址」項目中。
參數
srp server seqnum [seqnum]
示例
srp server seqnum 20
Done
srp server seqnum
20
Done
CLI 和 API 參考資料
RSA 伺服器服務
傳回已註冊服務的相關資訊。
TXT
記錄會以項目陣列的形式顯示。如果項目包含金鑰,則該金鑰會以 ASCII 格式列印。值部分會以十六進制位元組列印。詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
deleted: false
subtypes: (null)
port: 49152
priority: 0
weight: 0
ttl: 7200
lease: 7200
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-1.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
deleted: false
subtypes: _sub1,_sub2
port: 49152
priority: 0
weight: 0
ttl: 3600
lease: 3600
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-0.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
CLI 和 API 參考資料
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
TLS 伺服器狀態
傳回下列其中一種 SRP 伺服器可能的狀態:
disabled
:未啟用 SRP 伺服器。stopped
:SRP 伺服器已啟用,但因 Thread 網路中已有運作中的 SRP 伺服器而未啟用。如果 Thread 網路中不再有使用現有的 SRP 伺服器,SRP 伺服器可能就會處於啟用狀態。running
:SRP 伺服器已啟用,可處理服務註冊。
詳情請參閱「使用 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器用戶端連線」。
參數
沒有參數。
示例
srp server state
running
Done
CLI 和 API 參考資料
state
傳回 Thread 裝置目前的角色,或變更先前使用其中一個選項指定的角色。詢問裝置角色時,系統傳回的值可能包括:
child
:裝置目前搭載的是 Thread 子項。router
:裝置目前當做 Thread 路由器運作。leader
:裝置目前做為 Thread 負責人。detached
:裝置目前未加入 Thread 網路/分區。disabled
:執行緒堆疊目前已停用。
使用其中一個選項即可變更裝置目前的角色,但不包括變更為 disabled
狀態。
參數
state [child|router|leader|detached]
示例
state
child
Done
state leader
Done
CLI 和 API 參考資料
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
TCP 取消
不謹慎地結束與範例 TCP 端點相關聯的 TCP 連線,將 TCP 端點變更為已關閉狀態。
參數
沒有參數。
示例
tcp abort
TCP: Connection reset
Done
CLI 和 API 參考資料
TCP 基準結果
顯示 TCP 基準測試的最新結果。可能的狀態值如下:
- 作用中
- 已完成
- 未測試
這個指令主要用於建立可自動執行 TCP 基準測試的指令碼。
參數
沒有參數。
示例
tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s
CLI 和 API 參考資料
- 沒有相關聯的 API
TCP 基準執行作業
使用目前與 tcp
CLI 提供的範例 TCP 端點相關聯的 TCP 連線,來傳輸指定的位元組數。
參數
tcp benchmark run [size]
使用 size
參數指定要為基準測試傳送的位元組數。如未使用 size
參數,系統會使用預設值 (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
)。
示例
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
CLI 和 API 參考資料
- 沒有相關聯的 API
繫結
將 IPv6 位址和通訊埠與 tcp
CLI 提供的範例 TCP 端點建立關聯。將 TCP 端點與 IPv6 位址和通訊埠建立關聯,稱為「為 TCP 端點命名」。這會繫結端點以進行通訊。詳情請參閱使用 OT CLI 測試 TCP 功能。
參數
tcp bind ip port
ip
:要繫結的 IPv6 位址。如要讓 TCP/IPv6 堆疊指派繫結 IPv6 位址,請使用未指定的 IPv6 位址:::
。port
:要繫結的 TCP 通訊埠編號。
示例
tcp bind :: 30000
Done
CLI 和 API 參考資料
tcp Connect
使用指定的對等點建立連線。
如果連線建立成功,產生的 TCP 連線就會與範例 TCP 端點建立關聯。詳情請參閱使用 OT CLI 測試 TCP 功能。
參數
tcp connect ip port [fastopen]
ip
:對等點的 IP 位址可以是 IPv4 位址,且會使用網路資料中偏好的 NAT64 前置字串,將網際網路合成為 IPv6 位址。無法使用偏好的 NAT64 前置字串時,這個指令會傳回InvalidState
。port
:對等互連的 TCP 通訊埠編號。fastopen
:此為選用參數。如果設為fast
,表示此連線已啟用 TCP Fast Open。否則,如果將這個參數設為slow
或不使用,系統會停用 TCP Fast Open。
示例
tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
CLI 和 API 參考資料
tcp deinit
取消初始化這個 TCP 端點。
這表示 OpenThread 不會再追蹤此 TCP 端點,並釋放內部分配給此 TCP 端點的所有資源。應用程式可以在適當的情況下,重複使用支援 TCP 端點的記憶體。
如果對應於即時的 TCP 連線,系統會不謹慎地終止連線 (如 otTcpAbort() 所示)。應用程式為這個 TCP 端點提供的所有資源 (連結傳送緩衝區的已連結緩衝區、接收緩衝區的記憶體、aEndpoint
結構本身等) 會立即傳回應用程式。
參數
沒有參數。
示例
tcp deinit
Done
CLI 和 API 參考資料
tcp init
初始化範例 TCP 事件監聽器和 tcp
CLI 提供的範例 TCP 端點。
參數
tcp init [mode] [size]
mode
有三個可能的值:tls
:指定兩個節點之間的 TCP 連線也應使用 TCP 上的 TLS 通訊協定。當兩個節點透過 TCP 進行通訊時,兩個節點都必須使用 TLS,或是完全不使用 TLS,因為非 TLS 端點無法與 TLS 端點通訊。linked
或circular
:以上任一選項,都代表不使用 TLS,而且指定緩衝類型應用於 TCP 緩衝。linked
和circular
的行為完全相同。請檢查程式碼,瞭解這兩種緩衝類型之間的差異。TCP 連線的兩個端點不需要使用相同的緩衝類型。
size
參數會設定要與範例 TCP 端點建立關聯的接收緩衝區大小。如果未指定,系統會使用大小上限。大小上限是在OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
中設定。
示例
tcp init tls
Done
CLI 和 API 參考資料
tcp Listen
使用範例 TCP 事件監聽器監聽指定 IPv6 位址和通訊埠的連入連線。詳情請參閱使用 OT CLI 測試 TCP 功能。
參數
tcp listen ip port
以下是必要參數:
ip
:IPv6 位址或tcp
CLI 範例 TCP 事件監聽器提供的未指定 IPv6 位址 (::
)。port
:範例 TCP 事件監聽器的 TCP 通訊埠。如果 TCP 端點未與範例 TCP 端點相關聯,系統會接受任何符合指定 IPv6 位址和通訊埠的傳入連線,並與範例 TCP 端點建立關聯。
示例
tcp listen :: 30000
Done
CLI 和 API 參考資料
TCP 傳送
透過與 tcp
CLI 提供的範例 TCP 端點相關聯的 TCP 連線傳送資料。詳情請參閱使用 OT CLI 測試 TCP 功能。
參數
tcp send message
message
參數包含要傳送到遠端 TCP 端點的訊息。
示例
tcp send hello
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
TCP 傳送
透過與 tcp
CLI 提供的範例 TCP 端點相關聯的 TCP 連線,傳送「串流結束」信號。這會提醒對等點其不會再透過這個 TCP 連線接收任何資料。
參數
沒有參數。
示例
tcp sendend
Done
CLI 和 API 參考資料
tcp stoplistening
指示 TCP 事件監聽器範例以停止監聽傳入的 TCP 連線。
參數
沒有參數。
示例
tcp stoplistening
Done
CLI 和 API 參考資料
討論串開始
啟動 Thread 通訊協定作業。
參數
沒有參數。
示例
thread start
Done
CLI 和 API 參考資料
執行緒停止
停止 Thread 通訊協定作業。
參數
沒有參數。
示例
thread stop
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
討論串版本
取得 Thread 通訊協定版本。
參數
沒有參數。
示例
thread version
2
Done
CLI 和 API 參考資料
timeinqueue 最大值
取得 TX 佇列中訊息排入佇列的最大值。
需要 OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
。
系統只會追蹤直接傳輸佇列中的佇列時間,並測量從將訊息加入傳送佇列開始,直到訊息傳送到 MAC 層以進行傳送或捨棄。
您可以呼叫
otThreadResetTimeInQueueStat()
重設已收集的統計資料。
參數
沒有參數。
示例
timeinqueue max
281
Done
CLI 和 API 參考資料
已重設時間排入佇列
重設 TX 佇列中等待時間的統計資料。
需要 OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
。
參數
沒有參數。
示例
timeinqueue reset
Done
CLI 和 API 參考資料
時間排入佇列
針對 TX 佇列中的訊息取得排入佇列的時間直方圖。
需要 OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
。
收集傳輸佇列中訊息排入佇列的直方圖。系統只會追蹤直接傳輸佇列中的佇列時間,並測量從將訊息加入傳送佇列開始,直到訊息傳送到 MAC 層以進行傳送或捨棄。
直方圖會以 uint32_t
值的陣列的形式傳回,其中包含 aNumBins
項目。陣列中的第一個項目 (位於索引 0) 表示佇列中的時間少於 aBinInterval
的訊息數量。第二個項目代表佇列中的訊息數量大於或等於 aBinInterval
,但小於 2 * aBinInterval
。依此類推。最後一個項目代表佇列中的訊息數量大於或等於 (aNumBins - 1) * aBinInterval
,
您可以呼叫
otThreadResetTimeInQueueStat()
重設已收集的統計資料。當 OpenThread 執行個體初始化,或自上次呼叫
otThreadResetTimeInQueueStat()
重設統計資料集合以來,系統都會收集直方圖資訊。
指標 aNumBins
和 aBinInterval
不得為空值。
參數
沒有參數。
示例
timeinqueue
| Min | Max |Msg Count|
+------+------+---------+
| 0 | 9 | 1537 |
| 10 | 19 | 156 |
| 20 | 29 | 57 |
| 30 | 39 | 108 |
| 40 | 49 | 60 |
| 50 | 59 | 76 |
| 60 | 69 | 88 |
| 70 | 79 | 51 |
| 80 | 89 | 86 |
| 90 | 99 | 45 |
| 100 | 109 | 43 |
| 110 | 119 | 44 |
| 120 | 129 | 38 |
| 130 | 139 | 44 |
| 140 | 149 | 35 |
| 150 | 159 | 41 |
| 160 | 169 | 34 |
| 170 | 179 | 13 |
| 180 | 189 | 24 |
| 190 | 199 | 3 |
| 200 | 209 | 0 |
| 210 | 219 | 0 |
| 220 | 229 | 2 |
| 230 | 239 | 0 |
| 240 | 249 | 0 |
| 250 | 259 | 0 |
| 260 | 269 | 0 |
| 270 | 279 | 0 |
| 280 | 289 | 0 |
| 290 | 299 | 1 |
| 300 | 309 | 0 |
| 310 | 319 | 0 |
| 320 | 329 | 0 |
| 330 | 339 | 0 |
| 340 | 349 | 0 |
| 350 | 359 | 0 |
| 360 | 369 | 0 |
| 370 | 379 | 0 |
| 380 | 389 | 0 |
| 390 | 399 | 0 |
| 400 | 409 | 0 |
| 410 | 419 | 0 |
| 420 | 429 | 0 |
| 430 | 439 | 0 |
| 440 | 449 | 0 |
| 450 | 459 | 0 |
| 460 | 469 | 0 |
| 470 | 479 | 0 |
| 480 | 489 | 0 |
| 490 | inf | 0 |
Done
CLI 和 API 參考資料
trel (啟用、停用)
啟用或停用 TREL 無線電作業。
參數
trel enable|disable
示例
trel enable
Done
trel disable
Done
CLI 和 API 參考資料
已重設 Trel 計數器
重設 TREL 計數器。
參數
沒有參數。
示例
trel counters reset
Done
CLI 和 API 參考資料
Trel 計數器
取得 TREL 計數器。
參數
沒有參數。
示例
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
CLI 和 API 參考資料
「Trel」篩選器 (啟用、停用)
啟用或停用 TREL 篩選器模式。
參數
trel filter enable|disable
示例
trel filter enable
Done
trel filter disable
Done
CLI 和 API 參考資料
三色濾鏡
指出是否已啟用 TREL 濾鏡模式。
啟用篩選器模式後,所有透過 TREL 介面傳送的 Rx 和 Tx 流量都會在不發出通知的情況下遭到捨棄。
參數
沒有參數。
示例
trel filter
Disabled
Done
CLI 和 API 參考資料
Trel 同類應用程式
取得表格或清單格式的 TREL 對等互連資料表。
參數
trel peers [list]
示例
trel peers
| No | Ext MAC Address | Ext PAN Id | IPv6 Socket Address |
+-----+------------------+------------------+--------------------------------------------------+
| 1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202 |
| 2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203 |
Done
trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done
CLI 和 API 參考資料
Trel
指出是否已啟用 TREL 作業。
參數
沒有參數。
示例
trel
Enabled
Done
CLI 和 API 參考資料
tvcheck (啟用、停用)
在升級至路由器或主要版本時,啟用或停用 Thread 版本檢查功能。這項檢查預設為啟用。
參數
沒有參數。
示例
tvcheck enable
Done
tvcheck disable
Done
CLI 和 API 參考資料
txpower (get,set)
取得 (或使用選用的 txpower
引數) 取得 dBm 中的傳輸功率。
參數
txpower [txpower]
示例
txpower -10
Done
txpower
-10 dBm
Done
CLI 和 API 參考資料
HDp 繫結
這個外掛程式能將 IPv6 位址和通訊埠指派給開放式通訊端,以便繫結通訊端的通訊端。指派 IPv6 位址和通訊埠稱為為通訊端命名。詳情請參閱使用 OT CLI 測試 UDP 功能。
參數
udp bind [netif] ip port
netif
:繫結網路介面,定義如下:- 沒有任何值 (從指令中省略此參數):使用 Thread 網路介面。
-u
:未指定的網路介面,這代表 UDP/IPv6 堆疊會決定要將通訊端繫結至哪個網路介面。-b
:使用骨幹網路介面。
ip
:要繫結的 IPv6 位址。如要讓 UDP/IPv6 堆疊指派繫結 IPv6 位址,可以使用下列值來使用未指定的 IPv6 位址:::
。每個範例都會使用未指定的 IPv6 位址。port
:要繫結的 UDP 通訊埠編號。每個範例都使用通訊埠編號 1234。
示例
udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done
CLI 和 API 參考資料
HDp 關閉
關閉 UDP/IPv6 通訊端。
參數
沒有參數。
示例
udp close
Done
CLI 和 API 參考資料
udp Connect
連線 UDP/IPv6 通訊端。
參數
udp connect ip port
以下是必要參數:
ip
:對等互連的 IP 位址。port
:對等互連的 UDP 通訊埠編號。位址可以是 IPv4 位址,系統會使用網路資料中偏好的 NAT64 前置字串,將位址合成為 IPv6 位址。無法使用偏好的 NAT64 前置字串時,這個指令會傳回InvalidState
。
示例
udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done
udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
CLI 和 API 參考資料
udp linksecurity (啟用、停用)
啟用或停用連結安全性。
參數
沒有參數。
示例
udp linksecurity enable
Done
udp linksecurity disable
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
UDP 連結安全性
指出是否啟用連結安全性。
參數
沒有參數。
示例
udp linksecurity
Enabled
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
CANNOT TRANSLATE
開啟 UDP/IPv6 通訊端。
參數
沒有參數。
示例
udp open
Done
CLI 和 API 參考資料
CANNOT TRANSLATE
使用通訊端傳送 UDP 訊息。詳情請參閱使用 OT CLI 測試 UDP 功能。
參數
udp send [ip port] [type] value
ip
和 port
是選擇性的組合,如果指定其中一個,就必須指定另一個。如未指定 ip
和 port
,則會使用 udp connect
中的通訊端對等位址。
ip
:目的地地址。這個位址可以是 IPv4 或 IPv6 位址;IPv4 位址會合成為 IPv6 位址,而且會使用偏好的 NAT64 前置字元 (來自網路資料)。(如果偏好的 NAT64 前置字元無法使用,指令會傳回InvalidState
)。port
:UDP 目標通訊埠。type
/value
個組合:-t
:系統會將value
參數中的酬載視為文字。如未輸入type
值,系統也會將value
參數中的酬載視為文字。-s
:以value
參數中指定的長度自動產生酬載。-x
:value
參數中指定的二進位資料,以十六進位表示。
示例
udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done
CLI 和 API 參考資料
不安全取得
從允許的未加密通訊埠清單中列出所有通訊埠。
參數
沒有參數。
示例
unsecure get
1234
Done
CLI 和 API 參考資料
新增不安全的移植
將通訊埠新增至允許的未加密通訊埠清單。
參數
unsecureport add port
示例
unsecureport add 1234
Done
CLI 和 API 參考資料
移除不安全的移植內容
將指定的通訊埠或所有通訊埠從允許的未加密通訊埠清單中移除。
參數
unsecureport remove port|all
示例
unsecureport remove 1234
Done
unsecureport remove all
Done
CLI 和 API 參考資料
運作時間 (毫秒)
傳回目前執行個體的運作時間 (以毫秒為單位)。
必須啟用 OPENTHREAD_CONFIG_UPTIME_ENABLE
。
OpenThread 執行個體初始化後,會以毫秒數表示運作時間。
參數
沒有參數。
示例
uptime ms
426238
Done
CLI 和 API 參考資料
運作時間
以使用者可理解的字串傳回目前執行個體的運作時間。
必須啟用 OPENTHREAD_CONFIG_UPTIME_ENABLE
。
字串的格式為「
如果產生的字串不符合 aBuffer
的 aSize
字元內,則字串會遭到截斷,但輸出的字串一律會以空值終止。
參數
沒有參數。
示例
uptime
12:46:35.469
Done
CLI 和 API 參考資料
供應商應用程式網址 (設定)
設定供應商應用程式網址字串。
需要 OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
。
aVendorAppUrl
應為 UTF8,長度上限為 64 個半形字元 (MAX_VENDOR_APPL_URL_TLV_LENGTH
)。長度上限不含空值的 \0
字元。
參數
vendor appurl url
示例
vendor appurl http://www.example.com
Done
CLI 和 API 參考資料
供應商應用程式網址
取得供應商應用程式網址字串。
參數
沒有參數。
示例
vendor appurl
http://www.example.com
Done
CLI 和 API 參考資料
供應商模型 (設定)
設定供應商模型字串。
需要 OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
。
aVendorModel
應為 UTF8,長度上限為 32 個半形字元 (MAX_VENDOR_MODEL_TLV_LENGTH
),長度上限不含空值的 \0
字元。
參數
vendor model name
示例
vendor model Hub\ Max
Done
CLI 和 API 參考資料
供應商模型
取得供應商模型字串。
參數
沒有參數。
示例
vendor model
Hub Max
Done
CLI 和 API 參考資料
供應商名稱 (設定)
設定供應商名稱字串。
需要 OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
。
aVendorName
應為 UTF8,長度上限為 32 個半形字元 (MAX_VENDOR_NAME_TLV_LENGTH
),長度上限不含空值的 \0
字元。
參數
vendor name name
示例
vendor name nest
Done
CLI 和 API 參考資料
供應商名稱
取得供應商名稱字串。
參數
沒有參數。
示例
vendor name
nest
Done
CLI 和 API 參考資料
廠商 swversion (設定)
設定供應商軟體版本字串。
需要 OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
。
aVendorSwVersion
應為 UTF8,長度上限為 16 個半形字元(MAX_VENDOR_SW_VERSION_TLV_LENGTH
)。長度上限不含空值的 \0
字元。
參數
vendor swversion version
示例
vendor swversion Marble3.5.1
Done
CLI 和 API 參考資料
廠商 Swversion
取得供應商軟體版本字串。
參數
沒有參數。
示例
vendor swversion
Marble3.5.1
Done
CLI 和 API 參考資料
版本 API
列印 API 版本號碼。
參數
沒有參數。
示例
version api
28
Done
CLI 和 API 參考資料
- 沒有相關聯的 API
version
取得 OpenThread 版本字串。
參數
沒有參數。
示例
version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done