CLI 指令參考資料

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_LENGTHOT_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 時,請以指定的 statuscoap-code 回應下一個 DUA.req。

啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 後才能使用。

參數

bbr mgmt dua status|coap-code [meshLocalIid]

如果是 statuscoap-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_ENABLEOPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLEOPENTHREAD_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_ENABLEOPENTHREAD_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_ENABLEOPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLEOPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 後即可使用。

參數

沒有參數。

示例

bbr mgmt mlr listener clear
Done

CLI 和 API 參考資料

bbr mgmt mlr 回應

設定下一個多點傳播事件監聽器註冊的回應狀態。

啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLEOPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLEOPENTHREAD_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_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 為必要項目。

參數

channel manager auto enable

1enable 的布林值。

示例

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_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE

參數

channel manager delay delay-seconds

示例

channel manager delay 120
channel manager delay 120
Done

CLI 和 API 參考資料

頻道管理員已收藏

設定偏好的頻道遮罩。

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 為必要項目。

參數

channel manager favored mask

示例

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

CLI 和 API 參考資料

管道管理員間隔

設定自動頻道選取功能使用的週期間隔 (以秒為單位)。

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_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_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 為必要項目。

參數

channel manager select skip-quality-check

針對布林值 skip-quality-check,請使用 10

示例

channel manager select 1
channel manager select 1
Done

CLI 和 API 參考資料

支援管道管理員

設定支援的管道遮罩。

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 為必要項目。

參數

channel manager supported mask

示例

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

CLI 和 API 參考資料

頻道管理員門檻

設定 CCA 失敗率門檻。

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLEOPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLEOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE 為必要項目。

參數

channel manager threshold threshold-percent

使用 threshold-percent 的十六進位值。00xffff 分別對應到 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 參考資料

取得或設定 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-16block-32block-64block-128block-256block-512block-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]
  • typerequest 適用於 CoAP 要求,或 response 代表 CoAP 回應。如果未提供其他參數,指令會列印目前設定。
  • default:將傳輸參數設為下列預設值:
    • ack_timeout:2000 毫秒
    • ack_random_factor_numerator:3
    • ack_random_factor_denominator: 2
    • max_retransmit:4
  • ack_timeout:以毫秒為單位的 ACK_TIMEOUT (0-UINT32_MAX)。請參閱 RFC7252。
  • ack_random_factor_numeratorACK_RANDOM_FACTOR 分子,可能的值為 0 至 255。請參閱 RFC7252。
  • ack_random_factor_denominatorACK_RANDOM_FACTOR 分母,可能的值為 0 至 255。請參閱 RFC7252。
  • max_retransmitMAX_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-16block-32block-64block-128block-256block-512block-1024
  • payload:CoAP 酬載要求,使用時可以是字串或整數,視 type 而定。如果 typeconnon-con,則 payload 參數為選用參數。如果您省略 payload 參數,系統會傳送空白的酬載。不過,如果您使用 payload 參數,該參數的值必須是字串,例如 hellothere。如果 typeblock-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-16block-32block-64block-128block-256block-512block-1024
  • payload:CoAP 酬載要求,使用時可以是字串或整數,視 type 而定。如果 typeconnon-con,則 payload 參數為選用參數。如果您省略 payload 參數,系統會傳送空白的酬載。不過,如果您使用 payload 參數,該參數的值必須是字串,例如 hellothere。如果 typeblock-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-16block-32block-64block-128block-256block-512block-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-16block-32block-64block-128block-256block-512block-1024
  • payload:CoAPS 酬載要求,使用時可以是字串或整數,視 type 而定。如果 typeconnon-con,則酬載參數為選用。如果您省略酬載參數,系統會傳送空白的酬載。不過,如果您使用酬載參數,該參數的值必須是字串,例如 hellothere。如果 typeblock-,酬載參數的值必須是整數,用來指定要傳送的區塊數量。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-16block-32block-64block-128block-256block-512block-1024
  • payload:CoAPS 酬載要求,使用時可以是字串或整數,視 type 而定。如果 typeconnon-con,則酬載參數為選用。如果您省略酬載參數,系統會傳送空白的酬載。不過,如果您使用酬載參數,該參數的值必須是字串,例如 hellothere。如果 typeblock-,酬載參數的值必須是整數,用來指定要傳送的區塊數量。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-certmax-conn-attempts 參數會在下列組合中搭配運作:

  • 未指定引數:使用預設值。
  • check-peer-cert 設為 true:效果與省略引數相同 (也就是 check-peer-cert 值為 truemax-conn-attempts 值為 0)。
  • check-peer-cert 設為 falsecheck-peer-cert 值為 falsemax-conn-attempts 值為 0。
  • 指定數字:check-peer-certtrue,而 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:用來識別傳送 MLE Announce 訊息管道的位元遮罩。
  • count:每個通道的 MLE Announce 傳輸次數。
  • period:MLE Announce 連續傳輸之間的毫秒數。
  • 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 的目前狀態。可能的值為 activedisabledpetition (向對方請款)。

