ispLEVER 7.0 Installation Notice

Linux

Lattice Semiconductor Corporation 5555 NE Moore Court Hillsboro, OR 97124 (503) 268-8001

June 2007 Copyright Copyright © 2007 Lattice Semiconductor Corporation. This document may not, in whole or part, be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine- readable form without prior written consent from Lattice Semiconductor Corporation.

Trademarks Lattice Semiconductor Corporation, L Lattice Semiconductor Corporation (logo), L (stylized), L (design), Lattice (design), LSC, E2CMOS, Extreme Performance, FlashBAK, flexiFlash, flexiMAC, flexiPCS, FreedomChip, GAL, GDX, Generic Array Logic, HDL Explorer, IPexpress, ISP, ispATE, ispClock, ispDOWNLOAD, ispGAL, ispGDS, ispGDX, ispGDXV, ispGDX2, ispGENERATOR, ispJTAG, ispLEVER, ispLeverCORE, ispLSI, ispMACH, ispPAC, ispTRACY, ispTURBO, ispVIRTUAL MACHINE, ispVM, ispXP, ispXPGA, ispXPLD, LatticeEC, LatticeECP, LatticeECP-DSP, LatticeECP2, LatticeECP2M, LatticeMico8, LatticeMico32, LatticeSC, LatticeSCM, LatticeXP, LatticeXP2, MACH, MachXO, MACO, ORCA, PAC, PAC-Designer, PAL, Performance Analyst, PURESPEED, Reveal, Silicon Forest, Speedlocked, Speed Locking, SuperBIG, SuperCOOL, SuperFAST, SuperWIDE, sysCLOCK, sysCONFIG, sysDSP, sysHSI, sysI/O, sysMEM, The Simple Machine for Complex Design, TransFR, UltraMOS, and specific product designations are either registered trademarks or trademarks of Lattice Semiconductor Corporation or its subsidiaries in the United States and/or other countries. ISP, Bringing the Best Together, and More of the Best are service marks of Lattice Semiconductor Corporation. Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies.

Limited Warranty Lattice Semiconductor Corporation warrants the original purchaser that the Lattice Semiconductor shall be free from defects in material and workmanship for a period of ninety days from the date of purchase. If a defect covered by this limited warranty occurs during this 90-day warranty period, Lattice Semiconductor will repair or replace the component part at its option free of charge. This limited warranty does not apply if the defects have been caused by negligence, accident, unreasonable or unintended use, modification, or any causes not related to defective materials or workmanship.

ii ispLEVER 7.0 Installation Notice To receive service during the 90-day warranty period, contact Lattice Semiconductor Corporation at: Phone: 1-800-LATTICE or (503) 268-8001 E-mail: [email protected] If the Lattice Semiconductor support personnel are unable to solve your problem over the phone, we will provide you with instructions on returning your defective software to us. The cost of returning the software to the Lattice Semiconductor Service Center shall be paid by the purchaser.

Limitations on Warranty Any applicable implied warranties, including warranties of merchantability and fitness for a particular purpose, are hereby limited to ninety days from the date of purchase and are subject to the conditions set forth herein. In no event shall Lattice Semiconductor Corporation be liable for consequential or incidental damages resulting from the breach of any expressed or implied warranties. Purchaser’s sole remedy for any cause whatsoever, regardless of the form of action, shall be limited to the price paid to Lattice Semiconductor for the Lattice Semiconductor software. The provisions of this limited warranty are valid in the United States only. Some states do not allow limitations on how long an implied warranty lasts, or exclusion of consequential or incidental damages, so the above limitation or exclusion may not apply to you. This warranty provides you with specific legal rights. You may have other rights which vary from state to state.

ispLEVER 7.0 Installation Notice iii Type Conventions Used in This Document

Convention Meaning or Use

Bold Items in the user interface that you select or click. Text that you type into the user interface.

Variables in commands, code syntax, and path names.

Ctrl+L Press the two keys at the same time.

Courier Code examples. Messages, reports, and prompts from the software.

