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