Model Technology Model Sim EE User Manual

Start Here
for

Model

EE Installation - 6
Installation - UNIX platforms - 7
Installation - Windows platforms - 10

Sim

EE

Locating Documentation - 21
Tech Support, Updates & Licensing - 25
Online References - 32

Model

/VHDL, Model

Sim

/VLOG, Model

Sim

/LNL, and Model

Sim

/PLUS are

Sim

produced by Model Technology Incorporated. Unauthorized 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. The program described in
this manual is fu rnished under a license agreement and may not be used or copied
except in accordance with the terms of the agreement. The online documentation
provided with this product may be printed by the end-user. The number or copies that
may be printed is limited to the number of licenses purchased.

Model

is a trademark of Model Technology Incorporated. PostScript is a registered

Sim

trademark of Adobe Systems Incorporated. UNIX is a registered trademark of AT&T in
the USA and other countries. FLEXlm is a trademark of Globetrotter Software, Inc. IBM,
AT, and PC are registered trademarks, AIX and RISC System/6000 are trademarks of
International Business Machines Corporation. Windows, Microsoft, and MS-DOS are
registered trademarks of Microsoft Corporation. OSF /Motif is a trademark of the Open
Software Foundation, Inc. in the USA and other countries. SPARC is a registered
trademark and SPARCstation is a trademark of SPARC International, Inc. Sun
Microsystems is a registered trademark, and Sun, SunOS and OpenWindows are
trademarks of Sun Microsystems, I nc. All ot her trademarks and registered trademarks
are the properties of their respective holders.

Copyright (c) 1990-1998, Model Technology Incorporated.
All rights reserved. Confidential. Online documentation may be printed by licensed
customers of Model Technology Incorporated for internal business purposes only.

Published: November 1998

EE Start Here - Part # M16500 US$50

Thank you

Thank you for purchasing from Mode l Technology’s family of simulation
products! If we can help you with any additiona l product informat ion,
please email our sales department at [e-mail]
page at www.model.com

.

, or visit our home

Model

Questions?

This document

Sim

Elite Edition Simulators for UNIX and Windows

•

EE/VHDL

•

EE/VLOG

• EE/LNL

(Language-Neutral Licensing )

•

EE/PLUS

If you have quest ions a bout the product yo u have purc hase d here are a few
sources of information:

• "Locating Documentation" (p21)

• "Tech Support , Updates & Licensing" (p25)

• "Online References" (p32)

In this document you will find information on Model
documentati on for our Elite Edi tion (EE) simulators . You will also find
sections on tech support , licensing, and EDA industr y references. If you are
using this document online (the bes t way to use it), links for
cross-references, email and the web are available - just
click on
the blue text.

- for VHDL simulation only

- for Verilog simulation only

- for

either

- for single-langua ge, or mixed VHDL/Verilog simula tion

VHDL, or Verilog simulation

installation and

Sim

Help preserve the Silicon Forest

Oregon is famous for its forests as well as its
rain and slug chowder. Help us keep our forests
alive and green by using our online docume ntati on.

3

Table of Contents

EE Installation - 6

System requirements for ModelSim EE - 6
Installation - UNIX platforms - 7
Installation - Windows platforms - 10

Installing the FLEXid security key - 10
Installation and setup for a PC server - 10
Troubleshootin g PC server setu p - 12
Setup for a UNIX serv er - 12

Windows platform installation details - 12

Licensing - 12

How to find the security key ID - 13
Regenerat ing your design libraries - 13
Installed directories and files - 13
Platform-specific directories - 19

Locating Documentation - 21

Online documentation - 21

Getting the most current PDF manuals - 22

Getting pa per manuals - 22
EE documentation - 22
Using ModelSim’s PDF documentation - 23

Getting the Acrobat Reader - 23

Sear ching PDF files - 23

Requirements for Acrobat Search - 24

Doc files for ModelSim EE - 24
Copy and Past e from PDF files - 24

Tech Support, Updates & Licensing - 25

ModelSim contact matrix - 25
Technical support - by telephone - 25

Mentor Graphics customers In North America - 25