... Omitted material in a line of code.

. Omitted lines in code and report examples. . .

[ ] Optional items in syntax descriptions. In bus specifications, the brackets are required.

( ) Grouped items in syntax descriptions.

{ } Repeatable items in syntax descriptions.

| A choice between items in syntax descriptions.

iv ispLEVER 7.0 Installation Notice Contents

ispLEVER 7.0 Installation Notice 1 System Requirements 1 Contacting Lattice Semiconductor 2 Installation Disk Contents 3 CD-ROM Contents 3 DVD-ROM Contents 3 ispLEVER Installed Directory Structure 3 Installing the ispLEVER 7.0 Software 4 Full Installation 4 Customized Installation 5 Installing the ispLEVER Software from a Server 8 Setting Up the Files 8 Installing from the Server 9 Installing Service Packs 9 Installing Adobe Acrobat Reader 10 Licensing for the ispLEVER Software 10 Obtaining a License 11 Editing the License File 11 Starting the License Manager 12 Stopping the License Manager 12 Post-Installation Configuration 13

ispLEVER 7.0 Installation Notice v Contents

Linking to or Copying the Installation Directory 13 Using the Examples Directory 13 Running the ispLEVER Project Navigator GUI 14 Finding the Installation History 14 Specifying the Default Browser 15 Running Multiple Versions of the Software 15 Running from the Command Line 16 Environment Variable Setup 17 Configuring System Settings 17 Updating the ispLEVER Software 18

vi ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice

This document provides installation instructions for the ispLEVER® Linux software.

During installation, you will be prompted to select the installation path for the ispLEVER software and global constraints for JEDEC file options.

The ispLEVER software supports LatticeEC™, LatticeECP™, LatticeECP2™, LatticeECP2S, LatticeECP2M™, LatticeECP2MS, LatticeXP™, LatticeXP2™, LatticeSC™, LatticeSCM™, and MachXO™ designs.

System Requirements

The following are the basic system requirements for the ispLEVER Linux software:

‹ Intel Pentium or Pentium-compatible PC

‹ Red Hat Enterprise Linux version 3.0 or 4.0 operating system

‹ AMD Opteron system support (32-bit OS only)

‹ Approximately 3 GB free disk space

‹ 1024 x 768 graphics display

ispLEVER 7.0 Installation Notice 1 Contacting Lattice Semiconductor ispLEVER 7.0 Installation Notice

‹ CD-ROM drive (2X or above) or DVD-ROM drive

‹ HTML-compatible

Table 1 lists the minimum memory requirements and recommended memory for the UNIX and Linux operating systems on 32-bit platforms for all the Lattice Semiconductor FPGA device families.

Table 1: Recommended Memory for UNIX and Linux 32-Bit Platforms Device Size Minimum Recommended

MachXO All 256 MB512 MB

LatticeECP, LatticeXP, Up to 20K LUT 512 MB 768 MB LatticeXP2 Up to 50K LUT 768 MB 1 GB

LatticeECP2/S Up to 20K LUT 768 MB 1 GB

UP to 50K LUT 1 GB 1.5 GB

Up to 70K LUT 1 GB 2.0 GB

LatticeECP2M/S Up to 20K LUT 512 MB 768 MB

Up to 50K LUT 768 MB 1 GB

Up to 70K LUT 1 GB 1.5 GB

Up to 100K LUT 1 GB 2.0 GB

LatticeSC/M Up to 40K LUT 768 MB 1 GB

Up to 115K LUT 1 GB 2.5 GB

Contacting Lattice Semiconductor

You can contact Lattice Semiconductor by any of the following means:

‹ Lattice Semiconductor Corporation 5555 Northeast Moore Court Hillsboro, Oregon 97124-6421 U.S.A.

‹ Internet: www.latticesemi.com

‹ Literature Hotline: 1-888-ISP-PLDS (477-7537)

‹ Applications Support Domestic: 1-800-LATTICE (528-8423)

