gem5 ブートキャンプ環境

このリポジトリは、gem5 チュートリアルで使用するために設計されています。ユーザーが gem5 を学習するためにコードスペースを利用することを想定して構築されています。

リポジトリには次のディレクトリが含まれています。

• docker : Codespace Docker コンテナーを作成するために .devcontainer/Dockerfile によって使用される Docker イメージのソース コード。
• gem5 : gem5 の v22.0.0.1。
• gem5-resources : gem5 の v22.0 で使用できる gem5-resources。
• マテリアル: チュートリアルの一部として使用されるマテリアルの例。
• モジュール: 付属 Web サイトのソース: https://gem5bootcamp.github.io/gem5-bootcamp-env この Web サイトには、スライド、プレゼンテーション ビデオ、およびチュートリアルのメモへのリンクが含まれています。

注: .devcontainer/devcontainer.json ファイルでは、Codespace Docker コンテナーの作成時にgit module update --init --recursiveコマンドが実行されるように指定されていますが、「gem5」と「gem5-resources」はサブモジュールです。

Codespaces で使用されるコンテナーは .devcontainer/Dockerfile から構築されます。これには次のものが含まれます。

• すべての gem5 依存関係 (オプションの依存関係を含む)。
• 事前に構築された gem5 バイナリ:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• RISCV64 および AARCH64 GNU クロスコンパイラー:
  • RISCV64 GNU クロスコンパイラーは/opt/cross-compiler/riscv64-linux/にあります。
  • AARCH64 GNU クロスコンパイラーは/opt/cross-compiler/aarch64-linux/にあります。

初心者向けの例

Codespace コンテナ内で以下を使用すると、基本的な gem5 シミュレーションをすぐに実行できます。

 gem5-arm gem5/configs/example/gem5_library/arm-hello.py

これにより、「Hello world!」が実行されます。シミュレートされた ARM システム内のプログラム。

サブモジュールの更新

このプロジェクトには、「gem5」と「gem5-resources」という 2 つのサブモジュールがあります。これらは、コードスペースが初期化されるときに自動的に取得されます。この記事の執筆時点では、「gem5」ディレクトリは v22.0.0.1 の安定版ブランチにチェックアウトされています。 「gem5-resources」リポジトリはリビジョン「871e715」にチェックアウトされており、これには gem5 v22.0 との互換性が確認されているリソースが含まれている必要があります。

git サブモジュールを更新してリモートのオリジン (googlesource でホストされているもの) と同期するには、次のコマンドを実行します。

git submodule update --remote

このリポジトリは、次のコマンドを実行することでこれらの同期サブモジュールに更新できます (これは、実行するための適切な権限があることが前提です)。

git add gem5 gem5-resources
git commit -m " git submodules updated "
git push

ベストプラクティス

ブランチの使用

gem5 を使用する場合の良い戦略は、ブランチを使用することです。 「gem5」ディレクトリでは、ブランチを使用して開発を分離できます。典型的なワークフローは次のようになります。

1. 安定したブランチから開始します。これにより、確実に gem5 のクリーンで安定したバージョンから開始できるようになります。

git checkout stable

2. 作業する別のブランチを作成します。最初はこのブランチは安定版と同じになりますが、名前は任意です。

git branch example-1 # Creating a new branch named 'example-1'.

3. このブランチをチェックアウトしてください:

git checkout example- `

4. このブランチに変更を加え、変更をコミットします。例えば：

test.txt git add test.txt git commit -m "misc: Adding a test commit"">

 echo " Create a test commit " > test.txt
git add test.txt
git commit -m " misc: Adding a test commit "

5. 完了したら、または別の作業に移りたい場合は、stable をチェックアウトします。これにより、ブランチに加えられた変更が効果的に元に戻ります。

git checkout stable

6. いつでもこのブランチに戻ることができます。

git checkout example-1

利用可能なすべてのブランチのリストを表示するには、次のコマンドを実行します。

git branch