build_tools/cxx_config_cc.py - public/gem5 - Git at Google

 # Copyright 2004-2006 The Regents of The University of Michigan
 # Copyright 2010-20013 Advanced Micro Devices, Inc.
 # Copyright 2013 Mark D. Hill and David A. Wood
 # Copyright 2017-2020 ARM Limited
 # Copyright 2021 Google, Inc.
 #
 # The license below extends only to copyright in the software and shall
 # not be construed as granting a license to any other intellectual
 # property including but not limited to intellectual property relating
 # to a hardware implementation of the functionality of the software
 # licensed hereunder.  You may use the software subject to the license
 # terms below provided that you ensure that this notice is replicated
 # unmodified and in its entirety in all distributions of the software,
 # modified or unmodified, in source code or in binary form.
 #
 # 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.

 import argparse
 import importlib
 import os.path
 import sys

 import importer

 from code_formatter import code_formatter

 parser = argparse.ArgumentParser()
 parser.add_argument("modpath", help="module the simobject belongs to")
 parser.add_argument("cxx_config_cc", help="cxx config cc file to generate")

 args = parser.parse_args()

 basename = os.path.basename(args.cxx_config_cc)
 sim_object_name = os.path.splitext(basename)[0]

 importer.install()
 module = importlib.import_module(args.modpath)
 sim_object = getattr(module, sim_object_name)

 from m5.params import isSimObjectClass
 import m5.params

 code = code_formatter()

 entry_class = "CxxConfigDirectoryEntry_%s" % sim_object_name
 param_class = "%sCxxConfigParams" % sim_object_name


 def cxx_bool(b):
     return "true" if b else "false"


 code('#include "params/%s.hh"' % sim_object_name)

 for param in sim_object._params.values():
     if isSimObjectClass(param.ptype):
         code('#include "%s"' % param.ptype._value_dict["cxx_header"])
         code('#include "params/%s.hh"' % param.ptype.__name__)
     else:
         param.ptype.cxx_ini_predecls(code)

 code(
     """#include "${{sim_object._value_dict['cxx_header']}}"
 #include "base/str.hh"
 #include "cxx_config/${sim_object_name}.hh"

 namespace gem5
 {

 ${param_class}::DirectoryEntry::DirectoryEntry()
 {
 """
 )
 code.indent()
 for param in sim_object._params.values():
     is_vector = isinstance(param, m5.params.VectorParamDesc)
     is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

     code(
         'parameters["%s"] = new ParamDesc("%s", %s, %s);'
         % (param.name, param.name, cxx_bool(is_vector), cxx_bool(is_simobj))
     )

 for port in sim_object._ports.values():
     is_vector = isinstance(port, m5.params.VectorPort)
     is_requestor = port.role == "GEM5 REQUESTOR"

     code(
         'ports["%s"] = new PortDesc("%s", %s, %s);'
         % (port.name, port.name, cxx_bool(is_vector), cxx_bool(is_requestor))
     )

 code.dedent()

 code(
     """}

 bool
 ${param_class}::setSimObject(const std::string &name, SimObject *simObject)
 {
     bool ret = true;
     if (false) {
 """
 )

 code.indent()
 for param in sim_object._params.values():
     is_vector = isinstance(param, m5.params.VectorParamDesc)
     is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

     if is_simobj and not is_vector:
         code('} else if (name == "${{param.name}}") {')
         code.indent()
         code(
             "this->${{param.name}} = "
             "dynamic_cast<${{param.ptype.cxx_type}}>(simObject);"
         )
         code("if (simObject && !this->${{param.name}})")
         code("   ret = false;")
         code.dedent()
 code.dedent()

 code(
     """
     } else {
         ret = false;
     }

     return ret;
 }

 bool
 ${param_class}::setSimObjectVector(const std::string &name,
     const std::vector<SimObject *> &simObjects)
 {
     bool ret = true;

     if (false) {
 """
 )

 code.indent()
 for param in sim_object._params.values():
     is_vector = isinstance(param, m5.params.VectorParamDesc)
     is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

     if is_simobj and is_vector:
         code('} else if (name == "${{param.name}}") {')
         code.indent()
         code("this->${{param.name}}.clear();")
         code(
             "for (auto i = simObjects.begin(); "
             "ret && i != simObjects.end(); i ++)"
         )
         code("{")
         code.indent()
         code(
             "${{param.ptype.cxx_type}} object = "
             "dynamic_cast<${{param.ptype.cxx_type}}>(*i);"
         )
         code("if (*i && !object)")
         code("    ret = false;")
         code("else")
         code("    this->${{param.name}}.push_back(object);")
         code.dedent()
         code("}")
         code.dedent()
 code.dedent()

 code(
     """
     } else {
         ret = false;
     }

     return ret;
 }

 void
 ${param_class}::setName(const std::string &name_)
 {
     this->name = name_;
 }

 bool
 ${param_class}::setParam(const std::string &name,
     const std::string &value, const Flags flags)
 {
     bool ret = true;

     if (false) {
 """
 )

 code.indent()
 for param in sim_object._params.values():
     is_vector = isinstance(param, m5.params.VectorParamDesc)
     is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

     if not is_simobj and not is_vector:
         code('} else if (name == "${{param.name}}") {')
         code.indent()
         param.ptype.cxx_ini_parse(
             code, "value", "this->%s" % param.name, "ret ="
         )
         code.dedent()
 code.dedent()

 code(
     """
     } else {
         ret = false;
     }

     return ret;
 }

 bool
 ${param_class}::setParamVector(const std::string &name,
     const std::vector<std::string> &values, const Flags flags)
 {
     bool ret = true;

     if (false) {
 """
 )

 code.indent()
 for param in sim_object._params.values():
     is_vector = isinstance(param, m5.params.VectorParamDesc)
     is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

     if not is_simobj and is_vector:
         code('} else if (name == "${{param.name}}") {')
         code.indent()
         code("${{param.name}}.clear();")
         code(
             "for (auto i = values.begin(); " "ret && i != values.end(); i ++)"
         )
         code("{")
         code.indent()
         code("${{param.ptype.cxx_type}} elem;")
         param.ptype.cxx_ini_parse(code, "*i", "elem", "ret =")
         code("if (ret)")
         code("    this->${{param.name}}.push_back(elem);")
         code.dedent()
         code("}")
         code.dedent()
 code.dedent()

 code(
     """
     } else {
         ret = false;
     }

     return ret;
 }

 bool
 ${param_class}::setPortConnectionCount(const std::string &name,
     unsigned int count)
 {
     bool ret = true;

     if (false) {
 """
 )

 code.indent()
 for port in sim_object._ports.values():
     code('} else if (name == "${{port.name}}") {')
     code("    this->port_${{port.name}}_connection_count = count;")
 code.dedent()

 code(
     """
     } else {
         ret = false;
     }

     return ret;
 }

 SimObject *
 ${param_class}::simObjectCreate()
 {
 """
 )

 code.indent()
 if hasattr(sim_object, "abstract") and sim_object.abstract:
     code("return nullptr;")
 else:
     code("return this->create();")
 code.dedent()

 code(
     """}

 } // namespace gem5
 """
 )

 code.write(args.cxx_config_cc)
	# Copyright 2004-2006 The Regents of The University of Michigan
	# Copyright 2010-20013 Advanced Micro Devices, Inc.
	# Copyright 2013 Mark D. Hill and David A. Wood
	# Copyright 2017-2020 ARM Limited
	# Copyright 2021 Google, Inc.
	#
	# The license below extends only to copyright in the software and shall
	# not be construed as granting a license to any other intellectual
	# property including but not limited to intellectual property relating
	# to a hardware implementation of the functionality of the software
	# licensed hereunder. You may use the software subject to the license
	# terms below provided that you ensure that this notice is replicated
	# unmodified and in its entirety in all distributions of the software,
	# modified or unmodified, in source code or in binary form.
	#
	# 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.

	import argparse
	import importlib
	import os.path
	import sys

	import importer

	from code_formatter import code_formatter

	parser = argparse.ArgumentParser()
	parser.add_argument("modpath", help="module the simobject belongs to")
	parser.add_argument("cxx_config_cc", help="cxx config cc file to generate")

	args = parser.parse_args()

	basename = os.path.basename(args.cxx_config_cc)
	sim_object_name = os.path.splitext(basename)[0]

	importer.install()
	module = importlib.import_module(args.modpath)
	sim_object = getattr(module, sim_object_name)

	from m5.params import isSimObjectClass
	import m5.params

	code = code_formatter()

	entry_class = "CxxConfigDirectoryEntry_%s" % sim_object_name
	param_class = "%sCxxConfigParams" % sim_object_name


	def cxx_bool(b):
	return "true" if b else "false"


	code('#include "params/%s.hh"' % sim_object_name)

	for param in sim_object._params.values():
	if isSimObjectClass(param.ptype):
	code('#include "%s"' % param.ptype._value_dict["cxx_header"])
	code('#include "params/%s.hh"' % param.ptype.__name__)
	else:
	param.ptype.cxx_ini_predecls(code)

	code(
	"""#include "${{sim_object._value_dict['cxx_header']}}"
	#include "base/str.hh"
	#include "cxx_config/${sim_object_name}.hh"

	namespace gem5
	{

	${param_class}::DirectoryEntry::DirectoryEntry()
	{
	"""
	)
	code.indent()
	for param in sim_object._params.values():
	is_vector = isinstance(param, m5.params.VectorParamDesc)
	is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

	code(
	'parameters["%s"] = new ParamDesc("%s", %s, %s);'
	% (param.name, param.name, cxx_bool(is_vector), cxx_bool(is_simobj))
	)

	for port in sim_object._ports.values():
	is_vector = isinstance(port, m5.params.VectorPort)
	is_requestor = port.role == "GEM5 REQUESTOR"

	code(
	'ports["%s"] = new PortDesc("%s", %s, %s);'
	% (port.name, port.name, cxx_bool(is_vector), cxx_bool(is_requestor))
	)

	code.dedent()

	code(
	"""}

	bool
	${param_class}::setSimObject(const std::string &name, SimObject *simObject)
	{
	bool ret = true;
	if (false) {
	"""
	)

	code.indent()
	for param in sim_object._params.values():
	is_vector = isinstance(param, m5.params.VectorParamDesc)
	is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

	if is_simobj and not is_vector:
	code('} else if (name == "${{param.name}}") {')
	code.indent()
	code(
	"this->${{param.name}} = "
	"dynamic_cast<${{param.ptype.cxx_type}}>(simObject);"
	)
	code("if (simObject && !this->${{param.name}})")
	code(" ret = false;")
	code.dedent()
	code.dedent()

	code(
	"""
	} else {
	ret = false;
	}

	return ret;
	}

	bool
	${param_class}::setSimObjectVector(const std::string &name,
	const std::vector<SimObject *> &simObjects)
	{
	bool ret = true;

	if (false) {
	"""
	)

	code.indent()
	for param in sim_object._params.values():
	is_vector = isinstance(param, m5.params.VectorParamDesc)
	is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

	if is_simobj and is_vector:
	code('} else if (name == "${{param.name}}") {')
	code.indent()
	code("this->${{param.name}}.clear();")
	code(
	"for (auto i = simObjects.begin(); "
	"ret && i != simObjects.end(); i ++)"
	)
	code("{")
	code.indent()
	code(
	"${{param.ptype.cxx_type}} object = "
	"dynamic_cast<${{param.ptype.cxx_type}}>(*i);"
	)
	code("if (*i && !object)")
	code(" ret = false;")
	code("else")
	code(" this->${{param.name}}.push_back(object);")
	code.dedent()
	code("}")
	code.dedent()
	code.dedent()

	code(
	"""
	} else {
	ret = false;
	}

	return ret;
	}

	void
	${param_class}::setName(const std::string &name_)
	{
	this->name = name_;
	}

	bool
	${param_class}::setParam(const std::string &name,
	const std::string &value, const Flags flags)
	{
	bool ret = true;

	if (false) {
	"""
	)

	code.indent()
	for param in sim_object._params.values():
	is_vector = isinstance(param, m5.params.VectorParamDesc)
	is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

	if not is_simobj and not is_vector:
	code('} else if (name == "${{param.name}}") {')
	code.indent()
	param.ptype.cxx_ini_parse(
	code, "value", "this->%s" % param.name, "ret ="
	)
	code.dedent()
	code.dedent()

	code(
	"""
	} else {
	ret = false;
	}

	return ret;
	}

	bool
	${param_class}::setParamVector(const std::string &name,
	const std::vector<std::string> &values, const Flags flags)
	{
	bool ret = true;

	if (false) {
	"""
	)

	code.indent()
	for param in sim_object._params.values():
	is_vector = isinstance(param, m5.params.VectorParamDesc)
	is_simobj = issubclass(param.ptype, m5.SimObject.SimObject)

	if not is_simobj and is_vector:
	code('} else if (name == "${{param.name}}") {')
	code.indent()
	code("${{param.name}}.clear();")
	code(
	"for (auto i = values.begin(); " "ret && i != values.end(); i ++)"
	)
	code("{")
	code.indent()
	code("${{param.ptype.cxx_type}} elem;")
	param.ptype.cxx_ini_parse(code, "*i", "elem", "ret =")
	code("if (ret)")
	code(" this->${{param.name}}.push_back(elem);")
	code.dedent()
	code("}")
	code.dedent()
	code.dedent()

	code(
	"""
	} else {
	ret = false;
	}

	return ret;
	}

	bool
	${param_class}::setPortConnectionCount(const std::string &name,
	unsigned int count)
	{
	bool ret = true;

	if (false) {
	"""
	)

	code.indent()
	for port in sim_object._ports.values():
	code('} else if (name == "${{port.name}}") {')
	code(" this->port_${{port.name}}_connection_count = count;")
	code.dedent()

	code(
	"""
	} else {
	ret = false;
	}

	return ret;
	}

	SimObject *
	${param_class}::simObjectCreate()
	{
	"""
	)

	code.indent()
	if hasattr(sim_object, "abstract") and sim_object.abstract:
	code("return nullptr;")
	else:
	code("return this->create();")
	code.dedent()

	code(
	"""}

	} // namespace gem5
	"""
	)

	code.write(args.cxx_config_cc)