configs/ruby/Garnet_standalone.py

   1 # Copyright (c) 2009 Advanced Micro Devices, Inc.
   2 # Copyright (c) 2016 Georgia Institute of Technology
   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 import m5
  29 from m5.objects import *
  30 from m5.defines import buildEnv
  31 from m5.util import addToPath
  32 from .Ruby import create_topology, create_directories
  33
  34 #
  35 # Declare caches used by the protocol
  36 #
  37 class L1Cache(RubyCache): pass
  38
  39 def define_options(parser):
  40     return
  41
  42 def create_system(options, full_system, system, dma_ports, bootmem,
  43                   ruby_system):
  44     if buildEnv['PROTOCOL'] != 'Garnet_standalone':
  45         panic("This script requires Garnet_standalone protocol to be built.")
  46
  47     cpu_sequencers = []
  48
  49     #
  50     # The Garnet_standalone protocol does not support fs nor dma
  51     #
  52     assert(dma_ports == [])
  53
  54     #
  55     # The ruby network creation expects the list of nodes in the system to be
  56     # consistent with the NetDest list.
  57     # Therefore the l1 controller nodes must be listed before
  58     # the directory nodes and directory nodes before dma nodes, etc.
  59     l1_cntrl_nodes = []
  60
  61     #
  62     # Must create the individual controllers before the network to ensure the
  63     # controller constructors are called before the network constructor
  64     #
  65
  66     for i in range(options.num_cpus):
  67         #
  68         # First create the Ruby objects associated with this cpu
  69         # Only one cache exists for this protocol, so by default use the L1D
  70         # config parameters.
  71         #
  72         cache = L1Cache(size = options.l1d_size,
  73                         assoc = options.l1d_assoc)
  74
  75         #
  76         # Only one unified L1 cache exists.  Can cache instructions and data.
  77         #
  78         l1_cntrl = L1Cache_Controller(version = i,
  79                                       cacheMemory = cache,
  80                                       ruby_system = ruby_system)
  81
  82         cpu_seq = RubySequencer(dcache = cache,
  83                                 garnet_standalone = True,
  84                                 ruby_system = ruby_system)
  85
  86         l1_cntrl.sequencer = cpu_seq
  87         exec("ruby_system.l1_cntrl%d = l1_cntrl" % i)
  88
  89         # Add controllers and sequencers to the appropriate lists
  90         cpu_sequencers.append(cpu_seq)
  91         l1_cntrl_nodes.append(l1_cntrl)
  92
  93         # Connect the L1 controllers and the network
  94         l1_cntrl.mandatoryQueue = MessageBuffer()
  95         l1_cntrl.requestFromCache = MessageBuffer()
  96         l1_cntrl.responseFromCache = MessageBuffer()
  97         l1_cntrl.forwardFromCache = MessageBuffer()
  98
  99     mem_dir_cntrl_nodes, rom_dir_cntrl_node = create_directories(
 100         options, bootmem, ruby_system, system)
 101     dir_cntrl_nodes = mem_dir_cntrl_nodes[:]
 102     if rom_dir_cntrl_node is not None:
 103         dir_cntrl_nodes.append(rom_dir_cntrl_node)
 104     for dir_cntrl in dir_cntrl_nodes:
 105         # Connect the directory controllers and the network
 106         dir_cntrl.requestToDir = MessageBuffer()
 107         dir_cntrl.forwardToDir = MessageBuffer()
 108         dir_cntrl.responseToDir = MessageBuffer()
 109
 110
 111     all_cntrls = l1_cntrl_nodes + dir_cntrl_nodes
 112     ruby_system.network.number_of_virtual_networks = 3
 113     topology = create_topology(all_cntrls, options)
 114     return (cpu_sequencers, mem_dir_cntrl_nodes, topology)