entorno del bootcamp gem5

Este repositorio ha sido diseñado para su uso en tutoriales de gem5. Se creó asumiendo que los usuarios utilizarán Codespaces para aprender gem5.

El repositorio contiene los siguientes directorios:

• docker: el código fuente de la imagen de Docker utilizada por .devcontainer/Dockerfile para crear el contenedor Codespace Docker.
• gem5: v22.0.0.1 de gem5.
• gem5-resources: gem5-resources que se pueden usar con v22.0 de gem5.
• Materiales: Materiales de ejemplo utilizados como parte del tutorial.
• módulos: Fuente del sitio web adjunto: https://gem5bootcamp.github.io/gem5-bootcamp-env El sitio web contiene enlaces a diapositivas, videos de presentación y notas para los tutoriales.

Nota: 'gem5' y 'gem5-resources' son submódulos, aunque el archivo .devcontainer/devcontainer.json especifica que se ejecuta un comando git module update --init --recursive cuando se crea el contenedor Codespace Docker.

El contenedor utilizado por Codespaces se construye a partir de .devcontainer/Dockerfile. Contiene:

• Todas las dependencias de gem5 (incluidas las dependencias opcionales).
• Binarios gem5 prediseñados:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Un compilador cruzado RISCV64 y AARCH64 GNU:
  • Compilador cruzado RISCV64 GNU que se encuentra en /opt/cross-compiler/riscv64-linux/ .
  • Compilador cruzado AARCH64 GNU que se encuentra en /opt/cross-compiler/aarch64-linux/ .

ejemplo de principiantes

Lo siguiente se puede utilizar dentro del contenedor Codespace para ejecutar una simulación básica de gem5 de inmediato:

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

Esto ejecutará un "¡Hola mundo!" programa dentro de un sistema ARM simulado.

Actualización de submódulos

En este proyecto tenemos dos submódulos: 'gem5' y 'gem5-resources'. Estos se obtienen automáticamente cuando se inicializan los espacios de código. Al momento de escribir este artículo, el directorio 'gem5' está registrado en la rama estable en v22.0.0.1. El repositorio 'gem5-resources' está registrado en la revisión '871e715', que debería contener recursos con compatibilidad conocida con gem5 v22.0.

Para actualizar los submódulos de git para que estén sincronizados con sus orígenes remotos (alojados en nuestro googlesource), ejecute el siguiente comando:

git submodule update --remote

Este repositorio se puede actualizar a estos submódulos sincronizados ejecutando lo siguiente (esto supone que tiene los permisos correctos para hacerlo):

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

Mejores prácticas

Usando ramas

Una buena estrategia al trabajar con gem5 es utilizar ramas. En el directorio 'gem5', puedes usar ramas para segregar tu desarrollo. Un flujo de trabajo típico sería el siguiente.

1. Comience desde la rama estable. Esto asegurará que esté comenzando desde una versión limpia y estable de gem5.

git checkout stable

2. Crea otra rama para trabajar. Inicialmente, esta rama será idéntica a estable pero con el nombre que elijas.

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

3. Consulte esta sucursal:

git checkout example- `

4. Realice cambios en esta rama y confirme los cambios. Por ejemplo:

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. Cuando haya terminado, o desee pasar a otra cosa, realice el pago estable. Esto revierte efectivamente los cambios realizados en la rama.

git checkout stable

6. Podrás regresar a esta sucursal cuando quieras.

git checkout example-1

Para ver una lista de todas las sucursales disponibles puedes ejecutar:

git branch