# EMACS settings: -*- tab-width: 2; indent-tabs-mode: t; python-indent-offset: 2 -*-
# vim: tabstop=2:shiftwidth=2:noexpandtab
# kate: tab-width 2; replace-tabs off; indent-width 2;
#
# ==============================================================================
# Authors: Patrick Lehmann
# Martin Zabel
#
# Python Main Module: Entry point to the testbench tools in PoC repository.
#
# Description:
# ------------------------------------
# This is a python main module (executable) which:
# - runs automated testbenches,
# - ...
#
# License:
# ==============================================================================
# Copyright 2007-2016 Technische Universitaet Dresden - Germany
# Chair of VLSI-Design, Diagnostics and Architecture
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# distributed under the License is distributed on an "AS IS" BASIS,default
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ==============================================================================
#
# load dependencies
from argparse import RawDescriptionHelpFormatter
from configparser import Error as ConfigParser_Error, DuplicateOptionError
from datetime import datetime
from os import environ
from pathlib import Path
from platform import system as platform_system
from shutil import copy as shutil_copy
from sys import argv as sys_argv
from textwrap import dedent
from Compiler import CompilerException, CompileSteps
from Base.Exceptions import ExceptionBase, CommonException, PlatformNotSupportedException, EnvironmentException, NotConfiguredException
from Base.Logging import ILogable, Logger, Severity
from Base.Project import VHDLVersion
from Compiler.LSECompiler import Compiler as LSECompiler
from Compiler.QuartusCompiler import Compiler as MapCompiler
from Compiler.ISECompiler import Compiler as ISECompiler
from Compiler.XCICompiler import Compiler as XCICompiler
from Compiler.XCOCompiler import Compiler as XCOCompiler
from Compiler.XSTCompiler import Compiler as XSTCompiler
from Compiler.VivadoCompiler import Compiler as VivadoCompiler
from DataBase import Query
from DataBase.Config import Board
from DataBase.Entity import NamespaceRoot, FQN, EntityTypes, WildCard, TestbenchKind, NetlistKind
from DataBase.Solution import Repository
from Simulator import Simulator as BaseSimulator, SimulatorException, SimulationSteps
from Simulator.ActiveHDLSimulator import Simulator as ActiveHDLSimulator
from Simulator.CocotbSimulator import Simulator as CocotbSimulator
from Simulator.GHDLSimulator import Simulator as GHDLSimulator
from Simulator.ISESimulator import Simulator as ISESimulator
from Simulator.QuestaSimulator import Simulator as QuestaSimulator
from Simulator.VivadoSimulator import Simulator as VivadoSimulator
from ToolChains import ToolChainException, Configurator, ConfigurationException
from ToolChains.GHDL import Configuration as GHDLConfiguration
from lib.pyAttribute.ArgParseAttributes import ArgParseMixin
from lib.pyAttribute.ArgParseAttributes import CommandAttribute, CommandGroupAttribute, ArgumentAttribute, SwitchArgumentAttribute, DefaultAttribute
from lib.pyAttribute.ArgParseAttributes import CommonArgumentAttribute, CommonSwitchArgumentAttribute
from lib.ExtendedConfigParser import ExtendedConfigParser
from lib.Functions import Init, Exit
from lib.Parser import ParserException
from lib.pyAttribute import Attribute
__author__ = "Patrick Lehmann, Martin Zabel"
__copyright__ = "Copyright 2007-2016 Technische Universitaet Dresden - Germany, Chair of VLSI-Design, Diagnostics and Architecture"
__maintainer__ = "Patrick Lehmann"
__email__ = "Patrick.Lehmann@tu-dresden.de"
__version__ = "1.1.0"
__status__ = "Production"
__license__ = "Apache License 2.0"
__api__ = [
'PoCEntityAttribute',
'BoardDeviceAttributeGroup',
'VHDLVersionAttribute',
'SimulationStepsAttribute',
'CompileStepsAttribute',
'PileOfCores',
'main'
]
__all__ = __api__
[docs]class PoCEntityAttribute(Attribute):
def __call__(self, func):
self._AppendAttribute(func, ArgumentAttribute(metavar="PoC Entity", dest="FQN", type=str, nargs='+', help="A space separated list of PoC entities."))
return func
[docs]class BoardDeviceAttributeGroup(Attribute):
def __call__(self, func):
self._AppendAttribute(func, ArgumentAttribute("--device", metavar="DeviceName", dest="DeviceName", help="The target platform's device name."))
self._AppendAttribute(func, ArgumentAttribute("--board", metavar="BoardName", dest="BoardName", help="The target platform's board name."))
return func
[docs]class VHDLVersionAttribute(Attribute):
def __call__(self, func):
self._AppendAttribute(func, ArgumentAttribute("--std", metavar="VHDLVersion", dest="VHDLVersion", help="Simulate with VHDL-??"))
return func
[docs]class SimulationStepsAttribute(Attribute):
def __call__(self, func):
self._AppendAttribute(func, SwitchArgumentAttribute("-g", "--gui", dest="GUIMode", help="Run all steps (prepare, analysis, elaboration, optimization, simulation) and finally display the waveform in a GUI window."))
self._AppendAttribute(func, SwitchArgumentAttribute("-a", "--analyze", dest="Analyze", help="Run only the prepare and analysis step."))
self._AppendAttribute(func, SwitchArgumentAttribute("-e", "--elaborate", dest="Elaborate", help="Run only the prepare and elaboration step."))
# self._AppendAttribute(func, SwitchArgumentAttribute("-c", "--compile", dest="Compile", help="Run only the prepare and compile step."))
# self._AppendAttribute(func, SwitchArgumentAttribute("-o", "--optimize", dest="Optimize", help="Run only the prepare and optimization step."))
self._AppendAttribute(func, SwitchArgumentAttribute("-C", "--recompile", dest="Recompile", help="Run all compile steps (prepare, analysis, elaboration, optimization)."))
self._AppendAttribute(func, SwitchArgumentAttribute("-s", "--simulate", dest="Simulate", help="Run only the prepare and simulation step."))
self._AppendAttribute(func, SwitchArgumentAttribute("-w", "--showwave", dest="ShowWave", help="Run only the prepare step and display the waveform in a GUI window."))
self._AppendAttribute(func, SwitchArgumentAttribute("-W", "--review", dest="Review", help="Run only display the waveform in a GUI window."))
self._AppendAttribute(func, SwitchArgumentAttribute("-S", "--resimulate", dest="Resimulate", help="Run all simulation steps (prepare, simulation) and finally display the waveform in a GUI window."))
self._AppendAttribute(func, SwitchArgumentAttribute("-r", "--showreport", dest="ShowReport", help="Show a simulation report."))
# self._AppendAttribute(func, SwitchArgumentAttribute( "--cleanup-after", dest="CleanUpAfter", help="Don't delete intermediate files. Skip post-delete rules."))
return func
[docs]class CompileStepsAttribute(Attribute):
def __call__(self, func):
self._AppendAttribute(func, SwitchArgumentAttribute("-s", "--synthesize", dest="Synthesize", help="Run only the prepare and synthesize step."))
# merge
# place
# route
# bitfile
self._AppendAttribute(func, SwitchArgumentAttribute("-r", "--showreport", dest="ShowReport", help="Show a simulation report."))
self._AppendAttribute(func, SwitchArgumentAttribute( "--no-cleanup", dest="NoCleanUp", help="Don't delete intermediate files. Skip post-delete rules."))
return func
[docs]class PileOfCores(ILogable, ArgParseMixin):
HeadLine = "The PoC-Library - Service Tool"
# configure hard coded variables here
__CONFIGFILE_DIRECTORY = "py"
__CONFIGFILE_PRIVATE = "config.private.ini"
__CONFIGFILE_DEFAULTS = "config.defaults.ini"
__CONFIGFILE_BOARDS = "config.boards.ini"
__CONFIGFILE_STRUCTURE = "config.structure.ini"
__CONFIGFILE_IPCORES = "config.entity.ini"
# load platform information (Windows, Linux, Darwin, ...)
__PLATFORM = platform_system()
# records
class __Directories__:
"""Data structure for all main directories.
WORKAROUND: All members are initialized with empty :py:class:`pathlib.Path`
instances, until Python 3.6 with type hints gets the default Python version.
"""
Working = Path()
Root = Path()
ConfigFiles = Path()
Solution = Path()
Project = Path()
Source = Path()
Testbench = Path()
Netlist = Path()
Temp = Path()
PreCompiled = Path()
class __ConfigFiles__:
"""Data structure for all configuration files.
WORKAROUND: All members are initialized with empty :py:class:`pathlib.Path`
instances, until Python 3.6 with type hints gets the default Python version.
"""
Private = Path()
Defaults = Path()
Boards = Path()
Structure = Path()
IPCores = Path()
Solution = Path()
Project = Path()
def __init__(self, debug, verbose, quiet, dryRun, sphinx=False):
# Call the initializer of ILogable
# --------------------------------------------------------------------------
if quiet: severity = Severity.Quiet
elif debug: severity = Severity.Debug
elif verbose: severity = Severity.Verbose
else: severity = Severity.Normal
logger = Logger(severity, printToStdOut=True)
ILogable.__init__(self, logger=logger)
# Call the constructor of the ArgParseMixin
# --------------------------------------------------------------------------
description = dedent("""\
This is the PoC-Library Service Tool.
""")
epilog = "Pile-of-Cores"
class HelpFormatter(RawDescriptionHelpFormatter):
def __init__(self, *args, **kwargs):
kwargs['max_help_position'] = 25
super().__init__(*args, **kwargs)
ArgParseMixin.__init__(self, description=description, epilog=epilog, formatter_class=HelpFormatter, add_help=False)
if sphinx: return
# Do some basic checks
self.__CheckEnvironment()
# declare members
# --------------------------------------------------------------------------
self.__dryRun = dryRun
self.__pocConfig = None
self.__root = None
self.__repo = None
self.__directories = {}
self.__SimulationDefaultVHDLVersion = BaseSimulator.VHDL_VERSION
self.__SimulationDefaultBoard = None
self._directories = self.__Directories__()
self._directories.Working = Path.cwd()
self._directories.Root = Path(environ.get('PoCRootDirectory'))
self._directories.ConfigFiles = self.Directories.Root / self.__CONFIGFILE_DIRECTORY
self._configFiles = self.__ConfigFiles__()
self._configFiles.Private = self.Directories.ConfigFiles / self.__CONFIGFILE_PRIVATE
self._configFiles.Defaults = self.Directories.ConfigFiles / self.__CONFIGFILE_DEFAULTS
self._configFiles.Boards = self.Directories.ConfigFiles / self.__CONFIGFILE_BOARDS
self._configFiles.Structure = self.Directories.ConfigFiles / self.__CONFIGFILE_STRUCTURE
self._configFiles.IPCores = self.Directories.ConfigFiles / self.__CONFIGFILE_IPCORES
self.__pocConfig = ExtendedConfigParser()
self.__pocConfig.optionxform = str
# class properties
# ============================================================================
@property
def Platform(self): return self.__PLATFORM
@property
def DryRun(self): return self.__dryRun
@property
def Directories(self): return self._directories
@property
def ConfigFiles(self): return self._configFiles
@property
def PoCConfig(self): return self.__pocConfig
@property
def Root(self): return self.__root
@property
def Repository(self): return self.__repo
def __CheckEnvironment(self):
if (self.Platform not in ["Windows", "Linux", "Darwin"]): raise PlatformNotSupportedException(self.Platform)
if (environ.get('PoCRootDirectory') is None): raise EnvironmentException("Shell environment does not provide 'PoCRootDirectory' variable.")
# read PoC configuration
# ============================================================================
def __ReadPoCConfiguration(self):
self.LogVerbose("Reading configuration files...")
configFiles = [
(self.ConfigFiles.Private, "private"),
(self.ConfigFiles.Defaults, "defaults"),
(self.ConfigFiles.Boards, "boards"),
(self.ConfigFiles.Structure, "structure"),
(self.ConfigFiles.IPCores, "IP core")
]
# create parser instance
self.LogDebug("Reading PoC configuration from:")
try:
# process first file (private)
file, name = configFiles[0]
self.LogDebug(" {0!s}".format(file))
if not file.exists(): raise NotConfiguredException("PoC's {0} configuration file '{1!s}' does not exist.".format(name, file)) from FileNotFoundError(str(file))
self.__pocConfig.read(str(file))
for file, name in configFiles[1:]:
self.LogDebug(" {0!s}".format(file))
if not file.exists(): raise ConfigurationException("PoC's {0} configuration file '{1!s}' does not exist.".format(name, file)) from FileNotFoundError(str(file))
self.__pocConfig.read(str(file))
except DuplicateOptionError as ex:
raise ConfigurationException("Error in configuration file '{0!s}'.".format(file)) from ex
# check PoC installation directory
if (self.Directories.Root != Path(self.PoCConfig['INSTALL.PoC']['InstallationDirectory'])):
raise NotConfiguredException("There is a mismatch between PoCRoot and PoC's installation directory.")
# parsing values into class fields
configSection = self.__pocConfig['CONFIG.DirectoryNames']
self.Directories.Source = self.Directories.Root / configSection['HDLSourceFiles']
self.Directories.Testbench = self.Directories.Root / configSection['TestbenchFiles']
self.Directories.NetList = self.Directories.Root / configSection['NetlistFiles']
self.Directories.Temp = self.Directories.Root / configSection['TemporaryFiles']
self.Directories.PreCompiled = self.Directories.Root / configSection['PrecompiledFiles']
# Initialize the default board (GENERIC)
self.__SimulationDefaultBoard = Board(self)
# Initialize PoC's namespace structure
self.__root = NamespaceRoot(self)
self.__repo = Repository(self)
def __BackupPoCConfiguration(self):
now = datetime.now()
backupFile = self._configFiles.Private.with_suffix(".{datetime}.ini".format(datetime=now.strftime("%Y.%m.%d-%H.%M.%S")))
self.LogVerbose("Copying old configuration file to '{0!s}'.".format(backupFile, **Init.Foreground))
self.LogDebug("cp {0!s} {1!s}".format(self._configFiles.Private, backupFile))
try:
shutil_copy(str(self._configFiles.Private), str(backupFile), follow_symlinks=True)
except OSError as ex:
raise ConfigurationException("Error while copying '{0!s}'.".format(self._configFiles.Private)) from ex
def __WritePoCConfiguration(self):
for sectionName in [sectionName for sectionName in self.__pocConfig if not (sectionName.startswith("INSTALL") or sectionName.startswith("SOLUTION"))]:
self.__pocConfig.remove_section(sectionName)
self.__pocConfig.remove_section("SOLUTION.DEFAULTS")
# Writing configuration to disc
self.LogNormal("{GREEN}Writing configuration file to '{0!s}'.{NOCOLOR}".format(self._configFiles.Private, **Init.Foreground))
with self._configFiles.Private.open('w') as configFileHandle:
self.PoCConfig.write(configFileHandle)
[docs] def SaveAndReloadPoCConfiguration(self):
self.__WritePoCConfiguration()
self.__pocConfig.clear()
self.__ReadPoCConfiguration()
def __PrepareForConfiguration(self):
self.__ReadPoCConfiguration()
def __PrepareForSimulation(self):
self.LogNormal("Initializing PoC-Library Service Tool for simulations")
self.__ReadPoCConfiguration()
def __PrepareForSynthesis(self):
self.LogNormal("Initializing PoC-Library Service Tool for synthesis")
self.__ReadPoCConfiguration()
# ============================================================================
# Common commands
# ============================================================================
# common arguments valid for all commands
# ----------------------------------------------------------------------------
@CommonSwitchArgumentAttribute("-D", dest="DEBUG", help="Enable script wrapper debug mode. See also :option:`poc.ps1 -D`.")
@CommonSwitchArgumentAttribute( "--dryrun", dest="DryRun", help="Don't execute external programs.")
@CommonSwitchArgumentAttribute("-d", "--debug", dest="debug", help="Enable debug mode.")
@CommonSwitchArgumentAttribute("-v", "--verbose", dest="verbose", help="Print out detailed messages.")
@CommonSwitchArgumentAttribute("-q", "--quiet", dest="quiet", help="Reduce messages to a minimum.")
@CommonArgumentAttribute("--sln", metavar="SolutionID", dest="SolutionID", help="Solution name.")
@CommonArgumentAttribute("--prj", metavar="ProjectID", dest="ProjectID", help="Project name.")
[docs] def Run(self):
ArgParseMixin.Run(self)
[docs] def PrintHeadline(self):
self.LogNormal("{HEADLINE}{line}{NOCOLOR}".format(line="="*80, **Init.Foreground))
self.LogNormal("{HEADLINE}{headline: ^80s}{NOCOLOR}".format(headline=self.HeadLine, **Init.Foreground))
self.LogNormal("{HEADLINE}{line}{NOCOLOR}".format(line="="*80, **Init.Foreground))
# ----------------------------------------------------------------------------
# fallback handler if no command was recognized
# ----------------------------------------------------------------------------
@DefaultAttribute()
[docs] def HandleDefault(self, _):
self.PrintHeadline()
# print("Common arguments:")
# for funcname,func in CommonArgumentAttribute.GetMethods(self):
# for comAttribute in CommonArgumentAttribute.GetAttributes(func):
# print(" {0} {1}".format(comAttribute.Args, comAttribute.KWArgs['help']))
#
# self.__mainParser.add_argument(*(comAttribute.Args), **(comAttribute.KWArgs))
#
# for funcname,func in CommonSwitchArgumentAttribute.GetMethods(self):
# for comAttribute in CommonSwitchArgumentAttribute.GetAttributes(func):
# print(" {0} {1}".format(comAttribute.Args, comAttribute.KWArgs['help']))
self.MainParser.print_help()
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "help" command
# ----------------------------------------------------------------------------
@CommandAttribute("help", help="help help")
@ArgumentAttribute(metavar="Command", dest="Command", type=str, nargs="?", help="Print help page(s) for a command.")
[docs] def HandleHelp(self, args):
self.PrintHeadline()
if (args.Command is None):
self.MainParser.print_help()
Exit.exit()
elif (args.Command == "help"):
print("This is a recursion ...")
else:
self.SubParsers[args.Command].print_help()
Exit.exit()
# ============================================================================
# Configuration commands
# ============================================================================
# create the sub-parser for the "configure" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands") # mccabe:disable=MC0001
@CommandAttribute("configure", help="Configure vendor tools for PoC.")
@ArgumentAttribute(metavar="ToolChain", dest="ToolChain", type=str, nargs="?", help="Specify a tool chain to be configured.")
@SwitchArgumentAttribute("--set-default-tools", dest="SetDefaultTools", help="Set default tool for a tool chain.")
[docs] def HandleConfiguration(self, args):
"""Handle 'configure' command."""
self.PrintHeadline()
if (self.Platform not in ["Darwin", "Linux", "Windows"]): raise PlatformNotSupportedException(self.Platform)
# load existing configuration or create a new one
try:
self.__ReadPoCConfiguration()
self.__BackupPoCConfiguration()
configurator = Configurator(self)
configurator.UpdateConfiguration()
except NotConfiguredException:
self.LogWarning("No private configuration found. Generating an empty PoC configuration...")
configurator = Configurator(self)
configurator.InitializeConfiguration()
if (args.SetDefaultTools is True):
configurator.ConfigureDefaultTools()
else:
toolChain = args.ToolChain
if (toolChain is None):
configurator.ConfigureAll()
else:
configurator.ConfigureTool(toolChain)
if (self.Logger.LogLevel is Severity.Debug):
self.LogDebug("Dumping PoCConfig...")
self.LogDebug("-" * 40)
for sectionName in self.__pocConfig.sections():
if (not sectionName.startswith("INSTALL")):
continue
self.LogDebug("[{0}]".format(sectionName))
configSection = self.__pocConfig[sectionName]
for optionName in configSection:
try:
optionValue = configSection[optionName]
except Exception:
optionValue = "-- ERROR --"
self.LogDebug("{0} = {1}".format(optionName, optionValue), indent=3)
self.LogDebug("-" * 40)
# ----------------------------------------------------------------------------
# create the sub-parser for the "add-solution" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands")
@CommandAttribute("add-solution", help="Add a solution to PoC.", description=dedent("""\
Add a solution to PoC.
"""))
[docs] def HandleAddSolution(self, _): #args
self.PrintHeadline()
self.__PrepareForConfiguration()
self.LogNormal("Register a new solutions in PoC")
self.LogNormal("Solution name: ", indent=1)
solutionName = input()
if (solutionName == ""): raise ConfigurationException("Empty input. Aborting!")
self.LogNormal("Solution id: ", indent=1)
solutionID = input()
if (solutionID == ""): raise ConfigurationException("Empty input. Aborting!")
if (solutionID in self.__repo): raise ConfigurationException("Solution ID is already used.")
self.LogNormal("Solution path: ", indent=1)
solutionRootPath = input()
if (solutionRootPath == ""): raise ConfigurationException("Empty input. Aborting!")
solutionRootPath = Path(solutionRootPath)
if (not solutionRootPath.exists()):
self.LogNormal("Path does not exists. Should it be created? [{CYAN}Y{NOCOLOR}/n]: ".format(**Init.Foreground), appendLinebreak=False)
createPath = input()
createPath = createPath if createPath != "" else "Y"
if (createPath in ['n', 'N']):
raise ConfigurationException("Cannot continue to register the new project, because '{0!s}' does not exist.".format(solutionRootPath))
elif (createPath not in ['y', 'Y']):
raise ConfigurationException("Unsupported choice '{0}'".format(createPath))
try:
solutionRootPath.mkdir(parents=True)
except OSError as ex:
raise ConfigurationException("Error while creating '{0!s}'.".format(solutionRootPath)) from ex
self.__repo.AddSolution(solutionID, solutionName, solutionRootPath)
self.__WritePoCConfiguration()
self.LogNormal("Solution {GREEN}successfully{NOCOLOR} created.".format(**Init.Foreground))
# ----------------------------------------------------------------------------
# create the sub-parser for the "list-solution" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands")
@CommandAttribute("list-solution", help="List all solutions registered in PoC.", description=dedent("""\
List all solutions registered in PoC.
"""))
[docs] def HandleListSolution(self, _): #args
self.PrintHeadline()
self.__PrepareForConfiguration()
self.LogNormal("Registered solutions in PoC:")
if self.__repo.Solutions:
for solution in self.__repo.Solutions:
self.LogNormal(" {id: <10}{name}".format(id=solution.ID, name=solution.Name))
if (self.Logger.LogLevel <= Severity.Verbose):
self.LogVerbose(" Path: {path!s}".format(path=solution.Path))
self.LogVerbose(" Projects:")
for project in solution.Projects:
self.LogVerbose(" {id: <6}{name}".format(id=project.ID, name=project.Name))
else:
self.LogNormal(" {RED}No registered solutions found.{NOCOLOR}".format(**Init.Foreground))
# ----------------------------------------------------------------------------
# create the sub-parser for the "remove-solution" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands")
@CommandAttribute("remove-solution", help="Remove a solution from PoC.", description=dedent("""\
Remove a solution from PoC.
"""))
@ArgumentAttribute(metavar="SolutionID", dest="SolutionID", type=str, help="Solution name.")
[docs] def HandleRemoveSolution(self, args):
self.PrintHeadline()
self.__PrepareForConfiguration()
solution = self.__repo[args.SolutionID]
self.LogNormal("Removing solution '{0}'.".format(solution.Name))
remove = input("Do you really want to remove this solution? [N/y]: ")
remove = remove if remove != "" else "N"
if (remove in ['n', 'N']):
raise ConfigurationException("Operation canceled.")
elif (remove not in ['y', 'Y']):
raise ConfigurationException("Unsupported choice '{0}'".format(remove))
self.__repo.RemoveSolution(solution)
self.__WritePoCConfiguration()
self.LogNormal("Solution {GREEN}successfully{NOCOLOR} removed.".format(**Init.Foreground))
# ----------------------------------------------------------------------------
# create the sub-parser for the "add-project" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("add-project", help="Add a project to PoC.")
# def HandleAddProject(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "list-project" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands")
@CommandAttribute("list-project", help="List all projects registered in PoC.", description=dedent("""\
List all projects registered in PoC.
"""))
[docs] def HandleListProject(self, args):
self.PrintHeadline()
self.__PrepareForConfiguration()
if (args.SolutionID is None): raise ConfigurationException("Missing command line argument '--sln'.")
try:
solution = self.__repo[args.SolutionID]
except KeyError as ex:
raise ConfigurationException("Solution ID '{0}' is not registered in PoC.".format(args.SolutionID)) from ex
self.LogNormal("Registered projects for solution '{0}':".format(solution.ID))
if solution.Projects:
for project in solution.Projects:
self.LogNormal(" {id: <10}{name}".format(id=project.ID, name=project.Name))
else:
self.LogNormal(" {RED}No registered projects found.{NOCOLOR}".format(**Init.Foreground))
# ----------------------------------------------------------------------------
# create the sub-parser for the "remove-project" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("remove-project", help="Add a project to PoC.")
# @ArgumentAttribute(metavar="Project", dest="Project", type=str, help="Project name.")
# def HandleRemoveProject(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "add-ipcore" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("add-ipcore", help="Add a ipcore to PoC.")
# def HandleAddIPCore(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "list-ipcore" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("list-ipcore", help="List all ipcores registered in PoC.")
# def HandleListIPCore(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
#
# ipcore = Solution(self)
#
# self.LogNormal("Registered ipcores in PoC:")
# for ipcoreName in ipcore.GetIPCoreNames():
# print(" {0}".format(ipcoreName))
# ----------------------------------------------------------------------------
# create the sub-parser for the "remove-ipcore" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("remove-ipcore", help="Add a ipcore to PoC.")
# @ArgumentAttribute(metavar="IPCore", dest="IPCore", type=str, help="IPCore name.")
# def HandleRemoveIPCore(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "add-testbench" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("add-testbench", help="Add a testbench to PoC.")
# def HandleAddTestbench(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "remove-testbench" command
# ----------------------------------------------------------------------------
# @CommandGroupAttribute("Configuration commands")
# @CommandAttribute("remove-testbench", help="Add a testbench to PoC.")
# @ArgumentAttribute(metavar="Testbench", dest="Testbench", type=str, help="Testbench name.")
# def HandleRemoveTestbench(self, args):
# self.PrintHeadline()
# self.__PrepareForConfiguration()
# ----------------------------------------------------------------------------
# create the sub-parser for the "query" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Configuration commands")
@CommandAttribute("query", help="Query PoC's database.", description=dedent("""\
Query PoC's database.
"""))
@ArgumentAttribute(metavar="Query", dest="Query", type=str, help="todo help")
[docs] def HandleQueryConfiguration(self, args):
self.__PrepareForConfiguration()
query = Query(self)
try:
result = query.QueryConfiguration(args.Query)
print(result, end="")
Exit.exit()
except ConfigurationException as ex:
print(str(ex), end="")
Exit.exit(1)
# ============================================================================
# Simulation commands
# ============================================================================
# TODO: Maybe required to self-compile libraries again or in the future
# def __PrepareVendorLibraryPaths(self):
# # prepare vendor library path for Altera
# if (len(self.PoCConfig.options("INSTALL.Altera.Quartus")) != 0):
# self.Directories["AlteraPrimitiveSource"] = Path(self.PoCConfig['INSTALL.Altera.Quartus']['InstallationDirectory']) / "eda/sim_lib"
# # prepare vendor library path for Xilinx
# if (len(self.PoCConfig.options("INSTALL.Xilinx.ISE")) != 0):
# self.Directories["XilinxPrimitiveSource"] = Path(self.PoCConfig['INSTALL.Xilinx.ISE']['InstallationDirectory']) / "ISE/vhdl/src"
# elif (len(self.PoCConfig.options("INSTALL.Xilinx.Vivado")) != 0):
# self.Directories["XilinxPrimitiveSource"] = Path(self.PoCConfig['INSTALL.Xilinx.Vivado']['InstallationDirectory']) / "data/vhdl/src"
# TODO: move to Configuration class in ToolChains.Xilinx.Vivado
[docs] def _CheckVivadoEnvironment(self):
# check if Vivado is configure
if (len(self.PoCConfig.options("INSTALL.Xilinx.Vivado")) == 0): raise NotConfiguredException("Xilinx Vivado is not configured on this system.")
if (environ.get('XILINX_VIVADO') is None): raise EnvironmentException("Xilinx Vivado environment is not loaded in this shell environment.")
# TODO: move to Configuration class in ToolChains.Xilinx.ISE
[docs] def _CheckISEEnvironment(self):
# check if ISE is configure
if (len(self.PoCConfig.options("INSTALL.Xilinx.ISE")) == 0): raise NotConfiguredException("Xilinx ISE is not configured on this system.")
if (environ.get('XILINX') is None): raise EnvironmentException("Xilinx ISE environment is not loaded in this shell environment.")
@staticmethod
@staticmethod
# ----------------------------------------------------------------------------
# create the sub-parser for the "list-testbench" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands") # mccabe:disable=MC0001
@CommandAttribute("list-testbench", help="List all testbenches.", description=dedent("""\
List all testbenches.
"""))
@PoCEntityAttribute()
@ArgumentAttribute("--kind", metavar="Kind", dest="TestbenchKind", help="Testbench kind: VHDL | COCOTB")
[docs] def HandleListTestbenches(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
defaultLibrary = "PoC"
if (args.SolutionID is not None):
solutionName = args.SolutionID
print("Solution name: {0}".format(solutionName))
if self.PoCConfig.has_option("SOLUTION.Solutions", solutionName):
sectionName = "SOLUTION.{0}".format(solutionName)
print("Found registered solution:")
print(" Name: {0}".format(self.PoCConfig[sectionName]['Name']))
print(" Path: {0}".format(self.PoCConfig[sectionName]['Path']))
solutionRootPath = self.Directories.Root / self.PoCConfig[sectionName]['Path']
solutionConfigFile = solutionRootPath / ".PoC" / "solution.config.ini"
solutionDefaultsFile = solutionRootPath / ".PoC" / "solution.defaults.ini"
print(" sln files: {0!s} {1!s}".format(solutionConfigFile, solutionDefaultsFile))
self.LogVerbose("Reading solution file...")
self.LogDebug(" {0!s}".format(solutionConfigFile))
self.LogDebug(" {0!s}".format(solutionDefaultsFile))
if not solutionConfigFile.exists():
raise NotConfiguredException("Solution's {0} configuration file '{1!s}' does not exist.".format(solutionName, solutionConfigFile)) \
from FileNotFoundError(str(solutionConfigFile))
if not solutionDefaultsFile.exists():
raise NotConfiguredException("Solution's {0} defaults file '{1!s}' does not exist.".format(solutionName, solutionDefaultsFile)) \
from FileNotFoundError(str(solutionDefaultsFile))
self.__pocConfig.read(str(solutionConfigFile))
self.__pocConfig.read(str(solutionDefaultsFile))
section = self.PoCConfig['PROJECT.Projects']
defaultLibrary = section['DefaultLibrary']
print("Solution:")
print(" Name: {0}".format(section['Name']))
print(" Default library: {0}".format(defaultLibrary))
print(" Projects:")
for item in section:
if (section[item] in ["PoCProject", "ISEProject", "VivadoProject", "QuartusProject"]):
sectionName2 = "PROJECT.{0}".format(item)
print(" {0}".format(self.PoCConfig[sectionName2]['Name']))
print(" Namespace roots:")
for item in section:
if (section[item] == "Library"):
libraryPrefix = item
print(" {0: <16} {1}".format(self.PoCConfig[libraryPrefix]['Name'], libraryPrefix))
self.Root.AddLibrary(libraryPrefix, libraryPrefix)
if (args.TestbenchKind is None):
tbFilter = TestbenchKind.All
else:
tbFilter = TestbenchKind.Unknown
for kind in args.TestbenchKind.lower().split(","):
if (kind == "vhdl"): tbFilter |= TestbenchKind.VHDLTestbench
elif (kind == "cocotb"): tbFilter |= TestbenchKind.CocoTestbench
else: raise CommonException("Argument --kind has an unknown value '{0}'.".format(kind))
fqnList = self._ExtractFQNs(args.FQN, defaultLibrary)
for fqn in fqnList:
self.LogNormal("")
entity = fqn.Entity
if (isinstance(entity, WildCard)):
for testbench in entity.GetTestbenches(tbFilter):
print(str(testbench))
else:
testbench = entity.GetTestbenches(tbFilter)
print(str(testbench))
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "asim" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("asim", help="Simulate a PoC Entity with Aldec Active-HDL.", description=dedent("""\
Simulate a PoC Entity with Aldec Active-HDL.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@VHDLVersionAttribute()
@SimulationStepsAttribute()
[docs] def HandleActiveHDLSimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
vhdlVersion = self._ExtractVHDLVersion(args.VHDLVersion)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
# create a GHDLSimulator instance and prepare it
simulator = ActiveHDLSimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=vhdlVersion)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ----------------------------------------------------------------------------
# create the sub-parser for the "ghdl" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("ghdl", help="Simulate a PoC Entity with GHDL.", description=dedent("""\
Simulate a PoC Entity with GHDL.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@VHDLVersionAttribute()
@SimulationStepsAttribute()
@ArgumentAttribute("--reproducer", metavar="Name", dest="CreateReproducer", help="Create a bug reproducer")
[docs] def HandleGHDLSimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
config = GHDLConfiguration(self)
if (not config.IsSupportedPlatform()): raise PlatformNotSupportedException()
if (not config.IsConfigured()): raise NotConfiguredException("GHDL is not configured on this system.")
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
vhdlVersion = self._ExtractVHDLVersion(args.VHDLVersion)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
simulator = GHDLSimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=vhdlVersion)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ----------------------------------------------------------------------------
# create the sub-parser for the "isim" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("isim", help="Simulate a PoC Entity with Xilinx ISE Simulator (iSim).", description=dedent("""\
Simulate a PoC Entity with Xilinx ISE Simulator (iSim).
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@SimulationStepsAttribute()
[docs] def HandleISESimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
self._CheckISEEnvironment()
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
simulator = ISESimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=VHDLVersion.VHDL93)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ----------------------------------------------------------------------------
# create the sub-parser for the "vsim" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("vsim", help="Simulate a PoC Entity with Mentor QuestaSim or ModelSim (vsim).", description=dedent("""\
Simulate a PoC Entity with Mentor QuestaSim or ModelSim (vsim).
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@VHDLVersionAttribute()
@SimulationStepsAttribute()
[docs] def HandleQuestaSimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
vhdlVersion = self._ExtractVHDLVersion(args.VHDLVersion)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
simulator = QuestaSimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=vhdlVersion)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ----------------------------------------------------------------------------
# create the sub-parser for the "xsim" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("xsim", help="Simulate a PoC Entity with Xilinx Vivado Simulator (xSim).", description=dedent("""\
Simulate a PoC Entity with Xilinx Vivado Simulator (xSim).
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@VHDLVersionAttribute()
@SimulationStepsAttribute()
[docs] def HandleVivadoSimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
self._CheckVivadoEnvironment()
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
# FIXME: VHDL-2008 is broken in Vivado 2016.1 -> use VHDL-93 by default
vhdlVersion = self._ExtractVHDLVersion(args.VHDLVersion, defaultVersion=VHDLVersion.VHDL93)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
simulator = VivadoSimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=vhdlVersion)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ----------------------------------------------------------------------------
# create the sub-parser for the "cocotb" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("cocotb", help="Simulate a PoC Entity with Cocotb and QuestaSim.", description=dedent("""\
Simulate a PoC Entity with Cocotb and QuestaSim.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@SimulationStepsAttribute()
[docs] def HandleCocotbSimulation(self, args):
self.PrintHeadline()
self.__PrepareForSimulation()
# check if QuestaSim is configured
if (len(self.PoCConfig.options("INSTALL.Mentor.QuestaSim")) == 0):
if (len(self.PoCConfig.options("INSTALL.Altera.ModelSim")) == 0):
raise NotConfiguredException("Neither Mentor QuestaSim, Mentor ModelSim nor ModelSim Altera Edition are configured on this system.")
fqnList = self._ExtractFQNs(args.FQN)
board = self._ExtractBoard(args.BoardName, args.DeviceName)
simulationSteps = self._ExtractSimulationSteps(args.GUIMode, args.Analyze, args.Elaborate, False, args.Recompile, args.Simulate, args.ShowWave, args.Resimulate, args.ShowReport, False)
# create a CocotbSimulator instance and prepare it
simulator = CocotbSimulator(self, self.DryRun, simulationSteps)
allPassed = simulator.RunAll(fqnList, board=board, vhdlVersion=VHDLVersion.VHDL2008)
Exit.exit(1 if ((SimulationSteps.Simulate in simulationSteps) and not allPassed) else 0)
# ============================================================================
# Synthesis commands
# ============================================================================
# create the sub-parser for the "list-netlist" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Simulation commands")
@CommandAttribute("list-netlist", help="List all netlists.", description=dedent("""\
List all netlists.
"""))
@PoCEntityAttribute()
@ArgumentAttribute("--kind", metavar="Kind", dest="NetlistKind", help="Netlist kind: Lattice | Quartus | XST | CoreGen")
[docs] def HandleListNetlist(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
if (args.NetlistKind is None):
nlFilter = NetlistKind.All
else:
nlFilter = NetlistKind.Unknown
for kind in args.TestbenchKind.lower().split(","):
if (kind == "lattice"): nlFilter |= NetlistKind.LatticeNetlist
elif (kind == "quartus"): nlFilter |= NetlistKind.QuartusNetlist
elif (kind == "xst"): nlFilter |= NetlistKind.XstNetlist
elif (kind == "coregen"): nlFilter |= NetlistKind.CoreGeneratorNetlist
elif (kind == "vivado"): nlFilter |= NetlistKind.VivadoNetlist
else: raise CommonException("Argument --kind has an unknown value '{0}'.".format(kind))
fqnList = self._ExtractFQNs(args.FQN)
for fqn in fqnList:
entity = fqn.Entity
if (isinstance(entity, WildCard)):
for testbench in entity.GetNetlists(nlFilter):
print(str(testbench))
else:
testbench = entity.GetNetlists(nlFilter)
print(str(testbench))
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "ise" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("ise", help="Generate any IP core for the Xilinx ISE tool chain.", description=dedent("""\
Generate any IP core for the Xilinx ISE tool chain.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleISECompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
self._CheckISEEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = ISECompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "coregen" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("coregen", help="Generate an IP core with Xilinx ISE Core Generator.", description=dedent("""\
Generate an IP core with Xilinx ISE Core Generator.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleCoreGeneratorCompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
self._CheckISEEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = XCOCompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "xst" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("xst", help="Compile a PoC IP core with Xilinx ISE XST to a netlist.", description=dedent("""\
Compile a PoC IP core with Xilinx ISE XST to a netlist.
:ref:`IP:PoC.Mem`
foooo baaarr.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleXstCompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
self._CheckISEEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = XSTCompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "xci" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("xci", help="Generate an IP core from Xilinx Vivado IP Catalog.", description=dedent("""\
Generate an IP core from Xilinx Vivado IP Catalog.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleIpCatalogCompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
self._CheckISEEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = XCICompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "vivado" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("vivado", help="Compile a PoC IP core with Xilinx Vivado Synth to a design checkpoint.", description=dedent("""\
Compile a PoC IP core with Xilinx Vivado Synth to a design checkpoint.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleVivadoCompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
self._CheckVivadoEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = VivadoCompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "quartus" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("quartus", help="Compile a PoC IP core with Altera Quartus II Map to a netlist.", description=dedent("""\
Compile a PoC IP core with Altera Quartus II Map to a netlist.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleQuartusCompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
# TODO: check env variables
# self._CheckQuartusEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = MapCompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# ----------------------------------------------------------------------------
# create the sub-parser for the "lattice" command
# ----------------------------------------------------------------------------
@CommandGroupAttribute("Synthesis commands")
@CommandAttribute("lse", help="Compile a PoC IP core with Lattice Diamond LSE to a netlist.", description=dedent("""\
Compile a PoC IP core with Lattice Diamond LSE to a netlist.
"""))
@PoCEntityAttribute()
@BoardDeviceAttributeGroup()
@CompileStepsAttribute()
[docs] def HandleLSECompilation(self, args):
self.PrintHeadline()
self.__PrepareForSynthesis()
# TODO: check env variables
# self._CheckLatticeEnvironment()
fqnList = self._ExtractFQNs(args.FQN, defaultType=EntityTypes.NetList)
board = self._ExtractBoard(args.BoardName, args.DeviceName, force=True)
compiler = LSECompiler(self, self.DryRun, args.NoCleanUp)
compiler.RunAll(fqnList, board)
Exit.exit()
# main program
[docs]def main(): # mccabe:disable=MC0001
"""This is the entry point for PoC.py written as a function.
1. It extracts common flags from the script's arguments list, before :py:class:`~argparse.ArgumentParser` is fully loaded.
2. It initializes colorama for colored outputs
3. It creates an instance of PoC and hands over to class based execution. All is wrapped in a big ``try..except`` block to catch every unhandled exception.
4. Shutdown the script and return its exit code.
"""
dryRun = "--dryrun" in sys_argv
debug = "-d" in sys_argv
verbose = "-v" in sys_argv
quiet = "-q" in sys_argv
# configure Exit class
Exit.quiet = quiet
try:
Init.init()
# handover to a class instance
poc = PileOfCores(debug, verbose, quiet, dryRun)
poc.Run()
Exit.exit()
except (CommonException, ConfigurationException, SimulatorException, CompilerException) as ex:
print("{RED}ERROR:{NOCOLOR} {message}".format(message=ex.message, **Init.Foreground))
cause = ex.__cause__
if isinstance(cause, FileNotFoundError):
print("{YELLOW} FileNotFound:{NOCOLOR} '{cause}'".format(cause=str(cause), **Init.Foreground))
elif isinstance(cause, NotADirectoryError):
print("{YELLOW} NotADirectory:{NOCOLOR} '{cause}'".format(cause=str(cause), **Init.Foreground))
elif isinstance(cause, DuplicateOptionError):
print("{YELLOW} DuplicateOptionError:{NOCOLOR} '{cause}'".format(cause=str(cause), **Init.Foreground))
elif isinstance(cause, ConfigParser_Error):
print("{YELLOW} configparser.Error:{NOCOLOR} '{cause}'".format(cause=str(cause), **Init.Foreground))
elif isinstance(cause, ParserException):
print("{YELLOW} ParserException:{NOCOLOR} {cause}".format(cause=str(cause), **Init.Foreground))
cause = cause.__cause__
if (cause is not None):
print("{YELLOW} {name}:{NOCOLOR} {cause}".format(name=cause.__class__.__name__, cause= str(cause), **Init.Foreground))
elif isinstance(cause, ToolChainException):
print("{YELLOW} {name}:{NOCOLOR} {cause}".format(name=cause.__class__.__name__, cause=str(cause), **Init.Foreground))
cause = cause.__cause__
if (cause is not None):
if isinstance(cause, OSError):
print("{YELLOW} {name}:{NOCOLOR} {cause}".format(name=cause.__class__.__name__, cause=str(cause), **Init.Foreground))
else:
print(" Possible causes:")
print(" - The compile order is broken.")
print(" - A source file was not compiled and an old file got used.")
if (not (verbose or debug)):
print()
print("{CYAN} Use '-v' for verbose or '-d' for debug to print out extended messages.{NOCOLOR}".format(**Init.Foreground))
Exit.exit(1)
except EnvironmentException as ex: Exit.printEnvironmentException(ex)
except NotConfiguredException as ex: Exit.printNotConfiguredException(ex)
except PlatformNotSupportedException as ex: Exit.printPlatformNotSupportedException(ex)
except ExceptionBase as ex: Exit.printExceptionBase(ex)
except NotImplementedError as ex: Exit.printNotImplementedError(ex)
except Exception as ex: Exit.printException(ex)
# entry point
if __name__ == "__main__":
Exit.versionCheck((3,5,0))
main()
# else:
# print(__name__)
# Exit.printThisIsNoLibraryFile(PoC.HeadLine)