參數

沒有參數。

示例

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 會檢查 activependingtlvs,並傳回對應的值。否則,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 的任意組合,例如 activetimestamppendingtimestampnetworkkey
  • 選用的 -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,請將 -ppassphrase 引數搭配使用。-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]]

示例

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
  • 事件:可能的值為 AddedRemoved
  • 地址/前置字元長度:包含前置字串長度的 Unicast 位址 (以位元為單位)。
  • 來源:可能的值為 threadslaacdhcp6manual
  • 範圍: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
  • 事件:可能的值為 SubscribedUnsubscribed
  • 多點傳播位址
  • 來源:可能的值為 ThreadManual

參數

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
  • 類型:ChildRouter
  • 事件:可能的值為 AddedRemovedChanged
  • 詳細地址
  • RLOC16
  • 模式:MLE 連結模式。可能的值包括:
    • -:未設定任何旗標 (rx-off-when-idle、最小的 Thread 裝置、穩定的網路資料)。
    • r:rx-on-when-idle
    • d:完整 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
  • 角色:裝置角色。可能的值包括 routerchilddetacheddisabled
  • 模式:MLE 連結模式。可能的值包括:
    • -:未設定任何旗標 (rx-off-when-idle、最小的 Thread 裝置、穩定的網路資料)。
    • r:rx-on-when-idle
    • d:完整 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
  • 事件:可能的值為 AddedRemoved
  • 前置字串
  • 標記/意義:
    • p:偏好標記
    • a:無狀態 IPv6 位址自動設定標記。
    • d:DHCPv6 IPv6 位址設定標記。
    • c:DHCPv6 其他設定標記。
    • r:預設路徑旗標。
    • o:在網格標記上。
    • s:穩定版標記。
    • n:Nd Dns 標記。
    • D:網域前置字串標記。
  • 偏好設定:Preference。值可以是 highmedlow
  • 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
  • 事件:可能的值為 AddedRemoved
  • 路徑
  • 標記/意義:
    • s:穩定版標記。
    • n:NAT64 旗標。
  • 偏好設定:Preference。值可以是 highmedlow
  • 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
  • 事件:可能的值為 AddedRemovedNextHopChangedCostChanged
  • 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 訊息類型,例如 UDPTCPHopOptsICMP6 (及其子類型)。
    • src:來源 IPv6 位址和通訊埠編號。
    • dst:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
  • Len:IPv6 酬載長度 (不含 IPv6 標頭)。
  • Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
  • 秒:指出是否已使用連結層安全性。
  • Prio:訊息優先順序。可能的值為 lownormhighnet (適用於執行緒控制訊息)。
  • RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示 NA (不適用)。
  • 離子:顯示訊息是否已傳送 (TX) 或已收到 (RX)。傳輸失敗時會以表格格式顯示「TX-F」,或以清單格式顯示 tx-success:no。傳輸失敗的例子包括 tx 遭到取消,以及任何訊息片段都沒有從對等點傳送 ack
  • 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以 bcast 或清單格式顯示為 0xffff。如果無法取得鄰點的短地址,會以表格格式顯示 unknwn,在清單格式中則會顯示 0xfffe
  • 電台:傳送/接收訊息的圓形按鈕連結 (啟用 OPENTHREAD_CONFIG_MULTI_RADIO 時相當實用)。可以是 15.4trelall (如果傳送至所有電台連結)。

