CLI 指令參考資料

Baa 暫時金鑰

指出暫時金鑰是否已啟用。

需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE

參數

沒有參數。

範例

ba ephemeralkey
active
Done

CLI 與 API 參考資料

ba 暫時金鑰回呼 (啟用、停用)

設定 Border Agent 使用的回呼函式,以通知任何與暫時金鑰使用情況相關的變更。

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

Baa 暫時金鑰

取消正在使用的臨時金鑰。

需要 OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE

在逾時前,可用於取消先前設定的臨時金鑰。如果邊界代理程式未執行,或是未使用臨時金鑰,則呼叫此函式就不會有任何作用。

如果佣金工具使用臨時金鑰連線,且目前為啟用狀態,呼叫此函式不會變更其狀態。在這種情況下, otBorderAgentIsEphemeralKeyActive() 會繼續傳回 TRUE,直到佣金人員中斷連線為止。

參數

沒有參數。

範例

ba ephemeralkey clear
Done

CLI 與 API 參考資料

ba 暫時鍵設定 [timeout-in-msec] [port]

設定特定逾時持續時間的臨時金鑰。

需要 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,這組 ID 可在多組 BR 中識別該裝置。

參數

ba id [border-agent-id]

使用選用的 border-agent-id 引數設定邊框代理程式 ID。

範例

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done

CLI 與 API 參考資料

Bas Port

取得 Thread 邊界代理程式服務的 UDP 通訊埠。

參數

沒有參數。

範例

ba port
49153
Done

CLI 與 API 參考資料

Baku State

取得 Thread 邊界代理程式角色的 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 設定 (設定)

設定本機骨幹路由器設定 otBackboneRouterConfig

如果主要骨幹路由器的 BBR 資料集變更,系統會自動啟動伺服器資料要求訊息 SRV_DATA.ntf

啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE 後才能使用。

應明確核發 bbr register,才能將骨幹路由器服務註冊為次要骨幹路由器的領導者。

參數

bbr config [seqno seqno] [delay delay] [timeout timeout]

範例

bbr config seqno 20 delay 30
Done

CLI 與 API 參考資料

bbr 設定

取得本機骨幹路由器設定。

啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE 後才能使用。

參數

沒有參數。

範例

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

CLI 與 API 參考資料

停用 bbr。

啟用或停用骨幹功能。

啟用後,如果 Thread 網路資料中沒有骨幹路由器服務,連接的裝置就會觸發伺服器資料要求訊息 SRV_DATA.ntf

如果停用,當骨幹路由器處於主要狀態時,就會觸發 SRV_DATA.ntf

啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE 後才能使用。

參數

沒有參數。

範例

bbr disable
Done

CLI 與 API 參考資料

bbr 啟用

啟用或停用骨幹功能。

啟用後,如果 Thread 網路資料中沒有骨幹路由器服務,連接的裝置就會觸發伺服器資料要求訊息 SRV_DATA.ntf

如果停用,當骨幹路由器處於主要狀態時,就會觸發 SRV_DATA.ntf

啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE 後才能使用。

參數

沒有參數。

範例

bbr enable
Done

CLI 與 API 參考資料

bbr 時基誤差 (取得、設定)

取得或設定 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 狀態

取得骨幹路由器 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 nat64 前置字元

並輸出本機和建議使用的 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 前置字串。

Thread 網路可能無法通告 NAT64 前置字串。

必須啟用「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 最愛

取得目前慣用的 Off-Mesh-Routable (OMR) 前置字串。

您可以在網路資料中找到偏好的 OMR 前置字串,也可以是這部裝置的本機 OMR 前置碼。

參數

沒有參數。

範例

br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done

CLI 與 API 參考資料

br omrprefix (當地)

