Warp Release 4.1 Release Notes July 1996 This file contains information for all Warp products. Certain sections may not be applicable to you depending on the product you have purchased. Release 4.1 is an update release for Release 4.0 and all information contained herein applies to both releases. Release 4.1 adds support for the Ultra38000 and Flash370i series devices. Release 4.1 can be installed on top of Release 4.0 if you chose to do so. In the follow- ing document, the term "Release 4.X" is used to imply either releases. There are three different packages currently available and the following is a short description. 1. Warp2 This product supports Cypress' family of small PLDs (c16v8, c22v10, etc) and CPLDs (c34x, c37x, c37xi families) and FPGAs (pASIC380 and Ultra38000 families). It is also capable of Bolting in to ViewLogic PowerView and WorkView+ products. With Viewlogic Powerview, this product adds a very powerful schematic entry system with parameterized libraries, netlisting, backannotation and simulation, depending on which licenses you already own. Warp does not yet support the Viewlogic Workview Office environment for the Windows 95 or the Windows NT platforms. Warp has been tested under the following Viewlogic environments. Unix Platforms -- Powerview 5.3.2 PC Windows 3.1x -- Workview+ 5.2 Licenses for ViewLogic tools can be purchased from ViewLogic directly. We recommend the following products. 1. Digital Design Entry (Schematic entry tools) 2. ViewSim/SpeedWave simulator Even without the graphical entry, this package provides powerful high level synthesis for ALL of Cypress PLDs/CPLDs/FPGAs. 2. Warp3 This is the same product as Warp2 except that it comes packaged with all the necessary ViewLogic tools to take full advantage of High level VHDL design, schematic entry, mixed mode design entry, post-layout timing simulation, etc. To obtain your Warp3 license ---------------------------- Warp3 requires a license file to enable all the functionality. For existing customers under maintenance, your license file maybe available directly on the CDROM in the 'licenses' subdirectory at the top level and will have the same name as your hostid with a .wv extension. If your license file is not found in the directory please read the following instructions. PC Customers ------------ To obtain your license.wv file, please refer to the registration card included with this software. The hardware key and the license.wv file are necessary to run Warp3 and will require reactivation every 12 months. Cypress Applications will provide a license file good for one full year from the date of activation. Sun and HP Customers -------------------- If you purchased Warp3 for the Sun or HP unix platforms, you need to login to the machine where the software needs to run and do the following to determine your hostid cd /pv ./vlhostid This will display the hostid. Please note this information before contacting Cypress for a license file. 3. Warp2Sim This package is identical to the Warp3 package except that it lacks design entry using schematic capture. All the instructions that apply to Warp3 also apply to this product. Features in Warp Release 4.X: ----------------------------- Devices Supported: ------------------ PLDS: 16L8, 16R4, 16R6, 16R8, 16V8, 20G10, 20RA10, 22V10, 22VP10, c331, c335, c20V8 Complex PLDs: MAX340 : c341, c342, c343, c344, c346(84 and 100 pin) Flash370: c371 (32 Macrocells, 2 Logic Blocks) c372, c373 (64 Macrocells, 4 Logic Blocks) c374, c375 (128 Macrocells) Flash370i: c371i (32 Macrocells, 2 Logic Blocks) c372i, c373i (64 Macrocells, 4 Logic Blocks) c374i, c375i (128 Macrocells) FPGA pASIC380: 1K c381a, c382a, c381p, c382p, c3381a, c3382a 2K c383a, c384a, c3383a, c3384a 4k c385a, c386a, c385p, c386p, c3385a, c3386a 8k c387p, c388p, c3387p, c3388p c38xa is our 5-volt family c38xp is our 5-volt PCI compliant family c338xa is our 3-volt family c338xp is our 3-volt PCI compliant family FPGA Ultra38000: (Currently only available on the PC platforms) 5K c38005 7K c38007 9K c38009 Please note that the Flash370 series will soon be replaced by the Flash370i family which allows in-system-reprogramming. Also, additional devices and packages maybe be added to Warp as needed. Please use Galaxy to get an accurate list of devices/packages supported. Getting Started: ------------------- For All platforms: During installation, if you have allowed Warp to install the documentation for Warp, Warp places the Acrobat files in the \doc directory. If you have chosen not do this, these files are available on the CD in the \doc directory. The CDROM also contains the current Cypress Datasheets in Acrobat format in the \doc\databook directory. The most recent datasheets however can be obtained from the Cypress WWW site. These datasheets are not automatically installed by Warp. For PC: Installation for the PC is fully automated. To install Warp, run the Warp setup program d:\pc\setup.exe where 'd:' is your CDROM drive. During this installation, the following changes will be made during this installation to the following files. 1. Autoexec.bat If SHARE is running from this file, it is deleted The following lines are added to your autoexec.bat set CYPRESS_DIR= For Warp3, the following lines are also added set WVPLUS=%CYPRESS_DIR%\WVPLUS set PATH=%WVPLUS%;%PATH% set WDIR=%CYPRESS_DIR%\WARPSTD;%WVPLUS%\STANDARD set SYSPLT=%WVPLUS% If Warp2 is being configured into the Viewlogic WorkView+ environment, the following line is added set WDIR=%CYPRESS_DIR%\WARPSTD;%WVPLUS%\STANDARD All the above lines should be added in the order specified above and after the initial PATH setting preferable at the end of the autoexec.bat file. If the above changes were made to the file automatically, a backup is saved with a numeric extension. 2. Config.Sys If SHARE is running from this file, it is deleted 3. Windows\win.ini [SpDE] INI-PATH=\SPDE\DATA For all customers, the following line is added in the Extensions section WPR=\bin\galaxy.exe ^.WPR 4. Windows\system.ini If Microsoft Win32s is installed by Warp the following two lines will be added DEVICE=C:\WINDOWS\SYSTEM\WIN32S\W32S.386 DEVICE=C:\WINDOWS\SYSTEM\VSHARE.386 For Warp3 customers only, the following two lines are also added. DEVICE=\WVPLUS\ENV.386 DEVICE=\WVPLUS\VMD.386 Warp documentation is also available online. It can be viewed using Adobe Acrobat Reader, shipped with the CDROM. To install Acrobat Reader, insert CD and using the File Manager in Windows, locate \pc\acroread\disk1\setup.exe and double click the left mouse button on this file. It will automatically install the Acrobat Reader. For SunOS/Solaris/HP: - To install Warp, follow these steps Mount the CDROM (logging in as root if you have to) and assuming that you have mounted the CDROM as /cdrom, Note: Depending on how the system which is mounting the CD-ROM, you may have to use all lower-case letters on the HP platform during installation. Please list the directory to see which case is being shown in your system. - on Sun SunOS 1) cd /cdrom/sunos 2) ./install.wr4 - on Sun Solaris 1) cd /cdrom/solaris 2) ./install.wr4 - on HP 1) cd /cdrom/HP 2) ./INSTALL.WR4 The Warp installation program will step you through the installation process and will also give you the option of installing the Acrobat reader. If you skip this step and would like to install the Acrobat reader separately, please do the following after having mounted the CDROM as described above - on Sun SunOS 1) cd /cdrom/sunos/acroread 2) ./install - on Sun Solaris 1) cd /cdrom/solaris/acroread 2) ./install - on HP 1) cd /cdrom/HP/ACROREAD 2) ./INSTALL - The following sections describe the process necessary for correctly setting up the different products. This has to be done manually for each user. - If the user is using C shell, add the following lines to ~/.cshrc file. setenv CYPRESS_DIR set path = ($CYPRESS_DIR/bin $path) setenv SPDE_ROOT $CYPRESS_DIR/spde setenv XVTPATH $SPDE_ROOT/print setenv UIDPATH $SPDE_ROOT/%N.uid set path = ($SPDE_ROOT $path) On Sun/Solaris, also include the following line.. setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${SPDE_ROOT} On HP, also include the following line. setenv SHLIB_PATH ${SPDE_ROOT} On all platforms, copy the pASIC configuration file ($CYPRESS_DIR/spde/.spderc) into your home directory. If you already have purchased Viewlogic tools, add the following line to your ~/.cshrc file setenv WDIR ~/:$CYPRESS_DIR/warpstd:/standard If you have purchased Warp3 product, add the following lines to your ~/.cshrc file setenv WDIR ~/:$CYPRESS_DIR/warpstd:$CYPRESS_DIR/pv/standard set path = ($CYPRESS_DIR/pv $path) In the above is a local directory where user specific Powerview files and user design files can be stored, and is the PowerView installation directory. For Warp2 customers trying to integrate Warp into the Viewlogic environ- ment, it is important that the $CYPRESS_DIR/warpstd directory appear before the /standard directory. Source the ~/.cshrc file. - If the user is using Bourne shell, add the following lines to $HOME/.profile file in the same order. CYPRESS_DIR= PATH=$CYPRESS_DIR/bin:$PATH export CYPRESS_DIR PATH SPDE_ROOT=$CYPRESS_DIR/spde XVTPATH=$SPDE_ROOT/print UIDPATH=$SPDE_ROOT/%N.uid PATH=$SPDE_ROOT:$PATH On Sun/Solaris, also include the following lines. LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SPDE_ROOT export SPDE_ROOT XVTPATH UIDPATH PATH LD_LIBRARY_PATH On HP, also include the following lines. SHLIB_PATH=$SPDE_ROOT export SPDE_ROOT XVTPATH UIDPATH PATH SHLIB_PATH On all platforms, copy the pASIC configuration file ($CYPRESS_DIR/spde/.spderc) into your home directory. If you already have purchased Viewlogic tools, add the following lines to your $HOME/.profile file WDIR=$HOME/:$CYPRESS_DIR/warpstd:/standard export WDIR If you have purchased Warp3 product, add the following lines to your $HOME/.profile file WDIR=$HOME/:$CYPRESS_DIR/warpstd:$CYPRESS_DIR/pv/standard PATH=$CYPRESS_DIR/pv:$PATH export WDIR PATH In the above is a local directory where user specific Powerview files and user design files can be stored, and is the PowerView installation directory. For Warp2 customers trying to integrate Warp into the Viewlogic environ- ment, it is important that the $CYPRESS_DIR/warpstd directory appear before the /standard directory. Source the $HOME/.profile file. - If you are running SunOS 4.1.x, make sure that /usr/openwin/lib and /usr/motif/lib are included in the LD_LIBRARY_PATH before running Warp. - If you are running Solaris 2.3/2.5, make sure that /usr/openwin/lib is included in the LD_LIBRARY_PATH before running Warp. - If you are using Viewlogic tools, also make sure that WDIR path includes a writable directory ( above). - ViewLogic tools should be available from the PATH env. variable. Without this, certain features from Warp may not be accessible. - Place your copy of the "license.wv" in the first directory of the WDIR path. - Note that the documentation for the ViewLogic software is on-line, hard copies of the manuals can be purchased separately. Online documentation for ViewLogic tools can be viewed by executing the following command (if you have the viewlogic tools in your path) online What's new in Warp Release 4 : ------------------------------ 1. Support for VHDL 1164 stdlogic types 2. Advanced synthesis of math operators 3. All library elements (except multipliers) have been extended to 32 bits or more. 4. Library elements (instantiated either in a schematic or using VHDL text) are parameterizable and are highly optimized for Cypress CPLD and FPGA architectures 5. A new more flexible GUI for better project management 6. Support for VHDL and Verilog simulators 7. Improved c37x fitting and misc. features accessible from Galaxy. 8. Improved c37x and c38x synthesis. Results for c38x are considerably better (50% reduction in area and speed) for most designs. Behavioral designs will show more improvement than hand crafted schematic or structural designs. 9. Automatic buffer and PAD generation for c38x family 10. pASIC place and route tool SpDE upgraded to 5.1 version. This version has the following features/changes. * Improved Technology Mapping * Path constraints are remembered through design iterations * CHIP files are automatically saved after running tools * When the chip is saved, report file is generated automatically. * Final timing numbers are added for the 8K pASIC parts * Simulation support extended to a wide class of VHDL simulators including VITAL-Compliant * Bug fixes 11. Warp documentation is now available online and it can be viewed using Adobe Acrobat reader Notes about Warp ---------------- Library of parameterized elements (LPM) --------------------------------------- To be able to use Cypress's new parameterized library, some setup is required. The Parameterized library generator creates custom symbols from within the schematic entry tool on demand. Such symbols are automatically maintained by the Library Management software. The user has to select a directory which the Library Management tool can have complete control over and can use it as scratch area. This directory should be associated to a viewlogic library 'lpmlocal'. The first time you enter ViewDraw, instructions on how to initialize the lpm library are printed as an Alert message. Please follow these instructions. The process involves the creation of a directory where all LPM symbols are stored. Please NOTE that the lpmlocal directory should not be modified manually. If your design/project is being shipped to remote sites, this lpmlocal directory has to be shipped with it. Also NOTE that this library should be backed up like any other data. When creating new projects, the above steps should be repeated. However, the same lpm library directory can be shared by multiple projects or even users (conditional on the others users having write access to this directory). ViewLogic online documentation issues (PC users) ------------------------------------------------ When installing Warp, you will be asked if you want to install ViewLogic installation. If you choose not install ViewLogic documentation, you can still gain access to it using your CDROM. However, if you install on a Network drive with ViewLogic documentation and you want other users on the network to gain to this, all machines wishing to do so must use the same Drive Letter to accomplish this. When installing Warp3 without ViewLogic Documentation with the intention of accesing documentation directly off of the CDROM, you will have to go through some additional steps to be able to see the documentation if your CDROM drive letter is something other 'D'. Normally, clicking on the WorldView icon in the program manager will invoke the browser and load the documentation. If you want to access the documentation from the CDROM, use the File Manager to locate the iview.exe under the directory E:\pc\vldoc\wvplus\iview2\iview.exe and invoke the program by double clicking on it. Once the WorldView is up, use the 'Open Collection' menu item under the File Menu and open the collection that you are interested in. The following collections are available \pc\vldoc\wvplus\wvhelp\edf52\edf52.cfg Contains EDIF interface documentation \pc\vldoc\wvplus\wvhelp\edf52\gen52.cfg Contains General Framework doc., and ViewDraw, and other utilities. \pc\vldoc\wvplus\wvhelp\edf52\sim52.cfg Contains ViewSim and Vietrace documentation Compatibility with Version 3.5 ------------------------------ Warp Release 4.X has a new parameterized library that is not compatible with the fixed library that was available in Version 3.5. When Warp R4.X is installed, it configures itself for the new parameterized library. However, for those who are in the middle of their design cycles, we still provide access to the previous library. This applies to ALL customers. To switch to 3.5 library: SunOS/Solaris/HP: Logged in as the user who installed Warp (so that this user has permissions to modify the Warp install directory) and making sure that the CYPRESS_DIR environment variable is set to the correct directory, please execute the following command. $CYPRESS_DIR/cypver Essentially, this command performs the following tasks automatically for you. cd $CYPRESS_DIR rm lib ln -s lib35 lib cd warpstd cp viewdraw.v35 viewdraw.ini Unfortunately, the above changes, basically configures all users using Warp R4.X to the 3.5 libraries. If you have a situation where some users want to use the 3.5 libraries and some want to use the 4.X libraries, you can achieve this by either installing Warp twice in different directories or by using symbolic links to emulate the above directory structure. For example, the following c-shell script will clone a 3.5 library from an already installed Warp configured for 4.X library #!/bin/csh -f # # Assume that the Warp release that is installed at # /usr/local/warp and you want to clone it using # another directory /usr/local/warp35 that configures # warp r4.X for the 3.5 libraries # mkdir -p /usr/local/warp35 cd /usr/local/warp35 foreach i ( /usr/local/warp/* ) ln -s $i end # Configure the VHDL libraries for Version 3.5 rm lib ln -s lib35 lib # Configure ViewLogic libraries for Version 3.5 rm warpstd mkdir warpstd cd warpstd foreach i ( /usr/local/warp/warpstd/* ) ln -s $i end rm viewdraw.ini cp viewdraw.v35 viewdraw.ini Using CYPRESS_DIR to point to the new directory, users can now access 3.5 libraries. PC: Please use the 'Library' Icon available in the Program manager's Warp program group. ---------------------------------------------------------------------- For technical information and assistance, please contact Cypress applications via our WEB site or through email. Web site : http://www.cypress.com email : cyapps@cypress.com You can also call one of the following toll free numbers for technical assistance. Toll-free numbers : Australia 0014-800-125-203 Belgium 11-8729 Denmark 8001-0413 Finland 9800-10065 France 05-90-1251 Germany 0130-81-1902 Hong Kong 800-7214 Israel 00-17-942-1803 Italy 1678-97-034 Japan 0031-11-1731 Korea 008-1-800-942-8203 N. America 1-800-419-1481 Netherlands 06-022-5303 Norway 050-12068 Singapore 800-1578 Spain 900-99-1163 Sweden 020-795-637 Switzerland 046-05-8808 UK 0800-89-7339 USA 1-800-419-1481