參數

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 訊息類型,例如 UDPTCPHopOptsICMP6 (及其子類型)。
    • src:來源 IPv6 位址和通訊埠編號。
    • dst:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
  • Len:IPv6 酬載長度 (不含 IPv6 標頭)。
  • Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
  • 秒:指出是否已使用連結層安全性。
  • Prio:訊息優先順序。可能的值為 lownormhighnet (適用於執行緒控制訊息)。
  • RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示 NA (不適用)。
  • 離子:顯示訊息是否已傳送 (TX) 或已收到 (RX)。傳輸失敗時會以表格格式顯示「TX-F」,或以清單格式顯示 tx-success:no。傳輸失敗的例子包括 tx 遭到取消,以及任何訊息片段都沒有從對等點傳送 ack
  • 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以 bcast 或清單格式顯示為 0xffff。如果無法取得鄰點的短地址,會以表格格式顯示 unknwn,在清單格式中則會顯示 0xfffe
  • 電台:傳送/接收訊息的圓形按鈕連結 (啟用 OPENTHREAD_CONFIG_MULTI_RADIO 時相當實用)。可以是 15.4trelall (如果傳送至所有電台連結)。

參數

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 訊息類型,例如 UDPTCPHopOptsICMP6 (及其子類型)。
    • src:來源 IPv6 位址和通訊埠編號。
    • dst:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
  • Len:IPv6 酬載長度 (不含 IPv6 標頭)。
  • Chksum:訊息總和檢查碼 (適用於 UDP、TCP 或 ICMP6 訊息)。
  • 秒:指出是否已使用連結層安全性。
  • Prio:訊息優先順序。可能的值為 lownormhighnet (適用於執行緒控制訊息)。
  • RSS:接收訊號強度 (單位為 dBm),這是所有產生訊息的片段影格的平均值。如果是 TX 記錄,系統會顯示 NA (不適用)。
  • 離子:顯示訊息是否已傳送 (TX) 或已收到 (RX)。傳輸失敗時會以表格格式顯示「TX-F」,或以清單格式顯示 tx-success:no。傳輸失敗的例子包括 tx 遭到取消,以及任何訊息片段都沒有從對等點傳送 ack
  • 鄰:收發訊息的鄰居短地址 (RLOC16)。如為廣播影格,表格格式會以 bcast 或清單格式顯示為 0xffff。如果無法取得鄰點的短地址,會以表格格式顯示 unknwn,在清單格式中則會顯示 0xfffe
  • 電台:傳送/接收訊息的圓形按鈕連結 (啟用 OPENTHREAD_CONFIG_MULTI_RADIO 時相當實用)。可以是 15.4trelall (如果傳送至所有電台連結)。

參數

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:可以是 threadslaacdhcp6manual,表示地址起點
  • 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 clearaDiscerner 設為 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

如有索引鍵索引相符,立即使用 0Thread 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]

[qmr] 對應至 otLinkMetricsValues。根據規格 4.11.3.4.4.6,一次最多只能使用兩個選項,例如 qqm

  • 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。
  • [ldra] 會對應至 otLinkMetricsSeriesFlagsX 代表不含 otLinkMetricsSeriesFlags,且會停止會計並移除系列。
    • l:MLE 連結探測器。
    • d:MAC 資料。
    • r:MAC 資料要求。
    • a:MAC Ack。
    • X:只能在沒有其他旗標的情況下使用。
  • [pqmr] 會對應至 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:同儕地址。
  • [pqmr] 會對應至 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 ProgressIdle)。

啟用 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_UARTOPENTHREAD_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 篩選器清單目前的模式:AllowListDenyList,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 篩選器的目前模式:AllowListDenyList,Disabled
  • MAC 篩選器清單中所有延伸位址的清單。如果傳送的值與預設值不同,接收到的訊號強度 (rs) 和連結品質指標 (lqi) 就會顯示在地址旁邊。
  • 獨立的清單 (RssIn List),顯示所有將 rss 設為與預設值不同的延伸地址。
  • Default rss:顯示 rsslqi 設定的預設值 (如適用)。

參數

沒有參數。

示例

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)。rsslqi 設定會相互對應。設定其中一種時,系統會自動設定另一個廣告的值。此地址清單稱為 RssIn List。設定 rsilqi 會將對應的延伸地址新增至 RssIn 清單。
  • Default rss:顯示 rsslqi 設定的預設值 (如適用)。

參數

沒有參數。

示例

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

CLI 和 API 參考資料

macfilter rss 移除

RssIn 清單中移除指定的延伸地址。

RssIn 清單移除後,這個 MAC 位址將改用預設的 rsslqi 設定 (假設已設定預設值)。(如未設定預設值,系統會使用無線訊號)。

