Difference between revisions of "Defining CPU Models (as of M5 2.0 - beta 3)"

From gem5
Jump to: navigation, search
Line 8: Line 8:
 
*m5/cpu/static_inst.hh: Put a forward class declaration of your model in here
 
*m5/cpu/static_inst.hh: Put a forward class declaration of your model in here
 
*m5/cpu/cpu_models.py: Add in CPU Model-specific information for the ISA Parser ( check out the [[The M5 ISA description language | ISA Description Language documentation]] page for more details)  
 
*m5/cpu/cpu_models.py: Add in CPU Model-specific information for the ISA Parser ( check out the [[The M5 ISA description language | ISA Description Language documentation]] page for more details)  
*m5/python/objects/my_cpu.py: Create a python file (e.g. MyCPU.py) your model. A good example to follow is the file 'AlphaO3CPU.py'.
+
*m5/python/objects/my_cpu.py: Create a python file (e.g. MyCPU.py) your model. A good example to follow is the file 'O3CPU.py'.
 
*m5/python/objects/__init__.py: Add the base name of your python file into the 'file_bases' list.
 
*m5/python/objects/__init__.py: Add the base name of your python file into the 'file_bases' list.
  

Revision as of 18:36, 6 October 2006

First, make sure you have basic understanding of how the CPU models function within the M5 framework. A good start is the CPU Models page.

The easiest way is to derive a new C++ class of your CPU Model from M5 CPU Models that are already defined and the easiest model to start with is probably the 'AtomicSimpleCPU' located in the 'm5/cpu/simple' directory.

After you create a separate directory for your code (e.g. 'm5/cpu/my_cpu'), there are a couple files that need to be updated:

  • m5/SConstruct: Add the name of your CPU model to the 'ALL_CPU_LIST'
  • m5/cpu/SConscript: Add your CPU model and the relevant files that need to be built in here
  • m5/cpu/static_inst.hh: Put a forward class declaration of your model in here
  • m5/cpu/cpu_models.py: Add in CPU Model-specific information for the ISA Parser ( check out the ISA Description Language documentation page for more details)
  • m5/python/objects/my_cpu.py: Create a python file (e.g. MyCPU.py) your model. A good example to follow is the file 'O3CPU.py'.
  • m5/python/objects/__init__.py: Add the base name of your python file into the 'file_bases' list.


Now build your model:

  • scons build/ALPHA_SE/m5.debug CPU_MODELS=MY_CPU


Create and edit configuration files for your model:

  • m5/configs/test/MyCPUConfig.py: Define a configuration class w/corresponding parameters for your model. Look to 'FullO3Config.py' in the same directory for an example of how to do this.
  • m5/configs/test/test.py: Import your model's configuration at the top of the file (i.e. 'import MyCPUConfig') and add in a parser option for your CPU model (e.g. '--my_cpu').


Test your model:

  • build/ALPHA_SE/m5.debug configs/example/se.py --my_cpu --cmd=<bin_path>