ToolChains.Aldec.ActiveHDL

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.
• VHDLCompiler: Abstraction layer of Active-HDL’s VHDL compiler ‘vcom’.
• StandaloneSimulator: Abstraction layer of Active-HDL’s VHDL standalone simulator ‘vsimsa’.
• Simulator: Abstraction layer of Active-HDL’s VHDL simulator ‘vsim’.
• ActiveHDLVHDLLibraryTool: Abstraction layer of Active-HDL’s VHDL library management tool ‘vlib’.

Functions

• VHDLCompilerFilter(): A line based output stream filter for Active-HDL’s VHDL compiler.
• SimulatorFilter(): A line based output stream filter for Active-HDL’s VHDL simulator.
• VHDLLibraryToolFilter(): A line based output stream filter for Active-HDL’s VHDL library management

exception ToolChains.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 ToolChains.Aldec.ActiveHDL.AldecActiveHDLEditions(name, section)

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

Inheritance

Members

StandardEdition = 1

StudentEdition = 2

class ToolChains.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 ToolChains.Aldec.ActiveHDL.Configuration(host: 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': {'InstallationDirectory': ('${${SectionName}:InstallationDirectory}', '${INSTALL.Aldec:InstallationDirectory}/Active-HDL'), 'Version': '10.3', 'BinaryDirectory': ('${${SectionName}:BinaryDirectory}', '${InstallationDirectory}/BIN'), 'SectionName': ('%{PathWithRoot}#${Version}', None), 'Edition': ('${${SectionName}:Edition}', 'Active-HDL')}}}

The template for the configuration sections represented as nested dictionaries.

CheckDependency()

Check if general Aldec support is configured in PoC.

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.

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 ToolChains.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 ToolChains.Aldec.ActiveHDL.VHDLCompiler(toolchain: ToolChains.ToolMixIn)

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

Inheritance

Members

HasWarnings

HasErrors

class Executable

_value = None

class VHDLCompiler.FlagNoRangeCheck

_name = 'norangecheck'

_value = None

class VHDLCompiler.SwitchVHDLVersion

_pattern = '-{1}'

_name = ''

_value = None

class VHDLCompiler.SwitchVHDLLibrary

_name = 'work'

_value = None

class VHDLCompiler.ArgSourceFile

_value = None

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

VHDLCompiler.Compile()

VHDLCompiler.GetReader()

VHDLCompiler.Log(entry, condition=True)

Write an entry to the local logger.

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

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

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

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

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

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

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

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

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

VHDLCompiler.Logger

Return the local logger instance.

VHDLCompiler.Path

VHDLCompiler.ReadUntilBoundary(indent=0)

VHDLCompiler.Send(line, end='\n')

VHDLCompiler.SendBoundary()

VHDLCompiler.StartProcess(parameterList)

VHDLCompiler.Terminate()

VHDLCompiler._POC_BOUNDARY = '====== POC BOUNDARY ======'

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

class ToolChains.Aldec.ActiveHDL.StandaloneSimulator(toolchain: ToolChains.ToolMixIn)

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

Inheritance

Members

HasWarnings

HasErrors

class Executable

_value = None

class StandaloneSimulator.SwitchBatchCommand

_name = 'do'

_value = None

StandaloneSimulator.Parameters = [<class 'ToolChains.Aldec.ActiveHDL.StandaloneSimulator.Executable'>, <class 'ToolChains.Aldec.ActiveHDL.StandaloneSimulator.SwitchBatchCommand'>]

StandaloneSimulator.Simulate()

StandaloneSimulator.GetReader()

StandaloneSimulator.Log(entry, condition=True)

Write an entry to the local logger.

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

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

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

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

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

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

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

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

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

StandaloneSimulator.Logger

Return the local logger instance.

StandaloneSimulator.Path

StandaloneSimulator.ReadUntilBoundary(indent=0)

StandaloneSimulator.Send(line, end='\n')

StandaloneSimulator.SendBoundary()

StandaloneSimulator.StartProcess(parameterList)

StandaloneSimulator.Terminate()

StandaloneSimulator._POC_BOUNDARY = '====== POC BOUNDARY ======'

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

class ToolChains.Aldec.ActiveHDL.Simulator(platform, dryrun, binaryDirectoryPath, version, logger=None)

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

Inheritance

Members

class Executable

_value = None

class Simulator.SwitchBatchCommand

_name = 'do'

Simulator.Parameters = [<class 'ToolChains.Aldec.ActiveHDL.Simulator.Executable'>, <class 'ToolChains.Aldec.ActiveHDL.Simulator.SwitchBatchCommand'>]

Simulator.Simulate()

Simulator.GetReader()

Simulator.Log(entry, condition=True)

Write an entry to the local logger.

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

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

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

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

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

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

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

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

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

Simulator.Logger

Return the local logger instance.

Simulator.Path

Simulator.ReadUntilBoundary(indent=0)

Simulator.Send(line, end='\n')

Simulator.SendBoundary()

Simulator.StartProcess(parameterList)

Simulator.Terminate()

Simulator._POC_BOUNDARY = '====== POC BOUNDARY ======'

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

class ToolChains.Aldec.ActiveHDL.ActiveHDLVHDLLibraryTool(toolchain: ToolChains.ToolMixIn)

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

Inheritance

Members

HasWarnings

HasErrors

class Executable

_value = None

class ActiveHDLVHDLLibraryTool.SwitchLibraryName

_value = None

ActiveHDLVHDLLibraryTool.Parameters = [<class 'ToolChains.Aldec.ActiveHDL.ActiveHDLVHDLLibraryTool.Executable'>, <class 'ToolChains.Aldec.ActiveHDL.ActiveHDLVHDLLibraryTool.SwitchLibraryName'>]

ActiveHDLVHDLLibraryTool.CreateLibrary()

ActiveHDLVHDLLibraryTool.GetReader()

ActiveHDLVHDLLibraryTool.Log(entry, condition=True)

Write an entry to the local logger.

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

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

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

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

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

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

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

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

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

ActiveHDLVHDLLibraryTool.Logger

Return the local logger instance.

ActiveHDLVHDLLibraryTool.Path

ActiveHDLVHDLLibraryTool.ReadUntilBoundary(indent=0)

ActiveHDLVHDLLibraryTool.Send(line, end='\n')

ActiveHDLVHDLLibraryTool.SendBoundary()

ActiveHDLVHDLLibraryTool.StartProcess(parameterList)

ActiveHDLVHDLLibraryTool.Terminate()

ActiveHDLVHDLLibraryTool._POC_BOUNDARY = '====== POC BOUNDARY ======'

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

Functions

ToolChains.Aldec.ActiveHDL.VHDLCompilerFilter(gen)

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

ToolChains.Aldec.ActiveHDL.SimulatorFilter(gen)

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

ToolChains.Aldec.ActiveHDL.VHDLLibraryToolFilter(gen)

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