pyIPCMI.ToolChain.Aldec.ActiveHDL.py

Exceptions

• ActiveHDLException: An ActiveHDLException is raised if Active-HDL catches a system exception.

Classes

• AldecActiveHDLEditions: Enumeration of all Active-HDL editions provided by Aldec itself.
• ActiveHDLEditions: Enumeration of all Active-HDL editions provided by Aldec inclusive editions
• Configuration: Base class for all tool Configuration classes.
• ActiveHDL: Factory for executable abstractions in Active-HDL.
• VHDLLibraryTool: Abstraction layer of Active-HDL’s VHDL library management tool ‘vlib’.
• VHDLCompiler: Abstraction layer of Active-HDL’s VHDL compiler ‘vcom’.
• VHDLStandaloneSimulator: Abstraction layer of Active-HDL’s VHDL standalone simulator ‘vsimsa’.

Functions

• VLibFilter(): A line based output stream filter for Active-HDL’s VHDL library management
• VComFilter(): A line based output stream filter for Active-HDL’s VHDL compiler.
• VSimFilter(): A line based output stream filter for Active-HDL’s VHDL simulator.

exception pyIPCMI.ToolChain.Aldec.ActiveHDL.ActiveHDLException(message='')

An ActiveHDLException is raised if Active-HDL catches a system exception.

Inheritance

Members

__init__(message='')

Exception initializer

Parameters:message (str) – The exception message.

__str__()

Returns the exception’s message text.

args

class pyIPCMI.ToolChain.Aldec.ActiveHDL.AldecActiveHDLEditions(name, section)

Enumeration of all Active-HDL editions provided by Aldec itself.

Inheritance

Members

StandardEdition = 1

StudentEdition = 2

class pyIPCMI.ToolChain.Aldec.ActiveHDL.ActiveHDLEditions(name, section)

Enumeration of all Active-HDL editions provided by Aldec inclusive editions shipped by other vendors.

Inheritance

Members

StandardEdition = 1

LatticeEdition = 2

class pyIPCMI.ToolChain.Aldec.ActiveHDL.Configuration(host: pyIPCMI.Base.IHost)

Inheritance

Members

_vendor = 'Aldec'

The name of the tools vendor.

_toolName = 'Aldec Active-HDL'

The name of the tool.

_section = 'INSTALL.Aldec.ActiveHDL'

The name of the configuration section. Pattern: INSTALL.Vendor.ToolName.

_multiVersionSupport = True

Aldec Active-HDL supports multiple versions installed on the same system.

_template = {'Windows': {'INSTALL.Aldec.ActiveHDL': {'SectionName': ('%{PathWithRoot}#${Version}', None), 'Version': '10.3', 'Edition': ('${${SectionName}:Edition}', 'Active-HDL'), 'BinaryDirectory': ('${${SectionName}:BinaryDirectory}', '${InstallationDirectory}/BIN'), 'InstallationDirectory': ('${${SectionName}:InstallationDirectory}', '${INSTALL.Aldec:InstallationDirectory}/Active-HDL')}}}

The template for the configuration sections represented as nested dictionaries.

CheckDependency()

Check if general Aldec support is configured in pyIPCMI.

ConfigureForAll()

Configuration routine for Aldec Active-HDL on all supported platforms.

1. Ask if Active-HDL is installed.

• Pass → skip this configuration. Don’t change existing settings.
• Yes → collect installation information for Active-HDL.
• No → clear the Active-HDL configuration section.

1. Ask for Active-HDL’s version.
2. Ask for Active-HDL’s edition (normal, student).
3. Ask for Active-HDL’s installation directory.

_ConfigureEdition()

Configure Active-HDL for Aldec.

ClearSection(writeWarnings=False)

Clear the configuration section associated to this Configuration class.

ConfigureForDarwin()

Start the configuration procedure for Darwin.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Darwin specific configuration routine.

ConfigureForLinux()

Start the configuration procedure for Linux.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Linux specific configuration routine.

ConfigureForWindows()

Start the configuration procedure for Windows.

This method is a wrapper for ConfigureForAll(). Overwrite this method to implement a Windows specific configuration routine.

classmethod GetSections(platform)

