PandA-2024.02
xst_wrapper.cpp
Go to the documentation of this file.
1 /*
2  *
3  * _/_/_/ _/_/ _/ _/ _/_/_/ _/_/
4  * _/ _/ _/ _/ _/_/ _/ _/ _/ _/ _/
5  * _/_/_/ _/_/_/_/ _/ _/_/ _/ _/ _/_/_/_/
6  * _/ _/ _/ _/ _/ _/ _/ _/ _/
7  * _/ _/ _/ _/ _/ _/_/_/ _/ _/
8  *
9  * ***********************************************
10  * PandA Project
11  * URL: http://panda.dei.polimi.it
12  * Politecnico di Milano - DEIB
13  * System Architectures Group
14  * ***********************************************
15  * Copyright (C) 2004-2024 Politecnico di Milano
16  *
17  * This file is part of the PandA framework.
18  *
19  * The PandA framework is free software; you can redistribute it and/or modify
20  * it under the terms of the GNU General Public License as published by
21  * the Free Software Foundation; either version 3 of the License, or
22  * (at your option) any later version.
23  *
24  * This program is distributed in the hope that it will be useful,
25  * but WITHOUT ANY WARRANTY; without even the implied warranty of
26  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27  * GNU General Public License for more details.
28  *
29  * You should have received a copy of the GNU General Public License
30  * along with this program. If not, see <http://www.gnu.org/licenses/>.
31  *
32  */
45 #include "xst_wrapper.hpp"
47 
48 #include "DesignParameters.hpp"
49 #include "Parameter.hpp"
50 #include "ToolManager.hpp"
51 #include "dbgPrintHelper.hpp"
52 #include "fileIO.hpp"
53 #include "string_manipulation.hpp"
54 #include "utility.hpp"
55 #include "xml_script_command.hpp"
56 
57 // constructor
58 xst_wrapper::xst_wrapper(const ParameterConstRef& _Param, const std::string& _output_dir,
59  const generic_deviceRef& _device)
60  : XilinxWrapper(_Param, XST_TOOL_ID, _device, _output_dir, "xst")
61 {
62  debug_level = _Param->get_class_debug_level(GET_CLASS(*this));
63  PRINT_DBG_MEX(DEBUG_LEVEL_PEDANTIC, debug_level, "Creating the XST wrapper...");
64 }
65 
66 // destructor
67 xst_wrapper::~xst_wrapper() = default;
68 
70 {
73 }
74 
76 {
77  INDENT_DBG_MEX(DEBUG_LEVEL_VERY_PEDANTIC, debug_level, "-->Generating project file for xst");
78  std::string HDL_files = dp->get_value(PARAM_HDL_files);
79  const auto files = string_to_container<std::vector<std::filesystem::path>>(HDL_files, ";");
80 
81  std::string top_name = dp->get_value(PARAM_top_id);
82  std::string xst_tmpdir = dp->get_value(PARAM_xst_tmpdir);
83  std::string project_filename = xst_tmpdir + "/" + top_name + ".prj";
84  std::ofstream prj_file(project_filename);
85  for(const auto& file : files)
86  {
87  INDENT_DBG_MEX(DEBUG_LEVEL_VERY_PEDANTIC, debug_level, "---Adding file " + file.string());
88  std::string extension = file.extension().string();
89  std::string language;
90  if(extension == ".vhd" || extension == ".vhdl" || extension == ".VHD" || extension == ".VHDL")
91  {
92  language = "VHDL";
93  }
94  else if(extension == ".v" || extension == ".V" || extension == ".sv" || extension == ".SV")
95  {
96  language = "VERILOG";
97  }
98  else
99  {
100  THROW_ERROR("Extension not recognized! " + extension);
101  }
102  prj_file << language << " "
103  << "work"
104  << " " << file << std::endl;
105  }
106  prj_file.close();
107  dp->assign(PARAM_xst_prj_file, project_filename, false);
108  INDENT_DBG_MEX(DEBUG_LEVEL_VERY_PEDANTIC, debug_level, "<--Generated project file for xst");
109 }
110 
112 {
113  std::string top_name = dp->get_value(PARAM_top_id);
114  dp->assign(PARAM_xst_tmpdir, output_dir, false);
115  dp->assign(PARAM_xst_hdpdir, output_dir, false);
116  dp->assign(PARAM_xst_log_file, output_dir + "/" + top_name + ".log", false);
118  dp->assign(PARAM_xst_report, output_dir + "/" + top_name + "_xst.xrpt", false);
119 }
120 
122 {
123  std::ostringstream s;
124  s << get_tool_exec() << " -ifn " << dp->parameter_values[SCRIPT_FILENAME];
125  for(const auto& option : xml_tool_options)
126  {
127  if(option->checkCondition(dp))
128  {
129  std::string value = toString(option, dp);
130  replace_parameters(dp, value);
131  s << " " << value;
132  }
133  }
134  s << std::endl;
135  return s.str();
136 }
#define DEBUG_LEVEL_VERY_PEDANTIC
extremely verbose debugging print is performed.
#define INDENT_DBG_MEX(dbgLevel, curDbgLevel, mex)
We are producing a debug version of the program, so the message is printed;.
File containing functions and utilities to support the printing of debug messagges.
#define PRINT_DBG_MEX(dbgLevel, curDbgLevel, mex)
We are producing a debug version of the program, so the message is printed;.
#define DEBUG_LEVEL_PEDANTIC
very verbose debugging print is performed.
#define GET_CLASS(obj)
Macro returning the actual type of an object.
int debug_level
debug level of the class
void init_reserved_vars() override
Initializes the reserved variables.
Definition: xst_wrapper.cpp:69
#define PARAM_xst_tmpdir
Definition: xst_wrapper.hpp:63
virtual void init_reserved_vars()
Initializes the reserved variables.
std::string output_dir
the output directory
Auxiliary methods for manipulating string.
map_t parameter_values
Map between the name of the parameter and the corresponding string-based value.
void assign(const std::string &name, const std::string &value, bool checkExisting)
Assigns a value to a saved parameter.
~xst_wrapper() override
Destructor.
This file contains the definition of the parameters for the synthesis tools.
std::string get_command_line(const DesignParametersRef &dp) const override
Returns the proper command line.
Wrapper to XST by XILINX.
xst_wrapper(const ParameterConstRef &Param, const std::string &_output_dir, const generic_deviceRef &_device)
Constructor.
Definition: xst_wrapper.cpp:58
utility function used to read files.
void GenerateProjectFile(const DesignParametersRef &dp)
Generates project file.
Definition: xst_wrapper.cpp:75
void EvaluateVariables(const DesignParametersRef dp) override
Evaluates the design variables.
This file collects some utility functions and macros.
void replace_parameters(const DesignParametersRef &dp, std::string &script) const
Replaces occurrences of parameters inside a script.
#define SCRIPT_FILENAME
#define ADD_RES_VAR(name)
#define THROW_ERROR(str_expr)
helper function used to throw an error in a standard way
Definition: exceptions.hpp:263
#define PARAM_xst_log_file
std::vector< xml_parameter_tRef > xml_tool_options
#define PARAM_xst_hdpdir
Definition: xst_wrapper.hpp:64
Classes for handling configuration files.
#define PARAM_top_id
Class to manage a wrapped tool.
Template borrowed from the ANTLR library by Terence Parr (http://www.jGuru.com - Software rights: htt...
Definition: refcount.hpp:94
virtual std::string get_tool_exec() const
Returns the name of the tool executable.
this class is used to manage the command-line or XML options.
#define PARAM_xst_report
#define PARAM_xst_prj_file
Definition: xst_wrapper.hpp:65
#define XST_TOOL_ID
Definition: xst_wrapper.hpp:61
std::string toString(const xml_script_node_tRef node, const DesignParametersRef dp) const override
Returns the string-based representation of the XML element.
std::string get_value(const std::string &name) const
Returns the value associated with a parameter name.
#define PARAM_HDL_files

Generated on Mon Feb 12 2024 13:02:56 for PandA-2024.02 by doxygen 1.8.13