Ruby.py revision 7661:b03534522b91
1# Copyright (c) 2006-2007 The Regents of The University of Michigan 2# Copyright (c) 2009 Advanced Micro Devices, Inc. 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: Brad Beckmann 29 30import math 31import m5 32from m5.objects import * 33from m5.defines import buildEnv 34 35def define_options(parser): 36 # ruby network options 37 parser.add_option("--topology", type="string", default="Crossbar", 38 help="check src/mem/ruby/network/topologies for complete set") 39 parser.add_option("--mesh-rows", type="int", default=1, 40 help="the number of rows in the mesh topology") 41 parser.add_option("--garnet-network", type="string", default=None, 42 help="'fixed'|'flexible'") 43 44 # ruby mapping options 45 parser.add_option("--numa-high-bit", type="int", default=None, 46 help="high order address bit to use for numa mapping. " \ 47 "0 = highest bit, not specified = lowest bit") 48 49 # ruby sparse memory options 50 parser.add_option("--use-map", action="store_true", default=False) 51 parser.add_option("--map-levels", type="int", default=4) 52 53 # ruby debug cmd line options 54 parser.add_option("--ruby-debug", action="store_true", default=False) 55 parser.add_option("--ruby-debug-cycle", type="int", default=1) 56 57 parser.add_option("--recycle-latency", type="int", default=10, 58 help="Recycle latency for ruby controller input buffers") 59 60 protocol = buildEnv['PROTOCOL'] 61 exec "import %s" % protocol 62 eval("%s.define_options(parser)" % protocol) 63 64def create_system(options, system, piobus = None, dma_devices = []): 65 66 protocol = buildEnv['PROTOCOL'] 67 exec "import %s" % protocol 68 try: 69 (cpu_sequencers, dir_cntrls, all_cntrls) = \ 70 eval("%s.create_system(options, system, piobus, dma_devices)" \ 71 % protocol) 72 except: 73 print "Error: could not create sytem for ruby protocol %s" % protocol 74 raise 75 76 # 77 # Important: the topology must be created before the network and after the 78 # controllers. 79 # 80 exec "import %s" % options.topology 81 try: 82 net_topology = eval("%s.makeTopology(all_cntrls, options)" \ 83 % options.topology) 84 except: 85 print "Error: could not create topology %s" % options.topology 86 raise 87 88 if options.garnet_network == "fixed": 89 network = GarnetNetwork_d(topology = net_topology) 90 elif options.garnet_network == "flexible": 91 network = GarnetNetwork(topology = net_topology) 92 else: 93 network = SimpleNetwork(topology = net_topology) 94 95 # 96 # Loop through the directory controlers. 97 # Determine the total memory size of the ruby system and verify it is equal 98 # to physmem. However, if Ruby memory is using sparse memory in SE 99 # mode, then the system should not back-up the memory state with 100 # the Memory Vector and thus the memory size bytes should stay at 0. 101 # Also set the numa bits to the appropriate values. 102 # 103 total_mem_size = MemorySize('0B') 104 105 dir_bits = int(math.log(options.num_dirs, 2)) 106 107 if options.numa_high_bit: 108 numa_bit = options.numa_high_bit 109 else: 110 # if not specified, use the lowest bits above the block offest 111 if options.numa_high_bit == 0: 112 if dir_bits > 0: 113 # add 5 because bits 0-5 are the block offset 114 numa_bit = dir_bits + 5 115 else: 116 numa_bit = 6 117 118 for dir_cntrl in dir_cntrls: 119 total_mem_size.value += dir_cntrl.directory.size.value 120 dir_cntrl.directory.numa_high_bit = numa_bit 121 122 physmem_size = long(system.physmem.range.second) - \ 123 long(system.physmem.range.first) + 1 124 assert(total_mem_size.value == physmem_size) 125 126 ruby_profiler = RubyProfiler(num_of_sequencers = len(cpu_sequencers)) 127 128 ruby = RubySystem(clock = options.clock, 129 network = network, 130 profiler = ruby_profiler, 131 tracer = RubyTracer(), 132 debug = RubyDebug(filter_string = 'none', 133 verbosity_string = 'none', 134 protocol_trace = options.ruby_debug, 135 start_time = options.ruby_debug_cycle), 136 mem_size = total_mem_size) 137 138 ruby.cpu_ruby_ports = cpu_sequencers 139 140 return ruby 141