src/arch/arm/fastmodel/SConscript - public/gem5 - Git at Google

 # Copyright 2019 Google, Inc.
 #
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are
 # met: redistributions of source code must retain the above copyright
 # notice, this list of conditions and the following disclaimer;
 # redistributions in binary form must reproduce the above copyright
 # notice, this list of conditions and the following disclaimer in the
 # documentation and/or other materials provided with the distribution;
 # neither the name of the copyright holders nor the names of its
 # contributors may be used to endorse or promote products derived from
 # this software without specific prior written permission.
 #
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 #
 # Authors: Gabe Black

 from __future__ import print_function

 Import('*')

 from m5.util.terminal import termcap
 from m5.util.grammar import Grammar

 from gem5_scons import Transform

 import os.path

 if env['USE_ARM_FASTMODEL']:
     if not env['USE_SYSTEMC']:
         print(termcap.Yellow + termcap.Bold +
                 'Warning: ARM Fast Models require systemc support' +
                 termcap.Normal)
         env['USE_ARM_FASTMODEL'] = False
         Return()

 if not env['USE_ARM_FASTMODEL']:
     Return()


 systemc_home = Dir('#/src/systemc/ext/systemc_home')
 env['ENV']['SYSTEMC_HOME'] = systemc_home.abspath

 def extract_var(name):
     if name not in env:
         print(termcap.Red + termcap.Bold +
                 ('Error: %s is not set' % name) +
                 termcap.Normal)
         Exit(1)
     print('%s = %s' % (name, env[name]))
     # Make sure the value of this variable shows up as an environment variable
     # for commands scons runs.
     env['ENV'][name] = env[name]
     return env[name]

 pvlib_home, maxcore_home, armlmd_license_file = \
     list(map(extract_var, ('PVLIB_HOME', 'MAXCORE_HOME',
                            'ARMLMD_LICENSE_FILE')))

 pvlib_home = Dir(pvlib_home)
 maxcore_home = Dir(maxcore_home)
 armlmd_license_file = File(armlmd_license_file)


 pvlib_flavor = env['PVLIB_FLAVOR']
 pvlib_lib_dir = pvlib_home.Dir('lib').Dir(pvlib_flavor)

 simulation_engine_name = 'libMAXCOREInitSimulationEngine.3.so'
 simulation_engine_lib = pvlib_lib_dir.File(simulation_engine_name)


 def staticify(env, name):
     ''' Check for a static version of the library named 'name', and if it
         exists return a File node for it explicitly. Otherwise pass 'name'
         through for normal processing.'''

     static_name = env.subst('${LIBPREFIX}' + name + '${LIBSUFFIX}')

     for path in env.Flatten(env['LIBPATH']):
         full_name = Dir(path).File(static_name).get_abspath()
         if os.path.isfile(full_name):
             return File(full_name)

     return name


 # Adjust the build environment to support building in Fast Models.

 env.Append(CCFLAGS='-pthread')

 cpppaths = (
     pvlib_home.Dir('include/fmruntime'),
     pvlib_home.Dir('include/fmruntime/eslapi'),
     pvlib_home.Dir('Iris/include'),

     systemc_home.Dir('include'),

     maxcore_home.Dir('AMBA-PV/include'),
 )
 env.Append(CPPPATH=cpppaths)

 lib_paths = (
     pvlib_lib_dir,
     pvlib_home.Dir('Iris').Dir(pvlib_flavor),
 )
 env.Append(LIBPATH=lib_paths)
 env.Append(RPATH=lib_paths)

 libs = (
     'components',
     'pvbus',
     'armctmodel',
     'fmruntime',
     'IrisSupport',
     'dl',
     'rt',
 )
 env.Append(LIBS=list(staticify(env, lib) for lib in libs))


 class ProjectFileParser(Grammar):
     class Param(object):
         def __init__(self, is_object):
             self.is_object = is_object

         def __str__(self):
             return self._to_str(0)

     class StringParam(Param):
         def __init__(self, name, value):
             super(ProjectFileParser.StringParam, self).__init__(
                     is_object=False)
             self.name = name
             self.value = value

         def _to_str(self, indent):
             indent_str = "    " * indent
             return indent_str + self.name + ' = \"' + self.value + '\"'

     class ObjectParam(Param):
         def __init__(self, type_name, name, params):
             super(ProjectFileParser.ObjectParam, self).__init__(
                     is_object=True)
             self.type_name = type_name
             self.name = name
             self.params = params

         def _to_str(self, indent):
             indent_str = "    " * indent
             val = indent_str + self.type_name
             if self.name is not None:
                 val += ' "' + self.name + '"'
             val += "\n" + indent_str + "{\n"
             for param in self.params:
                 val += param._to_str(indent + 1) + "\n"
             val += indent_str + "}"
             return val

     #########
     # Lexer #
     #########

     tokens = (
         # identifier
         'ID',

         # string literal
         'STRLIT',

         # = { } ;
         'EQUALS',
         'LBRACE',
         'RBRACE',
         'SEMI',
     )

     t_ID = r'[A-Za-z_]\w*'

     def t_STRLIT(self, t):
         r'(?m)"([^"])*"'
         # strip off quotes
         t.value = t.value[1:-1]
         t.lexer.lineno += t.value.count('\n')
         return t

     t_EQUALS = r'='
     t_LBRACE = r'\{'
     t_RBRACE = r'\}'
     t_SEMI = r';'

     def t_NEWLINE(self, t):
         r'\n+'
         t.lexer.lineno += t.value.count('\n')

     t_ignore = ' \t\x0c'

     ##########
     # Parser #
     ##########

     def p_object(self, t):
         'object : object_heading LBRACE params RBRACE'
         t[0] = self.ObjectParam(t[1][0], t[1][1], t[3])

     def p_object_heading_0(self, t):
         'object_heading : ID STRLIT'
         t[0] = (t[1], t[2])

     def p_object_heading_1(self, t):
         'object_heading : ID'
         t[0] = (t[1], None)

     def p_params_0(self, t):
         'params : '
         t[0] = []

     def p_params_1(self, t):
         'params : param params'
         t[0] = [t[1]] + t[2]

     def p_param_0(self, t):
         'param : ID EQUALS STRLIT SEMI'
         t[0] = self.StringParam(t[1], t[3])

     def p_param_1(self, t):
         'param : object'
         t[0] = t[1]


 class ArmFastModelComponent(object):
     def __init__(self, project_file, *extra_deps):
         project_file = File(project_file)
         project_file_dir = project_file.Dir('.')

         parser = ProjectFileParser()
         proj = parser.parse_file(project_file.srcnode().abspath)

         # Top level component.
         tlc = None
         # Config name.
         config_name = None

         # Scan for particular properties of the project.
         for param in proj.params:
             if not param.is_object:
                 if param.name == 'TOP_LEVEL_COMPONENT':
                     tlc = param.value
                 elif param.name == 'ACTIVE_CONFIG_LINUX':
                     config_name = param.value

         assert tlc is not None and config_name is not None

         simgen_dir = project_file_dir.Dir(config_name)

         def simgen_static(name):
             return simgen_dir.File(env.subst(
                         '${LIBPREFIX}%s${LIBSUFFIX}' % name))

         def simgen_shared(name):
             return simgen_dir.File(env.subst(
                         '${SHLIBPREFIX}%s${SHLIBSUFFIX}' % name))

         static_libs = [
             'scx-%s-%s' % (tlc, config_name),
             'scx',
         ]
         shared_libs = [
             '%s-%s' % (tlc, config_name),
         ]

         static_lib_nodes = map(simgen_static, static_libs)
         shared_lib_nodes = map(simgen_shared, shared_libs)
         # We need to use the static libraries as files so that the linker
         # doesn't use the shared versions of them instead. We need to use
         # the shared libraries by name so that the linker will apply RPATH
         # and be able to find them at run time. If a shared libary includes
         # a path, the dynamic linker will apparently ignore RPATH when looking
         # for it.
         lib_nodes = static_lib_nodes + shared_lib_nodes

         gen_dir = simgen_dir.Dir('gen')

         header = gen_dir.File('scx_evs_%s.h' % tlc)

         self.headers = [header]
         self.headerpaths = [gen_dir]
         self.libs = static_lib_nodes + shared_libs
         self.libpaths = [simgen_dir]
         self.rpaths = [simgen_dir]

         simgen_cmd = env.subst('${SIMGEN} -p %s --configuration %s -b ' +
             '--verbose off --num-build-cpus 100 --build-dir %s') % \
             (project_file.srcnode().abspath, config_name, simgen_dir.abspath)
         if not GetOption('verbose'):
             simgen_cmd += ' > /dev/null'
         simgen_action = MakeAction(simgen_cmd, Transform('SIMGEN'))
         sources = [project_file]
         sources.extend(extra_deps)
         env.Command(lib_nodes + self.headers, sources, simgen_action)

     def prepare_env(self, env):
         env.Append(LIBPATH=self.libpaths)
         env.AddLocalRPATH(*self.rpaths)
         env.Append(CPPPATH=self.headerpaths)
         env.Prepend(LIBS=self.libs)


 class ArmFastModelBin(Executable):
     def __init__(self, target, *components_and_sources):
         def is_component(x):
             return isinstance(x, ArmFastModelComponent)

         def not_component(x):
             return not is_component(x)

         components = list(filter(is_component, components_and_sources))
         sources = list(filter(not_component, components_and_sources))

         self.components = components
         super(ArmFastModelBin, self).__init__(target, *sources)

     @classmethod
     def declare_all(cls, env):
         env = env.Clone()
         env.Prepend(LIBS=env['STATIC_LIB'][0])
         super(ArmFastModelBin, cls).declare_all(env)

     def declare(self, env):
         env = env.Clone()

         sources = list(self.sources)
         for f in self.filters:
             sources += Source.all.apply_filter(f)

         objs = self.srcs_to_objs(env, sources)
         objs = objs + env['MAIN_OBJS']

         for component in self.components:
             component.prepare_env(env)

         binary = super(ArmFastModelBin, self).declare(env, objs)[0]

         # We need a copy of the simulation engine lib alongside the executable
         # so that the license check works properly.
         local_engine = binary.File(simulation_engine_name)
         Depends(binary, local_engine)
         main.Command(local_engine, simulation_engine_lib,
                 MakeAction("cp ${SOURCE} ${TARGET}", Transform('COPY')))

 Export('ArmFastModelComponent')
 Export('ArmFastModelBin')

 PySource('m5', 'arm_fast_model.py')
 Source('fastmodel.cc')

 SimObject('FastModel.py')
 Source('amba_to_tlm_bridge.cc')
 Source('amba_from_tlm_bridge.cc')

 # HACK: Make sure the gic protocol headers are somewhere we can find them.
 # These should start out alongside other headers fast model provides which we
 # are already able to include, but unfortunately they're in the examples
 # directory.
 gicv3_comms_headers = (
         'gicv3_comms_base.h', 'gicv3_comms_if.h', 'gicv3_comms_sockets.h')
 examples_common_dir = pvlib_home.Dir('examples/SystemCExport/Common')
 gic_protocol_path = 'Protocols/GICv3Comms'
 gic_protocol_dest = Dir(env['BUILDDIR']).Dir(gic_protocol_path)
 gic_protocol_src = examples_common_dir.Dir(gic_protocol_path)

 for header in gicv3_comms_headers:
     Command(gic_protocol_dest.File(header), gic_protocol_src.File(header),
             Copy('${TARGET}', '${SOURCE}'))

 lisa_protocol_types_header_path = 'include/lisa_protocol_types.h'
 lisa_protocol_types_header_target = \
     gic_protocol_dest.File(lisa_protocol_types_header_path)
 lisa_protocol_types_header_src = \
     examples_common_dir.File(lisa_protocol_types_header_path)
 Command(lisa_protocol_types_header_target, lisa_protocol_types_header_src,
         Copy('${TARGET}', '${SOURCE}'))
	# Copyright 2019 Google, Inc.
	#
	# Redistribution and use in source and binary forms, with or without
	# modification, are permitted provided that the following conditions are
	# met: redistributions of source code must retain the above copyright
	# notice, this list of conditions and the following disclaimer;
	# redistributions in binary form must reproduce the above copyright
	# notice, this list of conditions and the following disclaimer in the
	# documentation and/or other materials provided with the distribution;
	# neither the name of the copyright holders nor the names of its
	# contributors may be used to endorse or promote products derived from
	# this software without specific prior written permission.
	#
	# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
	# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
	# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	#
	# Authors: Gabe Black

	from __future__ import print_function

	Import('*')

	from m5.util.terminal import termcap
	from m5.util.grammar import Grammar

	from gem5_scons import Transform

	import os.path

	if env['USE_ARM_FASTMODEL']:
	if not env['USE_SYSTEMC']:
	print(termcap.Yellow + termcap.Bold +
	'Warning: ARM Fast Models require systemc support' +
	termcap.Normal)
	env['USE_ARM_FASTMODEL'] = False
	Return()

	if not env['USE_ARM_FASTMODEL']:
	Return()


	systemc_home = Dir('#/src/systemc/ext/systemc_home')
	env['ENV']['SYSTEMC_HOME'] = systemc_home.abspath

	def extract_var(name):
	if name not in env:
	print(termcap.Red + termcap.Bold +
	('Error: %s is not set' % name) +
	termcap.Normal)
	Exit(1)
	print('%s = %s' % (name, env[name]))
	# Make sure the value of this variable shows up as an environment variable
	# for commands scons runs.
	env['ENV'][name] = env[name]
	return env[name]

	pvlib_home, maxcore_home, armlmd_license_file = \
	list(map(extract_var, ('PVLIB_HOME', 'MAXCORE_HOME',
	'ARMLMD_LICENSE_FILE')))

	pvlib_home = Dir(pvlib_home)
	maxcore_home = Dir(maxcore_home)
	armlmd_license_file = File(armlmd_license_file)


	pvlib_flavor = env['PVLIB_FLAVOR']
	pvlib_lib_dir = pvlib_home.Dir('lib').Dir(pvlib_flavor)

	simulation_engine_name = 'libMAXCOREInitSimulationEngine.3.so'
	simulation_engine_lib = pvlib_lib_dir.File(simulation_engine_name)


	def staticify(env, name):
	''' Check for a static version of the library named 'name', and if it
	exists return a File node for it explicitly. Otherwise pass 'name'
	through for normal processing.'''

	static_name = env.subst('${LIBPREFIX}' + name + '${LIBSUFFIX}')

	for path in env.Flatten(env['LIBPATH']):
	full_name = Dir(path).File(static_name).get_abspath()
	if os.path.isfile(full_name):
	return File(full_name)

	return name


	# Adjust the build environment to support building in Fast Models.

	env.Append(CCFLAGS='-pthread')

	cpppaths = (
	pvlib_home.Dir('include/fmruntime'),
	pvlib_home.Dir('include/fmruntime/eslapi'),
	pvlib_home.Dir('Iris/include'),

	systemc_home.Dir('include'),

	maxcore_home.Dir('AMBA-PV/include'),
	)
	env.Append(CPPPATH=cpppaths)

	lib_paths = (
	pvlib_lib_dir,
	pvlib_home.Dir('Iris').Dir(pvlib_flavor),
	)
	env.Append(LIBPATH=lib_paths)
	env.Append(RPATH=lib_paths)

	libs = (
	'components',
	'pvbus',
	'armctmodel',
	'fmruntime',
	'IrisSupport',
	'dl',
	'rt',
	)
	env.Append(LIBS=list(staticify(env, lib) for lib in libs))


	class ProjectFileParser(Grammar):
	class Param(object):
	def __init__(self, is_object):
	self.is_object = is_object

	def __str__(self):
	return self._to_str(0)

	class StringParam(Param):
	def __init__(self, name, value):
	super(ProjectFileParser.StringParam, self).__init__(
	is_object=False)
	self.name = name
	self.value = value

	def _to_str(self, indent):
	indent_str = " " * indent
	return indent_str + self.name + ' = \"' + self.value + '\"'

	class ObjectParam(Param):
	def __init__(self, type_name, name, params):
	super(ProjectFileParser.ObjectParam, self).__init__(
	is_object=True)
	self.type_name = type_name
	self.name = name
	self.params = params

	def _to_str(self, indent):
	indent_str = " " * indent
	val = indent_str + self.type_name
	if self.name is not None:
	val += ' "' + self.name + '"'
	val += "\n" + indent_str + "{\n"
	for param in self.params:
	val += param._to_str(indent + 1) + "\n"
	val += indent_str + "}"
	return val

	#########
	# Lexer #
	#########

	tokens = (
	# identifier
	'ID',

	# string literal
	'STRLIT',

	# = { } ;
	'EQUALS',
	'LBRACE',
	'RBRACE',
	'SEMI',
	)

	t_ID = r'[A-Za-z_]\w*'

	def t_STRLIT(self, t):
	r'(?m)"([^"])*"'
	# strip off quotes
	t.value = t.value[1:-1]
	t.lexer.lineno += t.value.count('\n')
	return t

	t_EQUALS = r'='
	t_LBRACE = r'\{'
	t_RBRACE = r'\}'
	t_SEMI = r';'

	def t_NEWLINE(self, t):
	r'\n+'
	t.lexer.lineno += t.value.count('\n')

	t_ignore = ' \t\x0c'

	##########
	# Parser #
	##########

	def p_object(self, t):
	'object : object_heading LBRACE params RBRACE'
	t[0] = self.ObjectParam(t[1][0], t[1][1], t[3])

	def p_object_heading_0(self, t):
	'object_heading : ID STRLIT'
	t[0] = (t[1], t[2])

	def p_object_heading_1(self, t):
	'object_heading : ID'
	t[0] = (t[1], None)

	def p_params_0(self, t):
	'params : '
	t[0] = []

	def p_params_1(self, t):
	'params : param params'
	t[0] = [t[1]] + t[2]

	def p_param_0(self, t):
	'param : ID EQUALS STRLIT SEMI'
	t[0] = self.StringParam(t[1], t[3])

	def p_param_1(self, t):
	'param : object'
	t[0] = t[1]


	class ArmFastModelComponent(object):
	def __init__(self, project_file, *extra_deps):
	project_file = File(project_file)
	project_file_dir = project_file.Dir('.')

	parser = ProjectFileParser()
	proj = parser.parse_file(project_file.srcnode().abspath)

	# Top level component.
	tlc = None
	# Config name.
	config_name = None

	# Scan for particular properties of the project.
	for param in proj.params:
	if not param.is_object:
	if param.name == 'TOP_LEVEL_COMPONENT':
	tlc = param.value
	elif param.name == 'ACTIVE_CONFIG_LINUX':
	config_name = param.value

	assert tlc is not None and config_name is not None

	simgen_dir = project_file_dir.Dir(config_name)

	def simgen_static(name):
	return simgen_dir.File(env.subst(
	'${LIBPREFIX}%s${LIBSUFFIX}' % name))

	def simgen_shared(name):
	return simgen_dir.File(env.subst(
	'${SHLIBPREFIX}%s${SHLIBSUFFIX}' % name))

	static_libs = [
	'scx-%s-%s' % (tlc, config_name),
	'scx',
	]
	shared_libs = [
	'%s-%s' % (tlc, config_name),
	]

	static_lib_nodes = map(simgen_static, static_libs)
	shared_lib_nodes = map(simgen_shared, shared_libs)
	# We need to use the static libraries as files so that the linker
	# doesn't use the shared versions of them instead. We need to use
	# the shared libraries by name so that the linker will apply RPATH
	# and be able to find them at run time. If a shared libary includes
	# a path, the dynamic linker will apparently ignore RPATH when looking
	# for it.
	lib_nodes = static_lib_nodes + shared_lib_nodes

	gen_dir = simgen_dir.Dir('gen')

	header = gen_dir.File('scx_evs_%s.h' % tlc)

	self.headers = [header]
	self.headerpaths = [gen_dir]
	self.libs = static_lib_nodes + shared_libs
	self.libpaths = [simgen_dir]
	self.rpaths = [simgen_dir]

	simgen_cmd = env.subst('${SIMGEN} -p %s --configuration %s -b ' +
	'--verbose off --num-build-cpus 100 --build-dir %s') % \
	(project_file.srcnode().abspath, config_name, simgen_dir.abspath)
	if not GetOption('verbose'):
	simgen_cmd += ' > /dev/null'
	simgen_action = MakeAction(simgen_cmd, Transform('SIMGEN'))
	sources = [project_file]
	sources.extend(extra_deps)
	env.Command(lib_nodes + self.headers, sources, simgen_action)

	def prepare_env(self, env):
	env.Append(LIBPATH=self.libpaths)
	env.AddLocalRPATH(*self.rpaths)
	env.Append(CPPPATH=self.headerpaths)
	env.Prepend(LIBS=self.libs)


	class ArmFastModelBin(Executable):
	def __init__(self, target, *components_and_sources):
	def is_component(x):
	return isinstance(x, ArmFastModelComponent)

	def not_component(x):
	return not is_component(x)

	components = list(filter(is_component, components_and_sources))
	sources = list(filter(not_component, components_and_sources))

	self.components = components
	super(ArmFastModelBin, self).__init__(target, *sources)

	@classmethod
	def declare_all(cls, env):
	env = env.Clone()
	env.Prepend(LIBS=env['STATIC_LIB'][0])
	super(ArmFastModelBin, cls).declare_all(env)

	def declare(self, env):
	env = env.Clone()

	sources = list(self.sources)
	for f in self.filters:
	sources += Source.all.apply_filter(f)

	objs = self.srcs_to_objs(env, sources)
	objs = objs + env['MAIN_OBJS']

	for component in self.components:
	component.prepare_env(env)

	binary = super(ArmFastModelBin, self).declare(env, objs)[0]

	# We need a copy of the simulation engine lib alongside the executable
	# so that the license check works properly.
	local_engine = binary.File(simulation_engine_name)
	Depends(binary, local_engine)
	main.Command(local_engine, simulation_engine_lib,
	MakeAction("cp ${SOURCE} ${TARGET}", Transform('COPY')))

	Export('ArmFastModelComponent')
	Export('ArmFastModelBin')

	PySource('m5', 'arm_fast_model.py')
	Source('fastmodel.cc')

	SimObject('FastModel.py')
	Source('amba_to_tlm_bridge.cc')
	Source('amba_from_tlm_bridge.cc')

	# HACK: Make sure the gic protocol headers are somewhere we can find them.
	# These should start out alongside other headers fast model provides which we
	# are already able to include, but unfortunately they're in the examples
	# directory.
	gicv3_comms_headers = (
	'gicv3_comms_base.h', 'gicv3_comms_if.h', 'gicv3_comms_sockets.h')
	examples_common_dir = pvlib_home.Dir('examples/SystemCExport/Common')
	gic_protocol_path = 'Protocols/GICv3Comms'
	gic_protocol_dest = Dir(env['BUILDDIR']).Dir(gic_protocol_path)
	gic_protocol_src = examples_common_dir.Dir(gic_protocol_path)

	for header in gicv3_comms_headers:
	Command(gic_protocol_dest.File(header), gic_protocol_src.File(header),
	Copy('${TARGET}', '${SOURCE}'))

	lisa_protocol_types_header_path = 'include/lisa_protocol_types.h'
	lisa_protocol_types_header_target = \
	gic_protocol_dest.File(lisa_protocol_types_header_path)
	lisa_protocol_types_header_src = \
	examples_common_dir.File(lisa_protocol_types_header_path)
	Command(lisa_protocol_types_header_target, lisa_protocol_types_header_src,
	Copy('${TARGET}', '${SOURCE}'))