取得本機 Off-Mesh-Routable (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

並輸出本機和常用的連結前置碼。

參數

沒有參數。

範例

br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done

CLI 與 API 參考資料

br onlinkprefix 偏好

取得目前慣用的 On-Link 前置字串。

建議使用的前置字串是基礎架構連結或本機連結前置碼找到的前置字串。

參數

沒有參數。

範例

br onlinkprefix favored
2600::0:1234:da12::/64
Done

CLI 與 API 參考資料

br onlinkprefix 當地

取得相鄰基礎架構連結的本機 On-Link 前置字串。

如果連結中尚未通告可用的連結前置碼,本機 On-Link 前置字串就會是 64 位元的前置字串,這將會透過基礎架構連結公告。

參數

沒有參數。

範例

br onlinkprefix local
fd41:2650:a6f5:0::/64
Done

CLI 與 API 參考資料

br pd (啟用、停用)

啟用 / 停用 DHCPv6 前置字串委派。

必須啟用「OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE」。

參數

br pd enable|disable

範例

br pd enable
Done
br pd disable
Done

CLI 與 API 參考資料

br pd omrprefix

取得 DHCPv6 前置碼委派 (PD) 提供的可密封轉送 (OMR) 前置字串。

傳回的前置字串資訊中只會使用 mPrefix、mValidLifetime 和 mPreferredLifetime 欄位。

必須啟用「OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE」。

參數

沒有參數。

範例

br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Done

CLI 與 API 參考資料

br pd 狀態

取得 DHCPv6 前置字串委派的目前狀態。

必須啟用「OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE」。

參數

沒有參數。

範例

br pd state
running
Done

CLI 與 API 參考資料

兄弟

取得在網路資料項目中找到的對等 BR 清單。「OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE」為必填欄位。對等互連 BR 是 Thread 網格中的其他裝置,可提供外部 IP 連線。裝置只要符合「網路資料」項目下列其中一項條件,就視為提供外部 IP 連線:

  • 這個物件已新增至少一個外部路徑項目。
  • 並加入至少一個已設定預設路徑和網狀標記的前置字串項目。
  • 而且新增了至少一個網域前置字串 (同時設定網域和網狀旗標)。即使目前的裝置本身是巴西,對等互連 BR 清單也會特別排除目前的裝置。每個 BR 項目的資訊:
  • 巴西 RLOC16
  • 此 BR 出現在網路資料中,且持續時間間隔。格式為 {hh}:{mm}:{ss},表示小時、分、秒 (如果時間長度小於 24 小時)。如果時間長度為 24 小時以上,格式為 {dd}d.{hh}:{mm}:{ss},表示日期、小時、分鐘、秒鐘。

參數

沒有參數。

範例

br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done

CLI 與 API 參考資料

br 對等互連數量

傳回在網路資料中找到的對等 BR 數量。

需要 OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE

對等互連 BR 是 Thread 網格中的其他裝置,可提供外部 IP 連線。裝置只要符合「網路資料」項目下列其中一項條件,就視為提供外部 IP 連線:

  • 這個物件已新增至少一個外部路徑項目。
  • 並加入至少一個已設定預設路徑和網狀標記的前置字串項目。
  • 而且新增了至少一個網域前置字串 (同時設定網域和網狀旗標)。

同業 BR 清單會特別排除目前的裝置,即使該裝置本身為巴西本質也包含在內。

參數

沒有參數。

範例

br peers count
2 min-age:00:00:47
Done

CLI 與 API 參考資料

br 前置碼

透過基礎架構連結取得邊界轉送管理員找到的前置字串。每個前置碼項目的資訊:

  • 前置字串
  • 前置字串為連結中還是路徑
  • 自上次收到包含這個前置字串的路由器通告以來的毫秒數
  • 前置時間 (以秒為單位)
  • 前置字元為連結時,優先使用效期 (以秒為單位)
  • 只有在前置字串為路徑 (非連結上) 時,路徑偏好設定 (低、中、高)
  • 通告這個前置碼的路由器 IPv6 位址
  • 收到的路由器通告標頭中的旗標:
    • M:Managed Address Config 旗標
    • O:其他設定旗標
    • Stub:Stub 路由器旗標 (指出路由器是否為虛設常式路由器)

參數

沒有參數。

範例

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 rioprf (高、中、低)

明確指定透過基礎架構連結傳送的路由器通告訊息中廣告路徑資訊選項 (RIO) 時使用的偏好設定。

呼叫此函式後,BR 會對所有通告的 RIO 使用指定偏好設定。您可以呼叫 otBorderRoutingClearRouteInfoOptionPreference() 來清除偏好設定。

參數

br rioprf [high|med|low]

範例

br rioprf low
Done

CLI 與 API 參考資料

巴西里奧普爾夫

取得透過基礎架構連結傳送的路由器通告訊息中宣傳路徑資訊選項 (RIO) 時採用的目前偏好設定。

RIO 偏好設定如下:

  • 如果使用者呼叫 otBorderRoutingSetRouteInfoOptionPreference() 以明確設定,系統會使用指定的偏好設定。
  • 否則,取決於裝置目前的角色:路由器/主要角色的偏好為中度,而在子項角色中的偏好偏低。

參數

沒有參數。

範例

br rioprf
med
Done

CLI 與 API 參考資料

br rioprf 清晰

清除先前為通告路線資訊選項設置的偏好設定值。

在呼叫這個函式後,BR 將根據裝置角色來判斷 RIO 偏好設定:路由器/領導人角色的偏好為中度,而在子項角色中則偏好偏低。

參數

沒有參數。

範例

br rioprf clear
Done

CLI 與 API 參考資料

br routeprf (高、中、低)

在網路資料中明確設定已發布路徑的偏好設定。

呼叫這個函式後,BR 會使用指定的偏好設定。您可以呼叫 otBorderRoutingClearRoutePreference() 來清除偏好設定。

參數

br routeprf [high|med|low]

範例

br routeprf low
Done

CLI 與 API 參考資料

Br 路線普夫

取得網路資料中已發布路線目前所使用的偏好設定。

偏好設定如下:

  • 如果使用者呼叫 otBorderRoutingSetRoutePreference() 以明確設定,系統會使用指定的偏好設定。
  • 否則,由 RoutingManager 根據裝置的角色和連結品質自動決定。

參數

沒有參數。

範例

br routeprf
med
Done

CLI 與 API 參考資料

br routeprf Clear

清除網路資料中已發布路徑先前設定的偏好設定值。

呼叫此函式後,BR 將根據裝置的角色和連結品質 (作為終端裝置時) 自動確定偏好設定。

參數

沒有參數。

範例

br routeprf clear
Done

CLI 與 API 參考資料

br 路由器

透過基礎架構連結取得已發現的路由器清單。每個路由器的資訊:

  • 路由器 IPv6 位址
  • 收到的路由器通告標頭中的旗標:
    • M:Managed Address Config 旗標
    • O:其他設定旗標
    • Stub:Stub 路由器旗標 (指出路由器是否為虛設常式路由器)
  • 從此路由器上次收到訊息後經過的毫秒數
  • 可連性標記:如果路由器無法回應多個「鄰近感應」探測器,就會標示為無法連線。
  • 存在時間:首次發現路由器後經過的間隔時間。格式為 {hh}:{mm}:{ss},表示小時、分、秒 (如果時間長度小於 24 小時)。如果時間長度為 24 小時以上,格式為 {dd}d.{hh}:{mm}:{ss},表示日期、小時、分鐘、秒鐘。
  • 路由器為本機裝置時,會附加 (this BR)
  • 如果路由器可能是對等互連 BR 連線至同一個 Thread 網狀網,則會附加 (peer BR)。這需要 OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE

參數

沒有參數。

範例

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done

CLI 與 API 參考資料

Br 州

取得邊線路由管理員的目前狀態。

參數

沒有參數。

範例

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 的 dBm 閾值。

參數

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 使用十六進位值。0 會對應至 0%,0xffff 則會對應至 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 參考資料

小子

取得為 MTD 子項儲存的 IP 位址清單。

參數

沒有參數。

範例

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

CLI 與 API 參考資料

Kidsip max (設定)

設定或還原每個 MTD 孩子能夠以家長身分註冊這部裝置的 IP 位址數量上限。

傳遞 0 即可清除設定並還原預設值。

啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 後才能使用。

參數

childip max count

範例

childip max 2
Done

CLI 與 API 參考資料

子項 IP 上限

取得各個 MTD 兒童可在這部裝置上註冊為父項的 IP 位址數量上限。

參數

沒有參數。

範例

childip max
4
Done

CLI 與 API 參考資料

Kidsmax (設定)

設定目前允許的兒童數量上限。

只有在 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 伺服器上的遠端資源。

參數

沒有參數。

範例

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

Coap get

取得 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 參數(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_timeoutACK_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 貼文

建立指定的 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 參數的值必須是整數,用來指定要傳送的區塊數量。必須設定 OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE,才能設定 block- 類型。

範例

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

Coap Put

修改指定的 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 參數的值必須是整數,用來指定要傳送的區塊數量。必須設定 OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE,才能設定 block- 類型。

範例

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 資源 (get、set)

取得或設定 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 Start

啟動 CoAP 伺服器。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定 (CoAP) 資源

參數

沒有參數。

範例

coap start
Done

CLI 與 API 參考資料

Coap Stop

停止 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

Coaps 中斷連線

停止 DTLS 工作階段。

參數

沒有參數。

範例

coaps disconnect
coaps disconnected
Done

CLI 與 API 參考資料

Coaps get

取得 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 isconnactive

指出 CoAP Secure 服務連線是否有效 (已連線或正在建立連線)。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定安全 (CoAPS) 資源

參數

沒有參數。

範例

coaps isconnactive
yes
Done

CLI 與 API 參考資料

已連線 Coaps

指出是否已連線至 CoAP Secure 服務。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定安全 (CoAPS) 資源

參數

沒有參數。

範例

coaps isconnected
yes
Done

CLI 與 API 參考資料

Coaps 貼文

建立指定的 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-,酬載參數值必須是整數,用來指定要傳送的區塊數量。必須設定 OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE,才能設定 block- 類型。

範例

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

眼鏡蛇

修改指定的 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-,酬載參數值必須是整數,用來指定要傳送的區塊數量。必須設定 OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE,才能設定 block- 類型。

範例

coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

Coaps 資源 (取得、設定)

取得或設定 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

Coaps 開始

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

委託代理彙整器移除

移除 Joiner 的項目。

參數

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:佣金者的工作階段 ID。
  • steeringdata:引導資料。
  • joinerudpport:彙整器 UDP 通訊埠。
  • TLVs:要擷取的 TLV 組合。

範例

commissioner mgmtget locator sessionid
Done

CLI 與 API 參考資料

委員 mgmtset

傳送 MGMT_SET (管理集) 訊息給領導者,並將變數設為指定的值。

參數

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator:邊界路由器 RLOC16。
  • sessionid:佣金者的工作階段 ID。
  • steeringdata:引導資料。
  • joinerudpport:彙整器 UDP 通訊埠。
  • TLVs:要擷取的 TLV 組合。

範例

commissioner mgmtset joinerudpport 9988
Done

CLI 與 API 參考資料

教練巴士

傳送永久帳號 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 參考資料

佣金 er sessionid

取得目前的佣金工作階段 ID。

參數

沒有參數。

範例

commissioner sessionid
0
Done

CLI 與 API 參考資料

調試者開始

啟動 Thread Commissioner 角色。

參數

沒有參數。

範例

commissioner start
Commissioner: petitioning
Done
Commissioner: active

CLI 與 API 參考資料

委員狀態

傳回執行委員會的目前狀態。可能的值包括 activedisabledpetition (請申請成為委員會)。

參數

沒有參數。

範例

commissioner state
active
Done

CLI 與 API 參考資料

教練停靠站

停止「Thread Commissioner」角色。

參數

沒有參數。

範例

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

計數器 (公尺)

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

CSS 管道

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

CSS 逾時

設定 CSL 逾時秒數。

參數

csl timeout timeout

範例

cls timeout 10
Done

CLI 與 API 參考資料

資料集有效

取得有效作業資料集。

OT CLI 使用 otOperationalDataset 成員,將資料集值傳回控制台。

參數

dataset active [-x]

選用的 -x 引數會以十六進位編碼的 TLV 列印有效作業資料集值。

範例

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

資料集延遲 (get,set)

取得或設定 otOperationalDataset::mDelay

參數

dataset delay [delay]

使用選用的 delay 引數設定延遲計時器值。

範例

dataset delay
1000
Done
dataset delay 1000
Done

CLI 與 API 參考資料

資料集 extpanid (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

資料集 init (有效、新、待處理、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 引數設定 Mesh-Local 前置字串。

範例

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

資料集 networkkey (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 引數設定永久帳號 ID。

範例

dataset panid
0x1234
Done
dataset panid 0x1234
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

資料集待處理時間戳記 (get,set)

取得或設定 otOperationalDataset::mPendingTimestamp

參數

dataset pendingtimestamp [timestamp]

使用選用的 timestamp 引數設定待處理時間戳記的秒數。

範例

dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

資料集 pskc (get,set)

取得或設定 otOperationalDataset::mPskc

參數

dataset pskc [-p passphrase] | [key]

僅適用於 FTD,請使用 -p 搭配 passphrase 引數。-p 會從您提供的 UTF-8 編碼 passphrase 產生 pskc,以及網路名稱和擴充永久帳號 ID。如果已設定,-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 資料集的裝置中啟用 Thread 時,裝置會嘗試使用資料集中的任何現有資訊,將 Thread 連接至現有的 Thread 網路。只需要 Thread 網路金鑰即可連接至網路。

如果頻道未納入資料集,裝置就會跨管道傳送 MLE 公告訊息,以便在其他管道中尋找鄰居。

如果裝置成功連接至 Thread 網路,裝置就會從其父項擷取完整的 Active 資料集。請注意,支援路由器的裝置需要取得完整的有效資料集,才能改用路由器或主要角色。

這個函式會持續傳回 OT_ERROR_NONE,且可有效視為具有 void 傳回類型。先前發生其他錯誤 (例如OT_ERROR_NOT_IMPLEMENTED)。不過,由於現在是 Thread 作業的必要非揮發性儲存空間,因此一旦儲存資料集失敗,就會觸發斷言。為顧及回溯相容性,系統會保留 otError 傳回類型。

CLI dataset set 指令會使用十六進位編碼的 TLV 設定 Active Operational 資料集。

參數

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

偵錯

執行一系列 CLI 指令,收集裝置和執行緒網路的相關資訊。這是為了偵錯。輸出內容將顯示已執行的各項 CLI 指令,後方依序加上 $ 和對應的指令產生的輸出內容。產生的輸出內容包含下列資訊:

  • 版本
  • 目前狀態
  • RLOC16,擴充 MAC 位址
  • 單點傳播和多點傳送 IPv6 位址清單
  • 頻道
  • 永久帳號 ID 和永久帳號 ID
  • 網路資料
  • 分區 ID
  • 領先者資料

如果裝置的運作方式為 FTD:

  • 子項和相鄰資料表
  • 路由器資料表和下一個躍點資訊
  • 位址快取表格
  • 已註冊的 MTD 子項 IPv6 位址
  • 裝置屬性

如果裝置支援並做為 SRP 用戶端:

  • SRP 用戶端狀態
  • SRP 客戶服務和主機資訊

如果裝置支援並做為 SRP 伺服器:

  • SRP 伺服器狀態和位址模式
  • SRP 伺服器已註冊的主機和服務

如果裝置支援 TREL:

  • TREL 狀態和對等互連資料表

如果裝置支援且做為邊界路由器:

  • BR 狀態
  • BR 前置字元 (OMR、連結、NAT64)
  • 已發現的前置字串表格

參數

沒有參數。

範例

CLI 與 API 參考資料

  • 沒有相關聯的 API

延遲時差 (設定)

設定最短延遲計時器 (以秒為單位)。

參數

delaytimermin delaytimermin

範例

delaytimermin 60
Done

CLI 與 API 參考資料

延遲時長

使用最短延遲時間 (以秒為單位)。

參數

沒有參數。

範例

delaytimermin
30
Done

CLI 與 API 參考資料

卸離非同步

啟動與 detach 指令類似的安全卸離程序,而不封鎖並等待回呼指出卸離已完成。

參數

沒有參數。

範例

detach async
Done

CLI 與 API 參考資料

卸離

如要啟動安全卸離程序,請先通知其他節點 (如果做為路由器的任務是傳送 Address Release),或是以子項的身分將子項逾時值設為零,再停止 Thread 通訊協定作業。

參數

沒有參數。

範例

detach
Finished detaching
Done

CLI 與 API 參考資料

裝置方案 (設定)

設定裝置屬性。

參數

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

deviceprops

取得目前的裝置屬性。

需要 OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE

參數

沒有參數。

範例

deviceprops
PowerSupply      : external
IsBorderRouter   : yes
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : 0
Done

CLI 與 API 參考資料

結識

執行 MLE 探索作業。

參數

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

瞭解 reqcallback (啟用、停用)

設定回呼以接收 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 用戶端的預設查詢設定。

在非 NULL 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 伺服器位址。

可以將部分欄位保留為未指定 (或使用值零)。指定的欄位會由對應的 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] [protocol]

範例

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
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
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 位址和通訊埠、以毫秒為單位的回應逾時 (以毫秒為單位等待 rx 回應)、回報失敗前的 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() 」的預設設定做為這項查詢的設定。在非 NULL 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() 」的預設設定做為這項查詢的設定。在非 NULL aConfig 中,可以保留部分欄位 (值零)。接著,未指定的欄位會替換為預設設定的值。

函式會傳送指定服務執行個體的 SRV 和/或 TXT 記錄查詢。 otDnsQueryConfig 中的 mServiceMode 欄位會決定要查詢的記錄 (僅限 SRV、僅限 TXT,或同時包含 TXT 和 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() 」的預設設定做為這項查詢的設定。在非 NULL 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 (設定、清除)

設定或清除為 Thread 網域單點傳播位址手動指定的介面 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 網域單點傳播位址手動指定的介面 ID。

啟用 OPENTHREAD_CONFIG_DUA_ENABLE 後才能使用。

參數

沒有參數。

範例

dua iid
0004000300020001
Done

CLI 與 API 參考資料

Eidcache

傳回 EID-to-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 參考資料

extaddr

取得 IEEE 802.15.4 延伸地址。

參數

沒有參數。

範例

extaddr
dead00beef00cafe
Done

CLI 與 API 參考資料

extpanid (設定)

設定 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)

取得外部 FEM 的 Rx LNA 增益值 (dBm)。

參數

沒有參數。

範例

fem lnagain
11
Done

CLI 與 API 參考資料

fem lnagain (集合)

設定外部 FEM 的 Rx LNA 增益值 (dBm)。

參數

沒有參數。

範例

fem lnagain 8
Done

CLI 與 API 參考資料

記錄 IPaddr

以資料表或清單格式顯示單點傳播 IPv6 位址記錄。

每個資料表或清單項目都提供以下功能:

  • 存在時間:發出指令後經過的時間,格式為:hours:minutes:seconds:milliseconds
  • 事件:可能的值為 AddedRemoved
  • 位址/前置字串長度:單點傳播位址及其前置字元長度 (以位元為單位)。
  • 來源:可能的值為 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 參考資料

記錄 IPmaddr

以資料表或清單格式顯示多點傳送 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
  • 模式:機器學習連結模式。可能的值包括:
    • -:未設定旗標 (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
  • 模式:機器學習連結模式。可能的值包括:
    • -:未設定旗標 (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:網域前置字元標記。
  • 偏好設定:偏好。值可以是 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 標記。
  • 偏好設定:偏好。值可以是 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 訊息有效)。
  • Sec:表示是否使用連結層安全性。
  • 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 參考資料

歷史紀錄 rxtx

以表格或清單格式顯示合併的 IPv6 訊息 RX 和 TX 記錄。

每個資料表或清單項目都提供以下功能:

  • 存在時間:發出指令後經過的時間,格式為:hours:minutes:seconds:milliseconds
  • 類型:
    • IPv6 訊息類型,例如 UDPTCPHopOptsICMP6 (及其子類型)。
    • src:來源 IPv6 位址和通訊埠編號。
    • dst:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
  • Len:IPv6 酬載長度 (不含 IPv6 標頭)。
  • Chksum:訊息總和檢查碼 (對 UDP、TCP 或 ICMP6 訊息有效)。
  • Sec:表示是否使用連結層安全性。
  • 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 參考資料

歷史紀錄 Tx

以資料表或清單格式顯示 IPv6 訊息 TX 記錄。

每個資料表或清單項目都提供以下功能:

  • 存在時間:發出指令後經過的時間,格式為:hours:minutes:seconds:milliseconds
  • 類型:
    • IPv6 訊息類型,例如 UDPTCPHopOptsICMP6 (及其子類型)。
    • src:來源 IPv6 位址和通訊埠編號。
    • dst:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
  • Len:IPv6 酬載長度 (不含 IPv6 標頭)。
  • Chksum:訊息總和檢查碼 (對 UDP、TCP 或 ICMP6 訊息有效)。
  • Sec:表示是否使用連結層安全性。
  • 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 (向上、向下)

上下移動 IPv6 介面。

呼叫此方法即可啟用或停用 IPv6 通訊。

參數

ifconfig up|down

範例

ifconfig up
Done
ifconfig down
Done

CLI 與 API 參考資料

ifconfig

指出 IPv6 介面是否開啟。

參數

沒有參數。

範例

ifconfig
down
Done
ifconfig
up
Done

CLI 與 API 參考資料

instanceid

取得執行個體 ID。

執行個體 ID 會在建構執行個體時設為隨機值,這樣執行個體的值在初始化後不會改變。

參數

沒有參數。

範例

instanceid
468697314
Done

CLI 與 API 參考資料

IPaddr 新增

將網路介面位址新增至 Thread 介面。

傳入的執行個體 aAddress 是由 Thread 介面複製。Thread 介面只支援固定數量的外部單點傳播位址。查看《OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS》。

參數

ipaddr add aAddress

範例

ipaddr add 2001::dead:beef:cafe
Done

CLI 與 API 參考資料

IPaddr del

這個外掛程式能從 Thread 介面移除網路介面位址。

參數

ipaddr del aAddress

範例

ipaddr del 2001::dead:beef:cafe
Done

CLI 與 API 參考資料

IPaddr

取得指派給 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 擴充位址做為介面 ID 衍生。

參數

沒有參數。

範例

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

IPmaddr 新增

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

Iipmaddrllatn

取得 Thread Link-Local 所有 Thread 節點多點傳播位址。

該位址是連結本機的 Unicast 前置碼式多點傳播位址 [RFC 3306],其中包含:

  • flgs 設為 3 (P = 1,T = 1)
  • 將視野設為 2
  • 亮度設為 64
  • 網路前置字串已設為網格本機前置字串
  • 群組 ID 已設為 1

參數

沒有參數。

範例

ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done

CLI 與 API 參考資料

Iipmaddr rlatn

取得 Thread Realm-Local 所有 Thread 節點的多點傳播位址。

該位址是運作範圍的 Unicast 前置碼式多點傳播位址 [RFC 3306],其中包含:

  • flgs 設為 3 (P = 1,T = 1)
  • 將視野設為 3
  • 亮度設為 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 參考資料

聯結器開始

啟用 Thread 彙整者角色。

參數

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

聯結機停靠點

停用「Thread 彙整者」角色。

參數

沒有參數。

範例

joiner stop
Done

CLI 與 API 參考資料

聯合通訊埠 (設定)

設定彙整器 UDP 通訊埠。

參數

joinerport udp-port

範例

joinerport 1000
Done

CLI 與 API 參考資料

聯合通訊埠

取得彙整器 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 參考資料

領先

取得 Thread 領導者資料。

參數

沒有參數。

範例

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

CLI 與 API 參考資料

領袖 (組合)

設定在領導者角色執行作業時使用的執行緒領導者權重。

直接將領導者權重設為新的值,替換掉先前的值 (判斷依據為目前 otDeviceProperties )。

參數

leaderweight weight

範例

leaderweight 128
Done

CLI 與 API 參考資料

領先

取得在領導者角色執行作業時使用的執行緒領導者權重。

參數

沒有參數。

範例

leaderweight
128
Done

CLI 與 API 參考資料

linkmetrics 設定強化版確認

傳送連結指標管理要求,以便清除以增強型 ACK 為基礎的探測。

參數

linkmetrics config [async] peer-ipaddr enhanced-ack clear
  • async:使用非封鎖模式。
  • peer-ipaddr 應為鄰近裝置的連結本機位址。

範例

linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done

CLI 與 API 參考資料

linkmetrics 設定 Enhanced-ack 註冊

其他 r 為選用項目,僅適用於參考裝置。指定此選項時,每個類型 ID 旗標的類型/平均列舉為保留設定。此 ID 用於驗證探測主體正確處理無效的類型 ID 旗標,且只有在 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 啟用時才能使用。

傳送連結指標管理要求,以註冊增強型增強型探測功能。

參數

linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
  • async:使用非封鎖模式。
  • [qmr] 會對應至 otLinkMetricsValues。根據規格 4.11.3.4.4.6,您一次最多只能使用兩個選項,例如 qqm
    • q:第 2 層 LQI。
    • m:連結利潤。
    • r:RSSI。

範例

linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
> linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Done

CLI 與 API 參考資料

linkmetrics 設定轉送

傳送 MLE 連結指標管理要求,以設定或清除正向追蹤系列。

參數

linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
  • async:使用非封鎖模式。
  • peer-ipaddr:對等互連位址。
  • series-id:系列叢書 ID。
  • [ldra] 對應至 otLinkMetricsSeriesFlagsX 代表任何 otLinkMetricsSeriesFlags,且停止計費並移除系列。
    • l:MLE Link Probe。
    • d:MAC 資料。
    • r:MAC 資料要求。
    • a:MAC Ack。
    • X:只能在沒有其他旗標的情況下使用。
  • [pqmr] 對應至 otLinkMetricsValues
    • p:收到的第 2 層 PDU 數量。
    • q:第 2 層 LQI。
    • m:連結利潤。
    • r:RSSI。

範例

linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Done

CLI 與 API 參考資料

連結指標探測器

傳送 MLE 連結探測器訊息。

參數

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr:對等互連位址。
  • series-id:這個 Probe 訊息指定的系列叢書 ID。
  • length:探測器訊息的長度。有效範圍為 [0, 64]。

範例

linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done

CLI 與 API 參考資料

轉送 linkmetrics 要求

執行連結指標查詢 (轉送追蹤系列)。

參數

linkmetrics query [async] peer-ipaddr forward series-id
  • async:使用非封鎖模式。
  • peer-ipaddr:對等互連位址。
  • series-id:系列叢書 ID。

範例

linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 forward 1
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)
Done

CLI 與 API 參考資料

連結指標要求單一

執行連結指標查詢 (單一探測)。

參數

linkmetrics request [async] peer-ipaddr single [pqmr]
  • async:使用非封鎖模式。
  • peer-ipaddr:對等互連位址。
  • [pqmr] 會對應至 otLinkMetrics
    • p:收到的第 2 層 PDU 數量。
    • q:第 2 層 LQI。
    • m:連結利潤。
    • r:RSSI。

範例

linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 single qmr
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)
Done

CLI 與 API 參考資料

linkmetricsmgr (啟用、停用)

啟用或停用連結指標管理工具。

參數

linkmetricsmgr enable|disable

範例

linkmetricmgr enable
Done
linkmetricmgr disable
Done

CLI 與 API 參考資料

連結指標模擬節目

透過延伸地址取得鄰居的連結指標資料。

參數

沒有參數。

範例

linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done

CLI 與 API 參考資料

定位 (設定)

找出最接近任意傳播位址的目的地 (也就是找出目的地的網狀本機 EID 和 RLOC16)。

系統會依據目前的路徑資料表和執行緒網格中的路徑費用,決定最接近的目的地。

啟用 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 層上的 TX 直接重試次數。

參數

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 引數,即可設定間接 Tx 重試次數。

範例

mac retries indirect
3
Done
 max retries indirect 5
Done

CLI 與 API 參考資料

Mac 傳送

指示 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 附加條件新增

必須先啟用 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 添加器

啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE 設定後才能使用。

這個指令會清除 MAC 篩選器清單中所有的擴充位址。

參數

沒有參數。

範例

macfilter addr clear
Done

CLI 與 API 參考資料

macfilter 新增器拒絕清單

啟用「denylist」MAC 篩選器模式,代表系統會拒絕存取 MAC 篩選器清單中的所有 MAC 位址。

參數

沒有參數。

範例

macfilter addr denylist
Done

CLI 與 API 參考資料

停用 macfilter 外掛程式

停用 MAC 篩選器模式。

參數

沒有參數。

範例

macfilter addr disable
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

macfilter 添加器

啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE 設定後才能使用。

提供下列資訊:

  • MAC 篩選器清單目前的模式:AllowListDenyList,Disabled
  • 篩選器中所有延伸地址的清單。如果將接收到的訊號強度 (rs) 和連結品質指標 (lqi) 設為與預設值不同,則地址旁邊會列出接收的信號強度 (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 參考資料

mac 篩選器

提供下列資訊:

  • Address Mode:MAC 篩選器的目前模式:AllowListDenyList,Disabled
  • MAC 篩選器清單中所有擴充地址的清單。如果將接收到的訊號強度 (rs) 和連結品質指標 (lqi) 設為與預設值不同,則地址旁邊會列出接收的信號強度 (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 參考資料

Meshdiag Childip6

將查詢傳送至父項,擷取其所有 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 參考資料

Meshdiag 子項表格

針對具有指定 RLOC16 的路由器,啟動其子項資料表查詢。輸出會列出所有子項目。每位孩子的資訊:

  • RLOC16
  • 擴充 MAC 位址
  • 執行緒版本
  • 逾時 (以秒為單位)
  • 年齡 (自上次得知後經過的秒數)
  • 監督時間間隔 (秒)
  • 已排入佇列的訊息數量 (以兒童睡著為例)
  • 裝置模式
  • RSS (平均值和最終值)
  • 錯誤率:框架 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

可鄰近的 Meshdiag 路由器

針對具有指定 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) 的路由器 ID
    • 2-links:這個路由器的連入連結 (連結品質為 2) 的路由器 ID
    • 1-links:這個路由器的連入連結連結品質為 1
    • 如果清單為空白,則系統會略過該清單。
  • 如果設為 ip6-addrs,系統會列出路由器的 IPv6 位址清單
  • 如果設為 children,請提供路由器的所有子項清單。每個兒童的相關資訊:
    • RLOC16
    • 從父項到子項的連入連結品質 (零表示不明)
    • 兒童裝置模式 (r rx-on-when-idle、d 完整執行緒裝置、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 參考資料

毫德

設定網格本機 IID (用於測試用途)。

需要 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE

您必須先使用 Thread 堆疊,才能啟用 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 參考資料

mode (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 時,停用設為 True 會重設翻譯器中的對應資料表。

啟用 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_ENABLE 時,PrefixManager 會傳回下列其中一種狀態:

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

啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE 時,Translator 會傳回下列其中一種狀態:

  • Disabled:NAT64 翻譯器已停用。
  • NotRunning:NAT64 翻譯器已啟用,但尚未轉譯封包。這可能表示翻譯器未設定 NAT64 前置字串,或 NAT64 的 CIDR。
  • Active:NAT64 翻譯器已啟用,正在轉譯封包。

參數

沒有參數。

範例

nat64 state
PrefixManager: Active
Translator: Active
Done

CLI 與 API 參考資料

鄰近交集清單

顯示鄰居的連線時間和年齡。這個指令與 neighbor conntime 類似,但會以清單格式顯示資訊。系統會以秒為單位顯示年齡和連線時間。

參數

沒有參數。

範例

neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done

CLI 與 API 參考資料

鄰居

顯示鄰居的連線時間和年齡。每個相鄰的資訊:

  • RLOC16
  • 擴充 MAC
  • 上次監聽時間 (年齡):上次聽鄰點後經過的秒數。
  • 連線時間:自建立連結後經過的秒數。如果時間長度間隔不到一天,持續時間間隔格式為 {hh}:{mm}:{ss},代表小時、分鐘和秒鐘。如果時間長度超過一天,則格式為 {dd}d.{hh}:{mm}:{ss}

參數

沒有參數。

範例

neighbor conntime
| RLOC16 | Extended MAC     | Last Heard (Age) | Connection Time  |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 |         00:00:13 |         00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 |         00:00:03 |         00:11:27 |
| 0xe800 | ce53628a1e3f5b3c |         00:00:02 |         00:00:15 |
Done

CLI 與 API 參考資料

鄰點連結品質

列印所有鄰居的連結品質資訊。

參數

沒有參數。

範例

neighbor linkquality
| RLOC16 | Extended MAC     | Frame Error | Msg Error | Avg RSS | Last RSS | Age   |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db |      0.00 % |    0.00 % |     -46 |      -48 |     1 |
| 0xc001 | 0ad7ed6beaa6016d |      4.67 % |    0.08 % |     -68 |      -72 |    10 |
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

鄰點清單

列出每個鄰居的 RLOC16。

參數

沒有參數。

範例

neighbor list
0xcc01 0xc800 0xf000
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

鄰點資料表

以表格格式顯示所有鄰居的相關資訊。

如果是 Role,這個資料表只能使用 C (子項) 或 R (路由器) 的值。

下列資料欄提供鄰點的裝置模式相關資訊。每個資料欄都有 0 (關閉) 或 1 (開啟) 的值。

  • R:閒置時開啟 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 參考資料

淨數據已滿

列印「是」或「否」表示「網路資料已滿」自上次使用 netdata full reset 重設標記以來,已叫用回呼。這個指令需要 OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL。「網路資料已滿」回呼函式會在以下情況下叫用:

  • 裝置扮演領袖,收到來自邊界路由器 (BR) 的網路資料註冊,但裝置無法新增至網路資料 (儲存空間用盡)。
  • 裝置會做為 BR 使用,您無法在本機網路資料中新增項目。
  • 裝置會扮演 BR 的角色,並嘗試向領導者註冊本機網路資料項目,但判斷其本機資料不符。

參數

沒有參數。

範例

netdata full
no
Done

CLI 與 API 參考資料

netdata 完整重設

重設標記追蹤,確認其是否顯示「net data full」回呼。

參數

沒有參數。

範例

netdata full reset
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

淨數據長度

取得分區 Thread 網路資料目前的長度 (位元組數)。

參數

沒有參數。

範例

netdata length
23
Done

CLI 與 API 參考資料

淨資料長度上限

取得自 OT 堆疊初始化以來,或自上次呼叫 otNetDataResetMaxLength() 以來的執行緒網路資料長度上限。

參數

沒有參數。

範例

netdata maxlength
40
Done

CLI 與 API 參考資料

netdata maxlength 重設

重設追蹤的執行緒網路資料長度上限。

參數

沒有參數。

範例

netdata maxlength reset
Done

CLI 與 API 參考資料

netdata 發布 dnssrp Anycast

發布包含序號的 DNS/SRP 服務 Anycast 位址。凡是透過先前的 publish dnssrp{anycast|unicast} 指令發布的現有 DNS/SRP 服務項目,都會遭到移除,並替換為新引數。

必須啟用「OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE」。

參數

netdata publish dnssrp anycast seq-num

範例

netdata publish dnssrp anycast 1
Done

CLI 與 API 參考資料

netdata 發布 dnssrp unicast (addr、通訊埠)

發布包含位址和通訊埠號碼的 DNS/SRP 服務單點傳播位址。服務 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 發布 dnssrp unicast (mle)

使用通訊埠編號發布裝置的 Mesh-Local 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 參考資料

Netdata 註冊

向領導者註冊已設定的前置字串、路徑和服務。

OT CLI 檢查 OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE。如果 OTBR 已啟用,則會向領導者註冊本機網路資料。否則,它會呼叫 CLI 函式 otServerRegister。詳情請參閱「使用 OT CLI 顯示及管理網路資料」一文。

參數

沒有參數。

範例

netdata register
Done

CLI 與 API 參考資料

netdata steeringdata Check (discerner)

檢查轉向資料是否包含具有特定光碟值的彙整器。

參數

netdata steeringdata check discerner
  • discerner:彙整器,格式為 {number}/{length}

範例

netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound

CLI 與 API 參考資料

netdata steeringdata 檢查 (eui64)

檢查導引資料是否包含彙整器。

參數

netdata steeringdata check eui64
  • eui64:加入者的 IEEE EUI-64。

範例

netdata steeringdata check d45e64fa83f81cf7
Done

CLI 與 API 參考資料

netdata unpublish (前置字串)

取消發布先前發布的 On-Mesh 或外部路徑前置字串。

必須啟用「OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE」。

詳情請參閱「使用 OT CLI 顯示及管理網路資料」一文。

參數

netdata unpublish prefix

範例

netdata unpublish fd00:1234:5678::/64
Done

CLI 與 API 參考資料

netdata 取消發布 DNS

取消發布先前在 Thread 網路資料中新增的 DNS/SRP (Anycast 或 Unicast) 服務項目。

必須啟用「OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE」。

參數

沒有參數。

範例

netdata unpublish dnssrp
Done

CLI 與 API 參考資料

Netstat

取得已連結 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:頻道頁面重點摘要
  • 19:子項逾時上限 TLV
  • 23:EUI64 TLV
  • 24:版本 TLV (通訊協定和功能的版本號碼)
  • 25:供應商名稱 TLV
  • 26:廠商型號 TLV
  • 27:供應商軟體版本 TLV
  • 28:執行緒堆疊版本 TLV (執行緒堆疊程式碼 base/commit/版本的版本 ID 為 UTF-8 字串)
  • 29:子項 TLV
  • 34:MLE 計數器 TLV
  • 35:供應商應用程式網址重點摘要

範例

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

下一個躍點 (取得)

取得到達指定 RLOC16 目的地的下一個躍點和路徑費用。

可與 aNextHopRloc16aPathCost 搭配使用,表示呼叫端不想取得這個值。

參數

nexthop rloc16

範例

nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done

CLI 與 API 參考資料

nexthop

這個輸出內容表格列出了已分配的路由器 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 永久帳號 ID。

只有在停用 Thread 通訊協定時才能成功。如果呼叫這個函式成功,則非揮發性記憶體中的有效和待處理作業資料集也會失效。

參數

panid panid

範例

panid 0xdead
Done

CLI 與 API 參考資料

恐慌

取得 IEEE 802.15.4 永久帳號 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 參考資料

父項優先順序 (get,set)

取得或設定指派的父項優先順序值:1、0、-1 或 -2。-2 表示未指定。

參數

parentpriority [parentpriority]

範例

parentpriority
1
Done
parentpriority 1
Done

CLI 與 API 參考資料

partitionid

取得 Thread 網路分區 ID。

參數

沒有參數。

範例

partitionid
4294967295
Done

CLI 與 API 參考資料

優先使用 partitionid (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 參考資料

Preferredrouterid

指定首席應提供的偏好路由器 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

PSkc -p

透過通關密語 (採用 UTF-8 編碼) 產生 pskc,以及目前的網路名稱和擴充永久帳號 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 參考資料

pskcref

取得儲存的 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/Sleep 狀態的時間。這些時間以微秒為單位。所有時間均從上次重設的無線電統計資料開始計算。

參數

沒有參數。

範例

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

區域 (設定)

設定區碼。

無線電區域格式採用 2 位元組的 ASCII 表示法,採 ISO 3166 alpha-2 代碼,

變更這項設定可能會影響傳輸功率限制。

參數

沒有參數。

範例

region US
Done

CLI 與 API 參考資料

區域

取得區碼。

無線電區域格式採用 2 位元組的 ASCII 表示法,採 ISO 3166 alpha-2 代碼,

參數

沒有參數。

範例

region
US
Done

CLI 與 API 參考資料

發布路徑 (路線)

釋出裝置為主要角色分配的路由器 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 參考資料

routerselectionjitter

取得或設定 ROUTER_SELECTION_JITTER 值。

參數

routerselectionjitter [jitter]

範例

routerselectionjitter
120
Done
routerselectionjitter 120
Done

CLI 與 API 參考資料

Router 升級門檻 (get、set)

取得或設定 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 參考資料

SFTP 查詢

傳送 SNTP 查詢以取得目前的 Unix 紀元時間 (從 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 參考資料

安全伺服器用戶端自動開始 (get)

指出自動啟動模式 (已啟用或已停用) 的目前狀態。詳情請參閱「透過 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器與用戶端連線」。

參數

沒有參數。

範例

srp client autostart
Disabled
Done

CLI 與 API 參考資料

停用 SSL 用戶端自動啟動功能

停用自動開始模式。

停用自動啟動模式不會停止執行中的用戶端。不過,SRP 用戶端會停止監控 Thread 網路資料。

參數

沒有參數。

範例

srp client autostart disable
Done

CLI 與 API 參考資料

啟用 SSL 用戶端自動啟動功能

啟用自動開始模式。

啟用自動開始功能後,SRP 用戶端就會監控 Thread 網路資料,找出 SRP 伺服器,選取偏好的伺服器,並在偵測到 SRP 伺服器時,自動啟動及停止用戶端。

網路資料項目有三個類別,代表有 SRP 伺服器,建議您按照下列順序排列:

  1. 服務資料中包含伺服器位址的 Unicast 項目。如果有多個選項,系統會優先採用數值最低的 IPv6 位址選項。
  2. 每個都有序號的 Anycast 項目。建議使用 RFC-1982 中序號算術邏輯指定的最大序號。
  3. 包含伺服器位址資訊的 Unicast 項目。如果有多個選項,系統會優先採用數值最低的 IPv6 位址選項。

參數

沒有參數。

範例

srp client autostart enable
Done

CLI 與 API 參考資料

srp 用戶端回呼 (get、enable、disable)

從 SRP 用戶端取得或啟用/停用列印回呼事件。詳情請參閱「透過 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器與用戶端連線」。

參數

srp client callback [enable|disable]

範例

srp client callback enable
Done
srp client callback
Enabled
Done

CLI 與 API 參考資料

安全伺服器主機位址 (get)

用於指出是否已啟用自動地址模式。如果未啟用自動位址模式,系統會傳回 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 參考資料

安全伺服器主機位址 (已設定)

啟用自動主機位址模式或明確設定主機位址清單。詳情請參閱「透過 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 參考資料

SRM 用戶端主機清除

清除所有主機資訊和服務。

參數

沒有參數。

範例

srp client host clear
Done

CLI 與 API 參考資料

SSL 用戶端主機名稱 (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 參考資料

從 SSL 用戶端主機移除

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

AMP 用戶端主機

取得主機資訊。

參數

沒有參數。

範例

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

SSL 用戶端主機狀態

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

SSL 用戶端伺服器位址

傳回伺服器的 IPv6 位址。

參數

沒有參數。

範例

srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

安全伺服器用戶端伺服器通訊埠

傳回伺服器的通訊埠號碼。

參數

沒有參數。

範例

srp client server port
4724
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

AMP 用戶端伺服器

取得 SRP 用戶端目前使用的 SRP 伺服器通訊端位址 (IPv6 位址和通訊埠號碼)。如果用戶端並未執行,系統就不會指定位址 (所有零),其通訊埠編號為 0。詳情請參閱「透過 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器與用戶端連線」。

參數

沒有參數。

範例

srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done

CLI 與 API 參考資料

SSL 用戶端服務新增

新增具有指定執行個體名稱、服務名稱和通訊埠編號的服務。詳情請參閱「透過 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 參考資料

安全伺服器用戶端服務金鑰 (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 參考資料

crp 客戶服務名稱清楚

清除服務,立即從用戶端服務清單中移除服務,不會與 SRP 伺服器互動。

參數

srp client service clear instancename servicename

範例

srp client service clear ins2 _test2._udp
Done

CLI 與 API 參考資料

從 SSL 用戶端服務移除

要求向 SRP 伺服器取消註冊服務。

參數

srp client service remove instancename servicename

範例

srp client service remove ins2 _test2._udp
Done

CLI 與 API 參考資料

AMP 用戶端服務

取得由用戶端管理的服務清單。

參數

沒有參數。

範例

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

SAP 用戶端啟動

啟動 SRP 用戶端作業。詳情請參閱「透過 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器與用戶端連線」。

參數

srp client start serveraddr serverport

範例

srp client start fd00::d88a:618b:384d:e760 4724
Done

CLI 與 API 參考資料

AMP 用戶端狀態

表示 SRP 用戶端是否正在執行。

參數

沒有參數。

範例

srp client state
Enabled
Done

CLI 與 API 參考資料

SRp 用戶端停止

停止 SRP 用戶端作業。

停止與 SRP 伺服器的任何進一步互動。請注意,該網頁不會移除或清除主機資訊和/或服務清單。用戶端啟動 (重新啟動) 後,即可再次標記要新增/移除的所有服務。

參數

沒有參數。

範例

srp client stop
Done

CLI 與 API 參考資料

標準 SSL 用戶端 ttl (get、set)

取得或設定 ttl (存留時間) 值 (以秒為單位)。

參數

srp client ttl [value]

範例

srp client ttl 3600
Done
srp client ttl
3600
Done

CLI 與 API 參考資料

安全伺服器伺服器 (啟用、停用)

啟用或停用 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 伺服器,以及何時要停用。

這個指令需要先啟用 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 參考資料

安全伺服器網域 (get、set)

取得或設定 SRP 伺服器的網域名稱。

參數

srp server domain [domain-name]

範例

srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done

CLI 與 API 參考資料

SAP 伺服器主機

傳回所有已註冊主機的相關資訊。詳情請參閱「透過 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 參考資料

SAP 伺服器租用 (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 參考資料

安全伺服器加密伺服器 (get,set)

取得或設定與 Anycast 位址模式搭配使用的序號。序號包含在「DNS/SRP Service Anycast 位址」中項目。

參數

srp server seqnum [seqnum]

範例

srp server seqnum 20
Done
srp server seqnum
20
Done

CLI 與 API 參考資料

AMP 伺服器服務

傳回已註冊服務的相關資訊。

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

AMP 伺服器狀態

傳回 SRP 伺服器可能出現的狀態之一:

  • disabled:SRP 伺服器未啟用。
  • stopped:由於 SRP 伺服器已在 Thread 網路中運作,因此 SRP 伺服器已啟用,但目前無效。當 SRP 伺服器在 Thread 網路中失效時,SRP 伺服器就會啟用。
  • running:SRP 伺服器已啟用,可處理服務註冊。

詳情請參閱「透過 OT CLI 設定服務註冊通訊協定 (SRP) 伺服器與用戶端連線」。

參數

沒有參數。

範例

srp server state
running
Done

CLI 與 API 參考資料

傳回 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

tcp 繫結

將 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 連線

建立與指定對等點的連線。

如果連線建立成功,產生的 TCP 連線會與範例 TCP 端點相關聯。詳情請參閱使用 OT CLI 測試 TCP 功能

參數

tcp connect ip port [fastopen]
  • ip:對等點的 IP 位址。這個位址可以是 IPv4 位址,系統會使用網路資料中偏好的 NAT64 前置字元,將這類位址合成至 IPv6 位址。當偏好的 NAT64 前置字串無法使用時,這個指令會傳回 InvalidState
  • port:對等點的 TCP 通訊埠編號。
  • fastopen:此為選用參數。如果設為 fast,此連線就會啟用 TCP 快速開啟。否則,如果此參數設為 slow 或未使用,則 TCP 快速開啟功能會停用。

範例

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 監聽

使用範例 TCP 事件監聽器監聽指定 IPv6 位址和通訊埠的傳入連線。詳情請參閱使用 OT CLI 測試 TCP 功能

參數

tcp listen ip port

以下是必要參數:

  • iptcp CLI 提供給範例 TCP 事件監聽器的 IPv6 位址或未指定 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 Sendend

傳送「直播結束」與 tcp CLI 提供的範例 TCP 端點相關聯的 TCP 連線送出訊號。這會提醒對等節點,無法再透過這個 TCP 連線接收任何資料。

參數

沒有參數。

範例

tcp sendend
Done

CLI 與 API 參考資料

tcp 停止監聽

指示範例 TCP 事件監聽器停止監聽傳入的 TCP 連線。

參數

沒有參數。

範例

tcp stoplistening
Done

CLI 與 API 參考資料

測試 tmforiginfilter

啟用或停用篩選器,排除來源不受信任的 TMF UDP 郵件。

根據預設,系統會啟用捨棄不受信任來源的 TMF UDP 郵件。如果停用這項設定,系統會允許傳送至不受信任來源 (例如主機、CLI 或外部 IPv6 節點) 的 TMF 通訊埠的 UDP 訊息。

參數

test tmforiginfilter [enable|disable]

範例

test tmforiginfilter
Enabled
test tmforiginfilter enable
Done
test tmforiginfilter disable
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

討論串開頭

啟動 Thread 通訊協定作業。

參數

沒有參數。

範例

thread start
Done

CLI 與 API 參考資料

停止執行緒

停止 Thread 通訊協定作業。

參數

沒有參數。

範例

thread stop
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

執行緒版本

取得 Thread 通訊協定版本。

常數 OT_THREADVERSION* 會定義數值版本值。

參數

沒有參數。

範例

 thread version
2
Done

CLI 與 API 參考資料

佇列時間上限

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

timeinqueue

取得 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 篩選器模式。

啟用篩選器模式後,所有透過 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 參考資料

AP 繫結

指派 IPv6 位址和通訊埠至開放式通訊端,藉此將通訊端繫結至通訊端。指派 IPv6 位址和通訊埠的方式稱為為通訊端命名。詳情請參閱「使用 OT CLI 測試 UDP 功能」。

參數

udp bind [netif] ip port
  • netif:繫結網路介面,其決定方式如下:
    • 無值 (從指令中省略此參數):使用 Thread 網路介面。
    • -u:未指定的網路介面,代表 UDP/IPv6 堆疊會決定要將通訊端繫結至哪個網路介面。
    • -b:使用骨幹網路介面。
  • ip:要繫結的單點 IPv6 位址。如果您想讓 UDP/IPv6 堆疊指派繫結 IPv6 位址,或想要繫結至多點傳送 IPv6 位址,可以使用下列值使用未指定的 IPv6 位址:::。每個範例使用未指定的 IPv6 位址。
  • port:要繫結的 UDP 通訊埠編號。每個範例都使用通訊埠編號 1234。

範例

udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done

CLI 與 API 參考資料

udp 關閉

關閉 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 連結安全性 (啟用、停用)

啟用或停用連結安全性功能。

參數

沒有參數。

範例

udp linksecurity enable
Done
udp linksecurity disable
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

udp 連結安全性

指出是否啟用或停用連結安全性功能。

參數

沒有參數。

範例

udp linksecurity
Enabled
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

啟用 udp。

開啟 UDP/IPv6 通訊端。

參數

沒有參數。

範例

udp open
Done

CLI 與 API 參考資料

udp Send

使用通訊端傳送 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.::."(超過一天)。

如果產生的字串不符合 aBuffer (在其 aSize 字元中) 內,就會截斷該字串,但輸出的字串一律以空值結束。

參數

沒有參數。

範例

uptime
12:46:35.469
Done

CLI 與 API 參考資料

供應商 appurl (設定)

設定供應商應用程式網址字串。

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

供應商轉換 (設定)

設定供應商軟體版本字串。

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

供應商 wversion

取得供應商軟體版本字串。

參數

沒有參數。

範例

vendor swversion
Marble3.5.1
Done

CLI 與 API 參考資料

Verhoeff 計算

計算指定十進位字串的 Verhoeff 總和檢查碼。

需要 OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE

參數

verhoeff calculate decimalstring

範例

verhoeff calculate 30731842
1
Done

CLI 與 API 參考資料

Verhoeff 驗證

驗證指定十進位字串的 Verhoeff 總和檢查碼。

需要 OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE

參數

verhoeff validate decimalstring

範例

verhoeff validate 307318421
Done

CLI 與 API 參考資料

版本 API

顯示 API 版本號碼。

參數

沒有參數。

範例

version api
28
Done

CLI 與 API 參考資料

  • 沒有相關聯的 API

版本

取得 OpenThread 版本字串。

參數

沒有參數。

範例

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

CLI 與 API 參考資料