Integrating gem5 + Ramulator2

Introduction

This repository distributes a enviorment that integrates gem5 and ramulator2.

The The repository contains following contents and files. The detailed process of integrating can be seen on How to integerate Ramulator2 to gem5.

• wrapper/: contains wrapper files to integarte ramultor2
• example/: example ramulator2's config file and binary file to test.
• script/: contains scripts utilizing gem5 standard library.

Getting started (Compile)

Clone the repository (don't need to include --recursive)

git clone https://github.com/sangjae4309/gem5-ramulator2.git

First, you need base image provided from gem5 official. This repo uses ubuntu22.04.

docker pull ghcr.io/gem5/ubuntu-22.04_all-dependencies:v23-0

Change directory to gloned repo and build docker images wit pre-defined Dockerfile (It takes a while to end) and execute the image

cd gem5-ramulator2
docker build --tag gem5-ramulator2 .
docker run -d -it --name gem5-ramulator2 gem5-ramulator2:latest
docker exec -it gem5-ramulator2 /bin/bash

After attached to gem5-ramulator2 container, run pre-defined build script which automatically compile Ramulator2 and gem5. The first argument means number of core your machine will use

cd gem5-ramulator2
./build.sh 4

Test running

Test simple binary file which runs matrix multiplication.

Option1. using deprecated script

cd gem5
build/X86/gem5.opt configs/deprecated/example/se.py --cmd=tests/test-progs/hello/bin/x86/linux/hello --cpu-type=TimingSimpleCPU --l1d_size=64kB --l1i_size=16kB --caches --mem-type=Ramulator2 --ramulator-config=../example/DDR4.yaml --cmd=../example/mm_base

Option2. using standard library (recommneded)

Use gem5's state-of-the-art feature, standard library. The script is located at script/. We recommend you to read the script and fully understand.

cd gem5
build/X86/gem5.opt ../script/base-system-se-x86.py