OpenThread 委員建構與設定

前往 GitHub 查看原始碼

本指南涵蓋 OpenThread Commissioner (OT 委員) 的基本建構和設定。完成這項程序後,您將會擁有 OT 修訂版本 CLI 執行檔和靜態佣金程式庫。

設定 OT 委員會專員

  1. 複製 OT 佣金存放區:

    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 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 委員委託加入彙整工具,請參閱外部佣金一節。