Return all section names for this configuration.

Host

Return the hosting object.

IsConfigured()

Return true if the configurations section is configured

IsSupportedPlatform()

Return true if the given platform is supported by this configuration routine.

Log(entry, condition=True)

Write an entry to the local logger.

LogDebug(*args, condition=True, **kwargs)

LogDryRun(*args, condition=True, **kwargs)

LogError(*args, condition=True, **kwargs)

LogFatal(*args, condition=True, **kwargs)

LogInfo(*args, condition=True, **kwargs)

LogNormal(*args, condition=True, **kwargs)

LogQuiet(*args, condition=True, **kwargs)

LogVerbose(*args, condition=True, **kwargs)

LogWarning(*args, condition=True, **kwargs)

Logger

Return the local logger instance.

PrepareOptions(writeWarnings=True)

PrepareSections(warningWasWritten, writeWarnings=True)

PrepareVersionedSections(writeWarnings=False)

RunPostConfigurationTasks()

Virtual method. Overwrite to execute post-configuration tasks.

SectionName

Return the configuration’s section name.

State

Return the configuration state.

_Ask(question, default, beforeDefault='', afterDefault='', indent=1)

_AskInstalled(question)

Ask a Yes/No/Pass question.

_AskYes_NoPass(question, indent=1)

Ask a yes/NO/pass question.

_Ask_YesNoPass(question, indent=1)

Ask a YES/no/pass question.

_Configuration__CheckActiveHDLVersion(binPath, version)

Compare the given Active-HDL version with the tool’s version string.

_ConfigureBinaryDirectory()

Updates section with value from _template and returns directory as Path object.

_ConfigureInstallationDirectory()

Asks for installation directory and updates section. Checks if entered directory exists and returns Path object. If no installation directory was configured before, then _GetDefaultInstallationDir is called.

_ConfigureVersion()

If no version was configured before, then _GetDefaultVersion is called. Asks for version and updates section. Returns version as string.

_GetDefaultEdition()

Returns unresolved default edition (str) from template.

Overwrite this method in a sub-class for automatic search of editions.

_GetDefaultInstallationDirectory()

Return unresolved default installation directory (str) from template.

Overwrite function in sub-class for automatic search of installation directory.

_GetDefaultOptionValue(optionName)

_GetDefaultVersion()

Returns unresolved default version (str) from template.

Overwrite this method in a sub-class for automatic search of version.

_PrintAvailableEditions(editions, selectedEdition)

Print all available editions and return the selected index.

_TestDefaultInstallPath(defaults)

Helper function for automatic search of installation directory.

_TryLog(*args, condition=True, **kwargs)

class pyIPCMI.ToolChain.Aldec.ActiveHDL.ActiveHDL(platform, dryrun, binaryDirectoryPath, version, logger=None)

Factory for executable abstractions in Active-HDL.

Inheritance

Members

GetVHDLLibraryTool()

Return an instance of Active-HDL’s VHDL library management tool ‘vlib’.

GetVHDLCompiler()

Return an instance of Active-HDL’s VHDL compiler ‘vcom’.

GetSimulator()

Return an instance of Active-HDL’s VHDL simulator ‘vsim’.

class pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLLibraryTool(toolchain: pyIPCMI.ToolChain.ToolMixIn)

Abstraction layer of Active-HDL’s VHDL library management tool ‘vlib’.

Inheritance

Members

class Executable

_value = None

class SwitchLibraryName

_value = None

Parameters = [<class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLLibraryTool.Executable'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLLibraryTool.SwitchLibraryName'>]

CreateLibrary()

GetReader()

HasErrors

True if errors or fatals errors were found while processing the output stream.

HasWarnings

True if errors or fatals errors were found while processing the output stream.

Log(entry, condition=True)

Write an entry to the local logger.

LogDebug(*args, condition=True, **kwargs)

LogDryRun(*args, condition=True, **kwargs)

LogError(*args, condition=True, **kwargs)

LogFatal(*args, condition=True, **kwargs)

LogInfo(*args, condition=True, **kwargs)

LogNormal(*args, condition=True, **kwargs)

LogQuiet(*args, condition=True, **kwargs)

LogVerbose(*args, condition=True, **kwargs)