2 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Installation Disk Contents

International: (503) 268-8001 Fax: (503) 268-8556

Installation Disk Contents

The ispLEVER 7.0 software gives you the option of installing from four CDs or from a single DVD.

CD-ROM Contents The following describes the contents of the four CD-ROMs.

‹ CD-ROM 1 contains the following directories and files:

‹ The acroread directory contains the acro_lin.taz file, which installs the Adobe Acrobat Reader software. Refer to “Installing Adobe Acrobat Reader” on page 10 for more information.

‹ The isptools directory contains the isplever.taz file, which contains the compressed ispLEVER software.

‹ The readme.txt file contains installation and licensing information.

‹ The install.csh file contains the installation script for installing the software that is on the CD.

‹ CD-ROMs 2, 3, and 4 contain the compressed ispLEVER software.

DVD-ROM Contents The single DVD-ROM contains the same directories and files that are included in the four CD-ROMs. ispLEVER Installed Directory Structure

Table 2 shows the directories and files of the ispLEVER software directory structure after installation:

Table 2: The ispLEVER Software Directory Structure File or Directory Description readme.txt This file contains installation instructions. isptools/ This directory is the main directory.

ispLEVER 7.0 Installation Notice 3 Installing the ispLEVER 7.0 Software ispLEVER 7.0 Installation Notice

Table 2: The ispLEVER Software Directory Structure File or Directory Description isptools/cae_library/ This directory contains synthesis header libraries for Synplicity in both Verilog and VHDL formats. It also contains the libraries for interface kits (ispLSI® design and simulation libraries). isptools/ispcomp/ This directory contains files for the ispLEVER software. isptools/ispcpld/ This directory contains files for the ispLEVER software. isptools/ispjtools/ This directory contains files used by ispUPDATE. isptools/ispvmsystem/ This directory contains Lattice Semiconductor ispVM device programming software. isptools/license/ This directory contains the license agreement.

Installing the ispLEVER 7.0 Software

An installation script named install.csh is provided on the CDs or DVD to simplify the installation process. You can perform full installation of the ispLEVER software, or you can perform customized installation to select parts of the software to be installed. The following sections guide you through these two installation methods step by step.

Full Installation The ispLEVER full installation installs all Lattice Semiconductor FPGA devices on your system. It also installs the ispVM System, sets the software to automatically generate serial vector format (SVF), and uses Checksum as the USERCODE default.

To perform full installation of the ispLEVER software: 1. Insert the ispLEVER software CD-ROM 1 or DVD into the disk drive. 2. Mount the installation disk. If you are installing from a network, mount the drive by making a directory mount point and using the proper mount argument. 3. Specify a path location for installing the ispLEVER software, create a directory, and change to that directory, as in this example: mkdir / cd /

4 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Installing the ispLEVER 7.0 Software

4. Execute the install.csh script located on the disk with the path to the installation disk as its argument: /install.csh

Note: You can execute install.csh without arguments to get its help message.

5. After running the install.csh script, you will be prompted with: Do you want to install all of ispLEVER Design Tools? ([Y]/N)

Note “[Y]“ indicates that Y is the default selection when you press ENTER.

6. Enter Y to install all of the ispLEVER Design Tools. If you want to perform customized installation, enter N and jump to “Customized Installation” on page 5. 7. When prompted by the following prompt, enter Y or N as appropriate: Are you installing from the DVD drive? ([Y]/N) 8. When prompted by the following prompt, enter Y or N as appropriate: Are you installing from the CDROM drive? ([Y]/N)

At this point, the installer begins copying the installation files to your directory. If you are installing from the CD-ROM, you will be prompted to insert CD- ROM 2, CD-ROM 3, and CD-ROM 4. If you are installing from the DVD, you will not be prompted.

Customized Installation The ispLEVER customized installation enables you to select the Lattice FPGA devices you want to install on your system. You can also install ispVM System, set the software to automatically generate serial vector format (SVF), and use Checksum as the USERCODE default.

