# 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 Class: Intel Quartus specific classes
#
# License:
# ==============================================================================
# Copyright 2017-2018 Patrick Lehmann - Bötzingen, Germany
# Copyright 2007-2016 Technische Universität 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,
# 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 collections import OrderedDict
from enum import unique
from subprocess import check_output, STDOUT
from lib.Functions import Init
from pyIPCMI.ToolChain import ConfigurationException, Edition, EditionDescription, ToolSelector
from pyIPCMI.ToolChain.Altera.Quartus import QuartusException as Altera_QuartusException, Configuration as Altera_Quartus_Configuration, Quartus as Altera_Quartus, Map as Altera_Quartus_Map
from pyIPCMI.ToolChain.Intel import IntelException
__api__ = [
'QuartusException',
'Configuration',
'Quartus',
'Map'
]
__all__ = __api__
[docs]class QuartusException(IntelException, Altera_QuartusException):
pass
@unique
class IntelQuartusPrimeEditions(Edition):
"""Enumeration of all Quartus Prime editions provided by Mentor Graphics itself."""
QuartusPrime = EditionDescription(Name="Quartus Prime", Section=None)
QuartusPrimeLite = EditionDescription(Name="Quartus Prime Lite", Section=None)
[docs]class Configuration(Altera_Quartus_Configuration):
_vendor = "Intel" #: The name of the tools vendor.
_toolName = "Intel Quartus Prime" #: The name of the tool.
_section = "INSTALL.Intel.Quartus" #: The name of the configuration section. Pattern: ``INSTALL.Vendor.ToolName``.
_multiVersionSupport = True #: Intel Quartus supports multiple versions installed on the same system.
[docs] def CheckDependency(self):
"""Check if general Intel support is configured in pyIPCMI."""
return (len(self._host.Config['INSTALL.Intel']) != 0)
def __CheckQuartusVersion(self, binPath, version):
if (self._host.Platform == "Windows"):
quartusPath = binPath / "quartus_sh.exe"
else:
quartusPath = binPath / "quartus_sh"
if not quartusPath.exists():
raise ConfigurationException("Executable '{0!s}' not found.".format(quartusPath)) from FileNotFoundError(
str(quartusPath))
output = check_output([str(quartusPath), "-v"], universal_newlines=True, stderr=STDOUT)
if "Version {0}".format(version) not in output:
raise ConfigurationException("Quartus version mismatch. Expected version {0}.".format(version))
class QuartusPrimeConfiguration(Configuration):
_toolName = "Intel Quartus Prime" #: The name of the tool.
_section = "INSTALL.Intel.QuartusPrime" #: The name of the configuration section. Pattern: ``INSTALL.Vendor.ToolName``.
_template = {
"Windows": {
_section: {
"Version": "17.0",
"SectionName": ("%{PathWithRoot}#${Version}", None),
"InstallationDirectory": ("${${SectionName}:InstallationDirectory}", "${INSTALL.Intel:InstallationDirectory}/${Version}/quartus"),
"BinaryDirectory": ("${${SectionName}:BinaryDirectory}", "${InstallationDirectory}/bin64")
}
},
"Linux": {
_section: {
"Version": "17.0",
"SectionName": ("%{PathWithRoot}#${Version}", None),
"InstallationDirectory": ("${${SectionName}:InstallationDirectory}", "${INSTALL.Intel:InstallationDirectory}/${Version}/quartus"),
"BinaryDirectory": ("${${SectionName}:BinaryDirectory}", "${InstallationDirectory}/bin")
}
}
} #: The template for the configuration sections represented as nested dictionaries.
def _ConfigureEdition(self):
"""Configure ModelSim PE for Mentor Graphics."""
sectionName = self._section
if self._multiVersionSupport:
sectionName = self._host.Config[sectionName]['SectionName']
configSection = self._host.Config[sectionName]
defaultEdition = MentorModelSimPEEditions.Parse(configSection['Edition'])
edition = super()._ConfigureEdition(MentorModelSimPEEditions, defaultEdition)
if (edition is not defaultEdition):
configSection['Edition'] = edition.Name
self._host.Config.Interpolation.clear_cache()
if self._multiVersionSupport:
sectionName = self._host.Config[self._section]['SectionName']
else:
sectionName = self._section
configSection = self._host.Config[sectionName]
binaryDirectory = self._host.Config.get(sectionName, 'BinaryDirectory', raw=True)
if (edition is MentorModelSimPEEditions.ModelSimPE):
toolInstallationName = "ModelSim PE"
binaryDirectory = binaryDirectory.replace("win32peedu", "win32pe")
elif (edition is MentorModelSimPEEditions.ModelSimPEEducation):
toolInstallationName = "ModelSim PE Student Edition"
binaryDirectory = binaryDirectory.replace("win32pe", "win32pe_edu")
else:
toolInstallationName = None
configSection['ToolInstallationName'] = toolInstallationName
configSection['BinaryDirectory'] = binaryDirectory
class QuartusPrimeLiteConfiguration(Configuration):
_toolName = "Intel Quartus Prime Lite" #: The name of the tool.
_section = "INSTALL.Intel.QuartusPrime" #: The name of the configuration section. Pattern: ``INSTALL.Vendor.ToolName``.
_template = {
"Windows": {
_section: {
"Version": "17.0",
"SectionName": ("%{PathWithRoot}#${Version}", None),
"InstallationDirectory": ("${${SectionName}:InstallationDirectory}", "${INSTALL.Intel:InstallationDirectory}/${Version}/quartus"),
"BinaryDirectory": ("${${SectionName}:BinaryDirectory}", "${InstallationDirectory}/bin64")
}
},
"Linux": {
_section: {
"Version": "17.0",
"SectionName": ("%{PathWithRoot}#${Version}", None),
"InstallationDirectory": ("${${SectionName}:InstallationDirectory}", "${INSTALL.Intel:InstallationDirectory}/${Version}/quartus"),
"BinaryDirectory": ("${${SectionName}:BinaryDirectory}", "${InstallationDirectory}/bin")
}
}
} #: The template for the configuration sections represented as nested dictionaries.
def _ConfigureEdition(self):
"""Configure ModelSim PE for Mentor Graphics."""
sectionName = self._section
if self._multiVersionSupport:
sectionName = self._host.Config[sectionName]['SectionName']
configSection = self._host.Config[sectionName]
defaultEdition = MentorModelSimPEEditions.Parse(configSection['Edition'])
edition = super()._ConfigureEdition(MentorModelSimPEEditions, defaultEdition)
if (edition is not defaultEdition):
configSection['Edition'] = edition.Name
self._host.Config.Interpolation.clear_cache()
if self._multiVersionSupport:
sectionName = self._host.Config[self._section]['SectionName']
else:
sectionName = self._section
configSection = self._host.Config[sectionName]
binaryDirectory = self._host.Config.get(sectionName, 'BinaryDirectory', raw=True)
if (edition is MentorModelSimPEEditions.ModelSimPE):
toolInstallationName = "ModelSim PE"
binaryDirectory = binaryDirectory.replace("win32peedu", "win32pe")
elif (edition is MentorModelSimPEEditions.ModelSimPEEducation):
toolInstallationName = "ModelSim PE Student Edition"
binaryDirectory = binaryDirectory.replace("win32pe", "win32pe_edu")
else:
toolInstallationName = None
configSection['ToolInstallationName'] = toolInstallationName
configSection['BinaryDirectory'] = binaryDirectory
class Selector(ToolSelector):
_toolName = "Quartus"
def Select(self):
editions = self._GetConfiguredEditions(IntelQuartusPrimeEditions)
if (len(editions) == 0):
self._host.LogWarning("No Quartus installation found.", indent=1)
self._host.Config['INSTALL.Quartus'] = OrderedDict()
elif (len(editions) == 1):
self._host.LogNormal("Default Quartus installation:", indent=1)
self._host.LogNormal("Set to {0}".format(editions[0].Name), indent=2)
self._host.Config['INSTALL.Quartus']['SectionName'] = editions[0].Section
else:
self._host.LogNormal("Select Quartus installation:", indent=1)
defaultEdition = IntelQuartusPrimeEditions.ModelSimSE64
if defaultEdition not in editions:
defaultEdition = editions[0]
selectedEdition = self._AskSelection(editions, defaultEdition)
self._host.Config['INSTALL.Quartus']['SectionName'] = selectedEdition.Section
[docs]class Quartus(Altera_Quartus):
[docs] def GetMap(self):
return Map(self)
# def GetTclShell(self):
# return TclShell(self)
[docs]class Map(Altera_Quartus_Map):
pass