LogWarning(*args, condition=True, **kwargs)

Logger

Return the local logger instance.

Path

ReadUntilBoundary(indent=0)

Send(line, end='\n')

SendBoundary()

StartProcess(parameterList)

Terminate()

_TryLog(*args, condition=True, **kwargs)

_pyIPCMI_BOUNDARY = '====== pyIPCMI BOUNDARY ======'

class pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler(toolchain: pyIPCMI.ToolChain.ToolMixIn)

Abstraction layer of Active-HDL’s VHDL compiler ‘vcom’.

Inheritance

Members

class Executable

_value = None

class FlagNoRangeCheck

_name = 'norangecheck'

_value = None

class SwitchVHDLVersion

_pattern = '-{1}'

_name = ''

_value = None

class SwitchVHDLLibrary

_name = 'work'

_value = None

class ArgSourceFile

_value = None

Parameters = [<class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler.Executable'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler.FlagNoRangeCheck'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler.SwitchVHDLVersion'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler.SwitchVHDLLibrary'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLCompiler.ArgSourceFile'>]

Compile()

GetReader()

HasErrors

True if errors or fatals errors were found while processing the output stream.

HasWarnings

True if errors or fatals errors were found while processing the output stream.

Log(entry, condition=True)

Write an entry to the local logger.

LogDebug(*args, condition=True, **kwargs)

LogDryRun(*args, condition=True, **kwargs)

LogError(*args, condition=True, **kwargs)

LogFatal(*args, condition=True, **kwargs)

LogInfo(*args, condition=True, **kwargs)

LogNormal(*args, condition=True, **kwargs)

LogQuiet(*args, condition=True, **kwargs)

LogVerbose(*args, condition=True, **kwargs)

LogWarning(*args, condition=True, **kwargs)

Logger

Return the local logger instance.

Path

ReadUntilBoundary(indent=0)

Send(line, end='\n')

SendBoundary()

StartProcess(parameterList)

Terminate()

_TryLog(*args, condition=True, **kwargs)

_pyIPCMI_BOUNDARY = '====== pyIPCMI BOUNDARY ======'

class pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLStandaloneSimulator(toolchain: pyIPCMI.ToolChain.ToolMixIn)

Abstraction layer of Active-HDL’s VHDL standalone simulator ‘vsimsa’.

Inheritance

Members

class Executable

_value = None

class SwitchBatchCommand

_name = 'do'

_value = None

Parameters = [<class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLStandaloneSimulator.Executable'>, <class 'pyIPCMI.ToolChain.Aldec.ActiveHDL.VHDLStandaloneSimulator.SwitchBatchCommand'>]

Simulate()

GetReader()

HasErrors

True if errors or fatals errors were found while processing the output stream.

HasWarnings

True if errors or fatals errors were found while processing the output stream.

Log(entry, condition=True)

Write an entry to the local logger.

LogDebug(*args, condition=True, **kwargs)

LogDryRun(*args, condition=True, **kwargs)

LogError(*args, condition=True, **kwargs)

LogFatal(*args, condition=True, **kwargs)

LogInfo(*args, condition=True, **kwargs)

LogNormal(*args, condition=True, **kwargs)

LogQuiet(*args, condition=True, **kwargs)

LogVerbose(*args, condition=True, **kwargs)

LogWarning(*args, condition=True, **kwargs)

Logger

Return the local logger instance.

Path

ReadUntilBoundary(indent=0)

Send(line, end='\n')

SendBoundary()

StartProcess(parameterList)

Terminate()

_TryLog(*args, condition=True, **kwargs)

_pyIPCMI_BOUNDARY = '====== pyIPCMI BOUNDARY ======'

Functions

pyIPCMI.ToolChain.Aldec.ActiveHDL.VLibFilter(gen)

A line based output stream filter for Active-HDL’s VHDL library management tool.

pyIPCMI.ToolChain.Aldec.ActiveHDL.VComFilter(gen)

A line based output stream filter for Active-HDL’s VHDL compiler.

pyIPCMI.ToolChain.Aldec.ActiveHDL.VSimFilter(gen)

A line based output stream filter for Active-HDL’s VHDL simulator.