окружение учебного курса gem5

Этот репозиторий был разработан для использования в учебных пособиях по Gem5. Он был создан с расчетом на то, что пользователи будут использовать Codespaces для изучения gem5.

Репозиторий содержит следующие каталоги:

• docker: исходный код образа Docker, используемый .devcontainer/Dockerfile для создания Docker-контейнера Codespace.
• драгоценный камень5: версия 22.0.0.1 из драгоценного камня5.
• gem5-resources: ресурсы gem5, которые можно использовать с версией 22.0 gem5.
• материалы: примеры материалов, используемых в рамках учебного пособия.
• Модули: Источник сопутствующего веб-сайта: https://gem5bootcamp.github.io/gem5-bootcamp-env. Веб-сайт содержит ссылки на слайды, презентационные видеоролики и примечания к учебным пособиям.

Примечание. «gem5» и «gem5-resources» являются подмодулями, хотя в файле .devcontainer/devcontainer.json указано, что команда git module update --init --recursive выполняется при создании Docker-контейнера Codespace.

Контейнер, используемый Codespaces, создан из .devcontainer/Dockerfile. Он содержит:

• Все зависимости gem5 (включая необязательные зависимости).
• Готовые двоичные файлы gem5:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Кросс-компилятор GNU RISCV64 и AARCH64:
  • Кросс-компилятор GNU RISCV64 находится в /opt/cross-compiler/riscv64-linux/ .
  • Кросс-компилятор GNU AARCH64 находится в /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 для синхронизации с их удаленными источниками (которые размещены в нашем источнике Google), выполните следующую команду:

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