SConscript revision 2733 
1# -*- mode:python -*-
2
3# Copyright (c) 2006 The Regents of The University of Michigan
4# All rights reserved.
5#
6# Redistribution and use in source and binary forms, with or without
7# modification, are permitted provided that the following conditions are
8# met: redistributions of source code must retain the above copyright
9# notice, this list of conditions and the following disclaimer;
10# redistributions in binary form must reproduce the above copyright
11# notice, this list of conditions and the following disclaimer in the
12# documentation and/or other materials provided with the distribution;
13# neither the name of the copyright holders nor the names of its
14# contributors may be used to endorse or promote products derived from
15# this software without specific prior written permission.
16#
17# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
21# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
22# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
23# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28#
29# Authors: Steve Reinhardt
30
31import os
32import os.path
33
34# Import build environment variable from SConstruct.
35Import('env')
36
37#################################################################
38#
39# Generate StaticInst execute() method signatures.
40#
41# There must be one signature for each CPU model compiled in.
42# Since the set of compiled-in models is flexible, we generate a
43# header containing the appropriate set of signatures on the fly.
44#
45#################################################################
46
47# CPU model-specific data is contained in cpu_models.py
48# Convert to SCons File node to get path handling
49models_db = File('cpu_models.py')
50# slurp in contents of file
51execfile(models_db.srcnode().abspath)
52
53# Template for execute() signature.
54exec_sig_template = '''
55virtual Fault execute(%s *xc, Trace::InstRecord *traceData) const = 0;
56virtual Fault initiateAcc(%s *xc, Trace::InstRecord *traceData) const
57{ panic("initiateAcc not defined!"); };
58virtual Fault completeAcc(Packet *pkt, %s *xc,
59                          Trace::InstRecord *traceData) const
60{ panic("completeAcc not defined!"); };
61'''
62
63mem_ini_sig_template = '''
64virtual Fault initiateAcc(%s *xc, Trace::InstRecord *traceData) const { panic("Not defined!"); };
65'''
66
67mem_comp_sig_template = '''
68virtual Fault completeAcc(uint8_t *data, %s *xc, Trace::InstRecord *traceData) const { panic("Not defined!"); return NoFault; };
69'''
70
71# Generate header.  
72def gen_cpu_exec_signatures(target, source, env):
73    f = open(str(target[0]), 'w')
74    print >> f, '''
75#ifndef __CPU_STATIC_INST_EXEC_SIGS_HH__
76#define __CPU_STATIC_INST_EXEC_SIGS_HH__
77'''
78    for cpu in env['CPU_MODELS']:
79        xc_type = CpuModel.dict[cpu].strings['CPU_exec_context']
80        print >> f, exec_sig_template % (xc_type, xc_type, xc_type)
81    print >> f, '''
82#endif  // __CPU_STATIC_INST_EXEC_SIGS_HH__
83'''
84
85# Generate string that gets printed when header is rebuilt
86def gen_sigs_string(target, source, env):
87    return "Generating static_inst_exec_sigs.hh: " \
88           + ', '.join(env['CPU_MODELS'])
89
90# Add command to generate header to environment.
91env.Command('static_inst_exec_sigs.hh', models_db,
92            Action(gen_cpu_exec_signatures, gen_sigs_string,
93                   varlist = ['CPU_MODELS']))
94
95# List of suppported CPUs by the Checker.  Errors out if USE_CHECKER=True
96# and one of these are not being used.
97CheckerSupportedCPUList = ['AlphaO3CPU', 'OzoneCPU']
98
99#################################################################
100#
101# Include CPU-model-specific files based on set of models
102# specified in CPU_MODELS build option.
103#
104#################################################################
105
106sources = []
107
108need_simple_base = False
109if 'AtomicSimpleCPU' in env['CPU_MODELS']:
110    need_simple_base = True
111    sources += Split('simple/atomic.cc')
112
113if 'TimingSimpleCPU' in env['CPU_MODELS']:
114    need_simple_base = True
115    sources += Split('simple/timing.cc')
116
117if need_simple_base:
118    sources += Split('simple/base.cc')
119
120if 'FastCPU' in env['CPU_MODELS']:
121    sources += Split('fast/cpu.cc')
122
123if 'AlphaO3CPU' in env['CPU_MODELS']:
124    sources += Split('''
125        base_dyn_inst.cc
126        o3/2bit_local_pred.cc
127        o3/alpha_dyn_inst.cc
128        o3/alpha_cpu.cc
129        o3/alpha_cpu_builder.cc
130        o3/bpred_unit.cc
131        o3/btb.cc
132        o3/commit.cc
133        o3/decode.cc
134        o3/fetch.cc
135        o3/free_list.cc
136        o3/fu_pool.cc
137        o3/cpu.cc
138        o3/iew.cc
139        o3/inst_queue.cc
140        o3/lsq_unit.cc
141        o3/lsq.cc
142        o3/mem_dep_unit.cc
143        o3/ras.cc
144        o3/rename.cc
145        o3/rename_map.cc
146        o3/rob.cc
147        o3/scoreboard.cc
148        o3/store_set.cc
149        o3/tournament_pred.cc
150        ''')
151    if 'CheckerCPU' in env['CPU_MODELS']:
152        sources += Split('checker/o3_builder.cc')
153
154if 'OzoneSimpleCPU' in env['CPU_MODELS']:
155    sources += Split('''
156        ozone/cpu.cc
157        ozone/cpu_builder.cc
158        ozone/dyn_inst.cc
159        ozone/front_end.cc
160        ozone/inorder_back_end.cc
161        ozone/inst_queue.cc
162        ozone/rename_table.cc
163        ''')
164    if 'CheckerCPU' in env['CPU_MODELS']:
165        sources += Split('checker/ozone_builder.cc')
166
167if 'OzoneCPU' in env['CPU_MODELS']:
168    sources += Split('''
169        ozone/lsq_unit.cc
170        ozone/lw_back_end.cc
171        ozone/lw_lsq.cc
172        ''')
173
174if 'CheckerCPU' in env['CPU_MODELS']:
175    sources += Split('checker/cpu.cc')
176    checker_supports = False
177    for i in CheckerSupportedCPUList:
178        if i in env['CPU_MODELS']:
179            checker_supports = True
180    if not checker_supports:
181        print "Checker only supports CPU models %s, please " \
182              "set USE_CHECKER=False or use one of those CPU models" \
183              % CheckerSupportedCPUList
184        Exit(1)
185
186
187# FullCPU sources are included from m5/SConscript since they're not
188# below this point in the file hierarchy.
189
190# Convert file names to SCons File objects.  This takes care of the
191# path relative to the top of the directory tree.
192sources = [File(s) for s in sources]
193
194Return('sources')
195
196