Start Here for ModelSim® SE Software Version 5.7 12/Jun/03 Model Technology™ A M E N T O R G R A P H I C S C O M P A N Y Copyright (c) 1990-2003, Model Technology, a Mentor Graphics Corporation company. All rights reserved. Confidential. Online documentation may be printed by licensed customers of Model Technology and Mentor Graphics for internal business purposes only.
ModelSim /VHDL, ModelSim /VLOG, ModelSim /LNL, and ModelSim /PLUS are produced by Model Technology™, a Mentor Graphics Corporation company. Copying, duplication, or other reproduction is prohibited without the written consent of Model Technology. The information in this manual is subject to change without notice and does not represent a commitment on the part of Model Technology.
Table of Contents Are you upgrading?.................................................................................................5 Supported platforms ...............................................................................................6 Discontinued and Retiring Operating Systems.......................................................7 Licensing ..................................................................................................................8 Overview..........................
iv Start Here for ModelSim SE, Software Version 5.
Are you upgrading? Are you upgrading? • From 5.6x or an earlier version When you upgrade to 5.7, you’ll need to regenerate your design libraries after installing the software. See "Regenerating your design libraries" (p24) for details. • From 5.2 or an earlier version Since version 5.3, ModelSim has used version 6.1g of FLEXlm (all FLEXlm 6.1 versions are compatible).
Supported platforms Supported platforms Platform / OS VCO name1 Memory capacity Large file capability2 HP 700 / HP-UX 11.x (64-bit capable) hp700 (32-bit binary)3 2GB / 3.4 GB4 Yes HP 700 / HP-UX 11.x (64-bit capable) hppa64 (64-bit binary) terabytes Yes Itanium 2 / Redhat Linux Advanced Workstation 2.15 (64-bit only) linux_ia64 (64-bit binary) terabytes Yes Itanium 2 / HP-UX B.11.22 (64-bit only) hpux_ia64 (64-bit binary) terabytes Yes RS/6000 / AIX 4.2.x, 4.
Supported platforms 5. This version was built and tested on Linux kernel release 2.4.18-e.12smp for ia64. 6. ModelSim runs on all UltraSPARC hardware including the Sun Blade platform. 7. This refers only to the WLF file. In FAT32 file system, the maximum possible WLF file size is 4G. In NTFS file system, WLF file size is limited by the size of the disk volume. 8. Only non-SMP versions of 7.0 and 7.1 are supported. 9. Memory usage is limited to the maximum process size allowed by the Linux kernel.
Licensing Licensing Overview ModelSim uses FlexLM licenses which are tied to a workstation or hardware ID (see below for how to locate your ID). When you purchase ModelSim, we’ll generate and email you a license file that you install on either a license server or the stand-alone system running ModelSim.
Licensing Licensing on Windows platforms On Windows platforms the hardware identifier may be either a hardware security key or an Ethernet ID. To determine a security key ID number, check the number printed on the key. To determine the Ethernet ID, select Start > Run then Open "cmd" (Windows NT/2000/XP), or Open "command.com" (Windows 98/Me) to open a command prompt. At the command prompt type: doskey ipconfig -all |more Check the configuration listing for your Ethernet "Physical Address".
Licensing Mentor Graphics licensing on Unix platforms To use ModelSim 5.7 in a Mentor Graphics environment you must be running MGLS version v4.1_0.0 (or newer) and Packaging Information version v3.0_3.0r (or newer). You can check your current versions using the following method: 1. Make sure the MGLS_HOME environment variable is set to /modeltech//mgls 2.
Installation Installation The commands used to install ModelSim are case-sensitive, so they must be entered exactly as shown. If you are upgrading, we recommend that you install in a new directory to avoid overwriting your old files and libraries. Read the section(s) that applies to your product(s) and platform(s).
Installation Stand-alone Windows PC Use this setup if you are installing on a stand-alone Windows PC. ModelSim and the license server run on the same system. 1. If you received a hardware security key (dongle), install it on the parallel port of your PC. Skip this step if you licensed ModelSim to the PC’s Ethernet ID. 2. Install ModelSim from the CD or via a downloaded installation executable. The ModelSim installation executable is available on the web at http:///www.model.com/products/release.asp. 3.
Installation 7. Set the LM_LICENSE_FILE environment variable with the port# and hostname: • For Windows NT/2000/XP, right-click the My Computer icon and select Properties, and then select the Environment tab (in Windows 2000/XP select the Advanced tab and then Environment Variables). Add LM_LICENSE_FILE with a value of 1650@hostname, where hostname is the name of your PC. • For Windows 98/Me, add the following line to the autoexec.
Installation Stand-alone Unix workstation Use this setup if you are running ModelSim on a stand-alone Unix workstation. ModelSim and the license server run on the same system. 1. From a mounted ModelSim CD or a downloaded file, uncompress base.tar and docs.tar. Compressed ModelSim installation files are available on the web at http:///www.model.com/products/release.asp. Use "tar xzf" to extract the compressed files. 2. Uncompress and execute the appropriate .
Installation 4. Open the license.dat file and change the server name to the hostname of your workstation. 5. Start the license manager daemon with the following commands: cd /modeltech/ START_SERVER where can be sunos5, sunos5_251, sunos5v9, hp700, hppa64, rs6000, rs64, or linux 6. Set the LM_LICENSE_FILE environment variable to the hostname: setenv LM_LICENSE_FILE 1650@hostname 7.
Installation Windows PC client (obtains license from a server) Use this setup if you are installing on a Windows PC that will obtain a license from a Windows PC or Unix license server. 1. Install ModelSim from the CD or via a downloaded installation executable. The ModelSim installation executable is available on the web at http:///www.model.com/products/release.asp. 2. During installation the Select Components dialog box asks you to select a licensing option.
Installation Unix client (obtains license from a server) Use this setup if you are installing on a Unix system that will obtain a license from a Unix or PC server. 1. From a mounted ModelSim CD or a downloaded file, uncompress base.tar and docs.tar. Compressed ModelSim installation files are available on the web at http:///www.model.com/products/release.asp. Use "tar xzf" to extract the compressed files. 2. Uncompress and execute the appropriate .exe file for your platform: Platform
Installation 4. Set the LM_LICENSE_FILE environment variable with the port# and hostname: setenv LM_LICENSE_FILE 1650@hostname where hostname is the name of the license server. 5. Make sure the license server is running, then enter the following command at the shell prompt to start ModelSim: vsim 18 Start Here for ModelSim PE, Software Version 5.
Installation Windows PC license server Use this setup if you are installing a Windows PC license server that will checkout licenses to clients. If you already have a FLEXlm installation on the server, you need only install the modeltech or mgcld daemon and the license file (contact Model Technology support if this is your situation). 1. If you received a hardware security key (dongle), install it on the parallel port of your server. Skip this step if you licensed ModelSim to the server’s Ethernet ID. 2.
Installation 7. Set the LM_LICENSE_FILE environment variable with the port# and hostname. • For Windows NT/2000/XP, right-click the My Computer icon and select Properties, and then select the Environment tab (in Windows 2000/XP select the Advanced tab and then Environment Variables). Add LM_LICENSE_FILE with a value of 1650@hostname, where hostname is the name of your server. • For Windows 98/Me, add the following line to the autoexec.
Installation Troubleshooting PC server setup The Licensing Wizard located in the ModelSim program group can help you solve ModelSim licensing problems. Run the wizard on a client machine to check the availability of the license from your PC server. In addition to running the Licensing Wizard, try the following: • Open a DOS window and go to the appropriate modeltech\win32 directory. For example, C:\modeltech\win32. Enter the command: lmutil.exe lmdiag This allows you to verify each feature independently.
Installation Unix license server Use this setup if you are installing a Unix license server that will checkout licenses to clients. If you already have a FlexLM installation on the server, you only need to install the modeltech or mgcld daemon and the license file. Contact Model Technology support for more information. 1. From a mounted ModelSim CD or a downloaded file, uncompress base.tar and docs.tar. Compressed ModelSim installation files are available on the web at http:///www.model.
Installation 4. Open the license.dat file and change the server name to the hostname of your server. 5. Start the license manager daemon with the following commands: cd /modeltech/ START_SERVER where can be sunos5, sunos5_251, sunos5v9, hp700, hppa64, rs6000, rs64, or linux 6. Set the LM_LICENSE_FILE environment variable with the port# and hostname: setenv LM_LICENSE_FILE 1650@hostname where hostname is the name of the license server.
Regenerating your design libraries Regenerating your design libraries When you upgrade between number versions (e.g., from 5.5 to 5.65), you must regenerate your design libraries. This is not true for letter versions (e.g., 5.6a to 5.6d). Regenerating methods Explicit refresh You can easily regenerate your design libraries with -refresh. You must use the vcom compiler with the -refresh option to update the VHDL design units in a library, and vlog with the -refresh option to update Verilog design units.
Regenerating your design libraries AutoRefreshing ModelSim 5.7 library files can be used by any 5.7 simulator type (PE, SE, or SE/64-bit) with the help of AutoRefresh. AutoRefresh works during simulation loading to build the library files needed by the current simulator type. AutoRefresh builds only the files needed by the loading simulation, and then only refreshes files for design units that have changed, leaving the rest of the library files untouched.
Installed directories Installed directories A typical installation for ModelSim 5.7 includes the directories listed below. All directories are located within the modeltech directory. Installed directories - ModelSim 5.7 Directory Description ./bin soft links to all ModelSim commands, allowing platform-independent invocation ./docs ModelSim documentation, general ModelSim technotes, HTML versions of the Tcl/Tk man pages ./drivers drivers for Windows hardware keys .
Installed directories Installed directories - ModelSim 5.7 Directory Description ./vhdl_src/ieee sources for rebuilding basic IEEE std_logic_1164 library and accelerated IEEE arithmetic packages ./vhdl_src/std sources for VHDL STD library and package TEXTIO ./vhdl_src/std_deve loperskit sources and examples for MGC standard developer’s kit ./vhdl_src/synopsys sources for rebuilding accelerated arithmetic packages ./vhdl_src/verilog source for rebuilding Verilog library ./vhdl_src/vital2.
Library notes Library notes Pre-compiled versions of some non-standard libraries and packages are no longer provided. The ARITHMETIC library, which contained a package for doing signed and unsigned vector arithmetic, is no longer included. However, you can download the source file at ftp://ftp.model.com/pub/obsolete/arithmetic.tar. The source for the ieee-precompiled version is in vhdl_src/synopsys/mti_std_logic_arith.
ModelSim documentation ModelSim documentation To access ModelSim documentation after installation, select Help > SE PDF / HTML Documentation from the Main window in ModelSim. All documents are available in PDF and most are also available in HTML. You will need Acrobat Reader version 4.0 to view or print the PDF documents (free from www.adobe.com, and on the ModelSim CD). The following documents are available: Start Here Guide The document you are currently reading.
ModelSim documentation Command Reference Describes ModelSim commands and associated options that are used from a command prompt or within macro files. Includes a section on command syntax. Tutorial Leads you step-by-step through common tasks such as compilation, simulation, debugging, and using the Wave window. FLI Reference Offers detailed description of the ModelSim Foreign Language Interface (FLI) including function description, syntax, and code samples.
ModelSim documentation Requirements for Acrobat Search These ModelSim documentation files must be in the modeltech/docs/pdf directory for Acrobat Search to work properly. se_man.pdf (user’s manual) se_cmds.pdf (command reference) se_tutor.pdf (tutorial) se_start.pdf (this document) se_guide.pdf (ModelSim command quick guide) se_index.pdx (PDF index file) fli.pdf (FLI reference) /se_index (directory and subdirectories for PDF index) Start Here for ModelSim PE, Software Version 5.
Tech Support and Updates Tech Support and Updates The Model Technology web site includes links to support, software updates, and many other information sources for both Model Technology and Mentor Graphics customers. Support Online and email technical support options, maintenance renewal, and links to international support contacts: www.model.com/support/default.asp Updates Access to the most current version of ModelSim: www.model.com/products/release.
FLEXlm Licenses FLEXlm Licenses ModelSim uses Globetrotter’s FLEXlm license manager and files. Globetrotter FLEXlm license files contain lines that can be referred to by the word that appears first on the line. Each kind of line has a specific purpose and there are many more kinds of lines that MTI does not use. Since version 5.3, ModelSim has used version 6.1g of FLEXlm (all FLEXlm 6.1 versions are compatible).
FLEXlm Licenses License file example A floating license.dat file: SERVER hostname 11111111 1650 DAEMON modeltech ./modeltech ./options FEATURE vcom modeltech 1998.080 31-aug-98 1 \ 0C944D8F0C79B02EF5CF ck=117 FEATURE vsim modeltech 1998.080 31-aug-98 1 \ FCB4FD0F2A635C20E5CF ck=128 FEATURE vlog modeltech 1998.080 31-aug-98 1 \ 0C944D9F176CA773E889 ck=10 FEATURE vsim-vlog modeltech 1998.080 31-aug-98 1 \ FCB41D9FC43C87567DBC ck=116 FEATURE hdlcom modeltech 1998.
FLEXlm Licenses The SERVER line The first line is a SERVER line; it spells out which computer on the network is the license server. The license server is a network resource that will manage the features for all users of ModelSim products. The SERVER line includes the server's hostname (the server’s network identification - for Windows, check the Network properties Identification tab), hostID (a unique serial number), and a port number.
For example, DAEMON modeltech /usr/mti5.6/sunos5/modeltech \ /usr/mti5.6/sunos5/options i The "options" line is only necessary if you are using a FLEXlm options file. The FEATURE line A FEATURE line describes how many licenses ("tokens") are available; it contains the feature name, daemon required, most current build date authorized to run, token expiration date, number of tokens for the feature, license code, and a checksum. Notice the FEATURE lines.
A quick ModelSim tutorial A quick ModelSim tutorial Here are the basic steps to simulation. These commands work within ModelSim at the ModelSim prompt, or on your operating system command line. You must be in the modeltech/examples directory to run the examples. (Go to "Licensing" (p8) if ModelSim is NOT ready to run.) Command Description vlib work creates a work library for holding your compiled designs vcom counter.
Software License Agreement Software License Agreement IIMPORTANT - USE OF THIS SOFTWARE IS SUBJECT TO LICENSE RESTRICTIONS. CAREFULLY READ THIS LICENSE AGREEMENT BEFORE USING THE SOFTWARE.
Software License Agreement testing, you will send to Mentor Graphics a written evaluation of the Beta Code, including its strengths, weaknesses and recommended improvements. You agree that any written evaluations and all inventions, product improvements, modifications or developments that Mentor Graphics conceives or made during or subsequent to this Agreement, including those based partly or wholly on your feedback, will be the exclusive property of Mentor Graphics.
Software License Agreement SHALL MENTOR GRAPHICS’ OR ITS LICENSORS’ LIABILITY UNDER THIS AGREEMENT EXCEED THE AMOUNT PAID BY YOU FOR THE SOFTWARE OR SERVICE GIVING RISE TO THE CLAIM. IN THE CASE WHERE NO AMOUNT WAS PAID, MENTOR GRAPHICS AND ITS LICENSORS SHALL HAVE NO LIABILITY FOR ANY DAMAGES WHATSOEVER. 7. LIFE ENDANGERING ACTIVITIES.
Software License Agreement 12. RESTRICTED RIGHTS NOTICE. Software was developed entirely at private expense and is commercial computer software provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the U.S. Government or a U.S. Government subcontractor is subject to the restrictions set forth in the license agreement under which Software was obtained pursuant to DFARS 227.
Start Here for ModelSim PE, Software Version 5.
Index A hppa64.tar file 14, 17, 22 Adobe Acrobat 31 autorefreshing design libraries 25 I D DAEMON line 35 design libraries autorefreshing 25 regenerating 24 directories 26 platform specific 27 documentation 29 E explicit refresh 24 F FEATURE line 36 FLEXid security key key ID number 9 FLEXlm license license example 8, 34 obtaining 9 floating licenses 12, 19 H hardware ID 9 help 29 hp700.
MGLS 10 ModelTech licenses 8 troubleshooting PC server setup 21 tutorial 30, 37 P U PC platforms licensing 9 PDF documentation 30 platforms supported 6 UNIX platforms licensing 9 upgrading regenerating design libraries 24 R V -refresh switch 24 regenerating design libraries 24 renewals 33 rs6000.tar file 14, 17, 22 rs64.
Keep these numbers handy for tech support: UNIX server hostid # : FLEXid security key # : Ethernet ID # : Rainbow dongle # :