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\ NetworkDonenetworknameTest 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 顯示及管理網路資料。