Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 2.6 KB

README.md

File metadata and controls

57 lines (41 loc) · 2.6 KB
Raw

DRAMSys with gem5 SE Mode

Install gem5 by following the instructions in the gem5 documentation. In order to allow a coupling without running into problems we recommend using the develop branch. Optionally, use the scripts from gem5.TnT to install gem5, build it, get some benchmark programs and learn more about gem5.

In order to understand the SystemC coupling with gem5 it is recommended to read the documentation in the gem5 repository util/tlm/README and [1].

First, select your gem5 variant and gem5 ISA in DRAMSys/gem5/CMakeLists.txt. Afterwards, follow the steps to build the gem5 executable and shared library.

$ cd gem5
$ scons build/<ARM/X86>/gem5.opt
$ scons --with-cxx-config --without-python --without-tcmalloc USE_SYSTEMC=False build/<ARM/X86>/libgem5_opt.so

In order to use gem5 with DRAMSys export the root directory as GEM5 environment variable. Run CMake with the additional variable -DDRAMSYS_WITH_GEM5=ON and Make.

$ export GEM5=/path/to/gem5
$ cd DRAMSys/build
$ cmake ../DRAMSys/ -DDRAMSYS_WITH_GEM5=ON
$ make

Adjust the path/to/gem5/configs/example/se.py as shown below:

...
if options.tlm_memory:
    system.physmem = SimpleMemory()
MemConfig.config_mem(options, system)
...

Next, a gem5 configuration file has to be generated. A "Hello world!" example is provided in the gem5 repository. To run the example execute the following commands:

$ cd DRAMSys/build/gem5
$ ./path/to/gem5/build/<ARM/X86>/gem5.opt path/to/gem5/configs/example/se.py \
  -c path/to/gem5/tests/test-progs/hello/bin/<arm/x86>/linux/hello \ 
  --mem-size=512MB --mem-channels=1 --caches --l2cache --mem-type=SimpleMemory \
  --cpu-type=TimingSimpleCPU --num-cpu=1 \
  --tlm-memory=transactor

The error message fatal: Can't find port handler type 'tlm_slave' is printed because a TLM memory is not yet connected to gem5. However, a configuration file that corresponds to the simulation will already be created inside the m5out directory. This configuration file can now be used to run the same simulation with gem5 coupled to DRAMSys:

$ ./DRAMSys_gem5 ../../DRAMSys/library/resources/simulations/ddr3-gem5-se.json m5out/config.ini 1

Hello world! should be printed to the standard output.

References

[1] System Simulation with gem5 and SystemC: The Keystone for Full Interoperability
C. Menard, M. Jung, J. Castrillon, N. Wehn. IEEE International Conference on Embedded Computer Systems Architectures Modeling and Simulation (SAMOS), July, 2017, Samos Island, Greece.