To perform customized installation of the ispLEVER software: 1. Follow step 1 through step 4 of the “Full Installation” on page 4. After running the install.csh script, you will be prompted with: Do you want to install all of ispLEVER Design Tools? ([Y]/N) 2. Enter N to select the parts of the software you want to install. ispLEVER 7.0 Installation Notice 5 Installing the ispLEVER 7.0 Software ispLEVER 7.0 Installation Notice

You will be prompted with: Do you want to install ispLEVER Design Tools (Part1)?([Y]/N) 3. Enter Y to proceed. You will be prompted with: ispLEVER Design Tools (Part 2, 3 & 4) will be installed automatically after installing Part 1. Are you installing Part 2, 3, & 4 from the DVD drive? ([Y]/ N) 4. Enter Y or N as appropriate. You will be prompted with: Are you installing Part 2, 3, & 4 from the CDROM drive? ([Y]/N) 5. Enter Y or N as appropriate. Now you will be prompted to choose the Lattice Semiconductor FPGA device options: Do you want to install the FPGA product family data files? ([Y]/N).

Lattice FPGA Device Options

To install Lattice FPGA devices: 1. To the following prompt from the previous step, enter Y to install Lattice FPGA devices: Do you want to install the FPGA product family data files? ([Y]/N) If you do not want to install Lattice FPGA device, enter N to jump to the next selection. You will be prompted with: Which FPGA families do you want to install? Please choose one of the following numbers: For example: enter 1 if you want to install LatticeECP2/ LatticeECP2S only.

1 --- LatticeECP/ECP2/LatticeECP2S 2 --- LatticeECP2M/LatticeECP2MS 3 --- LatticeSC/LatticeSCM 4 --- LatticeXP2 5 --- MachXO 6 --- LatticeXP

6 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Installing the ispLEVER 7.0 Software

7 --- LatticeEC/LatticeECP 8 --- All of the above 0 --- No FPGA Families

Please enter number(s) separated with a space: For example, enter: 1 4 (for LatticeECP/ECP2/LatticeECP2S and LatticeXP2) 2. Choose the FPGA devices that you want to install and enter the numbers accordingly. You will receive a confirmation message, showing your choices: You entered the following choice(s): 4 --- LatticeXP2 You will be prompted again to install from DVD or CD-ROM. 3. Enter Y or N as appropriate.

Setting ispVM Installation and SVF File Generation The ispLEVER installation script gives you the option, with a “Y” or “N” prompt, of forcing the installation of ispVM System and setting the default for SVF generation.

To set ispVM installation and SVF file generation:

‹ To the following prompt, enter Y or N as appropriate: Do you want to set the software to automatically generate Serial Vector Format (.svf) files? ([Y]/N) Now you will be prompted to set Checksum as the USERCODE default: Do you want to use Checksum as USERCODE default? ([Y]/N)

ispLEVER 7.0 Installation Notice 7 Installing the ispLEVER Software from a Server ispLEVER 7.0 Installation Notice

Setting CHECKSUM as USERCODE Default The ispLEVER installation script gives you the option, with a “Y” or “N” prompt, of setting the default for USERCODE to CHECKSUM. With this option, the ispLEVER software inserts the JEDEC file's CHECKSUM value into the USERCODE field. If the ispLEVER software is generating an ISC data file, it inserts the CRC value into the USERCODE field.

Note: For LatticeXP, LatticeXP2, and MachXO devices, CHECKSUM is the default for USERCODE.

To set CHECKSUM as the USERCODE default:

‹ To the following prompt from the previous step, enter Y or N as appropriate: Do you want to use Checksum as USERCODE default? ([Y]/N)

At this point, the installer begins copying the installation files to your directory. If you are installing from the CD-ROM, you will be prompted to insert CD- ROM 2, CD-ROM 3, and CD-ROM 4.

Installing the ispLEVER Software from a Server

The following sections explain how to set up the ispLEVER installation files on a server and install the software from the server instead of from the CD-ROM.