Mentor Graphics customers outside North America - 26

Model Technology customers worldwide - 26
Technical s upport - electronic support services - 26

Ment or G raphics cus to m er s - 26

Model Technology customers - 27
Technical support - other channels - 28
Updates - 28

Mentor customers: getting the latest version via FTP - 28

Model Technology customers: getting the latest version via FTP - 29

4

Licenses - ModelSim EE - 29

Wher e to obtain your license - 29
If you have trouble with licensing - 29
All cu stomers: ModelS im EE lice nsing - 29

A

license.dat

All customers: maintenance renewals and EE licenses - 32
All customers: license tra nsfers and server changes - 32

Online References - 32

Book s an d pu bli c at i on s - 32
Partners - 32
Training partners - 32
Resources - 32

Model Tec h nology
License Agreement - 33

Softw a re Lic e ns e A gre ement - 33
Model Technology Software License - 33
Important Notice - 34
Limited Warranty - 34

file example - 29

Table of Contents

5

EE Installation

System requirements for Model

Platform Operating system &

interface

SPARCstation SunOS 4.1 &

OpenWindows

Solaris 2.4, 2.5, 2.6 & OSF/
Motif , OpenWindows, or
CDE

IBM RISC/
6000

HP 700 HP-UX 9x through 11. 0 &

X86 network-ready (s ee note)

AIX 4.1, 4.2 & OSF/Motif

HP VUE , OSF/Motif, or
CDE

Windows NT 4.0 or 95/98

Sim

EE

Memory Stora ge

32 Mb
minimum
(memory
need
scales with
size of
circu i t ­med to
large gate
design
may need
256 Mb)

hard disk
with at
least 35
Mb spare
capacity

Platf o rm- s pe c if ic in s truc tions

Select your platform for installation instr uctions.

• Installation - UNIX platforms (p7)

• Installation - Windows platforms (p10)

Note:

TCP/IP or IPX/SPX. If you are installing on an NT machine, make sure
you are logged in as "administrator" when running th e ins tallation
program.

Start Here for ModelSim EE

6

Any PC client or server must be connected to a network with

Installation - UNIX platforms

Before you begin a new Model
make sure you have a Globetro tter licen se data file (
need the file to run Mode l

Sim

EE installat ion on a UNIX machine,

Sim

license. dat

file); you ’ll

. If you don’t have a license file see

"Licenses - ModelSim EE" (p29).

Your workstation’s identificat ion is required for a lice ns e; here are the
commands that r eturn the ID :

Syntax Platform

hostid SPARC
/etc/la nscan HP 700
uname -m RISC/6000

The commands used to i nstall Model

are cas e - sen s i ti v e, so they m u st

Sim

be entered exactly as shown in the following steps. (Note that neither the
prompt nor the <Retu r n> at the end of a line is shown in the exa mpl es .)

Model

1

you are installing it in the

can be installed in any directory. T hes e instructions as s ume that

Sim

directory. You can change to the desired

/usr

installation directory by entering one of the following commands:

cd /usr

or

cd <pathname>

From a mounted Model

2

following syntax (this creates the top-level directory

tar xf /<CD-ROM>/WORKSTATION/install/<filename.tar>

CD, extract the file for your platform with the

Sim

modeltech

where the <filename.tar> is:

Platform <filename.tar>

All platforms base.tar (extract for all platforms)
Sun OS-4/Solaris 1.x sun4.tar
Sun OS-5/Solaris 2.x sunos5.tar

):

EE Installation

7

Platform <filename.tar>

HP hp700.tar
IBM rs6000.tar
All platforms docs.tar ( Model

In addition to the platform-specific file you need to extract
(common Model

Add the pathname of the Model

3

files) and

Sim

docs.ta r

Sim

(documentation).

executable directory to you r search

manuals in pdf format)

Sim

base.tar

path (use one of the following):

/usr/modeltech/sun4
/usr/modeltech/sunos5
/usr/modeltech/hp700
/usr/modeltech/rs6000

If are using shell scripts that require platform independenc e, you can use
the
directory to your search path.

