OpenThread CLI 可公開 指令列介面使用 OT CLI 建立 OpenThread 開發作業 也可以做為搭配其他應用程式程式碼使用的工具例如: OpenThread 測試指令碼使用 CLI 來執行測試案例
開始使用
使用 Docker 完成模擬程式碼研究室,並查看 CLI 指令參考資料。
使用 OT CLI
您可以將 OT CLI 與 OpenThread 邊界路由器 (OTBR) 和 Thread 裝置搭配使用。CLI 指令會因裝置類型和建構旗標而異。
OTBR
如要搭配使用 OT CLI 與 OTBR,請輸入以下內容 前置字串:
sudo ot-ctl
Thread 裝置
如要在 Thread 裝置上使用 CLI 指令,請參閱平台說明文件: 或指南針對許多範例,您可以在沒有 前置字串:
state
router
Done
以下資源可協助你快速上手:
- 查看 OpenThread 平台
- Nordic 硬體程式碼研究室
- Silicon Labs 硬體程式碼研究室
- GitHub 上的平台範例
特殊字元
空白字元 (' '
) 用於分隔指令名稱和
包含 Tab 鍵 ('\t'
) 和換行字元
('\r'
、'\n'
)。
部分引數可能含有空格,例如 Thread 網路名稱。目的地:
傳送含有空格的引數,請使用反斜線字元 ('\'
) 將
逸出分隔符號或反斜線:
networkname Test\ Network
Donenetworkname
Test Network Done
引數對應
OT CLI 會使用與 API 設定值相對應的預先定義引數。這些 對應可以透過 CLI 指令傳遞,也可能傳回 CLI 不同的網路資料指令 netdata show。
otBorderRouterConfig
使用某些指令 (例如 prefix add
) 時需要
otBorderRouterConfig
輕鬆分配獎金透過指令列 OT CLI 設定 otBorderRouterConfig
位成員
為每個成員剖析對應的字母引數。舉例來說
組合 paros
會設定
mPreferred、
mSlaac、
mDefaultRoute,
mOnMesh、
且mStable
成員。
語法
在以下範例中,prefix
為必要項目,且
otBorderRouterConfig
引數為選用項目,對應為 p
、a
、d
、c
、r
、o
、s
、n
和
D
:
prefix add prefix [padcrosnD]
用量
如要使用引數對應,請勿在字母之間輸入空格:
prefix add 2001:dead:beef:cafe::/64 paros
otRoutePreference
如要設定 otRoutePreference,
在 OT CLI 指令中使用 high
、med
或 low
。
語法
prefix add prefix [padcrosnD] [high|med|low]
用量
以下舉例說明如何使用對應的 otBorderRouterConfig
和 otRoutePreference
參數:
prefix add 2001:dead:beef:cafe::/64 paros med
Done
otExternalRouteConfig
適用於 otExternalRouteConfig
值,s
對應至 mStable
,n
對應至 mNat64
。
語法
publish route prefix [sn]
用量
route add 2001:dead:beef:cafe::/64 s
Done
傳回值
大多數指令都會傳回要求的值,後面加上 Done
:
br onlinkprefix
fd41:2650:a6f5:0::/64
Done
其他包含網路資料的指令可能會傳回引數對應 ,用於定義前置字串、路徑和服務記錄如需更多資訊,請參閱 使用 OT CLI 顯示及管理網路資料。