Setting Up the Files To copy the four CD-ROMs to a server: 1. Create the following directories: cd_1, cd_2, cd_3, cd_4. 2. Copy the contents from each of the four CD-ROMs to its appropriate directory.

To copy the DVD to a server: 1. Create a directory for the DVD contents, using lower-case letters. 2. Copy the contents from the DVD to the dvd directory that you created. The DVD contains the same files and directories as the three CD-ROMs.

8 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Installing the ispLEVER Software from a Server

Installing from the Server To install the ispLEVER software from the server to your local computer: 1. Create a directory for the installation on your local computer. 2. Change to the directory that you created. 3. Copy and paste the path for the installation script, and then paste it again without the installation script file name, for example: //cd_1/install.csh //cd_1 4. Press Enter. You will be prompted with: Do you want to install all of ispLEVER Design Tools? ([Y]/N)

‹ If you enter Y to perform full installation, refer to “Full Installation” on page 4 for further instructions.

‹ If you enter N to perform customized installation, refer to “Customized Installation” on page 5 for further instructions.

Installing Service Packs Lattice may introduce Service Pack updates to the ispLEVER 7.0 software. To see if a Service Pack is available, run the ispUPDATE tool, or visit the Lattice web site at: www.latticesemi.com/isplever

If you choose to download a Linux service pack, follow these instructions to install it.

Download the Linux service pack to your local temporary directory, , and use the following commands to execute the self- extracting .sh file for decompressing: cd /isptools/ sh /rl.sh

You can obtain the from ispUPDATE on the Web.

ispLEVER 7.0 Installation Notice 9 Installing Adobe Acrobat Reader ispLEVER 7.0 Installation Notice

Installing Adobe Acrobat Reader

Adobe Acrobat Reader is required for viewing manuals and data sheets in PDF format. If you do not already have Adobe Acrobat Reader installed on your system, you can use the Acrobat Reader installation file, acro_lin.taz, which is included in the acroread directory of CD-ROM 1. This file installs Acrobat Reader version 5.0.9. If you have an older version of Acrobat Reader, it is recommended that you install version 5.0.9 to ensure the proper viewing and printing of the documents. The acro_lin.taz file contains a readme text file with complete installation instructions.

After you install Acrobat Reader, each user must set the path to the software’s bin directory, as follows: set path = ( $path)

To apply the change, open a new window or type the following: source .cshrc

Licensing for the ispLEVER Software

You must set the license environment variable before running the ispLEVER software.

Note The ispLEVER 7.0 software uses FLEXlm 9.2 license administration software. Users of the ispLEVER 3.1 or older software must bring down the previous license daemon and start the new license daemon.

The default location of the license file is /isptools/license/ license.dat. If this location is changed, you must set the LM_LICENSE_FILE environment variable to include the new path name.

Note In order to change the LM_LICENSE_FILE variable, you must edit the .cshrc file. Do not change the license.dat location after installation.

10 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Licensing for the ispLEVER Software

Obtaining a License To register and license your ispLEVER software:

‹ Obtain the host ID of your license server with the following command: /isptools/ispcpld/bin/lmutil lmhostid

‹ Go to the Licensing section of the Lattice Semiconductor Web site (www.latticesemi.com/license) and follow the on-screen instructions.

Note Lattice Semiconductor supports licensing for a single server or three redundant servers. If you are using three redundant servers, enter all three server host IDs on the License File/Registration Form.

Lattice Semiconductor will send your ispLEVER license file (license.dat) to you by e-mail within one working day. After you receive the license file from Lattice Semiconductor, copy the license.dat file to the ispLEVER license directory as follows: /isptools/license/license.dat

Editing the License File You must edit a floating license file to specify the server name and the path to the Lattice daemon. The following example shows a floating license file: SERVER nodename 1234abcd 1710 DAEMON lattice daemon_path FEATURE LSC_ADVANCED lattice 10 02-may-2004 1 \ 8C9136CA9F6A "ispLEVER Advanced"

