ビルド環境をセットアップする

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

SiLabs
署名 <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> メーソン トラン
SiLabs の寄稿者

自由でオープンな開発を推進するため、OpenThread は CMake を ビルド ツールチェーン。現在、このツールチェーンは移植に必要です。 新しいハードウェア プラットフォームに移行する。

他のビルド ツールチェーンも今後サポートされる可能性がありますが、 対象外です。

新しいリポジトリを作成する

最初のステップは、ハードウェア プラットフォームの新しいホームを設定することです。このガイドでは、ot-efr32 という名前の新しいリポジトリを作成します。このリポジトリには、プラットフォーム抽象化レイヤ、ハードウェア プラットフォームの SDK、いくつかの有用なスクリプトが含まれます。

この例では、GitHub に SiliconLabs/ot-efr32 リポジトリを作成し、そのクローンを ~/repos/ot-efr32 に作成しました。

mkdir -p ~/repos
cd ~/repos
git clone git@github.com:SiliconLabs/ot-efr32.git
Cloning into 'ot-efr32'...
remote: Enumerating objects: 99, done.
remote: Counting objects: 100% (99/99), done.
remote: Compressing objects: 100% (60/60), done.
remote: Total 333 (delta 65), reused 39 (delta 39), pack-reused 234
Receiving objects: 100% (333/333), 170.78 KiB | 5.69 MiB/s, done.
Resolving deltas: 100% (194/194), done.
git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

リポジトリの構成

OpenThread GitHub 組織の既存のプラットフォーム リポジトリとの整合性を維持するために、次のようにリポジトリを構造化できます。

tree -F -L 1 --dirsfirst
.
├── examples/
├── openthread/
├── script/
├── src/
├── third_party/
├── CMakeLists.txt
├── LICENSE
└── README.md
フォルダ 説明
examples オプション アプリケーション例
openthread サブモジュールとしての openthread リポジトリ
script ビルド、テスト、lint チェック用のスクリプト
src プラットフォーム抽象化レイヤの実装
third_party サードパーティのソースのロケーション

サブモジュールを追加する

次に、openthread とその他の必要なリポジトリをサブモジュールとして追加します。

git submodule add git@github.com:openthread/openthread.git
Cloning into '/home/user/repos/ot-efr32/openthread'...
remote: Enumerating objects: 78281, done.
remote: Counting objects: 100% (1056/1056), done.
remote: Compressing objects: 100% (488/488), done.
remote: Total 78281 (delta 639), reused 864 (delta 556), pack-reused 77225
Receiving objects: 100% (78281/78281), 76.62 MiB | 35.24 MiB/s, done.
Resolving deltas: 100% (61292/61292), done.

この例では、Silicon Labs Gecko SDK のライト版を third_party のサブモジュールとして追加します。

cd third_party
git submodule add git@github.com:SiliconLabs/sdk_support.git
Cloning into '/home/user/repos/ot-efr32/third_party/sdk_support'...
remote: Enumerating objects: 32867, done.
remote: Counting objects: 100% (8181/8181), done.
remote: Compressing objects: 100% (3098/3098), done.
remote: Total 32867 (delta 4945), reused 7469 (delta 4732), pack-reused 24686
Receiving objects: 100% (32867/32867), 128.83 MiB | 30.91 MiB/s, done.
Resolving deltas: 100% (19797/19797), done.

スクリプト

一般的なタスクを簡単にするために、script フォルダにいくつかのスクリプトを作成することをおすすめします。これには、ブートストラップ、ビルド、コード リンターの実行などのタスクのスクリプトや、GitHub CI チェック用のテスト スクリプトが含まれる場合があります。

以下は、ほとんどの既存のプラットフォーム リポジトリで標準となっているスクリプトの例です。

bootstrap

このスクリプトは、ハードウェア プラットフォームに必要なすべてのツールとパッケージをインストールします。また、openthread のブートストラップ スクリプトを実行して、OpenThread スタックのビルドに必要なものがすべてユーザーにあることを確認します。

例については、ot-efr32 のブートストラップ スクリプトをご覧ください。

build

CMake ビルド スクリプトを使用して、ユーザーがプラットフォーム用の OpenThread スタックをビルドできるようにする必要があります。リポジトリにサンプル アプリケーションを定義している場合は、このスクリプトでサンプル アプリケーションもビルドします。このスクリプトには、プラットフォーム固有のマクロ定義など、基本的なシステム構成オプションを含める必要があります。

例については、ot-efr32 のビルド スクリプトをご覧ください。

test

テスト スクリプトは、ユーザーが定義したテストを使用して変更をテストするのに役立ちます。サニティ チェック ビルドの実行といった単純なものから、単体テストスイートの起動のような複雑なものまで、どのようなものでもかまいません。

ot-efr32 では、各 efr32 プラットフォームでサポートされているすべてのボードに対して build スクリプトを実行するだけです。

例については、ot-efr32 のテスト スクリプトをご覧ください。

make-pretty

一貫性のあるスタイル設定を維持するため、このスクリプトではコード、スクリプト、マークダウン ファイルをフォーマットする必要があります。

このスクリプトは自分で定義することもできますが、既存のプラットフォーム リポジトリで使用されている make-pretty スクリプトを使用する方が簡単です。このスクリプトは、openthread のスタイル スクリプトを呼び出し、すべての OpenThread リポジトリで一貫したスタイルを確保します。

リンカー スクリプトの構成

GNU リンカー スクリプト 入力ファイル（.o「オブジェクト」ファイル）内のすべてのセクションを （GNU Compiler Collection（GCC）で生成されたもの）を、最終出力ファイル（ 例: .elf）。また、ストレージ バケットの各セグメントの エントリアドレスを指定します。プラットフォーム固有のリンカー スクリプトは通常、プラットフォームの BSP とともに提供されます。

次のコマンドを使用して、プラットフォーム固有のリンカー スクリプトを指すように ld ツールを構成します。 プラットフォームの CMake ターゲットの target_link_libraries（src/CMakeLists.txt 内）:

set(LD_FILE "${CMAKE_CURRENT_SOURCE_DIR}/efr32mg12.ld")

target_link_libraries(openthread-efr32mg12
    PRIVATE
        ot-config
    PUBLIC
        -T${LD_FILE}
        -Wl,--gc-sections -Wl,-Map=$.map
)

ツールチェーンの起動コード

多くの場合、ツールチェーンのスタートアップ コードはプラットフォームの BSP とともに提供されます。この 通常:

  1. 実行可能プログラムのエントリ関数（Reset_Handler）を実装する
  2. 割り込みベクトル テーブルを定義する
  3. ヒープとスタックを初期化する
  4. .data セクションを不揮発性メモリから RAM にコピーします。
  5. アプリケーションのメイン関数に移動してアプリケーション ロジックを実行する

起動コード（C またはアセンブリ ソースコード）は、お使いのプラットフォームの openthread-platform-name ライブラリ。それ以外の場合は、リンカーで使用される一部のキー変数。 スクリプトを正しく引用できません。

  • src/CMakeLists.txt

例: ot-cc2538 の startup-gcc.c - src/CMakeLists.txt

add_library(openthread-cc2538
    alarm.c
...
    startup-gcc.c
...
    system.c
    logging.c
    uart.c
    $
)
前へ
概要
次へ
CMake ルールを定義する