本指南涵蓋 OpenThread Commissioner (OT 委員) 的基本建構和設定。完成這項程序後,您將會擁有 OT 修訂版本 CLI 執行檔和靜態佣金程式庫。
設定 OT 委員會專員
複製 OT 佣金存放區:
git clone https://github.com/openthread/ot-commissioner
安裝依附元件:
cd ot-commissioner
./script/bootstrap.sh
建構 OT 委員會
OT 佣金會安裝到 /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 委員 CLI 的指令碼
sudo ninja install
查看說明選單以確認安裝狀態。
$COMMISSIONER_CLI -h
如果您安裝了 /usr/local
目錄,則可透過指令列取得 commissioner-cli
。
commissioner-cli -h
設定
OT 調度工具 CLI 支援 Thread 1.2 商業佣金模式 (CCM) 和 Thread 1.1 修訂版本 (非 CCM)。如要連線至不同的 Thread 網路,必須使用 JSON 設定檔才能啟動 OT 委任工具 CLI:
ccm-config.json
:CCM Thread Network 的預設設定檔。non-ccm-config.json
:非 CCM 執行緒網路的預設設定檔。
根據預設,這些設定檔會安裝在 /usr/local/etc/commissioner
中。您也可以在 ot-commissioner GitHub 存放區中查看範例檔案。
CCM 設定
如要連線至 CCM 執行緒網路,請更新 ccm-config.json
中的下列欄位:
欄位 | 說明 |
---|---|
DomainName |
企業網域中的專屬 ID。 |
PrivateKeyFile |
採用 PEM 格式的私密金鑰檔案。 |
CertificateFile |
憑證檔案 (採用 PEM 格式)。 |
TrustAnchorFile |
採用 PEM 格式的信任錨點檔案。 |
這些金鑰和憑證檔案可用來建立委員會與邊界代理程式之間的安全工作階段。
非 CCM 設定
預先共用金鑰 PSKc
可用來在委員會與邊界代理程式之間建立安全的工作階段。如要連線至非 CCM 執行緒網路,您可以透過 OT 委任工具 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 委員委託加入彙整工具,請參閱外部佣金一節。