Edit the SERVER line by replacing the node name with the host name and the port ID (1710). The port ID must be unique, so you might need to change it.

To edit the Lattice DAEMON line, replace daemon_path with the path to the Lattice daemon, as in this example: /isptools/ispcpld/bin/lmgrd

ispLEVER 7.0 Installation Notice 11 Licensing for the ispLEVER Software ispLEVER 7.0 Installation Notice

When editing these lines, type them exactly as you received them. All entries are case-sensitive.

Note The encryption codes are in hexadecimal format (digits 0-9, and lower-case letters a-f or upper-case letters A-F). Enter the number 0, not the letter O; enter the number 1, not the lower-case letter L.

Starting the License Manager Type the following command on one line to start the license manager daemon: /isptools/ispcpld/bin/lmgrd -l /isptools/license/license.log -c /isptools/license/license.dat

Note Redirecting output to a log file is helpful when you debug licensing problems. The -l switch tells the license manager to send its output to a log file (license.log), and -c tells it which license to serve. The log file contains information on the status of the server and the daemon and TC port in use. It also shows which users have checked out the license and the checkout time.

Stopping the License Manager If it is necessary to stop the FLEXlm license manager, follow this procedure: 1. Confirm that the daemon is running by typing the following command: ps -ef | grep lmgrd 2. If lmgrd.exe is running, type the following command on one line to stop the daemon: /isptools/ispcpld/bin/lmutil lmdown -c /isptools/license/license.dat The following prompt appears: Shutting down FLEXlm on nodes: hostname Are you sure? [y/n]: 3. Type Y and press Enter to shut down the license daemon.

12 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Post-Installation Configuration

Post-Installation Configuration

The following sections give instructions on properly setting up the ispLEVER software for optimal performance after the software installation process.

Linking to or Copying the Installation Directory After installing the ispLEVER software, you might want to link the installation directory to another directory or copy the installation directory to another directory and set the installation path to the new directory.

To link or copy the installation directory to another directory: 1. If you want to link to the installation directory, create a soft link pointing to this location. If you want to copy the installation directory, choose the new path location and copy the files to it. 2. Set the NEW_INSTALL_PATH environment variable to the new directory location as follows: setenv NEW_INSTALL_PATH /isptools 3. If you want to return to the original working directory, set the NEW_INSTALL_PATH variable as follows: setenv NEW_INSTALL_PATH /isptools

Using the Examples Directory In order to use the design examples directory, you must copy the files from the server to your local system and change the write permissions. Copy the files from the server examples directory to the equivalent path and directory on your local system: /isptools/examples

ispLEVER 7.0 Installation Notice 13 Post-Installation Configuration ispLEVER 7.0 Installation Notice

Running the ispLEVER Project Navigator GUI The ispLEVER software has a graphical user interface (GUI) called the Project Navigator. When you use the ispgui script command, the software automatically performs the environment setup.

Note The ispLEVER Linux software supports EDIF designs only. Schematic, VHDL, and Verilog design entries are not supported.

To start the ispLEVER software Project Navigator GUI: 1. Set the PATH environment variable as follows:

Set path = (/isptools/ispcpld/bin $path)

Note If your license file (license.dat) is not under //isptools/license/license.dat, you must set the LM_LICENSE_FILE variable to the location of your license file. For example: setenv LM_LICENSE_FILE //license.dat

2. Set the display environment as follows: setenv DISPLAY :0.0 3. Type the following script command in the command line: ./ispgui

Refer to the online Help for more information about the Project Navigator.

Finding the Installation History When you install a service pack, control pack, or patch on a release, the ispLEVER software records a log of your installation history. You can find the history in the Project Navigator GUI.

To view the installation history: 1. Open the Project Navigator GUI. 2. Select Help > About Project Navigator.

14 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Post-Installation Configuration

Specifying the Default Browser You can specify a default browser on Linux. In your $PATH setting, specify the available browsers in order of preference. The preferred browser must be at the beginning of the list. By default, the ispLEVER graphical user interface (GUI) tools search the browsers in the following order: 1. 2. Mozilla 3. 4. HotJava 5. Mfcie

