3 # Copyright (c) 2006 The Regents of The University of Michigan
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.
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.
29 # Authors: Steve Reinhardt
37 #################################################################
39 # ISA "switch header" generation.
41 # Auto-generate arch headers that include the right ISA-specific
42 # header based on the setting of THE_ISA preprocessor variable.
44 #################################################################
67 env.subst('${TARGET_ISA}'))
76 env.subst('${TARGET_GPU_ISA}'))
78 #################################################################
80 # Include architecture-specific files.
82 #################################################################
85 # Build a SCons scanner for ISA files
89 isa_scanner = SCons.Scanner.Classic("ISAScan",
92 r'^\s*##include\s+"([\w/.-]*)"')
94 env.Append(SCANNERS = isa_scanner)
97 # Now create a Builder object that uses isa_parser.py to generate C++
98 # output from the ISA description (*.isa) files.
101 isa_parser = File('isa_parser.py')
103 # The emitter patches up the sources & targets to include the
104 # autogenerated files as targets and isa parser itself as a source.
105 def isa_desc_emitter(target, source, env):
106 # List the isa parser as a source.
109 Value("ExecContext"),
112 # Specify different targets depending on if we're running the ISA
113 # parser for its dependency information, or for the generated files.
114 # (As an optimization, the ISA parser detects the useless second run
115 # and skips doing any work, if the first run was performed, since it
116 # always generates all its files). The way we track this in SCons is the
117 # <arch>_isa_outputs value in the environment (env). If it's unset, we
118 # don't know what the dependencies are so we ask for generated/inc.d to
119 # be generated so they can be acquired. If we know what they are, then
120 # it's because we've already processed inc.d and then claim that our
121 # outputs (targets) will be thus.
122 isa = env['TARGET_ISA']
123 key = '%s_isa_outputs' % isa
125 targets = [ os.path.join('generated', f) for f in env[key] ]
127 targets = [ os.path.join('generated','inc.d') ]
130 return os.path.join(target[0].dir.up().abspath, s)
132 return [ prefix(t) for t in targets ], source
136 # import ply here because SCons screws with sys.path when performing actions.
139 def isa_desc_action_func(target, source, env):
140 # Add the current directory to the system path so we can import files
141 sys.path[0:0] = [ ARCH_DIR.srcnode().abspath ]
144 # Skip over the ISA description itself and the parser to the CPU models.
145 models = [ s.get_contents() for s in source[2:] ]
146 parser = isa_parser.ISAParser(target[0].dir.abspath)
147 parser.parse_isa_desc(source[0].abspath)
148 isa_desc_action = MakeAction(isa_desc_action_func, Transform("ISA DESC", 1))
150 # Also include the CheckerCPU as one of the models if it is being
151 # enabled via command line.
152 isa_desc_builder = Builder(action=isa_desc_action, emitter=isa_desc_emitter)
154 env.Append(BUILDERS = { 'ISADesc' : isa_desc_builder })
156 # The ISA is generated twice: the first time to find out what it generates,
157 # and the second time to make scons happy by telling the ISADesc builder
158 # what it will make before it builds it.
159 def scan_isa_deps(target, source, env):
160 # Process dependency file generated by the ISA parser --
161 # add the listed files to the dependency tree of the build.
163 archbase = source.dir.up().path
166 depfile = open(source.abspath, 'r')
168 print "scan_isa_deps: Can't open ISA deps file '%s' in %s" % \
169 (source.path,os.getcwd())
172 # Scan through the lines
175 # Read the dependency line with the format
176 # <target file>: [ <dependent file>* ]
177 m = re.match(r'^\s*([^:]+\.([^\.:]+))\s*:\s*(.*)', line)
179 targ, extn = m.group(1,2)
180 deps = m.group(3).split()
182 files = [ targ ] + deps
185 # Eliminate unnecessary re-generation if we already generated it
186 env.Precious(os.path.join(archbase, 'generated', f))
188 files = [ os.path.join(archbase, 'generated', f) for f in files ]
191 Source(os.path.join(archbase,'generated', targ))
193 env[env['TARGET_ISA'] + '_isa_outputs'] = targets.keys()
195 isa = env.ISADesc(os.path.join(archbase,'isa','main.isa'))
197 env.Depends('#all-isas', isa)
199 env.Append(BUILDERS = {'ScanISA' :
200 Builder(action=MakeAction(scan_isa_deps,
201 Transform("NEW DEPS", 1)))})
204 DebugFlag('FloatRegs')
206 DebugFlag('MiscRegs')
207 CompoundFlag('Registers', [ 'IntRegs', 'FloatRegs', 'CCRegs', 'MiscRegs' ])