必須啟用 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:這個路由器與這個路由器的連入連結,連結品質 3
    • 2-links:這個路由器擁有連結品質 2 的連入連結路由器 ID
    • 1-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_ENABLEOPENTHREAD_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-idle
  • d:完整 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_ENABLEOPENTHREAD_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_ENABLEPrefixManager 會傳回下列其中一種狀態:

  • Disabled:NAT64 前置字串管理員已停用。
  • NotRunning:NAT64 前置字串管理員已啟用,不過目前並未執行。這可能代表該轉送管理員已停用。
  • Idle:NAT64 前置字串管理員已啟用且正在執行,但尚未發布 NAT64 前置字串。如果另一個邊界路由器發布了優先順序較高的 NAT64 前置字串,就有可能發生這種情況。
  • Active:NAT64 前置字串管理員已啟用、執行及發布 NAT64 前置字串。

如果啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLETranslator 會傳回下列其中一種狀態:

  • 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:閒置時開啟 RX
  • D:完整 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 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 發布前置字串

發布位於網狀網路的前置字串項目。詳情請參閱「使用 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 擴充位址 TLV
  • 1:Address16 TLV
  • 2:模式 TLV
  • 3:逾時 TLV (SED 的輪詢時間範圍上限)
  • 4:連線 TLV
  • 5:Route64 TLV
  • 6:主要資料領袖
  • 7:網路資料 TLV
  • 8:IPv6 位址清單 TLV
  • 9:MAC 計數器 TLV
  • 14:電池電量 TLV
  • 15:供應電壓 TLV
  • 16:子項資料表 TLV
  • 17:頻道頁面 TLV
  • 19:子項逾時上限 TLV
  • 23:EUI64 TLV
  • 24:TLV 版本 (通訊協定和功能的版本號碼)
  • 25:供應商名稱 TLV
  • 26:廠商型號 TLV
  • 27:供應商軟體版本 TLV
  • 28:執行緒堆疊版本 TLV (Thread 堆疊程式碼集/修訂版本/版本的版本 ID 為 UTF-8 字串)
  • 29:子項 TLV
  • 34: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 目的地的下一個躍點和路徑費用。

可與 aNextHopRloc16aPathCost 搭配使用時為 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 參考資料

單例模式

表示節點是否為網路上唯一的路由器。傳回 truefalse

參數

沒有參數。

示例

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 伺服器,且優先順序如下:

  1. 服務資料中包含伺服器位址的 Unicast 項目。如果有多個選項,建議您選擇數值最低的 IPv6 位址。
  2. 每個播送項目都有序號。建議採用 RFC-1982 中由序號演算法指定的最大序號。
  3. 伺服器資料中包含伺服器位址資訊的 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 參數啟用自動主機位址模式。啟用後,用戶端會自動使用所有偏好的 Thread netif 單點傳播位址,但連結本機和網格本機位址除外。如果沒有有效的位址,系統會新增網狀本機 EID 位址。如果 Thread netif 上的地址新增或移除,或標示為不偏好,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 參數可選擇加入以半形逗號分隔的服務子類型標籤清單。此處的範例使用一般的命名方式。priorityweight (兩者皆為 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 參考資料

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 參考資料

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 端點通訊。
    • linkedcircular:以上任一選項,都代表不使用 TLS,而且指定緩衝類型應用於 TCP 緩衝。linkedcircular 的行為完全相同。請檢查程式碼,瞭解這兩種緩衝類型之間的差異。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() 重設統計資料集合以來,系統都會收集直方圖資訊。

指標 aNumBinsaBinInterval 不得為空值。

參數

沒有參數。

示例

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

ipport 是選擇性的組合,如果指定其中一個,就必須指定另一個。如未指定 ipport,則會使用 udp connect 中的通訊端對等位址。

  • ip:目的地地址。這個位址可以是 IPv4 或 IPv6 位址;IPv4 位址會合成為 IPv6 位址,而且會使用偏好的 NAT64 前置字元 (來自網路資料)。(如果偏好的 NAT64 前置字元無法使用,指令會傳回 InvalidState)。
  • port:UDP 目標通訊埠。
  • type/value 個組合:
    • -t:系統會將 value 參數中的酬載視為文字。如未輸入 type 值,系統也會將 value 參數中的酬載視為文字。
    • -s:以 value 參數中指定的長度自動產生酬載。
    • -xvalue 參數中指定的二進位資料,以十六進位表示。

示例

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

字串的格式為「::.」代表小時、分鐘、秒和毫秒 (如果運作時間少於一天) 或「」格式。

d.::"(超過一天)。

如果產生的字串不符合 aBufferaSize 字元內,則字串會遭到截斷,但輸出的字串一律會以空值終止。

參數

沒有參數。

示例

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

CLI 和 API 參考資料