You must be sure that the browser that you want to use can be invoked in your shell. If no browsers are listed in the $PATH statement, the GUI tools will open mfcie.

For example, suppose that both Mozilla and Netscape can be used on your system, but you want to use Mozilla as your default browser. You must place Mozilla before Netscape in your path. If Netscape resides in /usr/bin/netscape and Mozilla resides in /usr/local/bin, your path may be /usr/local/bin : /usr/bin. If you do not want to change the order of /usr/local/bin and /usr/bin, make a link to Mozilla in your $HOME/bin directory, and always put your $HOME/bin directory at the beginning.

Note If you have trouble viewing the ispLEVER Help using your default browser, check the browser’s options to make sure that JavaScript is enabled.

Running Multiple Versions of the Software You can run multiple versions of ispLEVER at the same time from either the command line or the graphical user interface. You can run current and previous versions. However, the following restrictions apply:

‹ You cannot run a major release, such as 7.0, and one of its service pack releases, such as 7.0 SP1, at the same time. In addition, you must install the major release in one directory and in another directory install the major release and the service-pack release on top of it.

‹ One individual can install or run only one release at a time in UNIX or Linux. However, an individual can install or run one release in UNIX and at the same time run another release in Linux. Different individuals can install or run different releases at the same time in UNIX or Linux. ispLEVER 7.0 Installation Notice 15 Post-Installation Configuration ispLEVER 7.0 Installation Notice

Running from the Command Line You can run the ispLEVER software in batch mode using the ispflow command-line software. When you use the ispbatch command, as shown in the following procedure, the software automatically performs the environment setup.

Note 1. Run only EDIF designs with the ispflow command-line software for Linux. The ispflow command-line software for Linux does not support schematic, VHDL, or Verilog designs. 2. If you are running an EDIF design that was designed on a PC, you must convert the file from PC to Linux format. Use the following command: dos2unix .edf .edf

To run ispflow software using the ispbatch command: 1. Set the PATH environment variable as follows: set path = (/isptools/ispcpld/bin $path) 2. In your design directory, type the following: ispbatch [-i ] [-d ]

Note If your license file (license.dat) is not under //isptools/license/license.dat, you must set the LM_LICENSE_FILE variable to the location of your license file. For example: setenv LM_LICENSE_FILE //license.dat

Refer to “Environment Variable Setup” on page 17 for information about environment setup scripts. Refer to the online Help for more information about using the ispflow command-line software.

To refer to the online Help for command-line usage: 1. Open your Web browser. 2. Point your browser to this file: /isptools/ispcpld/webhelp/index.htm 3. The section on command-line usage can be found in the Design User Guide in the left Contents frame.

16 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Post-Installation Configuration

Environment Variable Setup The installation script creates two environment setup scripts: /isptools/ispcpld/bin/setup_lv.csh /isptools/ispcpld/bin/setup_lv.sh (for Bourne/ korn shell users)

If you want to set up your environment manually to run the ispLEVER software in batch mode—using programs such as ispflow, legacy2lci, or legacyglci—you can use the environment setup scripts.

After editing your license.dat file and starting the FLEXlm license manager, source either the setup_lv.csh or setup_lv.sh file as follows: source /isptools/ispcpld/bin/setup_lv.csh

or source /isptools/ispcpld/bin/setup_lv.sh

Configuring System Settings You must configure your system settings by using the MainWin Control Panel, shown in Figure 1. Configurable settings include the following:

‹ Date/Time

‹ Printers

‹ Regional Settings

‹ Display

‹ Internet Options

To configure your system settings: 1. Navigate to /isptools/ispcpld/bin directory, and type ispsetting.

ispLEVER 7.0 Installation Notice 17 Updating the ispLEVER Software ispLEVER 7.0 Installation Notice

The MainWin Control Panel appears, as shown in Figure 1.

Figure 1: MainWin Control Panel

