OpenThread Commissioner 建構與設定

在 GitHub 中查看來源

本指南包含 OpenThread 代理程式 (OT 佣金) 的基本建構和設定。完成這項程序後,您會獲得 OT 執行者 CLI 執行檔和靜態佣金者程式庫。

設定 OT 總裁

  1. 複製 OT Commissioner 存放區:

    git clone https://github.com/openthread/ot-commissioner
    

  2. 安裝依附元件:

    cd ot-commissioner
    ./script/bootstrap.sh
    

建構 OT 總裁

OT 代理程式會在 /usr/local 目錄中執行安裝作業。如要變更安裝目錄,請設定 -DCMAKE_INSTALL_PREFIX

  1. 建構 OT 佣金:

    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
    ninja -j1
    

  2. 建立環境變數,以便在下個步驟執行 commissioner-cli

    export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
    

  3. (選用) 執行單元測試:

    ./tests/commissioner-test
    

安裝 OT 總裁

OT 委員會會在您的安裝目錄中安裝下列項目:

  • OT 佣金程式庫和標頭檔案
  • OT Commissioner CLI 執行檔二進位檔
  • 預設設定檔和憑證
  • 以 Dememon 形式執行 OT Commissioner CLI 的指令碼
sudo ninja install

查看說明選單以驗證安裝狀態。

$COMMISSIONER_CLI -h

如果您是安裝 /usr/local 目錄,可從指令列存取 commissioner-cli

commissioner-cli -h

設定

OT 佣金 CLI 同時支援 Thread 1.2 商務佣金模式 (CCM) 和 Thread 1.1 佣金 (非 CCM)。如要連線至不同的執行緒網路,需要 JSON 設定檔才能啟動 OT 佣金 CLI:

  • ccm-config.json - CCM Thread Network 的預設設定檔。
  • non-ccm-config.json:非 CCC 執行緒網路的預設設定檔。

根據預設,這些設定檔會安裝於 /usr/local/etc/commissioner。您也可以在 ot-commissioner GitHub 存放區查看範例檔案。

CCM 設定

如要連線到 CCM Thread 網路,請更新 ccm-config.json 中的下列欄位:

欄位 說明
DomainName 企業網域中的專屬 ID。
PrivateKeyFile 私密金鑰檔案 (PEM 格式)。
CertificateFile PEM 格式的憑證檔案。
TrustAnchorFile PEM 格式的信任錨定檔案。

這些金鑰和憑證檔案是用來在佣金和邊境代理程式之間建立安全工作階段。

非 CCM 設定

預先共用金鑰 PSKc 用於在佣金和邊境代理程式之間建立安全工作階段。如要連線至非 CCM 執行緒網路,可透過 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 代理程式來委派參與者,請參閱外部提交