command within th e pa th of your s hell s cript to r etu rn the pl atform

vco

returns a path appropriate for the

Vco

hardware from which you ar e invoking the simulator. The shell you are
running determines how you add vco to your path:

• for csh:

set path = ( $path /usr/modeltech/‘/usr/modeltech/vco‘ )

• for sh (Bourne or Korn)

PATH=$PATH:/usr/modeltech/‘/usr/modeltech/vco‘
export PATH

If you are using SunOS 4, and are planning to load shared libraries, you’ll

4

need this path included in the LD_LIBRARY_PATH environment
variable:

/usr/openwin/lib

Enter or edit the

5

license.dat

file in th e

modeltech

directory. Typically the

file looks like this (also see "L ic ense s - Mode lSim EE" (p29)):

SERVER hostname nnnnnnnn 1650
DAEMON modeltech ./modeltech ./options
FEATURE vsim modeltech 1997.090 dd-mmm-yyyy 2 \
6C92577EC335F4C9568D ck=61
FEATURE vcom modeltech 1997.090 dd-mmm-yyyy 2 \
6C92577EC335F4C9568D ck=61

Start Here for ModelSim EE

8

Note:

To enable starting the license daemon from any directory,

change the DAEMON line to use the ful l pat h. For example:

DAEMON modeltech /usr/modeltech/hp700/modeltech \
/usr/modeltech/hp700/options

For HP installation using HP-UX version 9.x only: either the device /dev/

6

lan0 must be writable by the userID that starts the server, or the lmgrd
daemon and the lmhos tid utilit y must be made “setuid root”. The
commands to do this are:

chmod a+w /dev/lan0

or

chown root lmgrd lmhostid
chmod u+s lmgrd lmhostid

Start the license manager daemon by entering the following commands:

7

cd /usr/modeltech/<platform>
START_SERVER

where <platform> can be sun4, sunos5, hp700, rs6000.
If your system runs other appl ications that use Globetrotter Software’s

FLEXlm, a complete user’s manual for FLEXlm is availa b le at
Globetrotte r S oftware’s home page:

http://www.globetrotter.com/manual.htm

You may delete the executables you don’t want. Fo r example, if you don’t

8

need Model

cd /usr/modeltech/
rm -rf hp700

for HP machines:

Sim

EE Installation

9

Installati on - Windows platforms

Note:

IP or IPX/SPX. If you are installing on an NT machine, make sure you are
logged in as "admi nistrator" when running the inst allation program.

Model
one of the following:

Installing the FLEXid security key

Attach the FLEXid security key (FLEXid is printed on the key) to the
parallel port of the PC server or stand-alone PC (key dri vers are loaded
during installation). If a printe r or other device is using the paral lel port,
install the security key on the port f ir st, then attach that device to the key.
The security key will not interfere with normal device operations.

Any PC client or server must be connected to a network with TCP/

EE requires a server for proper installation. Your server can be

Sim

• A stand-alone PC with a FLEXlm security key attached. (The PC acts

as both server and client.)

• A Windows server (95/98/NT) with a security key attache d. (The client

has no security key.)

• A UNIX server . (The client nor server have a security key; th e server’s

hostID provi des the same locking function as the security key.)

Please remember to protect your security key; Model Technology will
replace a defective key, but not one that is lost or stolen.

Installation and setup for a PC server

Follow this proc ess to set up a floating lice nse server on a PC. If you are
installing Model
floating license. If you are using a UNIX server see: "Set u p for a U NIX

server" (p12).

Run the Model

1

•

Install from the CD -

you can click on the CD icon.

•

Install from an FTP file

below.
The password-protected Model
and documentation file (ee_docs.zip) are available within th e version­numbered directories at:

ftp.model .com/pub/EE/

Place the unzipped documentation files in the
after Model

Sim

on a stand-alone PC, the license is sti ll a considered

Sim

installation.

Sim

instal l wil l auto- r un when you ins er t the CD, or

- run the installation executa ble as noted

installati o n exe cu table (mti52 e e .ex e)

Sim

modelsim\docs

is installed.

directory