2. Double-click the appropriate icon in the MainWin Control Panel to display dialog boxes for setting Date/Time, Printers, Regional Settings, Display, and Internet Options.

Updating the ispLEVER Software

After you have registered and licensed your installation, check the Lattice Semiconductor Web site for new software updates, device support, and enhancements. Make sure that you have the latest software by checking for updates regularly.

To activate ispUPDATE: 1. From the command line, in the /isptools/ispcpld/bin directory, type the following: iupdate

18 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Updating the ispLEVER Software

The main ispUPDATE window appears, as shown in Figure 2.

Figure 2: ispUPDATE Window

2. In the main window, click Setting. The Internet Connection Setting dialog box now appears with the Connections tab selected, as shown in Figure 3.

ispLEVER 7.0 Installation Notice 19 Updating the ispLEVER Software ispLEVER 7.0 Installation Notice

Changing the Connection Settings To enable the automatic checking, you must indicate how your computer accesses the Internet.

To change the Internet connection settings: 1. Select the Connections tab of the Internet Connection Setting dialog box, shown in Figure 3.

Figure 3: Connections Tab

2. Select one of the three Internet settings provided:

‹ Connect to the Internet directly – Select this option if you do not have to go through a proxy server.

‹ Use a proxy server – Select this option if you must go through a proxy server before connecting to the Internet. The proxy server prevents outsiders from breaking into your organization’s private network. Ask your system administrator for the URL address and port assignment. This option is turned on by default.

‹ Use automatic proxy configuration script – Select this option if you have an automatic proxy configuration file. Ask your system administrator for the URL address and type it in the text box provided.

Changing the Automatic Checking Settings The Lattice Semiconductor software can automatically check for updates and activate a window showing the ispLEVER updates available.

20 ispLEVER 7.0 Installation Notice ispLEVER 7.0 Installation Notice Updating the ispLEVER Software

To turn off or change the automatic update checking in ispUPDATE: 1. Select the Auto Check tab of the Internet Connection Setting dialog box. 2. If you want to enable the automatic checking for software updates, make sure that the Automatic check for ispLEVER software update option is selected. It is selected by default. If you want to disable the automatic checking, clear the Automatic check for ispLEVER software update option, as shown in Figure 4.

Figure 4: Disabling Automatic Checking in Auto Check Tab

3. If you selected the Automatic check for ispLEVER software update option, indicate the frequency with which you want the checking to be performed: every time that the Project Navigator is started, daily, or weekly. A daily check is the default. 4. Select Enable log to keep a record of the ispLEVER update checking. When you select this option, a log is kept, even if automatic checking is not implemented. This option is selected by default.

‹ If desired, rename the log file and select a different directory for the log file.

‹ Select Overwrite log to save only the last log. This option is selected by default. Clear this selection to append each log to the previous one. 5. Click OK.

ispLEVER 7.0 Installation Notice 21 Updating the ispLEVER Software ispLEVER 7.0 Installation Notice

Installing a Recommended Service Patch When you use the Auto Check feature, ispUPDATE notifies you whenever a new service patch becomes available. You receive notification when you open the Project Navigator.

To install the recommended service patch:

Do one of the following:

‹ Click Upgrade Now to immediately install the service patch.

‹ Click Download to save the service patch to a directory and install it later.

‹ Click Upgrade Later to do nothing now. You can wait for the next automatic check or update manually at a convenient time.

To manually check for and install a service patch: 1. Close all ispLEVER tools. 2. On a command line, type iupdate. 3. In the dialog box, click Update. The ispUPDATE software goes online to check for service patches. If one is available, the Select ispLEVER Patch Version dialog box opens. 4. In the top portion of the dialog box, choose the desired installed version of ispLEVER and a service patch. 5. Click Update.

To install a downloaded service patch: 1. Close all ispLEVER tools. 2. Go to the location where you saved the service patch. 3. Double-click the service patch file and follow the on-screen instructions.

22 ispLEVER 7.0 Installation Notice