configs/learning_gem5/part1/simple.py

   1 # -*- coding: utf-8 -*-
   2 # Copyright (c) 2015 Jason Power
   3 # All rights reserved.
   4 #
   5 # Redistribution and use in source and binary forms, with or without
   6 # modification, are permitted provided that the following conditions are
   7 # met: redistributions of source code must retain the above copyright
   8 # notice, this list of conditions and the following disclaimer;
   9 # redistributions in binary form must reproduce the above copyright
  10 # notice, this list of conditions and the following disclaimer in the
  11 # documentation and/or other materials provided with the distribution;
  12 # neither the name of the copyright holders nor the names of its
  13 # contributors may be used to endorse or promote products derived from
  14 # this software without specific prior written permission.
  15 #
  16 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  17 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  18 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  19 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  20 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  26 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27 #
  28 # Authors: Jason Power
  29
  30 """ This file creates a barebones system and executes 'hello', a simple Hello
  31 World application.
  32 See Part 1, Chapter 2: Creating a simple configuration script in the
  33 learning_gem5 book for more information about this script.
  34
  35 IMPORTANT: If you modify this file, it's likely that the Learning gem5 book
  36            also needs to be updated. For now, email Jason <power.jg@gmail.com>
  37
  38 """
  39
  40 from __future__ import print_function
  41 from __future__ import absolute_import
  42
  43
  44 # import the m5 (gem5) library created when gem5 is built
  45 import m5
  46 # import all of the SimObjects
  47 from m5.objects import *
  48
  49 # create the system we are going to simulate
  50 system = System()
  51
  52 # Set the clock fequency of the system (and all of its children)
  53 system.clk_domain = SrcClockDomain()
  54 system.clk_domain.clock = '1GHz'
  55 system.clk_domain.voltage_domain = VoltageDomain()
  56
  57 # Set up the system
  58 system.mem_mode = 'timing'               # Use timing accesses
  59 system.mem_ranges = [AddrRange('512MB')] # Create an address range
  60
  61 # Create a simple CPU
  62 system.cpu = TimingSimpleCPU()
  63
  64 # Create a memory bus, a system crossbar, in this case
  65 system.membus = SystemXBar()
  66
  67 # Hook the CPU ports up to the membus
  68 system.cpu.icache_port = system.membus.slave
  69 system.cpu.dcache_port = system.membus.slave
  70
  71 # create the interrupt controller for the CPU and connect to the membus
  72 system.cpu.createInterruptController()
  73
  74 # For x86 only, make sure the interrupts are connected to the memory
  75 # Note: these are directly connected to the memory bus and are not cached
  76 if m5.defines.buildEnv['TARGET_ISA'] == "x86":
  77     system.cpu.interrupts[0].pio = system.membus.master
  78     system.cpu.interrupts[0].int_master = system.membus.slave
  79     system.cpu.interrupts[0].int_slave = system.membus.master
  80
  81 # Create a DDR3 memory controller and connect it to the membus
  82 system.mem_ctrl = DDR3_1600_8x8()
  83 system.mem_ctrl.range = system.mem_ranges[0]
  84 system.mem_ctrl.port = system.membus.master
  85
  86 # Connect the system up to the membus
  87 system.system_port = system.membus.slave
  88
  89 # get ISA for the binary to run.
  90 isa = str(m5.defines.buildEnv['TARGET_ISA']).lower()
  91
  92 # Default to running 'hello', use the compiled ISA to find the binary
  93 # grab the specific path to the binary
  94 thispath = os.path.dirname(os.path.realpath(__file__))
  95 binary = os.path.join(thispath, '../../../',
  96                       'tests/test-progs/hello/bin/', isa, 'linux/hello')
  97
  98 # Create a process for a simple "Hello World" application
  99 process = Process()
 100 # Set the command
 101 # cmd is a list which begins with the executable (like argv)
 102 process.cmd = [binary]
 103 # Set the cpu to use the process as its workload and create thread contexts
 104 system.cpu.workload = process
 105 system.cpu.createThreads()
 106
 107 # set up the root SimObject and start the simulation
 108 root = Root(full_system = False, system = system)
 109 # instantiate all of the objects we've created above
 110 m5.instantiate()
 111
 112 print("Beginning simulation!")
 113 exit_event = m5.simulate()
 114 print('Exiting @ tick %i because %s' % (m5.curTick(), exit_event.getCause()))