ambiente de bootcamp gem5

Este repositório foi projetado para uso em tutoriais gem5. Ele foi construído com a suposição de que os usuários utilizarão Codespaces para aprender gem5.

O repositório contém os seguintes diretórios:

• docker : o código-fonte da imagem Docker usada por .devcontainer/Dockerfile para criar o contêiner Codespace Docker.
• gem5: v22.0.0.1 do gem5.
• gem5-resources: gem5-resources que pode ser usado com v22.0 do gem5.
• materiais: exemplos de materiais usados ​​como parte do tutorial.
• módulos: Fonte para o site que o acompanha: https://gem5bootcamp.github.io/gem5-bootcamp-env O site contém links para slides, vídeos de apresentação e notas para os tutoriais.

Nota: 'gem5' e 'gem5-resources' são submódulos, embora o arquivo .devcontainer/devcontainer.json especifique que um comando git module update --init --recursive é executado quando o contêiner Codespace Docker é criado.

O contêiner usado pelo Codespaces é construído a partir de .devcontainer/Dockerfile. Ele contém:

• Todas as dependências gem5 (incluindo dependências opcionais).
• Binários gem5 pré-construídos:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Um compilador cruzado RISCV64 e AARCH64 GNU:
  • Compilador cruzado RISCV64 GNU encontrado em /opt/cross-compiler/riscv64-linux/ .
  • Compilador cruzado AARCH64 GNU encontrado em /opt/cross-compiler/aarch64-linux/ .

Exemplo para iniciantes

O seguinte pode ser usado no contêiner Codespace para executar uma simulação gem5 básica imediatamente:

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

Isso executará um "Olá, mundo!" programa dentro de um sistema ARM simulado.

Atualizando submódulos

Neste projeto temos dois submódulos: 'gem5' e 'gem5-resources'. Eles são obtidos automaticamente quando os codespaces são inicializados. No momento em que este artigo foi escrito, o diretório 'gem5' estava em check-out na ramificação estável em v22.0.0.1. O repositório 'gem5-resources' foi verificado para a revisão '871e715', que deve conter recursos com compatibilidade conhecida com gem5 v22.0.

Para atualizar os submódulos git para que estejam sincronizados com suas origens remotas (hospedadas em nosso googlesource), execute o seguinte comando:

git submodule update --remote

Este repositório pode ser atualizado para esses submódulos sincronizados executando o seguinte (isso pressupõe que você tenha as permissões corretas para fazer isso):

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

Melhores práticas

Usando filiais

Uma boa estratégia ao trabalhar com gem5 é usar ramificações. No diretório ‘gem5’, você pode usar ramificações para segregar seu desenvolvimento. Um fluxo de trabalho típico seria o seguinte.

1. Comece no branch estável. Isso garantirá que você esteja começando com uma versão limpa e estável do gem5.

git checkout stable

2. Crie outro branch para trabalhar. Inicialmente este branch será ideal para estável mas com um nome à sua escolha.

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

3. Confira este ramo:

git checkout example- `

4. Faça alterações neste branch e confirme as alterações. Por exemplo:

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. Quando terminar, ou desejar passar para outra coisa, checkout estável. Isso reverte efetivamente as alterações feitas na ramificação.

git checkout stable

6. Você pode retornar a este ramo quando quiser.

git checkout example-1

Para ver uma lista de todas as ramificações disponíveis que você pode executar:

git branch