gem5 bootcamp env

Repositori ini telah dirancang untuk digunakan dalam tutorial gem5. Itu dibangun dengan asumsi pengguna akan menggunakan Codespaces untuk mempelajari gem5.

Repositori berisi direktori berikut:

• docker : Kode sumber untuk image Docker yang digunakan oleh .devcontainer/Dockerfile untuk membuat container Codespace Docker.
• permata5 : v22.0.0.1 dari permata5.
• gem5-resources : gem5-resources yang dapat digunakan dengan gem5 v22.0.
• bahan: Contoh bahan yang digunakan sebagai bagian dari tutorial.
• modul: Sumber untuk situs web yang menyertainya: https://gem5bootcamp.github.io/gem5-bootcamp-env Situs web ini berisi tautan ke slide, video presentasi, dan catatan untuk tutorial.

Catatan: 'gem5' dan 'gem5-resources' adalah submodul meskipun file .devcontainer/devcontainer.json menetapkan bahwa perintah git module update --init --recursive dijalankan ketika kontainer Codespace Docker dibuat.

Kontainer yang digunakan oleh Codespaces dibuat dari .devcontainer/Dockerfile. Ini berisi:

• Semua dependensi gem5 (termasuk dependensi opsional).
• Biner gem5 bawaan:
  • /usr/local/bin/gem5-x86
  • /usr/local/bin/gem5-arm
  • /usr/local/bin/gem5-riscv
• Kompiler silang RISCV64 dan AARCH64 GNU:
  • Kompiler silang GNU RISCV64 ditemukan di /opt/cross-compiler/riscv64-linux/ .
  • Kompiler silang GNU AARCH64 ditemukan di /opt/cross-compiler/aarch64-linux/ .

Contoh bagi pemula

Berikut ini dapat digunakan dalam wadah Codespace untuk langsung menjalankan simulasi gem5 dasar:

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

Ini akan menjalankan pesan "Halo dunia!" program di dalam sistem ARM yang disimulasikan.

Memperbarui submodul

Dalam proyek ini kami memiliki dua submodul: 'gem5' dan 'gem5-resources'. Ini secara otomatis diperoleh ketika ruang kode diinisialisasi. Pada saat penulisan, direktori 'gem5' diperiksa ke cabang stabil di v22.0.0.1. Repositori 'gem5-resources' diperiksa ke revisi '871e715', yang harus berisi sumber daya yang diketahui kompatibel dengan gem5 v22.0.

Untuk memperbarui submodul git agar sinkron dengan asal usulnya yang jauh (yang dihosting di sumber Google kami), jalankan perintah berikut:

git submodule update --remote

Repositori ini dapat diperbarui ke submodul yang disinkronkan dengan menjalankan perintah berikut (dengan asumsi Anda memiliki izin yang benar untuk melakukannya):

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

Praktik terbaik

Menggunakan cabang

Strategi yang baik ketika bekerja dengan gem5 adalah dengan menggunakan cabang. Di direktori 'gem5', Anda dapat menggunakan cabang untuk memisahkan pengembangan Anda. Alur kerja umumnya adalah sebagai berikut.

1. Mulai dari cabang stabil. Ini akan memastikan Anda memulai dari versi gem5 yang bersih dan stabil.

git checkout stable

2. Buat cabang lain untuk dikerjakan. Awalnya cabang ini identik dengan stable tetapi dengan nama pilihan Anda.

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

3. Lihat cabang ini:

git checkout example- `

4. Buat perubahan pada cabang ini dan komit perubahan tersebut. Misalnya:

 echo " Create a test commit " > test.txt
git add test.txt
git commit -m " misc: Adding a test commit "

5. Setelah selesai, atau ingin beralih ke hal lain, checkout stabil. Ini secara efektif mengembalikan perubahan yang dibuat pada cabang.

git checkout stable

6. Anda dapat kembali ke cabang ini kapan pun Anda mau.

git checkout example-1

Untuk melihat daftar semua cabang yang tersedia, Anda dapat menjalankan:

git branch