Source code for pyIPCMI.ToolChain.Intel.Quartus

# 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)
[docs] def ConfigureForAll(self): try: if (not self._AskInstalled("Is Intel Quartus Prime installed on your system?")): self.ClearSection() else: # Configure Quartus version version = self._ConfigureVersion() if self._multiVersionSupport: self.PrepareVersionedSections() sectionName = self._host.Config[self._section]['SectionName'] self._host.Config[sectionName]['Version'] = version self._ConfigureInstallationDirectory() binPath = self._ConfigureBinaryDirectory() self.LogNormal("Checking Altera Quartus version... (this may take a few seconds)", indent=1) self.__CheckQuartusVersion(binPath, version) self._host.LogNormal("{DARK_GREEN}Intel Quartus Prime is now configured.{NOCOLOR}".format(**Init.Foreground), indent=1) except ConfigurationException: self.ClearSection() raise
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