Start Here for ModelSim EE

10

During installation you will be asked to choose a Sentinel driver for your

2

specific FLEXid s ecurity key. The number on your FLEX id s ecurity key
(something like 7-xxxxxxxx, or 8-xxxxxxxx) rel ate s to the driver you will
select.

Copy

3

license.dat

purchased Model
specific Mode l
into th e

license.dat

(the license file you received by email when you

) to

Sim

pathname if different. Pasting the text from the email

Sim

C:\modelsim\win32\license.dat

, or to your

file is the safest way to create a valid license file.
See "A lic en se.dat f il e ex ample" (p29) for details on the structur e of a
licen se file.

Verify your hostname (the server’s computer name) via the Windows

4

Control Panel with either FLEXlm > Advance d > Diagnostics, or with
Network > Identific ation.

5

Edit the

license.dat

file and make the f ollowing changes:

• Replac e "hostna me" with t h e server co mputer n ame.

• Change the "1650" port value only if this port is already used. If
uncertain, do not change.

• Change the DAEMON path to corres pond with the full pathname of
the modeltech daemon. For example,

DAEMON modeltech C:\modelsim\win32\modeltech

Set the environment variable for LM_LICENSE_FILE.

6

• For

Win dows NT

go to Control Panel > System > Environment and
add LM_LICENSE_FILE wit h an initial value of 1650@MYPC,
where MYPC is the hostnam e.

• For

Windows 95/98

set LM_LICENSE_FILE=1650@MYPC

edit the

autoexec.bat

and add the following line:

where MYPC is your hostna me.

Note that the c hanges m ade to y our

license.dat

file are reflec ted i n the port #

(1650) and the hostname (MYPC) that you set for LM_LICENSE_FILE.

Note:

If the LM_LICENSE_FILE vari able is al ready defined, you can add
a second value by separating the two values with a semi-colon ( ; ). For
example: LM_LICENS E_FILE=1650@MYPC;c: \renoir\li ce nse.dat

For Windows 95/98, reboot your machine; no reboot is needed for NT.

7

EE Installation

11

Go to the FLE Xlm License Ma nager locate d in your Control Panel . Choose

8

the Setup tab and add the pathnames for the lmgrd.exe, license.dat, and
debug.log. Make sure the pathnames and exten sions are correct, then save
the setup. Ty pical entries mi ght look like this:

lmgrd.exe C:\models im\win32\lm grd.exe
License file C:\modelsim\win32\license.dat
Debug log file C: \m odelsim\win32\debug.log

Next choose the FLEXlm Control tab. Press the start button. Wait a

9

moment, then press t he status button. The serve r shoul d be up . If the s erver
does not start, try the following troubleshooting procedures.

Troubleshooting PC server setup

Open a DOS window and go to the appropriate

1

modelsim\win32

directory.

For example, C:\modelsim\ win32. Enter t h e comman d :

lmutil lmdiag

This allows you to veri fy ea ch fe ature independently.
From a DOS window, and the same

2

lmutil lmstat -a

win32

directory, enter the following:

This shows you all licenses that are available.

3

Go to the

debug.l og

inside the

win32

directory. This may pr ovide other

infor mation about the source of the lice n se server problems.

Setup for a UNIX server

Check with your system administra tor for the server’s hostna me and port#,
then follow the installation instructions above (steps 5 through 7) to set the
LM_LICENSE_FILE variabl e for your platform.

Windows platform installation details

Licensing

Model
Globetrott er Software. In a Windows-only en vironment, a FLEXid sec urity
key is installed that identifies the machine as the license server (a stand­alone PC acts as server
the license server, and requires no security key because FLEXlm uses the
UNIX server’s hostID as the identifier.

licensing is handled by the FLEXlm license manager from

Sim

client). A UNIX machine may also be used as

and

The license file (

license.dat

or host ID), and is obtained from either Model Technology or Mentor
Graph ic s. ( See "Lic ense s - ModelS im EE" (p29) if y ou need a license file.)

Start Here for ModelSim EE

12

) is ba s ed on the s erver identifier ( the FLEXid,