Active HDL9.1SoftwareManual
Active HDL9.1SoftwareManual
Active HDL9.1SoftwareManual
Table Of Contents
Introduction .................................................................................................................................................... 1 System Requirements ................................................................................................................................... 1 Installation...................................................................................................................................................... 2 On-line Resources Access .......................................................................................................................... 14 Using the Product Help ................................................................................................................................ 15 Sample Designs .......................................................................................................................................... 17 Automated FPGA Design Flow Manager .................................................................................................... 19 Licensing Information .................................................................................................................................. 22 Important Network Licensing Information .................................................................................................... 25 Network Client Installation ........................................................................................................................... 29 Export/Import of Active-HDL Preferences ................................................................................................... 30 How to Reach Technical Support ................................................................................................................ 32
Introduction
Active-HDL offers a completely integrated design entry and verification environment for HDL designs. The product also supports C/C++ and SystemC languages as well as OVA, PSL, and SVA assertions and allows mixed SystemC/VHDL/Verilog and EDIF simulations. This User Guide was created to better acquaint users with the process of the software installation, using the Product Help files, configuration, and the use of the Design Flow Manager, licensing, etc. NOTES: 1. In order to start working with Active-HDL, you need to have a valid license file. Users who have a valid maintenance contract will be able to use newer versions of Active-HDL. 2. If you are using the software for evaluation purposes, it does require a license. Please see the Licensing Information section for more details. The Product Help and tutorials are valuable resources for users at all stages of HDL and C design experience. In the beginning stages of using the tool, the Product Help will explain the functionality and features of the product. As your familiarity with the product grows, the help files can be used as a source of information on utilizing advanced Active-HDL features in your designs.
System Requirements
Active-HDL requires: A Pentium PC or Higher/Compatible 256MB of physical memory (512MB recommended, see also the notes below) Monitor resolution: 1280 x 1024 (recommended) Microsoft Windows XP with Service Pack 1 or higher, Windows XP Professional x64 Edition, Windows Server 2003 with Service Pack 1 or Windows Server 2008, Windows Vista, Windows Vista x64 Edition, Windows 7, or Windows 7 x64 Edition Microsoft Internet Explorer version 4.0 or higher (see notes) Hard disk drive with at least 660MB of free space for minimal installation including only standard VHDL and Verilog libraries (2.65GB for full installation including the Active-CAD Import feature, SystemC libraries, all available system/vendor libraries, and sample designs)
NOTES: The hard disk drive requirements calculated by the installation program are approximate and depend on both your operating system and chosen file system. The amount of available physical memory limits the maximum size of the design that can be simulated in Active-HDL. Although being a 32-bit application, Active-HDL supports the simulation of designs that require over 2 GB of memory to run. To allow using this feature on a 32-bit operating system, the system must be running in the 3 GB memory mode. On the 64-bit operating systems this feature is available by default. The additional information on how to enable the operating system capability and use the extended memory resources is available on the following Microsoft web page: http://www.microsoft.com/whdc/system/platform/server/PAE/PAEmem.mspx For full functionality, it is recommended to install the Microsoft Internet Explorer version 5.0 or higher. Active-HDL 9.1 requires the Microsoft Internet Explorer version 4.0 or higher to be installed on your system. If not, the following system components will not be available: - Dataflow window - Query window of the Block Diagram Editor - Product Help
If you have a different Internet browser (other than Internet Explorer) installed on your system, you can continue to use it without any problems. Internet Explorer can be installed as a non-default browser and be used only by Active-HDL.
Installation
When you receive your copy of Active-HDL, insert the DVD-ROM into your machines DVD-ROM drive. Active-HDL is equipped with an Auto-Run feature that will start the set-up process without having to locate the setup.exe file. At this point you have the option to read the release notes on the product or begin the installation process.
Active-HDL 9.1 User Guide After clicking the INSTALLATION button in the welcome screen, the installation process will begin. Click the Next button to proceed to the License Agreement screen.
Active-HDL 9.1 User Guide Before continuing the installation you will be asked to read the softwares licensing agreement. Read this section carefully. When you read and accept the terms of the license agreement, choose the Next button.
Active-HDL 9.1 User Guide Next, you will need to fill in the user information for the software and choose whether or not anyone else will be allowed to access the software from the machine it is installed on. Select Next to continue.
Destination Locations
After you have specified the user data, you should choose the destination path for the Active-HDL software to be installed on your machine. By default, Active-HDL already has a path selected and will create the required folders on your systems C drive. If you wish to select a new destination, choose the Browse button and locate space for both the softwares program files as well as any projects you will create with Active-HDL.
Active-HDL 9.1 User Guide You will also need to select the default location to store the design files. If you wish to change the destination, click the Browse button and select the new location. Click Next to continue.
Installed Components
The installation program of Active-HDL allows you to select components that will be copied or set up during the installation. You can also choose whether to install vendor HDL libraries. The selection results in the installation of different system and vendor libraries that are copied during the installation. The optional components and libraries can be selected in the dialog box shown below:
This dialog box provides the following options: Active-CAD Import When this option is enabled, you can install Active-CAD executables and auxiliary files necessary to import Active-CAD designs to the Active-HDL environment. The Active-CAD files are copied to the \Active subfolder of the installation directory if Active-HDL is installed on 32-bit versions of Windows. Since Active-CAD is not supported on 64-bit platforms, no files are installed even if this option is checked. If the option is not selected, the \Active subfolder is not created during the installation. Network Setup Installation This option adds an additional component that can be used to start and use Active-HDL from a remote computer (client). When the installation of Active-HDL is finished (on a server), the \NetSetup directory contains the setup program that can be run from a client computer and install on this computer the Active-HDL Network Client software. The installation of the Active-HDL Network Client contains only configuration files and files that are necessary to establish communication between the client machine and the workstation where Active-HDL is installed. SystemC Libraries If this check box is selected, the installation program will install SystemC Class Library files. The files are copied to the \SystemC subfolder of the Active-HDL installation directory. If this feature is not selected, the subfolder is not created during the installation.
Active-HDL 9.1 User Guide Run MATLAB/Simulink Interface Setup This option allows automatic installation and setup of the Active-HDL Co-simulation Interface to Simulink directly in the MATLAB environment. (The interface is required to start Active-HDLSimulink co-simulation. Prior to running the Active-HDL installation, the MATLAB software must be installed first.) The configuration process of the co-simulation interface is started during the Active-HDL installation. In the Simulink Interface Setup dialog box, you will be asked to enter the path to the MATLAB installation folder (use matlabroot command in MATLAB Console to retrieve its location). Clicking on the Next button adds the Active-HDL Blockset block to the Simulink Library Browser and installs the on-line documentation in MATLAB help system. If this option is disabled, you will still be able to setup the interface in MATLAB after the process of the Active-HDL installation is finished. The interface files are stored in the \Simulink subfolder of the Active-HDL installation directory regardless of whether the Run MATLAB/Simulink Interface Setup option is checked or not during the Active-HDL installation. Vendor HDL Libraries Checking this option allows you to select in the subsequent dialog box which VHDL and/or Verilog simulation/schematic libraries will be copied during the installation of Active-HDL.
Regardless of the selected set of simulation libraries, the functionality and supported features depend ultimately on the purchased license only. Active-HDL delivers the updated Product Help that is not limited and it provides the help system for all features. In the next stage of the installation process, you will need to choose which pre-installed IC vendor libraries you will require for your designs. All libraries are based on the latest files provided to Aldec at the time the software was produced. Please, check with the appropriate IC vendor for the latest library resources.
License Environment
The next step is to specify the license environment for Active-HDL. During the installation procedure of Active-HDL, you can select the license environment that will be used to protect the program. The license environment settings should be related to the type of the license you have purchased. The following settings are available in the Choose License Environment window:
Evaluation license, USB keylock driver installation This option allows starting Active-HDL 9.1 with different types of license and in several modes. The functionality and options available in the evaluation mode depend on features included in a license file that is required to start Active-HDL. The license file (license.dat) will use the Ethernet card number as the license hostid. When you receive the file, it should be copied to the \dat subdirectory in the Active-HDL installation folder. During the installation procedure, the ALDEC_LICENSE_FILE variable pointing to the location of license.dat is set by the setup program. By default, the variable is set to C:\Aldec\Active-HDL 9.1\Dat\license.dat. In order to receive evaluation license, send your license request to [email protected] or fill out the form at http://www.aldec.com/registration/evals.htm prior to downloading Active-HDL. You can
10
Active-HDL 9.1 User Guide also register the new version of Active-HDL and apply for an evaluation license file. In order to register the product, check the Register over the Web option in the last dialog box of the ActiveHDL Installation Wizard and then fill out the registration form. You should also select this option if you use the FLEXid keylock attached to the USB port of your computer. However, prior to choosing this type of licensing, make sure that your workstation supports the USB standard and that the USB keylock is disconnected from the USB port of your computer while installing Active-HDL. In this type of licensing, the installation program will automatically copy and install to your system all required drivers. It also requires the license file that should be copied to the \dat subdirectory in the Active-HDL installation folder. The license file will use the FLEXid keylock number as the license hostid. The ALDEC_LICENSE_FILE variable is set during the installation and it points to the default location of the license file, i.e. to C:\Aldec\Active-HDL 9.1\Dat\license.dat. Refer to the technical documentation of the keylock for additional information on how to install or remove drivers. This option also allows you to start Active-HDL 9.1 when it is protected by the network license server manager. The floating license also requires the license file. When used, the ALDEC_LICENSE_FILE variable is also set during the installation of Active-HDL. The variable should point to the location of either the license.dat file or the license server. Specifying the license server, you can use either of notations: <TCP-port>@<host_computer_name> or <TCP-port>@<host_computer_address> No changes, already have the license You can check this option in case your current maintenance contract is valid, your license is set up, and no changes are required. For the detailed information about the Active-HDL versions and the corresponding maintenance versions, refer to the License Maintenance section in the Release Notes.
11
File Associations
The next step is to select the file types you wish to register to Active-HDL. For each file type selected, Active-HDL will be the default program associated when working with these files. By default, each file type is checked for use with Active-HDL. Click Next to continue with the installation.
12
Active-HDL 9.1 User Guide You may wish to check the information listed in this screen to verify that all paths and associations are correct. If not, you may click the Back button to return to the appropriate stage of the installation setup and make any changes. Choose Next when you are ready to begin copying files to your system.
13
Active-HDL 9.1 User Guide When the installation is complete, you have the option to immediately register your copy with Aldec to ensure you receive the latest updates and product information. You can also choose to display the Release Notes. Select the desired options and click Finish to conclude the installation process.
14
This will open a new window with the complete on-line resources. It is highly recommended that you spend some time exploring the on-line resources, as they can be very valuable tools.
15
The topics of the Tutorials section include: Code Coverage Tutorial HDL Entry and Simulation Tutorial Mixed Mode Entry and Simulation Tutorial Mixed VHDL - Verilog Tutorial Post Simulation Debug Tutorial State Machine Entry and Debugging Tutorial Verilog Entry and Simulation Tutorial VHDL Configurations Tutorial VHDL Entry and Simulation Tutorial VHDL Testbench Tutorial
16
Active-HDL 9.1 User Guide The References are educational resources that can be accessed and used in the same manner as the tutorials:
The topics of the References section include: Active-HDL Interfaces Defines interfaces to SWIFT, VHPI, DVM, CoVer, Simulink, SystemC and SWIFT SmartModels Library Interface VHDL Language Reference Guide Defines terminology and gives examples of the topics contained within the VHDL language Verilog Language Reference Guide Defines terminology and gives examples of the topics contained within the Verilog language SystemVerilog Reference Guide Defines all components of SystemVerilog PLI Reference Guide Defines all components of PLI OVA Reference Guide - Defines all components of OVA PSL Reference Guide Defines all components of PSL VTL Reference Guide Defines all components of VTL library Tcl/Tk Reference Manual Provides the Tool Command Language definition and variables. Perl for Win32 Describes the Perl language and OLE and Win32 extensions
Sample Designs
Active-HDL comes with a series of sample designs that allow users to open a small design and practice using the software on real world applications. Users are encouraged to load a sample design and experiment with all of the tools features before beginning a new project. These designs can be accessed by clicking File on the main tool bar and selecting Open Workspace/Design Explorer.
17
Active-HDL 9.1 User Guide The Workspace/Design Explorer window will then open and you can select Schematic, Verilog, VHDL, Assertions, Matlab, SystemC, SystemVerilog and mixed language designs. When you select a folder in the left hand pane, all sample designs in that folder will be displayed in the right hand pane of the window.
Double clicking on the design will automatically open the design files in the design browser. NOTE: It is recommended that you refer to the Product Help after you have opened a design for Tutorials and Documentation on some of the features of Active-HDL.
18
NOTE: If you are seeking an alternate vendor flow or an updated version, check the Aldec website at www.aldec.com or submit your support request via the Aldec Technical Support web site at http://support.aldec.com/ContactSupport/
19
Once the Flow Settings feature is invoked, users can specify the synthesis and implementation tools that they will be using for this design. With the Tcl based flows, designers can customize the flows and add additional tools that may be required during the verification process. This adds flexibility to the design process and allows the instant addition of user-approved tools.
20
The Design Flow Manager will now invoke specified tools and complete automation of the FPGA design flow.
21
Active-HDL 9.1 User Guide that specific PC. This licensing customization feature prevents restricted licenses of synthesis and implementation tools to be mistakenly called upon during the design process. The flow was made to provide maximum flexibility for the entire design process. It enables designers to disable certain parts of the design flow so that they can concentrate on the specific areas of the design cycle that they are currently working on. The flow also permits designers to edit the list of tools supported so that only those that a designer uses most frequently will be invoked.
Project Control
When synthesis and implementation are running in batch mode, the Design Flow Manager back-annotates the results directly into the Active-HDL environment so that system designers do not have to manually transfer the results. This allows tracking the design progress from one centralized location. Since all files are managed through a single project manager, the users are able to quickly run gate level and timing simulations with the same stimuli files.
Full Version
In order to continue working with an unlimited version of Active-HDL, the software requires a license file. Active-HDL can be protected by using either a local or network floating license configuration, which means that the license file can use hostid of your machine or on a remote computer (license server) running on the Windows, Linux, or UNIX platform.
License HOSTID
The FLEXnet License hostid can be either the number of the Ethernet card or the FLEXid number of the USB keylock/dongle.
Active-HDL 9.1 User Guide Active-HDL supports multiple configurations of the network license. If you have purchased the multiple user installation with network licensing that contains several license types, you will be able to switch among them each time you start Active-HDL. If you have purchased a network license with several products enabled in the license file, you can choose your working configuration while starting Active-HDL in the License Configuration window.
Otherwise, when you have the possibility to use only one given configuration, the License Configuration window can be omitted during the Active-HDL start-up. To do so, clear the Show License Configuration dialog box on Active-HDL startup check box in the Diagnose License window. The Diagnose License program is a tool that allows you to check Active-HDL options/features available in your license regardless of the purchased licensing configuration. You can run the tool from the Help menu by selecting the License Information option or by executing the diagnose.exe program in the \Bin subfolder of the ActiveHDL installation directory, e.g. if you want to check the available features in the license for VSimSA. If you have purchased a multiple-user installation with network licensing, you will need to: Install Active-HDL on all workstations (also called license clients) Install a license server on your network server (or any other computer permanently connected to the network). Re-configure workstations to use network licensing.
All products enabled in your license file can be seen in the last dialog box after you scan your license with Diagnose License. All program files required for setting up a license server are available in the \License directory of the Active-HDL installation DVD. NOTES: Only the hardware keylocks connected to the USB port can be used (FLEXid=9). You must plug the keylock into the USB port of your license server before you start the ActiveHDL network license server manager. Active-HDL provides an additional program that users can use to setup the license server on the Windows platform. The Aldec FLEXnet License Server (setup.exe) program can be run from the \License\Windows\Aldec_License_Server subfolder of the installation DVD. The \License folder also provides files required to run the license server on other platforms. For more information on setting up the Active-HDL license server, refer to the readme_first.txt and setup_license_server.txt files. Active-HDL 9.1 (GUI mode) and VSimSA 9.1 (batch mode) require FLEXnet ver. 11.9.1.
23
License Maintenance
In order to start working with Active-HDL, you need to have a valid Maintenance Agreement and a valid license file. Starting from Active-HDL 7.1 SP1 (BUILD 1583.SP1.23, 03/08/2006), only users who have a valid maintenance contract will be able to use newer versions of Active-HDL. Users who have a maintenance contract that expired should install neither updates nor service packs for newer versions of Active-HDL as it will not run with their existing license and report the following error: Your license file does not support this version of Active-HDL. or (FLEXlm error = -5) You do not have valid license to run Active-HDL. or (FLEXlm error = -18) License server system does not support this feature. Review the License chapter in the Active-HDL Release Notes to check requirements for software licensing. Contact Aldec for ordering information - [email protected] In order to find out whether your license allows using a newer version of Active-HDL or applying a service pack for a recently released version of the software, check out your current license file. In the header section of the license.dat file, there is a line that determines the Maintenance Expiration Date. If your maintenance has expired, you are not eligible to install a newer build or its update (e.g. service pack). Below is an example of the license header with the explicitly specified Maintenance Expiration Date. #---------- ALDEC LICENSE -----------# License Number: 26251 # Configuration: ADE-VHDL(3)APE-VHDL(1) # License Expires: 12/31/2011 # Maintenance Expires: 12/31/2011 # License Type: Floating # # Generator Build: 2.0.8.1030 # License Generated: 2/12/2010 # Host ID: flexid=9-3EC12CE5 You can also find out whether you have a valid maintenance by checking the contents of your license file. It contains a number of lines with a string of information (keyword FEATURE) that define the license features. The license features indicate how long and which version of Active-HDL will run with the license, e.g.: FEATURE ACTIVEHDL_LIC_NUMBER ALDEC 2011.1231 31-dec-2011 uncounted \ The argument 2011.1231 (which refers to December 31, 2011) indicates the Maintenance Expiration Date. If your current maintenance contract is valid, you are entitled to the new license with the updated maintenance date. If your maintenance contract has lapsed, you can run versions of Active-HDL released before your maintenance expired or you can renew your maintenance by contacting Aldec at [email protected].
24
25
Active-HDL 9.1 User Guide The License Environment Variable fields display the current license environment settings. The path to the license file displayed in the Value field should be the same as the one specified in the system environment settings window (System Properties | Advanced):
26
Active-HDL 9.1 User Guide This dialog is used to check the validity of the license. If you encounter problems you will see an error message:
NOTES: The ALDEC_LICENSE_FILE variable, by default set during the Active-HDL installation, points to the same location that is displayed by the Diagnose License program. To run Active-HDL on your workstation you must set a system variable pointing to the location of the LICENSE.DAT file. There are two predefined system variables used for checking licensed features: ALDEC_LICENSE_FILE LM_LICENSE_FILE If the first one, considered as the default variable set during the Active-HDL installation, cannot be found in your system, the standard LM_LICENSE_FILE variable is searched for. In case when neither ALDEC_LICENSE_FILE nor the LM_LICENSE_FILE variable is accessible, Active-HDL starts in the evaluation mode if the evaluation license is not expired. If your LICENSE.DAT file is stored in a different location, the path to it can be specified only by changing the ALDEC_LICENSE_FILE or LM_LICENSE_FILE variables.
Active-HDL 9.1 User Guide valid license, it is possible that you are experiencing problems with communication between license client and license server. In this case, you should try LMTOOLS diagnostic program, located in the \Bin subfolder of the Active-HDL installation directory folder.
Please follow these steps to diagnose problem: Start lmtools.exe on the machine where Active-HDL cannot start. Select the Configuration using License File button, then click Browse and select the same license.dat file Active-HDL is using. The selected license file path should be displayed in the text box next to the Browse button as it is shown in the figure. Click Server Diagnostics tab in the LMTOOLS window, then click Perform Diagnostics.
List of all features listed in the license file and available on the license server should be displayed in the LMTOOLS window. If there are any problems with checking out the features, they will be listed in the LMTOOLS window. If diagnostics did not clarify the situation, click the Server Status tab in the LMTOOLS window, then click Perform Status Enquiry.
28
A list of all license servers running on the server specified in the license file will be listed, sorted by the TCP/IP port number. Active-HDL license server should have correct license file path listed and ALDEC vendor daemon status UP.
29
NOTES: The user account on which a network client is installed must have administrative privileges. Also, the setup program requires restarting the machine to complete the installation. After the restart, you must log on the same user account from which you have started the installation. The local client installation comprises the following files: 1. The minimum set of executable files required locally for Active-HDL to work. 2. Language Assistant templates. The system libraries are stored on the server. The sample designs are copied onto workstations during the installation. The copy of Active-HDL installed on the server must have a network license that meets the required number of client users intended to operate simultaneously. The following variable is set automatically prior to starting the Active-HDL GUI from the Network Client Installation: - ACTIVEHDLLIBRARYCFG The following variable is set automatically prior to starting VSimSA from the Network Client Installation: - ACTIVEHDLCFG - ACTIVEHDLBIN - ACTIVEHDLLIBRARYCFG See the Installation of VSimSA chapter of the documentation for additional information.
30
To run the Active-HDL Preferences Manager in the GUI mode, execute the prefman.exe program without any additional switches (only the v switch is allowed). As a result, the Active-HDL Preferences Manager dialog box will start. The Active-HDL Preferences Manager running in the GUI mode allows you to perform all the operations that are available in the command line mode. The following options are available in the dialog box: Available versions Lists Active-HDL installations available on the current computer. Export Start the export of the preferences from the Active-HDL installation (specified in the Available versions list box) by invoking the Save Active-HDL Preferences as dialog box. This dialog box allows you to specify the Active-HDL preferences dump file (*.dmp) that will be used to store the preferences. Import Starts the import of the preferences to the Active-HDL installation (specified in the Available versions list box) by invoking the Import Active-HDL Preferences File dialog box. This dialog box let you specify the Active-HDL preferences dump file from which the preferences will be imported to the specified Active-HDL installation. Set Defaults Restores the default settings of the Active-HDL installation specified in the Available versions list box. Exit Closes the Active-HDL Preferences Manager dialog box.
31
32