OpenThread を構築する

<ph type="x-smartling-placeholder"></ph> GitHub のソースを表示

OpenThread のビルド方法

OpenThread をビルドする手順は、ツールチェーン、ユーザーマシン、 ターゲット プラットフォームです。

最も一般的なワークフローは次のとおりです。

  1. ビルド環境をセットアップし、必要なツールチェーンをインストールします。 <ph type="x-smartling-placeholder">
      </ph>
    1. マシンで直接ビルドするには、シミュレーションの Codelab で詳細な手順をご確認ください。
    2. 事前構成済みの環境で Docker コンテナを使用するには、 OpenThread environment イメージをダウンロードして実行します。 
      docker pull openthread/environment:latest
docker run -it --rm openthread/environment bash
  2. 選択した環境で、プラットフォーム固有の OpenThread Git リポジトリのクローンを作成します。CC2538 を例にとります。 
    git clone https://github.com/openthread/ot-cc2538.git --recursive
  3. クローン リポジトリのルート ディレクトリから、次のコマンドを実行します。 <ph type="x-smartling-placeholder">
      </ph>
    1. ツールチェーンをインストールします。 
      ./script/bootstrap
    2. 構成をビルドします。 
      ./script/build platform-specific-args cmake-options
  4. 目的のバイナリをターゲット プラットフォームに書き込みます。生成されるバイナリはすべて、 ./build/bin にあります。
で確認できます。

構成

OpenThread は、接続中にさまざまな機能や動作に設定できます。 ビルドプロセスです。使用可能な構成オプションの詳細については、以下をご覧ください。 locations:

タイプ 場所
コンパイル時の定数 /src/core/config のすべてのヘッダー ファイルに記述
cmake のビルド オプション openthread/examples/README.mdで掲載

ビルド例

cmake ビルド オプションを使用してプラットフォームの機能を有効にします。たとえば、 Commissioner と Joiner のサポートを有効にした CC2538 プラットフォーム用のバイナリをビルドします。

./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON

または、Jam 検出機能を備えた nRF52840 プラットフォームを構築できます。 feature がリポジトリで有効になっている必要があります。

./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON

バイナリ

次のバイナリは、ビルドプロセスにより ./build/bin に生成されます。生成されるバイナリを確認するには、./script/build コマンドでフラグを使用します。たとえば、OpenThread をビルドして FTD CLI バイナリのみを生成するには、次のようにします。

./script/build -DOT_APP_CLI=ON -DOT_FTD=ON -DOT_MTD=OFF -DOT_APP_NCP=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF
バイナリ 説明 オプション
ot-cli-ftd SoC 設計向けフルスレッド デバイス -DOT_APP_CLI=ON
-DOT_FTD=ON
ot-cli-mtd SoC 設計向けの最小 Thread デバイス -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd ネットワーク コプロセッサ（NCP）設計向けのフルスレッド デバイス -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd NCP 設計向けの Minimal Thread デバイス -DOT_APP_NCP=ON
-DOT_MTD=ON
ot-rcp 無線コプロセッサ（RCP）の設計 -DOT_APP_RCP=ON
-DOT_RCP=ON

デフォルトでは、上記のフラグはすべて有効になっています。すべてのフラグを明示的に無効にした場合、アプリケーションは OpenThread ライブラリ ファイルは、プロジェクトで使用するために引き続き ./build/lib で生成されます。

各プラットフォームのフラグを確認するには、examples/platforms ディレクトリを確認します。 サポートします。FTD と MTD の詳細については、 Thread Primer。対象 SoC と NCP の設計について詳しくは、プラットフォームをご覧ください。

これらのバイナリを書き込むプロセスは、サンプル プラットフォームによって異なります。詳しくは、 各プラットフォームの README は、 サンプル フォルダをご覧ください。

OpenThread デーモン

OpenThread Daemon（OT Daemon）は、OpenThread POSIX ビルドモードであり、 OpenThread をサービスとして使用し、RCP 設計で使用します。このモジュールの OpenThread Daemon をご覧ください。

サポート パッケージを構築する

Build サポート パッケージ（BSP）は次の場所にあります。 /third_party。BSP は、各プラットフォームの OpenThread が使用する追加のサードパーティ コードで、通常、新しいハードウェア プラットフォームに OpenThread を移植するときに含まれます。