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

Revision as of 04:09, 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 'AlphaO3CPU.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>