diff options
author | Jason Lowe-Power <power.jg@gmail.com> | 2015-09-16 09:35:36 -0500 |
---|---|---|
committer | Jason Lowe-Power <power.jg@gmail.com> | 2015-09-16 09:35:36 -0500 |
commit | f065f9941b5e3b2796ec46d1926115283edd66cd (patch) | |
tree | fd115020de8f10457614eb747c463aa5928ca7e4 /configs/learning_gem5/part1/two_level.py | |
parent | 0d6a6dfd7b500aff7e91a22c9bb7211e1807b90e (diff) | |
download | gem5-f065f9941b5e3b2796ec46d1926115283edd66cd.tar.xz |
config: Add configs scripts used in Learning gem5
Added a new directory in configs (learning_gem5) to hold the scripts that are
used in the book. See http://lowepower.com/jason/learning_gem5/ for a working
copy. For now, only the scripts in Part 1: Getting started with gem5
have been added. A separate patch adds tests for these scripts.
Committed by: Nilay Vaish <nilay@cs.wisc.edu>
Diffstat (limited to 'configs/learning_gem5/part1/two_level.py')
-rw-r--r-- | configs/learning_gem5/part1/two_level.py | 151 |
1 files changed, 151 insertions, 0 deletions
diff --git a/configs/learning_gem5/part1/two_level.py b/configs/learning_gem5/part1/two_level.py new file mode 100644 index 000000000..edaeafe79 --- /dev/null +++ b/configs/learning_gem5/part1/two_level.py @@ -0,0 +1,151 @@ +# -*- coding: utf-8 -*- +# Copyright (c) 2015 Jason Power +# All rights reserved. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer; +# redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution; +# neither the name of the copyright holders nor the names of its +# contributors may be used to endorse or promote products derived from +# this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# +# Authors: Jason Power + +""" This file creates a single CPU and a two-level cache system. +This script takes a single parameter which specifies a binary to execute. +If none is provided it executes 'hello' by default (mostly used for testing) + +See Part 1, Chapter 3: Adding cache to the configuration script in the +learning_gem5 book for more information about this script. +This file exports options for the L1 I/D and L2 cache sizes. + +IMPORTANT: If you modify this file, it's likely that the Learning gem5 book + also needs to be updated. For now, email Jason <power.jg@gmail.com> + +""" + +# import the m5 (gem5) library created when gem5 is built +import m5 +# import all of the SimObjects +from m5.objects import * + +# Add the common scripts to our path +m5.util.addToPath('../../common') + +# import the caches which we made +from caches import * + +# import the SimpleOpts module +import SimpleOpts + +# Set the usage message to display +SimpleOpts.set_usage("usage: %prog [options] <binary to execute>") + +# Finalize the arguments and grab the opts so we can pass it on to our objects +(opts, args) = SimpleOpts.parse_args() + +# get ISA for the default binary to run. This is mostly for simple testing +isa = str(m5.defines.buildEnv['TARGET_ISA']).lower() + +# Default to running 'hello', use the compiled ISA to find the binary +binary = 'tests/test-progs/hello/bin/' + isa + '/linux/hello' + +# Check if there was a binary passed in via the command line and error if +# there are too many arguments +if len(args) == 1: + binary = args[0] +elif len(args) > 1: + SimpleOpts.print_help() + m5.fatal("Expected a binary to execute as positional argument") + +# create the system we are going to simulate +system = System() + +# Set the clock fequency of the system (and all of its children) +system.clk_domain = SrcClockDomain() +system.clk_domain.clock = '1GHz' +system.clk_domain.voltage_domain = VoltageDomain() + +# Set up the system +system.mem_mode = 'timing' # Use timing accesses +system.mem_ranges = [AddrRange('512MB')] # Create an address range + +# Create a simple CPU +system.cpu = TimingSimpleCPU() + +# Create an L1 instruction and data cache +system.cpu.icache = L1ICache(opts) +system.cpu.dcache = L1DCache(opts) + +# Connect the instruction and data caches to the CPU +system.cpu.icache.connectCPU(system.cpu) +system.cpu.dcache.connectCPU(system.cpu) + +# Create a memory bus, a coherent crossbar, in this case +system.l2bus = L2XBar() + +# Hook the CPU ports up to the l2bus +system.cpu.icache.connectBus(system.l2bus) +system.cpu.dcache.connectBus(system.l2bus) + +# Create an L2 cache and connect it to the l2bus +system.l2cache = L2Cache(opts) +system.l2cache.connectCPUSideBus(system.l2bus) + +# Create a memory bus +system.membus = SystemXBar() + +# Connect the L2 cache to the membus +system.l2cache.connectMemSideBus(system.membus) + +# create the interrupt controller for the CPU +system.cpu.createInterruptController() + +# For x86 only, make sure the interrupts are connected to the memory +# Note: these are directly connected to the memory bus and are not cached +if m5.defines.buildEnv['TARGET_ISA'] == "x86": + system.cpu.interrupts.pio = system.membus.master + system.cpu.interrupts.int_master = system.membus.slave + system.cpu.interrupts.int_slave = system.membus.master + +# Connect the system up to the membus +system.system_port = system.membus.slave + +# Create a DDR3 memory controller +system.mem_ctrl = DDR3_1600_x64() +system.mem_ctrl.range = system.mem_ranges[0] +system.mem_ctrl.port = system.membus.master + +# Create a process for a simple "Hello World" application +process = LiveProcess() +# Set the command +# cmd is a list which begins with the executable (like argv) +process.cmd = [binary] +# Set the cpu to use the process as its workload and create thread contexts +system.cpu.workload = process +system.cpu.createThreads() + +# set up the root SimObject and start the simulation +root = Root(full_system = False, system = system) +# instantiate all of the objects we've created above +m5.instantiate() + +print "Beginning simulation!" +exit_event = m5.simulate() +print 'Exiting @ tick %i because %s' % (m5.curTick(), exit_event.getCause()) |