SConscript (2874:5389a28b80fb) SConscript (2921:e6bb350c3fa5)
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 a temporary CPU list, including the CheckerCPU if
72# it's enabled. This isn't used for anything else other than StaticInst
73# headers.
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 a temporary CPU list, including the CheckerCPU if
72# it's enabled. This isn't used for anything else other than StaticInst
73# headers.
74temp_cpu_list = env['CPU_MODELS']
74temp_cpu_list = env['CPU_MODELS'][:]
75
75if env['USE_CHECKER']:
76 temp_cpu_list.append('CheckerCPU')
77
78# Generate header.
79def gen_cpu_exec_signatures(target, source, env):
80 f = open(str(target[0]), 'w')
81 print >> f, '''
82#ifndef __CPU_STATIC_INST_EXEC_SIGS_HH__
83#define __CPU_STATIC_INST_EXEC_SIGS_HH__
84'''
85 for cpu in temp_cpu_list:
86 xc_type = CpuModel.dict[cpu].strings['CPU_exec_context']
87 print >> f, exec_sig_template % (xc_type, xc_type, xc_type)
88 print >> f, '''
89#endif // __CPU_STATIC_INST_EXEC_SIGS_HH__
90'''
91
92# Generate string that gets printed when header is rebuilt
93def gen_sigs_string(target, source, env):
94 return "Generating static_inst_exec_sigs.hh: " \
95 + ', '.join(temp_cpu_list)
96
97# Add command to generate header to environment.
98env.Command('static_inst_exec_sigs.hh', models_db,
99 Action(gen_cpu_exec_signatures, gen_sigs_string,
100 varlist = temp_cpu_list))
101
102env.Depends('static_inst_exec_sigs.hh', Value(env['USE_CHECKER']))
103env.Depends('static_inst_exec_sigs.hh', Value(env['CPU_MODELS']))
104
105# List of suppported CPUs by the Checker. Errors out if USE_CHECKER=True
106# and one of these are not being used.
107CheckerSupportedCPUList = ['O3CPU', 'OzoneCPU']
108
109#################################################################
110#
111# Include CPU-model-specific files based on set of models
112# specified in CPU_MODELS build option.
113#
114#################################################################
115
116sources = []
117
118need_simple_base = False
119if 'AtomicSimpleCPU' in env['CPU_MODELS']:
120 need_simple_base = True
121 sources += Split('simple/atomic.cc')
122
123if 'TimingSimpleCPU' in env['CPU_MODELS']:
124 need_simple_base = True
125 sources += Split('simple/timing.cc')
126
127if need_simple_base:
128 sources += Split('simple/base.cc')
129
130if 'FastCPU' in env['CPU_MODELS']:
131 sources += Split('fast/cpu.cc')
132
133need_bp_unit = False
134if 'O3CPU' in env['CPU_MODELS']:
135 need_bp_unit = True
136 sources += SConscript('o3/SConscript', exports = 'env')
137 sources += Split('''
138 o3/base_dyn_inst.cc
139 o3/bpred_unit.cc
140 o3/commit.cc
141 o3/decode.cc
142 o3/fetch.cc
143 o3/free_list.cc
144 o3/fu_pool.cc
145 o3/cpu.cc
146 o3/iew.cc
147 o3/inst_queue.cc
148 o3/lsq_unit.cc
149 o3/lsq.cc
150 o3/mem_dep_unit.cc
151 o3/rename.cc
152 o3/rename_map.cc
153 o3/rob.cc
154 o3/scoreboard.cc
155 o3/store_set.cc
156 ''')
157 if env['USE_CHECKER']:
158 sources += Split('o3/checker_builder.cc')
159
160if 'OzoneCPU' in env['CPU_MODELS']:
161 need_bp_unit = True
162 sources += Split('''
163 ozone/base_dyn_inst.cc
164 ozone/bpred_unit.cc
165 ozone/cpu.cc
166 ozone/cpu_builder.cc
167 ozone/dyn_inst.cc
168 ozone/front_end.cc
169 ozone/lw_back_end.cc
170 ozone/lw_lsq.cc
171 ozone/rename_table.cc
172 ''')
173 if env['USE_CHECKER']:
174 sources += Split('ozone/checker_builder.cc')
175
176if need_bp_unit:
177 sources += Split('''
178 o3/2bit_local_pred.cc
179 o3/btb.cc
180 o3/ras.cc
181 o3/tournament_pred.cc
182 ''')
183
184if env['USE_CHECKER']:
185 sources += Split('checker/cpu.cc')
186 checker_supports = False
187 for i in CheckerSupportedCPUList:
188 if i in env['CPU_MODELS']:
189 checker_supports = True
190 if not checker_supports:
191 print "Checker only supports CPU models",
192 for i in CheckerSupportedCPUList:
193 print i,
194 print ", please set USE_CHECKER=False or use one of those CPU models"
195 Exit(1)
196
197
198# FullCPU sources are included from src/SConscript since they're not
199# below this point in the file hierarchy.
200
201# Convert file names to SCons File objects. This takes care of the
202# path relative to the top of the directory tree.
203sources = [File(s) for s in sources]
204
205Return('sources')
206
76if env['USE_CHECKER']:
77 temp_cpu_list.append('CheckerCPU')
78
79# Generate header.
80def gen_cpu_exec_signatures(target, source, env):
81 f = open(str(target[0]), 'w')
82 print >> f, '''
83#ifndef __CPU_STATIC_INST_EXEC_SIGS_HH__
84#define __CPU_STATIC_INST_EXEC_SIGS_HH__
85'''
86 for cpu in temp_cpu_list:
87 xc_type = CpuModel.dict[cpu].strings['CPU_exec_context']
88 print >> f, exec_sig_template % (xc_type, xc_type, xc_type)
89 print >> f, '''
90#endif // __CPU_STATIC_INST_EXEC_SIGS_HH__
91'''
92
93# Generate string that gets printed when header is rebuilt
94def gen_sigs_string(target, source, env):
95 return "Generating static_inst_exec_sigs.hh: " \
96 + ', '.join(temp_cpu_list)
97
98# Add command to generate header to environment.
99env.Command('static_inst_exec_sigs.hh', models_db,
100 Action(gen_cpu_exec_signatures, gen_sigs_string,
101 varlist = temp_cpu_list))
102
103env.Depends('static_inst_exec_sigs.hh', Value(env['USE_CHECKER']))
104env.Depends('static_inst_exec_sigs.hh', Value(env['CPU_MODELS']))
105
106# List of suppported CPUs by the Checker. Errors out if USE_CHECKER=True
107# and one of these are not being used.
108CheckerSupportedCPUList = ['O3CPU', 'OzoneCPU']
109
110#################################################################
111#
112# Include CPU-model-specific files based on set of models
113# specified in CPU_MODELS build option.
114#
115#################################################################
116
117sources = []
118
119need_simple_base = False
120if 'AtomicSimpleCPU' in env['CPU_MODELS']:
121 need_simple_base = True
122 sources += Split('simple/atomic.cc')
123
124if 'TimingSimpleCPU' in env['CPU_MODELS']:
125 need_simple_base = True
126 sources += Split('simple/timing.cc')
127
128if need_simple_base:
129 sources += Split('simple/base.cc')
130
131if 'FastCPU' in env['CPU_MODELS']:
132 sources += Split('fast/cpu.cc')
133
134need_bp_unit = False
135if 'O3CPU' in env['CPU_MODELS']:
136 need_bp_unit = True
137 sources += SConscript('o3/SConscript', exports = 'env')
138 sources += Split('''
139 o3/base_dyn_inst.cc
140 o3/bpred_unit.cc
141 o3/commit.cc
142 o3/decode.cc
143 o3/fetch.cc
144 o3/free_list.cc
145 o3/fu_pool.cc
146 o3/cpu.cc
147 o3/iew.cc
148 o3/inst_queue.cc
149 o3/lsq_unit.cc
150 o3/lsq.cc
151 o3/mem_dep_unit.cc
152 o3/rename.cc
153 o3/rename_map.cc
154 o3/rob.cc
155 o3/scoreboard.cc
156 o3/store_set.cc
157 ''')
158 if env['USE_CHECKER']:
159 sources += Split('o3/checker_builder.cc')
160
161if 'OzoneCPU' in env['CPU_MODELS']:
162 need_bp_unit = True
163 sources += Split('''
164 ozone/base_dyn_inst.cc
165 ozone/bpred_unit.cc
166 ozone/cpu.cc
167 ozone/cpu_builder.cc
168 ozone/dyn_inst.cc
169 ozone/front_end.cc
170 ozone/lw_back_end.cc
171 ozone/lw_lsq.cc
172 ozone/rename_table.cc
173 ''')
174 if env['USE_CHECKER']:
175 sources += Split('ozone/checker_builder.cc')
176
177if need_bp_unit:
178 sources += Split('''
179 o3/2bit_local_pred.cc
180 o3/btb.cc
181 o3/ras.cc
182 o3/tournament_pred.cc
183 ''')
184
185if env['USE_CHECKER']:
186 sources += Split('checker/cpu.cc')
187 checker_supports = False
188 for i in CheckerSupportedCPUList:
189 if i in env['CPU_MODELS']:
190 checker_supports = True
191 if not checker_supports:
192 print "Checker only supports CPU models",
193 for i in CheckerSupportedCPUList:
194 print i,
195 print ", please set USE_CHECKER=False or use one of those CPU models"
196 Exit(1)
197
198
199# FullCPU sources are included from src/SConscript since they're not
200# below this point in the file hierarchy.
201
202# Convert file names to SCons File objects. This takes care of the
203# path relative to the top of the directory tree.
204sources = [File(s) for s in sources]
205
206Return('sources')
207