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_LENGTH
至 OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH
之間 (含首尾)。
在先前設定的金鑰逾時前,再次設定臨時金鑰,將會取代先前設定的金鑰,並重設逾時設定。
雖然逾時間隔仍然有效,但外部代理程式只能使用一次臨時金鑰進行連線。代理程式中斷連線時,系統會清除暫時金鑰, Border Agent 改回使用 PSKc。
參數
沒有參數。
範例
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
CLI 與 API 參考資料
ba ID (get,set)
取得或設定 16 個位元組的邊界路由器 ID,這組 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
,請以指定的 status
或 coap-code
回應下一個 DUA.req。
啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
bbr mgmt dua status|coap-code [meshLocalIid]
如果是 status
或 coap-code
,請使用:
- 0:ST_DUA_SUCCESS
- 1:ST_DUA_REGISTER
- 2:ST_DUA_INVALID
- 3:ST_DUA_DUPLICATE
- 4:ST_DUA_NO_RESOURCES
- 5:ST_DUA_BBR_NOT_PRIMARY
- 6:ST_DUA_GENERAL_FAILURE
- 160:COAP 代碼 5.00
範例
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
CLI 與 API 參考資料
bbr mgmt mlr 事件監聽器新增
新增具有逾時值的多點傳播監聽器 (以秒為單位)。
傳遞 0
即可使用預設的 MLR 逾時。
需啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
bbr mgmt mlr listener add ipaddress [timeout-seconds]
範例
bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done
CLI 與 API 參考資料
bbr mgmt mlr 事件監聽器
傳回多點傳播監聽器和 otBackboneRouterMulticastListenerInfomTimeout
以秒為單位。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
和 OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
後才能使用。
參數
沒有參數。
範例
bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
CLI 與 API 參考資料
bbr mgmt mlr 事件監聽器
清除多點傳播監聽器。
需啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
沒有參數。
範例
bbr mgmt mlr listener clear
Done
CLI 與 API 參考資料
bbr mgmt mlr 回應
設定下一次多點傳播監聽器註冊的回應狀態。
需啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
和 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
後才能使用。
參數
bbr mgmt mlr response status-code
如果是 status-code
,請使用:
- 0:ST_MLR_SUCCESS
- 2:ST_MLR_INVALID
- 3:ST_MLR_NO_PERSISTENT
- 4:ST_MLR_NO_RESOURCES
- 5:ST_MLR_BBR_NOT_PRIMARY
- 6:ST_MLR_GENERAL_FAILURE
範例
bbr mgmt mlr response 2
Done
CLI 與 API 參考資料
bbr 登錄
明確註冊本機 Backbone 路由器設定。
系統已針對連接的裝置觸發伺服器資料要求訊息 SRV_DATA.ntf
。
啟用 OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
後才能使用。
參數
沒有參數。
範例
bbr register
Done
CLI 與 API 參考資料
bbr 狀態
取得骨幹路由器 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_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager auto enable
1
是 enable
的布林值。
範例
channel manager auto 1
channel manager auto 1
Done
CLI 與 API 參考資料
頻道管理員異動
要求 Thread 網路頻道變更。
網路會在指定的延遲時間過後切換至指定頻道 (請參閱 otChannelManagerSetDelay())。系統會更新待處理的作業資料集,藉此執行管道變更。
後續通話便會取消先前要求的頻道變更。
「OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
」為必填欄位。
參數
channel manager change channel-num
範例
channel manager change 11
channel manager change 11
Done
CLI 與 API 參考資料
頻道管理員
取得頻道管理員狀態。「OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
」或「OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
」為必填欄位。
參數
沒有參數。
範例
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
CLI 與 API 參考資料
頻道管理員延遲
設定聯播網版本變更所使用的延遲時間 (以秒為單位)。
僅適用於 FTD。這類延遲時間應大於 Thread 網路中所有睡眠端裝置所使用的資料輪詢時間間隔上限。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager delay delay-seconds
範例
channel manager delay 120
channel manager delay 120
Done
CLI 與 API 參考資料
頻道管理員喜歡
設定喜歡的頻道遮罩。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager favored mask
範例
channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
CLI 與 API 參考資料
頻道管理員間隔
設定自動頻道選擇功能使用的時段間隔 (以秒為單位)。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager interval interval-seconds
範例
channel manager interval 10800
channel manager interval 10800
Done
CLI 與 API 參考資料
選取頻道管理員
ChannelManager
會檢查並選取新頻道,並開始變更頻道。
與
otChannelManagerRequestChannelChange()
不同,後者必須指定為參數,這個函式會要求 ChannelManager
根據收集的頻道品質資訊自行選取頻道。
按下連結後,頻道管理員將執行下列 3 個步驟:
1) ChannelManager
決定是否對頻道進行變更有幫助。如果將 aSkipQualityCheck
設為 True,則可以略過這項檢查 (強制選取頻道並略過品質檢查)。這個步驟會使用裝置上收集到的連結品質指標 (例如 CCA 失敗率、每個鄰居的訊息錯誤率等),判斷目前的頻道品質是否屬於需要調整頻道變更的等級。
2) 如果第一個步驟通過,ChannelManager
會選擇可能更合適的頻道。該模組會使用 ChannelMonitor
模組收集到的頻道品質資料。這個步驟會使用支援和偏好的管道。(請參閱
otChannelManagerSetSupportedChannels()
和
otChannelManagerSetFavoredChannels()
)。
3) 如果新選取的頻道與目前的頻道不同,ChannelManager
會要求/啟動頻道變更程序 (內部叫用 RequestChannelChange()
)。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager select skip-quality-check
針對布林值 skip-quality-check
,使用 1
或 0
。
範例
channel manager select 1
channel manager select 1
Done
CLI 與 API 參考資料
支援的頻道管理員
設定支援的頻道遮罩。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager supported mask
範例
channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
CLI 與 API 參考資料
頻道管理員門檻
設定 CCA 失敗率門檻。
必須提供 OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
或 OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
和 OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
。
參數
channel manager threshold threshold-percent
請為 threshold-percent
使用十六進位值。0
會對應至 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 參考資料
subrouterlinks (get,set)
取得或設定 MLE_CHILD_ROUTER_LINKS 值。
參數
childrouterlinks [links]
範例
childrouterlinks
16
Done
childrouterlinks 16
Done
CLI 與 API 參考資料
子監護結帳時間 (已設定)
為孩子設定監督檢查逾時間隔 (以秒為單位)。
參數
childsupervision checktimeout timeout-seconds
範例
childsupervision checktimeout 30
Done
CLI 與 API 參考資料
子監督結帳系統逾時
取得孩子的監督檢查逾時間隔 (以秒為單位)。
如果裝置是想睡覺的孩子,但是在指定的檢查逾時期限內,裝置也未收到父項通知,就會啟動重新附加程序 (MLE 子項更新要求/回應與父項進行交換)。
參數
沒有參數。
範例
childsupervision checktimeout
30
Done
CLI 與 API 參考資料
子項權限間隔 (設定)
為孩子設定監督時間間隔 (以秒為單位)。
參數
childsupervision interval interval-seconds
範例
childsupervision interval 30
Done
CLI 與 API 參考資料
子項權限間隔
取得子項的子項監督間隔 (以秒為單位)。
孩童監督功能為家長提供了一個機制,確保他們的訊息會在監督間隔時間中傳送給每位睡著的孩子。如果沒有在監督期間向孩子傳輸訊息,OpenThread 會將子項監督訊息排入佇列,並傳送子項監督訊息給子項。
參數
沒有參數。
範例
childsupervision interval
30
Done
CLI 與 API 參考資料
子項逾時 (設定)
設定在子項角色中作業時,使用的執行緒子項逾時 (以秒為單位)。
參數
childtimeout timeout-seconds
範例
childtimeout 300
Done
CLI 與 API 參考資料
子項逾時
取得子項角色作業時使用的執行緒子項逾時 (以秒為單位)。
參數
沒有參數。
範例
childtimeout
300
Done
CLI 與 API 參考資料
Coap 取消
取消現有的觀測訂閱對 CoAP 伺服器上的遠端資源。
參數
沒有參數。
範例
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-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
範例
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
凝視觀察
觸發訂閱要求,讓 CoAP 用戶端觀察 CoAP 伺服器上的指定資源是否有狀態變更。
參數
coap observe address uri-path [type]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:無法確認 (預設)。
範例
coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
coap 參數(get,set)
在沒有選用參數的情況下執行指令時,取得目前的 CoAP 參數值。
根據所選語法,將 CoAP 參數設為預設值或您指定的值。
參數
coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
type
:request
用於 CoAP 要求,response
用於 CoAP 回應。如果未提供其他參數,指令會顯示目前的設定。default
:將傳輸參數設為下列預設值:ack_timeout
:2000 毫秒ack_random_factor_numerator
:3ack_random_factor_denominator
: 2max_retransmit
:4
ack_timeout
:ACK_TIMEOUT
(0-UINT32_MAX),以毫秒為單位。請參閱 RFC7252。ack_random_factor_numerator
:ACK_RANDOM_FACTOR
分子,可能值為 0 到 255。請參閱 RFC7252。ack_random_factor_denominator
:ACK_RANDOM_FACTOR
分母,可能值為 0 至 255。請參閱 RFC7252。max_retransmit
:MAX_RETRANSMIT
(0-255)。請參閱 RFC7252。
範例
coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
Coap 貼文
建立指定的 CoAP 資源。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定 (CoAP) 資源。
參數
coap post address uri-path [type] [payload]
address
:CoAP 伺服器的 IPv6 位址。uri-path
:資源的 URI 路徑。type
:con
:可確認non-con
:無法確認 (預設)block-
:使用這個選項後面加上區塊值,即可針對酬載隨機產生的位元組數傳送區塊。有效值為block-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAP 酬載要求,如果使用為字串或整數,視type
而定。如果type
是con
或non-con
,則payload
參數為選用項目。如果您保留payload
參數,則會傳送空白的酬載。不過,如果您使用payload
參數,其值必須是字串,例如hellothere
。如果type
是block-
,payload
參數的值必須是整數,用來指定要傳送的區塊數量。必須設定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-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAP 酬載要求,如果使用為字串或整數,視type
而定。如果type
是con
或non-con
,則payload
參數為選用項目。如果您保留payload
參數,則會傳送空白的酬載。不過,如果您使用payload
參數,其值必須是字串,例如hellothere
。如果type
是block-
,payload
參數的值必須是整數,用來指定要傳送的區塊數量。必須設定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-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
範例
coaps get test-resource
Done
coaps get test-resource block-1024
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
避震
表示 CoAP Secure 服務是否關閉。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定安全 (CoAPS) 資源。
參數
沒有參數。
範例
coaps isclosed
no
Done
CLI 與 API 參考資料
Coaps 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-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAPS 酬載要求,如果使用為字串或整數,視type
而定。如果type
是con
或non-con
,則酬載參數為選用項目。如果您略過酬載參數,則會傳送空白的酬載。不過,如果您使用酬載參數,其值必須是字串,例如hellothere
。如果type
為block-
,酬載參數值必須是整數,用來指定要傳送的區塊數量。必須設定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-16
、block-32
、block-64
、block-128
、block-256
、block-512
或block-1024
。
payload
:CoAPS 酬載要求,如果使用為字串或整數,視type
而定。如果type
是con
或non-con
,則酬載參數為選用項目。如果您略過酬載參數,則會傳送空白的酬載。不過,如果您使用酬載參數,其值必須是字串,例如hellothere
。如果type
為block-
,酬載參數值必須是整數,用來指定要傳送的區塊數量。必須設定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-cert
和 max-conn-attempts
參數仍會在下列組合中運作:
- 未指定引數:使用預設值。
- 將
check-peer-cert
設為true
:效果與省略引數相同,也就是check-peer-cert
的值為true
,max-conn-attempts
值為 0。 - 將
check-peer-cert
設為false
:check-peer-cert
的值為false
,max-conn-attempts
值為 0。 - 指定數字:
check-peer-cert
為true
,max-conn-attempts
值則是引數中指定的數字。
範例
coaps start
Done
coaps start false
Done
coaps start 8
Done
CLI 與 API 參考資料
煤炭停靠站
停止 CoAP Secure 服務。詳情請參閱使用 OT CLI 將連線傳送至受限應用程式通訊協定安全 (CoAPS) 資源。
參數
沒有參數。
範例
coaps stop
Done
CLI 與 API 參考資料
Coaps x509
使用 DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
設定本機裝置的 X509 憑證,以及 DTLS 工作階段的相應私密金鑰。
參數
沒有參數。
範例
coaps x509
Done
CLI 與 API 參考資料
委員公告
傳送「開始」訊息。
參數
commissioner announce mask count period destination
mask
:這個位元遮罩可識別傳送 MLEAnnounce
訊息的管道。count
:每個聲道的 MLEAnnounce
傳輸次數。period
:連續 MLEAnnounce
傳輸之間的毫秒數。destination
:訊息的目的地 IPv6 位址。訊息可能是多點傳播。
範例
commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done
CLI 與 API 參考資料
委員能
傳送能源掃描查詢訊息。指令輸出內容會在接收時列印。
參數
commissioner energy mask count period scanDuration destination
mask
:可識別執行 IEEE 802.15.4 能量掃描的位元遮罩。count
:每個管道的 IEEE 802.15.4 能量掃描數量。period
:連續 IEEE 802.15.4 能量掃描之間的毫秒數。scanDuration
:執行 IEEE 802.15.4 能源掃描時使用的掃描時間長度 (以毫秒為單位)。destination
:訊息的目的地 IPv6 位址。訊息可能是多點傳播。
範例
commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0
CLI 與 API 參考資料
委託者 ID (get,set)
取得或設定 OpenThread 委員會 ID 名稱。
參數
commissioner id name
範例
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
CLI 與 API 參考資料
新增委託人員加入
新增彙整者項目。
參數
commissioner joiner add eui64|discerner pksd [timeout]
eui64
:加入者的 IEEE EUI-64。如要比對任何彙整器,請使用*
。discerner
:彙整器,格式為number/length
。pksd
:彙整器的預先共用金鑰。timeout
:彙整器逾時,以秒為單位。
範例
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
CLI 與 API 參考資料
委託代理彙整器移除
移除 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 參考資料
委員狀態
傳回執行委員會的目前狀態。可能的值包括 active
、disabled
或 petition
(請申請成為委員會)。
參數
沒有參數。
範例
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 會檢查是否含有 active
、pending
或 tlvs
,並傳回對應的值。否則,OT CLI 會建立新的隨機網路,並傳回新的資料集。
參數
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
使用 new
初始化新的資料集,然後輸入 dataset commit active
指令。針對十六進位編碼的 TLV,請使用 tlvs
。
範例
dataset init new
Done
CLI 與 API 參考資料
資料集網格本機前置字串 (get,set)
取得或設定 otOperationalDataset::mMeshLocalPrefix。
參數
dataset meshlocalprefix [meshlocalprefix]
使用選用的 meshlocalprefix
引數設定 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 的任意組合,例如activetimestamp
、pendingtimestamp
或networkkey
。 - 選用的
-x
引數會指定要要求的原始 TLV。
範例
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done
CLI 與 API 參考資料
- otDatasetSendMgmtActiveGet
- dataset mgmtgetcommand 待處理
- 資料集 mgmtsetcommand 有效
- dataset mgmtsetcommand 待處理
資料集 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 參考資料
- otDatasetSendMgmtActiveSet
- 資料集 mgmtgetcommand 有效
- dataset mgmtgetcommand 待處理
- dataset mgmtsetcommand 待處理
資料集 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]]
- 使用
rotationtime
代表thrKeyRotation
(以小時為單位)。 - 安全性政策指令使用
onrcCepR
引數對應取得及設定 otSecurityPolicy 成員,例如o
代表 otSecurityPolicy::mObtainNetworkKeyEnabled。詳情請參閱使用 OT CLI 顯示及管理資料集。
範例
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
- 事件:可能的值為
Added
或Removed
。 - 位址/前置字串長度:單點傳播位址及其前置字元長度 (以位元為單位)。
- 來源:可能的值為
thread
、slaac
、dhcp6
或manual
。 - 範圍:IPv6 位址範圍。
- P:首選旗標。
- V:有效標記。
- RLOC (R):此標記會指出 IPv6 位址是否為路由定位器。
參數
history ipaddr [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history ipaddr
| Age | Event | Address / Prefix Length | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
| 00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:00:44.647 | Added | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:01:07.199 | Added | fd00:0:0:0:0:0:0:1/64 | manual | 14 | Y | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:fc00/64 | thread | 3 | N | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64 | thread | 3 | N | Y | N |
| 00:02:23.904 | Added | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64 | thread | 2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done
CLI 與 API 參考資料
記錄 IPmaddr
以資料表或清單格式顯示多點傳送 IPv6 位址記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Subscribed
或Unsubscribed
。 - 多點傳播位址
- 來源:可能的值為
Thread
或Manual
。
參數
history ipmaddr [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history ipmaddr
| Age | Event | Multicast Address | Origin |
+----------------------+--------------+-----------------------------------------+--------+
| 00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:25.353 | Subscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:54.953 | Subscribed | ff03:0:0:0:0:0:0:2 | Thread |
| 00:01:54.953 | Subscribed | ff02:0:0:0:0:0:0:2 | Thread |
| 00:01:59.329 | Subscribed | ff33:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:01:59.329 | Subscribed | ff32:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:fc | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff02:0:0:0:0:0:0:1 | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done
CLI 與 API 參考資料
歷史鄰居
以表格或清單格式顯示鄰點記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
Child
或Router
。 - 事件:可能的值為
Added
、Removed
或Changed
。 - 詳細地址
- RLOC16
- 模式:機器學習連結模式。可能的值包括:
-
:未設定旗標 (rx-off-when-idle、最低 Thread 裝置、穩定的網路資料)。r
:rx-on-when-idled
:完整 Thread 裝置。n
:完整網路資料
- Ave RSS:記錄項目時,從鄰點接收的平均影格數 (以 dBm 為單位)。
參數
history neighbor [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done
CLI 與 API 參考資料
歷史記錄 netinfo
以表格或清單格式顯示網路資訊記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 角色:裝置角色。可能的值包括
router
、child
、detached
或disabled
。 - 模式:機器學習連結模式。可能的值包括:
-
:未設定旗標 (rx-off-when-idle、最低 Thread 裝置、穩定的網路資料)。r
:rx-on-when-idled
:完整 Thread 裝置。n
:完整網路資料
- RLOC16
- 分區 ID。
參數
history netinfo [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:02:05.451 | router | rdn | 0x6000 | 151029327 |
| 00:04:04.719 | child | rdn | 0x2001 | 151029327 |
Done
CLI 與 API 參考資料
記錄前置字串
以資料表或清單格式顯示網格前置字串記錄的網路資料。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
或Removed
。 - 前置字串
- 檢舉/意義:
p
:首選標記a
:無狀態 IPv6 位址自動設定旗標。d
:DHCPv6 IPv6 位址設定旗標。c
:DHCPv6 其他設定標記。r
:預設路徑標記。o
:位於網格標記上。s
:穩定版標記。n
:Nd Dns 標記。D
:網域前置字元標記。
- 偏好設定:偏好。值可以是
high
、med
或low
。 - RLOC16
參數
history prefix [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history prefix
| Age | Event | Prefix | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:10.663 | Added | fd00:1111:2222:3333::/64 | paro | med | 0x5400 |
| 00:01:02.054 | Removed | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:21.136 | Added | fd00:abba:cddd:0::/64 | paos | med | 0x5400 |
| 00:01:45.144 | Added | fd00:dead:beef:1::/64 | paros | high | 0x3c00 |
| 00:01:50.944 | Added | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:59.887 | Added | fd00:dead:beef:1::/64 | paros | med | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done
CLI 與 API 參考資料
歷史路線
以表格或清單格式顯示網路資料外部路徑記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
或Removed
。 - 路線
- 檢舉/意義:
s
:穩定版標記。n
:NAT64 標記。
- 偏好設定:偏好。值可以是
high
、med
或low
。 - RLOC16
參數
history route [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history route
| Age | Event | Route | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:05.456 | Removed | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:29.310 | Added | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:42.822 | Added | fd00:1111:0::/48 | s | med | 0x5400 |
| 00:01:27.688 | Added | fd00:aaaa:bbbb:cccc::/64 | s | med | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done
CLI 與 API 參考資料
歷史記錄路由器
以資料表或清單格式顯示路徑資料表記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 事件:可能的值為
Added
、Removed
、NextHopChanged
或CostChanged
。 - ID (RLOC16):路由器 ID 和 RLOC16。
- 下一個躍點:路由器 ID 和下一個躍點的 RLOC16。如果沒有下一個躍點,系統會顯示
none
。 - 路徑費用:舊費用
->
。inf
值表示無限路徑費用。
參數
history router [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history router
| Age | Event | ID (RLOC16) | Next Hop | Path Cost |
+----------------------+----------------+-------------+-------------+------------+
| 00:00:05.258 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:00:08.604 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:00:11.931 | Added | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 59 (0xec00) | none | inf -> inf |
| 00:00:14.948 | Removed | 54 (0xd800) | none | inf -> inf |
| 00:00:14.948 | Removed | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 7 (0x1c00) | none | inf -> inf |
| 00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) | 1 -> 5 |
| 00:02:33.735 | NextHopChanged | 54 (0xd800) | none | 15 -> inf |
| 00:03:10.915 | CostChanged | 54 (0xd800) | 34 (0x8800) | 13 -> 15 |
| 00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) | 15 -> 13 |
| 00:03:46.188 | CostChanged | 54 (0xd800) | 59 (0xec00) | 13 -> 15 |
| 00:04:19.124 | CostChanged | 54 (0xd800) | 59 (0xec00) | 11 -> 13 |
| 00:04:52.008 | CostChanged | 54 (0xd800) | 59 (0xec00) | 9 -> 11 |
| 00:05:23.176 | CostChanged | 54 (0xd800) | 59 (0xec00) | 7 -> 9 |
| 00:05:51.081 | CostChanged | 54 (0xd800) | 59 (0xec00) | 5 -> 7 |
| 00:06:48.721 | CostChanged | 54 (0xd800) | 59 (0xec00) | 3 -> 5 |
| 00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) | 1 -> 3 |
| 00:09:28.681 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:09:31.882 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf -> 1 |
| 00:09:54.204 | Added | 54 (0xd800) | none | inf -> inf |
| 00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
| 00:10:24.242 | Added | 34 (0x8800) | none | inf -> inf |
| 00:10:41.900 | NextHopChanged | 59 (0xec00) | none | 1 -> inf |
| 00:10:42.480 | Added | 3 (0x0c00) | 3 (0x0c00) | inf -> inf |
| 00:10:43.614 | Added | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done
CLI 與 API 參考資料
歷史 RX
以資料表或清單格式顯示 IPv6 訊息 RX 記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (對 UDP、TCP 或 ICMP6 訊息有效)。
- Sec:表示是否使用連結層安全性。
- Prio:訊息優先順序。可能的值包括
low
、norm
、high
或net
(用於討論串控制訊息)。 - RSS:收到的訊號強度 (以 dBm 為單位),是構成訊息的所有接收片段平均值。TX 記錄會顯示
NA
(不適用)。 - 目錄:顯示訊息的傳送狀態 (
TX
) 或已接收 (RX
)。假設傳輸失敗,表格格式會顯示TX-F
,清單格式則為tx-success:no
。傳輸失敗的範例包括tx
取消作業,以及任何訊息片段從對等點傳送ack
。 - 鄰點:收發訊息的鄰居簡短地址 (RLOC16)。如有播送影格,表格格式會顯示為
bcast
,清單格式則為0xffff
。如果無法提供鄰點的簡短地址,則會以表格格式顯示unknwn
或清單格式的0xfffe
。 - 無線電:接收/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果是透過所有電台連結傳送)。
參數
history rx [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history rx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xbd26 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x3f7d | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0x942c | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
| | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x2e37 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xe177 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0x82ee | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0x52df | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x5ccf | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
Done
history rx list 4
00:00:13.368
type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done
CLI 與 API 參考資料
歷史紀錄 rxtx
以表格或清單格式顯示合併的 IPv6 訊息 RX 和 TX 記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (對 UDP、TCP 或 ICMP6 訊息有效)。
- Sec:表示是否使用連結層安全性。
- Prio:訊息優先順序。可能的值包括
low
、norm
、high
或net
(用於討論串控制訊息)。 - RSS:收到的訊號強度 (以 dBm 為單位),是構成訊息的所有接收片段平均值。TX 記錄會顯示
NA
(不適用)。 - 目錄:顯示訊息的傳送狀態 (
TX
) 或已接收 (RX
)。假設傳輸失敗,表格格式會顯示TX-F
,清單格式則為tx-success:no
。傳輸失敗的範例包括tx
取消作業,以及任何訊息片段從對等點傳送ack
。 - 鄰點:收發訊息的鄰居簡短地址 (RLOC16)。如有播送影格,表格格式會顯示為
bcast
,清單格式則為0xffff
。如果無法提供鄰點的簡短地址,則會以表格格式顯示unknwn
或清單格式的0xfffe
。 - 無線電:接收/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果是透過所有電台連結傳送)。
參數
history rxtx [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history rxtx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x6c6b | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0xc6a2 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
| | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0xc5a2 | yes | norm | NA | TX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
| | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xaa0d | yes | net | NA | TX | 0x0800 | 15.4 |
| 00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xc1d8 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x3cb1 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xeda0 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0xbdfa | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0x1c11 | no | net | NA | TX | 0x0800 | 15.4 |
| 00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0xedff | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0xd383 | no | net | NA | TX | bcast | 15.4 |
| 00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history rxtx list 5
00:00:02.100
type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done
CLI 與 API 參考資料
歷史紀錄 Tx
以資料表或清單格式顯示 IPv6 訊息 TX 記錄。
每個資料表或清單項目都提供以下功能:
- 存在時間:發出指令後經過的時間,格式為:
hours
:minutes
:seconds
:milliseconds
- 類型:
- IPv6 訊息類型,例如
UDP
、TCP
、HopOpts
和ICMP6
(及其子類型)。 src
:來源 IPv6 位址和通訊埠編號。dst
:目的地 IPv6 位址和通訊埠編號 (通訊埠編號對 UDP/TCP 有效,否則為 0)。
- IPv6 訊息類型,例如
- Len:IPv6 酬載長度 (不含 IPv6 標頭)。
- Chksum:訊息總和檢查碼 (對 UDP、TCP 或 ICMP6 訊息有效)。
- Sec:表示是否使用連結層安全性。
- Prio:訊息優先順序。可能的值包括
low
、norm
、high
或net
(用於討論串控制訊息)。 - RSS:收到的訊號強度 (以 dBm 為單位),是構成訊息的所有接收片段平均值。TX 記錄會顯示
NA
(不適用)。 - 目錄:顯示訊息的傳送狀態 (
TX
) 或已接收 (RX
)。假設傳輸失敗,表格格式會顯示TX-F
,清單格式則為tx-success:no
。傳輸失敗的範例包括tx
取消作業,以及任何訊息片段從對等點傳送ack
。 - 鄰點:收發訊息的鄰居簡短地址 (RLOC16)。如有播送影格,表格格式會顯示為
bcast
,清單格式則為0xffff
。如果無法提供鄰點的簡短地址,則會以表格格式顯示unknwn
或清單格式的0xfffe
。 - 無線電:接收/接收訊息的圓形按鈕連結 (啟用
OPENTHREAD_CONFIG_MULTI_RADIO
時相當實用)。可以是15.4
、trel
或all
(如果是透過所有電台連結傳送)。
參數
history tx [list] [num-entries]
- 使用
list
選項以清單格式顯示輸出內容。否則輸出內容會以資料表格式顯示。 - 使用
num-entries
選項,即可將輸出內容限制為最新的指定項目數。如未使用這個選項,則所有儲存的項目都會顯示在輸出內容中。
範例
history tx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0x932c | yes | norm | NA | TX | 0x4800 | 15.4 |
| 00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
| | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xce87 | yes | net | NA | TX | 0x4800 | 15.4 |
| 00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0xf7ba | no | net | NA | TX | 0x4800 | 15.4 |
| 00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0x26d4 | no | net | NA | TX | bcast | 15.4 |
| 00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history tx list
00:00:23.957
type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[ff02:0:0:0:0:0:0:2]:19788
Done
CLI 與 API 參考資料
ifconfig (向上、向下)
上下移動 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
:可以是thread
、slaac
、dhcp6
、manual
,表示位址的來源plen
:前置字串長度preferred
:偏好標記 (布林值)valid
:有效標記 (布林值)
範例
ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done
CLI 與 API 參考資料
ipaddr linklocal
取得 Thread 連結本機 IPv6 位址。
Thread 連結本機位址會以 IEEE802.15.4 擴充位址做為介面 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 clear
將aDiscerner
設為nullptr
。
範例
joiner discerner 0xabc/12
Done
CLI 與 API 參考資料
聯結器清楚易懂
清除彙整器。
參數
沒有參數。
範例
joiner discerner clear
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
熱線器
取得彙整器。
詳情請參閱 otJoinerSetDiscerner。
參數
沒有參數。
範例
joiner discerner
0xabc/12
Done
CLI 與 API 參考資料
彙整器說明
顯示 joiner
說明選單。
參數
沒有參數。
範例
joiner help
help
id
start
state
stop
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
加入者 ID
取得彙整者 ID。
如未設定彙整器 ID,彙整器 ID 會是工廠指派 IEEE EUI-64 計算 SHA-256 時所產生結果的前 64 位元。否則,彙整器 ID 是根據彙整者 ID 值計算得出。
在調校過程中,彙整者 ID 也可做為裝置的 IEEE 802.15.4 延伸地址。
參數
沒有參數。
範例
joiner id
d65e64fa83f81cf7
Done
CLI 與 API 參考資料
聯結器開始
啟用 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
如果有相符的索引鍵索引,請立即使用 0
至 Thread 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
:使用非封鎖模式。- [
q
、m
和r
] 會對應至 otLinkMetricsValues。根據規格 4.11.3.4.4.6,您一次最多只能使用兩個選項,例如q
或qm
。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。- [
l
、d
、r
和a
] 對應至 otLinkMetricsSeriesFlags。X
代表任何otLinkMetricsSeriesFlags
,且停止計費並移除系列。l
:MLE Link Probe。d
:MAC 資料。r
:MAC 資料要求。a
:MAC Ack。X
:只能在沒有其他旗標的情況下使用。
- [
p
、q
、m
和r
] 對應至 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
:對等互連位址。- [
p
、q
、m
和r
] 會對應至 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 Progress
或 Idle
)。
啟用 OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
後才能使用。
參數
沒有參數。
範例
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
CLI 與 API 參考資料
記錄檔名稱
指定用於擷取
otPlatLog()
訊息的檔案名稱。如要對 Linux 上的自動測試指令碼偵錯,這項功能會中斷自動測試指令碼。
需要 OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
和 OPENTHREAD_POSIX
。
參數
log filename filename
範例
CLI 與 API 參考資料
記錄層級 (設定)
設定記錄層級。
參數
log level level
範例
log level 4
Done
CLI 與 API 參考資料
記錄檔層級
取得記錄層級。
參數
沒有參數。
範例
log level
1
Done
CLI 與 API 參考資料
mac 重試 (get,set)
取得或設定 MAC 層上的 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 篩選器清單目前的模式:
AllowList
、DenyList,
或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 篩選器的目前模式:AllowList
、DenyList,
或Disabled
- MAC 篩選器清單中所有擴充地址的清單。如果將接收到的訊號強度 (rs) 和連結品質指標 (lqi) 設為與預設值不同,則地址旁邊會列出接收的信號強度 (rs) 和連結品質指標 (lqi)。
- 獨立清單 (
RssIn List
),其中列出rss
已設為與預設值不同的所有擴充位址。 Default rss
:顯示rss
和lqi
設定的預設值 (如果適用)。
參數
沒有參數。
範例
macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI 與 API 參考資料
macfilter rss 新增
將指定的延伸地址加入 RssIn
清單 (或修改 RssIn
清單中的現有地址),並針對來自該地址的郵件設定接收的訊號強度 (dBm) 項目。
參數
macfilter rss add extaddr rss
如要為所有收到的訊息設定接收的信號強度預設值,請針對 extaddr
引數使用 *
。
範例
macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done
CLI 與 API 參考資料
Macfilter rss add-lqi
將指定的延伸地址加入 RssIn
清單 (或修改 RssIn
清單中的現有地址),並為來自該地址的郵件設定固定連結品質指標。擴充地址不一定要位於 address allowlist/denylist
篩選器中,即可設定 lqi
。
啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定後才能使用這個選項。
參數
macfilter rss add-lqi extaddr lqi
如要為所有收到的訊息設定連結品質指標的預設值,請針對 extaddr
引數使用 *
。允許的介於 0 至 3 之間。
範例
macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done
CLI 與 API 參考資料
macfilter rss 清除
清除「RssIn
」清單中所有接收到的信號強度 (rss
) 和連結品質指標 (lqi
) 項目 (包括預設值)。
執行這項操作後,所有延伸地址都會使用無線訊號。
啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定後才能使用。
參數
沒有參數。
範例
macfilter rss clear
Done
CLI 與 API 參考資料
macfilter rss
提供下列資訊:
- 所有收到訊號強度 (
rss
) 設為與預設值不同的延伸地址清單。連結品質指標 (lqi
) 也會顯示。rss
和lqi
設定會相互對應。如果您設定其中一個值,系統會自動設定另一個值。此位址清單稱為RssIn List
。設定rsi
或lqi
會將對應的擴充地址新增至RssIn
清單。 Default rss
:顯示rss
和lqi
設定的預設值 (如果適用)。
參數
沒有參數。
範例
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI 與 API 參考資料
macfilter rss 移除
從 RssIn
清單中移除指定的延伸地址。
從 RssIn
清單中移除後,這個 MAC 位址會改用預設的 rss
和 lqi
設定 (假設已設定預設值)。(如未設定預設值,則會使用無線訊號)。
啟用 OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
設定後才能使用。
如果 RssIn
清單中目前沒有與指定延伸地址相符的項目,則不會執行任何動作。
參數
macfilter rss remove extaddr
如要移除預設的收到訊號強度和連結品質指標設定,請使用 *
做為 extaddr
。這麼做會取消設定預設值,但不會移除 RssIn
清單中的項目。
範例
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
CLI 與 API 參考資料
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) 的路由器 ID2-links
:這個路由器的連入連結 (連結品質為 2) 的路由器 ID1-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_ENABLE
和 OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
。
如果省略逾時,則會使用主要骨幹路由器的預設 MLR 逾時。
使用 timeout = 0 即可取消註冊多點傳播事件監聽器。
參數
mlr reg ipaddr [timeout]
範例
mlr reg ff04::1
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done
CLI 與 API 參考資料
mode (get,set) (模式)
進行 MLE 連結模式設定。
參數
mode [rdn]
-
:未設定旗標 (rx-off-when-idle、最低 Thread 裝置、穩定的網路資料)r
:rx-on-when-idled
:完整 Thread 裝置n
:完整網路資料
範例
mode rdn
Done
mode -
Done
CLI 與 API 參考資料
多無線電
取得裝置支援的電台連結清單。
即使裝置只支援單一無線電,還是可以使用這個指令。
參數
沒有參數。
範例
multiradio
[15.4, TREL]
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
多無線電鄰點清單
取得與指定延伸地址的鄰點相關聯的多重無線電連結資訊。
必須啟用「OPENTHREAD_CONFIG_MULTI_RADIO
」。
參數
沒有參數。
範例
multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
CLI 與 API 參考資料
多鄰電機
取得與指定延伸地址的鄰點相關聯的多重無線電連結資訊。
必須啟用「OPENTHREAD_CONFIG_MULTI_RADIO
」。
參數
multiradio neighbor ext-address
範例
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
CLI 與 API 參考資料
nat64 (啟用、停用)
啟用或停用 NAT64 函式。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
時,停用設為 True 會重設翻譯器中的對應資料表。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
或 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
後才能使用。
參數
nat64 enable|disable
範例
nat64 enable
Done
nat64 disable
Done
CLI 與 API 參考資料
nat64 cidr
參數
沒有參數。
範例
nat64 cidr 192.168.255.0/24
Done
CLI 與 API 參考資料
nat64 蘋果酒
取得在 NAT64 轉譯器中設定的 IPv4 CIDR。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
範例
nat64 cidr
192.168.255.0/24
Done
CLI 與 API 參考資料
nat64 計數器
取得 NAT64 轉譯器封包和錯誤計數器。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
範例
nat64 counters
| | 4 to 6 | 6 to 4 |
+---------------+-------------------------+-------------------------+
| Protocol | Pkts | Bytes | Pkts | Bytes |
+---------------+----------+--------------+----------+--------------+
| Total | 11 | 704 | 11 | 704 |
| TCP | 0 | 0 | 0 | 0 |
| UDP | 0 | 0 | 0 | 0 |
| ICMP | 11 | 704 | 11 | 704 |
| Errors | Pkts | Pkts |
+---------------+-------------------------+-------------------------+
| Total | 8 | 4 |
| Illegal Pkt | 0 | 0 |
| Unsup Proto | 0 | 0 |
| No Mapping | 2 | 0 |
Done
CLI 與 API 參考資料
nat64 對應
取得下一個 AddressMapping 資訊 (使用疊代器)。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
後才能使用。
參數
沒有參數。
範例
nat64 mappings
| | Address | | 4 to 6 | 6 to 4 |
+----------+---------------------------+--------+--------------+--------------+
| ID | IPv6 | IPv4 | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 | 7196s | 6 | 456 | 11 | 1928 |
| | TCP | 0 | 0 | 0 | 0 |
| | UDP | 1 | 136 | 16 | 1608 |
| | ICMP | 5 | 320 | 5 | 320 |
CLI 與 API 參考資料
nat64 狀態
取得 NAT64 函式的狀態。
啟用 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
時,可以使用 PrefixManager
狀態。啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
時,可以使用 Translator
狀態。
啟用 OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
時,PrefixManager
會傳回下列其中一種狀態:
Disabled
:NAT64 前置碼管理員已停用。NotRunning
:NAT64 前置碼管理員已啟用,但尚未執行。這可能表示轉送管理員已停用。Idle
:NAT64 前置碼管理員已啟用且正在運作,但尚未發布 NAT64 前置字串。如果有另一個邊界路由器發布優先順序較高的 NAT64 前置字串,可能就會發生這種情況。Active
:NAT64 前置碼管理員已啟用、執行,並發布 NAT64 前置字串。
啟用 OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
時,Translator
會傳回下列其中一種狀態:
Disabled
:NAT64 翻譯器已停用。NotRunning
:NAT64 翻譯器已啟用,但尚未轉譯封包。這可能表示翻譯器未設定 NAT64 前置字串,或 NAT64 的 CIDR。Active
:NAT64 翻譯器已啟用,正在轉譯封包。
參數
沒有參數。
範例
nat64 state
PrefixManager: Active
Translator: Active
Done
CLI 與 API 參考資料
鄰近交集清單
顯示鄰居的連線時間和年齡。這個指令與 neighbor conntime
類似,但會以清單格式顯示資訊。系統會以秒為單位顯示年齡和連線時間。
參數
沒有參數。
範例
neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done
CLI 與 API 參考資料
鄰居
顯示鄰居的連線時間和年齡。每個相鄰的資訊:
- RLOC16
- 擴充 MAC
- 上次監聽時間 (年齡):上次聽鄰點後經過的秒數。
- 連線時間:自建立連結後經過的秒數。如果時間長度間隔不到一天,持續時間間隔格式為
{hh}:{mm}:{ss}
,代表小時、分鐘和秒鐘。如果時間長度超過一天,則格式為{dd}d.{hh}:{mm}:{ss}
。
參數
沒有參數。
範例
neighbor conntime
| RLOC16 | Extended MAC | Last Heard (Age) | Connection Time |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 | 00:00:13 | 00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 | 00:00:03 | 00:11:27 |
| 0xe800 | ce53628a1e3f5b3c | 00:00:02 | 00:00:15 |
Done
CLI 與 API 參考資料
鄰點連結品質
列印所有鄰居的連結品質資訊。
參數
沒有參數。
範例
neighbor linkquality
| RLOC16 | Extended MAC | Frame Error | Msg Error | Avg RSS | Last RSS | Age |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db | 0.00 % | 0.00 % | -46 | -48 | 1 |
| 0xc001 | 0ad7ed6beaa6016d | 4.67 % | 0.08 % | -68 | -72 | 10 |
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
鄰點清單
列出每個鄰居的 RLOC16。
參數
沒有參數。
範例
neighbor list
0xcc01 0xc800 0xf000
Done
CLI 與 API 參考資料
- 沒有相關聯的 API
鄰點資料表
以表格格式顯示所有鄰居的相關資訊。
如果是 Role
,這個資料表只能使用 C
(子項) 或 R
(路由器) 的值。
下列資料欄提供鄰點的裝置模式相關資訊。每個資料欄都有 0
(關閉) 或 1
(開啟) 的值。
R
:閒置時開啟 RXD
:完整 Thread 裝置N
:完整網路資料
參數
沒有參數。
範例
neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC |
+------+--------+-----+----------+-----------+-+-+-+------------------+
| C | 0xcc01 | 96 | -46 | -46 |1|1|1| 1eb9ba8a6522636b |
| R | 0xc800 | 2 | -29 | -29 |1|1|1| 9a91556102c39ddb |
| R | 0xf000 | 3 | -28 | -28 |1|1|1| 0ad7ed6beaa6016d |
Done
CLI 與 API 參考資料
淨數據已滿
列印「是」或「否」表示「網路資料已滿」自上次使用 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、通訊埠)
- netdata 發布 dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
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 發布 dnssrp unicast (addr、通訊埠)
- netdata 發布 dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
netdata 發布前置字串
發布網狀搜尋前置碼項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」一文。
參數
netdata publish prefix prefix [padcrosnD] [high|med|low]
OT CLI 會使用對應引數設定 otBorderRouterConfig 值。詳情請參閱 OpenThread CLI 總覽。
範例
netdata publish prefix fd00:1234:5678::/64 paos med
Done
CLI 與 API 參考資料
netdata 發布取代
取代先前發布的外部路徑項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」一文。
參數
netdata publish replace oldprefix prefix [sn] [high|med|low]
OT CLI 會使用對應引數設定 otExternalRouteConfig 值。詳情請參閱 OpenThread CLI 總覽。
範例
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
CLI 與 API 參考資料
netdata 發布路徑
發布外部路徑項目。詳情請參閱「使用 OT CLI 顯示及管理網路資料」一文。
參數
publish route prefix [sn] [high|med|low]
OT CLI 會使用對應引數設定 otExternalRouteConfig 值。詳情請參閱 OpenThread CLI 總覽。
範例
netdata publish route fd00:1234:5678::/64 s high
Done
CLI 與 API 參考資料
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 擴充位址 TLV1
:Address16 TLV2
:模式 TLV3
:逾時 TLV (SED 輪詢時間範圍上限)4
:連線 TLV5
:Route64 TLV6
:領導者資料技術負責人7
:網路資料 TLV8
:IPv6 位址清單 TLV9
:MAC 計數器 TLV14
:電池電量 TLV15
:電源電壓 TLV16
:子項資料表 TLV17
:頻道頁面重點摘要19
:子項逾時上限 TLV23
:EUI64 TLV24
:版本 TLV (通訊協定和功能的版本號碼)25
:供應商名稱 TLV26
:廠商型號 TLV27
:供應商軟體版本 TLV28
:執行緒堆疊版本 TLV (執行緒堆疊程式碼 base/commit/版本的版本 ID 為 UTF-8 字串)29
:子項 TLV34
:MLE 計數器 TLV35
:供應商應用程式網址重點摘要
範例
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 目的地的下一個躍點和路徑費用。
可與 aNextHopRloc16
或 aPathCost
搭配使用,表示呼叫端不想取得這個值。
參數
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 參考資料
單例模式
指出節點是否為網路中唯一的路由器。會傳回 true
或 false
。
參數
沒有參數。
範例
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 伺服器,建議您按照下列順序排列:
- 服務資料中包含伺服器位址的 Unicast 項目。如果有多個選項,系統會優先採用數值最低的 IPv6 位址選項。
- 每個都有序號的 Anycast 項目。建議使用 RFC-1982 中序號算術邏輯指定的最大序號。
- 包含伺服器位址資訊的 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
參數啟用自動主機位址模式。啟用後,用戶端會自動使用所有偏好的 Threadnetif
單點傳播位址,但連結本機和網狀本機位址除外。如果沒有有效的位址,系統就會新增網格本機 EID 位址。如果您新增或移除 Threadnetif
中的地址,或標示為非偏好地址,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
參數可視需要加入服務子類型標籤清單 (以半形逗號分隔)。這裡的範例使用通用命名。priority
和 weight
(兩者都是 uint16_t
值) 是選用參數,如未提供,則會使用零。選用的 txt
參數可設定與服務相關聯的 TXT 資料。txt
值必須採用十六進位字串格式,並視為已編碼的 TXT 資料位元組序列。
範例
srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done
CLI 與 API 參考資料
安全伺服器用戶端服務金鑰 (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 參考資料
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
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 參考資料
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
tcp 取消
無預警地結束與範例 TCP 端點相關聯的 TCP 連線,同時將 TCP 端點轉換為關閉狀態。
參數
沒有參數。
範例
tcp abort
TCP: Connection reset
Done
CLI 與 API 參考資料
tcp 基準測試結果
顯示 TCP 基準測試的最新結果。可能的狀態值如下:
- 作用中
- 已完成
- 未測試
這個指令主要用於建立能自動執行 TCP 基準測試的指令碼。
參數
沒有參數。
範例
tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s
CLI 與 API 參考資料
- 沒有相關聯的 API
tcp 基準執行作業
使用目前與 tcp
CLI 提供的範例 TCP 端點相關聯的 TCP 連線來傳輸指定的位元組數。
參數
tcp benchmark run [size]
使用 size
參數指定要為基準測試傳送的位元組數。如果您不使用 size
參數,則會使用預設值 (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
)。
範例
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
CLI 與 API 參考資料
- 沒有相關聯的 API
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 端點通訊。linked
或circular
:這兩個選項都代表不使用 TLS,且應使用指定的緩衝類型進行 TCP 緩衝處理。linked
和circular
的行為相同。檢查程式碼,找出這兩種緩衝區類型間的差異。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
以下是必要參數:
ip
:tcp
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()
收集統計資料收集之後,都會收集直方圖資訊。
指標 aNumBins
和 aBinInterval
不得為空值。
參數
沒有參數。
範例
timeinqueue
| Min | Max |Msg Count|
+------+------+---------+
| 0 | 9 | 1537 |
| 10 | 19 | 156 |
| 20 | 29 | 57 |
| 30 | 39 | 108 |
| 40 | 49 | 60 |
| 50 | 59 | 76 |
| 60 | 69 | 88 |
| 70 | 79 | 51 |
| 80 | 89 | 86 |
| 90 | 99 | 45 |
| 100 | 109 | 43 |
| 110 | 119 | 44 |
| 120 | 129 | 38 |
| 130 | 139 | 44 |
| 140 | 149 | 35 |
| 150 | 159 | 41 |
| 160 | 169 | 34 |
| 170 | 179 | 13 |
| 180 | 189 | 24 |
| 190 | 199 | 3 |
| 200 | 209 | 0 |
| 210 | 219 | 0 |
| 220 | 229 | 2 |
| 230 | 239 | 0 |
| 240 | 249 | 0 |
| 250 | 259 | 0 |
| 260 | 269 | 0 |
| 270 | 279 | 0 |
| 280 | 289 | 0 |
| 290 | 299 | 1 |
| 300 | 309 | 0 |
| 310 | 319 | 0 |
| 320 | 329 | 0 |
| 330 | 339 | 0 |
| 340 | 349 | 0 |
| 350 | 359 | 0 |
| 360 | 369 | 0 |
| 370 | 379 | 0 |
| 380 | 389 | 0 |
| 390 | 399 | 0 |
| 400 | 409 | 0 |
| 410 | 419 | 0 |
| 420 | 429 | 0 |
| 430 | 439 | 0 |
| 440 | 449 | 0 |
| 450 | 459 | 0 |
| 460 | 469 | 0 |
| 470 | 479 | 0 |
| 480 | 489 | 0 |
| 490 | inf | 0 |
Done
CLI 與 API 參考資料
trel (啟用、停用)
啟用或停用 TREL 無線電作業。
參數
trel enable|disable
範例
trel enable
Done
trel disable
Done
CLI 與 API 參考資料
Trel 計數器已重設
重設 TREL 計數器。
參數
沒有參數。
範例
trel counters reset
Done
CLI 與 API 參考資料
Trel 計數器
取得 TREL 計數器。
參數
沒有參數。
範例
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
CLI 與 API 參考資料
trel 篩選器 (啟用、停用)
啟用或停用 TREL 篩選器模式。
參數
trel filter enable|disable
範例
trel filter enable
Done
trel filter disable
Done
CLI 與 API 參考資料
Trel 篩選器
用於指出是否已啟用 TREL 篩選器模式。
啟用篩選器模式後,所有透過 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
ip
和 port
是選用組合,但如果您指定其中之一,就必須指定另一個。如未指定 ip
和 port
,系統會從 udp connect
使用通訊端對等互連位址。
ip
:目的地地址。這個位址可以是 IPv4 或 IPv6 位址,IPv4 位址會合成至 IPv6 位址,並提供網路資料中的偏好 NAT64 前置字元。(無法使用偏好的 NAT64 前置字元,指令會傳回InvalidState
)。port
:UDP 目的地通訊埠。type
/value
個組合:-t
:將value
參數中的酬載視為文字。如未輸入type
值,系統會將value
參數中的酬載視為文字。-s
:自動產生具有value
參數指定長度的酬載。-x
:value
參數中以十六進位表示的二進位資料。
範例
udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done
CLI 與 API 參考資料
不安全取得
從已允許未加密的通訊埠清單中列出所有通訊埠。
參數
沒有參數。
範例
unsecure get
1234
Done
CLI 與 API 參考資料
新增不安全的通訊埠
將通訊埠新增至允許的未受保護的通訊埠清單。
參數
unsecureport add port
範例
unsecureport add 1234
Done
CLI 與 API 參考資料
移除不安全的連接埠
將特定通訊埠或所有通訊埠從允許的未受保護的通訊埠清單中移除。
參數
unsecureport remove port|all
範例
unsecureport remove 1234
Done
unsecureport remove all
Done
CLI 與 API 參考資料
運作時間 (毫秒)
傳回目前執行個體的運作時間 (毫秒)。
必須啟用「OPENTHREAD_CONFIG_UPTIME_ENABLE
」。
運作時間是以 OpenThread 執行個體初始化之後的毫秒數表示。
參數
沒有參數。
範例
uptime ms
426238
Done
CLI 與 API 參考資料
正常運行時間
以使用者可理解的字串傳回目前的執行個體運作時間。
必須啟用「OPENTHREAD_CONFIG_UPTIME_ENABLE
」。
字串會採用「
如果產生的字串不符合 aBuffer
(在其 aSize
字元中) 內,就會截斷該字串,但輸出的字串一律以空值結束。
參數
沒有參數。
範例
uptime
12:46:35.469
Done
CLI 與 API 參考資料
供應商 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