gem5 Bootcamp-Umgebung

Dieses Repository wurde für die Verwendung in gem5-Tutorials entwickelt. Es wurde unter der Annahme entwickelt, dass Benutzer Codespaces verwenden, um gem5 zu erlernen.

Das Repository enthält die folgenden Verzeichnisse:

• docker: Der Quellcode für das Docker-Image, das von .devcontainer/Dockerfile zum Erstellen des Codespace-Docker-Containers verwendet wird.
• gem5: v22.0.0.1 von gem5.
• gem5-resources: gem5-Ressourcen, die mit v22.0 von gem5 verwendet werden können.
• Materialien: Beispielmaterialien, die im Rahmen des Tutorials verwendet werden.
• Module: Quelle für die zugehörige Website: https://gem5bootcamp.github.io/gem5-bootcamp-env Die Website enthält Links zu Folien, Präsentationsvideos und Notizen für die Tutorials.

Hinweis: „gem5“ und „gem5-resources“ sind Submodule, obwohl die Datei .devcontainer/devcontainer.json angibt, dass ein Befehl git module update --init --recursive ausgeführt wird, wenn der Codespace Docker-Container erstellt wird.

Der von Codespaces verwendete Container wird aus .devcontainer/Dockerfile erstellt. Es enthält:

• Alle gem5-Abhängigkeiten (einschließlich optionaler Abhängigkeiten).
• Vorgefertigte gem5-Binärdateien:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Ein RISCV64- und ein AARCH64-GNU-Cross-Compiler:
  • RISCV64 GNU Cross-Compiler gefunden in /opt/cross-compiler/riscv64-linux/ .
  • AARCH64 GNU Cross-Compiler gefunden in /opt/cross-compiler/aarch64-linux/ .

Beispiel für Anfänger

Folgendes kann im Codespace-Container verwendet werden, um sofort eine grundlegende gem5-Simulation auszuführen:

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

Dadurch wird ein „Hallo Welt!“-Befehl ausgeführt. Programm in einem simulierten ARM-System.

Submodule aktualisieren

In diesem Projekt haben wir zwei Untermodule: „gem5“ und „gem5-resources“. Diese werden automatisch abgerufen, wenn der Codespace initialisiert wird. Zum Zeitpunkt des Schreibens ist das Verzeichnis „gem5“ in den Stable-Zweig bei v22.0.0.1 ausgecheckt. Das Repository „gem5-resources“ wird auf die Revision „871e715“ ausgecheckt, die Ressourcen mit bekannter Kompatibilität mit gem5 v22.0 enthalten sollte.

Um die Git-Submodule so zu aktualisieren, dass sie mit ihren Remote-Ursprüngen (die auf unserer Google-Quelle gehostet werden) synchronisiert sind, führen Sie den folgenden Befehl aus:

git submodule update --remote

Dieses Repository kann auf diese synchronisierten Submodule aktualisiert werden, indem Sie Folgendes ausführen (dies setzt voraus, dass Sie über die entsprechenden Berechtigungen verfügen):

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

Best Practices

Verwendung von Zweigen

Eine gute Strategie bei der Arbeit mit gem5 ist die Verwendung von Branches. Im Verzeichnis „gem5“ können Sie Zweige verwenden, um Ihre Entwicklung zu trennen. Ein typischer Arbeitsablauf wäre wie folgt.

1. Beginnen Sie im Stable-Zweig. Dadurch wird sichergestellt, dass Sie von einer sauberen, stabilen Version von gem5 ausgehen.

git checkout stable

2. Erstellen Sie einen weiteren Zweig, an dem Sie arbeiten können. Zunächst wird dieser Zweig mit „stable“ identisch sein, jedoch mit einem Namen Ihrer Wahl.

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

3. Bezahlen Sie diesen Zweig:

git checkout example- `

4. Nehmen Sie Änderungen an diesem Zweig vor und übernehmen Sie die Änderungen. Zum Beispiel:

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. Wenn Sie fertig sind oder mit etwas anderem fortfahren möchten, gehen Sie zur Kasse. Dadurch werden die am Zweig vorgenommenen Änderungen effektiv rückgängig gemacht.

git checkout stable

6. Sie können jederzeit zu dieser Filiale zurückkehren.

git checkout example-1

Um eine Liste aller verfügbaren Zweige anzuzeigen, können Sie Folgendes ausführen:

git branch