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

OpenThread をビルドする

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

GitHub でソースを見る

OpenThread の構築方法

OpenThread の構築手順は、ツールチェーン、ユーザーマシン、ターゲット プラットフォームによって異なります。

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

  1. ビルド環境をセットアップし、目的のツールチェーンをインストールします。
    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. クローンが作成されたリポジトリのルート ディレクトリから:
    1. ツールチェーン
      ./script/bootstrap
      
      をインストールします。
    2. 構成をビルドします。
      ./script/build platform-specific-args cmake-options
      
  4. 目的のバイナリをターゲット プラットフォームにフラッシュします。生成されたバイナリはすべて ./build/bin にあります。

構成

OpenThread は、ビルドプロセス中にさまざまな機能と動作を設定できます。使用可能な構成オプションの詳細は、次の場所で確認できます。

Type 場所
コンパイル時の定数 /src/core/configのすべてのヘッダー ファイルにリストされています。
cmake のビルド オプション openthread/examples/README.md にリストされている

ビルド例

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

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

または、リポジトリで Jam Detection 機能を有効にして nRF52840 プラットフォームをビルドするには:

./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 設計用の最小限のスレッド デバイス -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd ネットワーク コプロセッサ(NCP)設計のためのフルスレッド デバイス -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd NCP 設計の最小スレッド デバイス -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 プライマーをご覧ください。SoC と NCP の設計の詳細については、プラットフォームをご覧ください。

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

OpenThread デーモン

OpenThread Daemon(OT Daemon)は、OpenThread をサービスとして実行し、RCP 設計とともに使用する OpenThread POSIX ビルドモードです。ビルドして使用する方法について詳しくは、OpenThread デーモンをご覧ください。

サポート パッケージの構築

ビルド サポート パッケージ(BSP)は /third_party にあります。BSP は、それぞれのプラットフォームで OpenThread が使用する追加のサードパーティ コードで、通常、新しいハードウェア プラットフォームに OpenThread を移植する際に含まれます。