本指南說明 OpenThread Commissioner 的基本建構和設定 (OT 委託人員)。完成這項程序後,即可得到 OT 委託工具 CLI 執行檔和靜態 Commissioner 程式庫。
設定 OT 委員
複製 OT Commissioner 存放區:
git clone https://github.com/openthread/ot-commissioner
安裝依附元件:
cd ot-commissioner
./script/bootstrap.sh
打造 OT 委員
OT Commissioner 會安裝至 /usr/local
目錄。如果您要更改
安裝目錄,請設定 -DCMAKE_INSTALL_PREFIX
。
構建 OT 委員會:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
建立環境變數,以便在下一個步驟中執行
commissioner-cli
:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
(選用) 執行單元測試:
./tests/commissioner-test
安裝 OT 委員會
OT Commissioner 將下列項目安裝到您的安裝目錄:
- OT 委員會程式庫和標頭檔案
- OT 執行委員會 CLI 可執行二進位檔
- 預設設定檔和憑證
- 以 Daemon 形式執行 OT Commissioner CLI 的指令碼
sudo ninja install
查看說明選單,驗證安裝狀態。
$COMMISSIONER_CLI -h
如果安裝至 /usr/local
目錄,則可使用 commissioner-cli
建立虛擬機器
commissioner-cli -h
設定
OT Commissioner CLI 支援 Thread 1.2 商業調試模式 (CCM) 和 Thread 1.1 調校 (非 CCM)。如何連線至其他 Thread 網路 ,需要 JSON 設定檔才能啟動 OT Commissioner CLI:
ccm-config.json
:CCM Thread 網路的預設設定檔。non-ccm-config.json
:非 CCM 執行緒的預設設定檔 網路。
根據預設,這些設定檔會安裝在 /usr/local/etc/commissioner
中。你可以
也會前往 ot-commissioner GitHub 存放區查看範例檔案。
CCM 設定
如要連線至 CCM Thread 網路,請更新 ccm-config.json
中的下列欄位:
欄位 | 說明 |
---|---|
DomainName |
企業網域內的專屬 ID。 |
PrivateKeyFile |
PEM 格式的私密金鑰檔案。 |
CertificateFile |
PEM 格式的憑證檔案。 |
TrustAnchorFile |
PEM 格式的信任錨點檔案。 |
這些金鑰和憑證檔案可用來在 委員和邊境代理人。
非 CCM 設定
預先共用金鑰 PSKc
可用來在
委員和邊境代理人。如要連線到非 CCM Thread 網路,你必須
可以透過 OT Commissioner CLI 設定 PSKc
。如需更多資訊
請參閱外部調試。
記錄
當您從指令列執行 pi@raspberrypi: commissioner-cli
時,
OT 委員會在目前工作中建立 commissioner.log
檔案
目錄,例如 /home/pi/commissioner.log
。JSON 設定
檔案,您可以設定 LogFile
路徑、記錄層級和其他記錄
可以管理叢集設定,像是節點
資源調度、安全性和其他預先設定項目
載入設定
如何透過配置啟動 OT 委員會:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
委託加入計畫
如要委託 OT 執行委員會委任合作者,請參閱「外部」 調試。