environnement de bootcamp gem5

Ce référentiel a été conçu pour être utilisé dans les didacticiels gem5. Il a été construit en partant du principe que les utilisateurs utiliseront les Codespaces pour apprendre gem5.

Le référentiel contient les répertoires suivants :

• docker : Le code source de l'image Docker utilisée par .devcontainer/Dockerfile pour créer le conteneur Codespace Docker.
• gem5 : v22.0.0.1 de gem5.
• gem5-resources : gem5-resources qui peuvent être utilisées avec la v22.0 de gem5.
• matériaux : exemples de matériaux utilisés dans le cadre du didacticiel.
• modules : Source du site Web qui l'accompagne : https://gem5bootcamp.github.io/gem5-bootcamp-env Le site Web contient des liens vers des diapositives, des vidéos de présentation et des notes pour les didacticiels.

Remarque : 'gem5' et 'gem5-resources' sont des sous-modules bien que le fichier .devcontainer/devcontainer.json spécifie qu'une commande git module update --init --recursive est exécutée lors de la création du conteneur Codespace Docker.

Le conteneur utilisé par Codespaces est construit à partir de .devcontainer/Dockerfile. Il contient :

• Toutes les dépendances gem5 (y compris les dépendances facultatives).
• Binaires gem5 prédéfinis :
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Un compilateur croisé RISCV64 et AARCH64 GNU :
  • Compilateur croisé RISCV64 GNU trouvé dans /opt/cross-compiler/riscv64-linux/ .
  • Compilateur croisé AARCH64 GNU trouvé dans /opt/cross-compiler/aarch64-linux/ .

Exemple pour débutants

Les éléments suivants peuvent être utilisés dans le conteneur Codespace pour exécuter immédiatement une simulation gem5 de base :

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

Cela exécutera un message « Hello world ! » programme dans un système ARM simulé.

Mise à jour des sous-modules

Dans ce projet, nous avons deux sous-modules : 'gem5' et 'gem5-resources'. Ceux-ci sont automatiquement obtenus lors de l’initialisation des espaces de codes. Au moment de la rédaction, le répertoire 'gem5' est extrait dans la branche stable v22.0.0.1. Le référentiel 'gem5-resources' est extrait vers la révision '871e715', qui devrait contenir des ressources avec une compatibilité connue avec gem5 v22.0.

Pour mettre à jour les sous-modules git afin qu'ils soient synchronisés avec leurs origines distantes (hébergées sur notre source Google), exécutez la commande suivante :

git submodule update --remote

Ce référentiel peut être mis à jour vers ces sous-modules synchronisés en exécutant ce qui suit (cela suppose que vous disposez des autorisations appropriées pour le faire) :

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

Meilleures pratiques

Utiliser des succursales

Une bonne stratégie lorsque vous travaillez avec gem5 consiste à utiliser des branches. Dans le répertoire 'gem5', vous pouvez utiliser des branches pour séparer votre développement. Un flux de travail typique serait le suivant.

1. Commencez par la branche stable. Cela garantira que vous partez d’une version propre et stable de gem5.

git checkout stable

2. Créez une autre branche sur laquelle travailler. Initialement cette branche sera identique à stable mais avec un nom de votre choix.

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

3. Découvrez cette branche :

git checkout example- `

4. Apportez des modifications sur cette branche et validez les modifications. Par exemple:

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. Une fois terminé, ou si vous souhaitez passer à autre chose, commandez stable. Cela annule efficacement les modifications apportées à la branche.

git checkout stable

6. Vous pouvez revenir dans cette agence quand vous le souhaitez.

git checkout example-1

Pour voir une liste de toutes les branches disponibles, vous pouvez exécuter :

git branch