Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

OpenThread Commissioner のビルドと構成

GitHub でソースを見る

このガイドでは、OpenThread コミッター(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. Build 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 の実行可能バイナリ
  • デフォルトの構成ファイルと認証情報
  • OT コミッショナー CLI をデーモンとして実行するスクリプト
sudo ninja install

ヘルプ メニューでインストールを確認します。

$COMMISSIONER_CLI -h

/usr/local ディレクトリにインストールした場合、コマンドラインから commissioner-cli を使用できます。

commissioner-cli -h

構成

OT コミッショナー CLI は、Thread 1.2 コマーシャル コミッショニング モード(CCM)とスレッド 1.1 コミッショニング(CCM 以外)の両方をサポートしています。別のスレッド ネットワークに接続するには、OT コミッショナー CLI を起動するための JSON 構成ファイルが必要です。

  • ccm-config.json - CCM スレッド ネットワークのデフォルトの構成ファイル。
  • non-ccm-config.json - 非 CCM スレッド ネットワークのデフォルトの構成ファイル。

デフォルトでは、これらの構成ファイルは /usr/local/etc/commissioner にインストールされます。ot-commissioner GitHub リポジトリでもサンプル ファイルを確認できます。

CCM の設定

CCM スレッド ネットワークに接続するには、ccm-config.json の次のフィールドを更新します。

項目 説明
DomainName 企業ドメイン内の一意の識別子。
PrivateKeyFile PEM 形式の秘密鍵ファイル。
CertificateFile PEM 形式の証明書ファイル。
TrustAnchorFile PEM 形式のトラスト アンカー ファイル。

これらの鍵ファイルと証明書ファイルは、コミッショナーと国境エージェント間の安全なセッションを確立するために使用されます。

CCM 以外の構成

事前共有キー PSKc は、コミッショナーと国境エージェント間の安全なセッションを確立するために使用されます。CCM 以外のスレッド ネットワークに接続するには、OT コミッショナー CLI から PSKc を設定します。詳しくは、外部コミッショニングをご覧ください。

ロギング

コマンドラインから pi@raspberrypi: commissioner-cli を実行すると、OT Commissioner は、現在の作業ディレクトリに commissioner.log ファイル(/home/pi/commissioner.log など)を作成します。JSON 構成ファイルでは、LogFile パス、ロギングレベル、その他のログ設定を構成できます。

読み込みの構成

現在の設定で、OT コミッショナーを開始するには:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

スタッフをコミッショニングする

OT コミッショナーを使用して参加者をコミッショニングするには、外部コミッションをご覧ください。