gem5 訓練營環境

此存儲庫設計用於 gem5 教程。它是在假設用戶將利用 Codespaces 來學習 gem5 的情況下建構的。

此儲存庫包含以下目錄：

• docker ：.devcontainer/Dockerfile 用於建立 Codespace Docker 容器的 Docker 映像的原始程式碼。
• gem5 ：gem5 的 v22.0.0.1。
• gem5-resources ：可與 gem5 v22.0 一起使用的 gem5-resources 。
• 材料：作為教程一部分的範例材料。
• 模組：隨附網站的來源：https://gem5bootcamp.github.io/gem5-bootcamp-env 本網站包含幻燈片、簡報影片和教學註解的連結。

注意： “gem5”和“gem5-resources”是子模組，儘管 .devcontainer/devcontainer.json 檔案指定在建立 Codespace Docker 容器時執行git module update --init --recursive指令。

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」。這些是在初始化程式碼空間時自動獲得的。在撰寫本文時，「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. 完成後，或希望轉移到其他地方，請結帳穩定。這有效地恢復了在分支上所做的更改。

git checkout stable

6. 您可以隨時返回該分行。

git checkout example-1

要查看所有可用分支的列表，您可以執行：

git branch