For more detailed information on workstation installation, refer to the “Workstation Installation” chapter of the Xilinx Release Document.
To obtain the best performance from the Xilinx software, it is important to install the software correctly on the recommended hardware with the recommended operating memory capacity.
Use the steps in the following checklist as a guide when installing the software. This checklist applies to Solaris 2.5 and 2.6, Ultra Sparc (or equivalent), HP-UX 10.2, HP715 (or equivalent), and AIX 4.1.5. All workstation installations must be done while logged in with “root” authority.
| Step | Checklist |
|---|---|
| 1 | Be prepared to enter the number on the back of your CD-ROM package when you begin the installation process |
| 2 | Install Alliance Series Design Implementation Tools software |
| 3 | Install CAE interface and libraries |
| 4 | Install online documentation |
| 5 | Install CORE Generator (optional) |
| 6 | Set environment variables |
| 7 | Verify DynaText and variable settings |
| 8 | Verify installation |
Follow these steps to install the implementation tools.
Follow these steps to install the CAE interface and libraries.
If you have previously installed the Beta/Pre-release version of the Xilinx software you must re-load the DynaText Browser.
Install the online documentation as follows.
Refer to the “Workstation Installation” chapter of the Xilinx Release Document for information on installing the CORE Generator software.
You must set various environment variables for the Xilinx software to run correctly.
Set the following variables on HP workstations.
Set these variables as follows.
setenv XILINX installation_path_of_Xilinx_tools
set path = ($XILINX/bin/platform_name $path)
For Solaris workstations, set the following variables.
setenv LD_LIBRARY_PATH $XILINX/bin/platform_name:/usr/openwin/lib
For HP-UX workstations, set the following.
setenv SHLIB_PATH $XILINX/bin/hp:lib:/usr/lib
The following is an example for a Solaris workstation.
setenv XILINX /usr/xilinx
set path = ($XILINX/bin/sol $path)
setenv LD_LIBRARY_PATH $XILINX/bin/sol:/usr/openwin/lib
The Xilinx collection of online documentation is located in the $XILINX/doc/usenglish directory. The DynaText Reader Guide is located in the $XILINX/data/dtext directory. To view the documentation, use the DynaText browser included on the Alliance Series Documentation CD-ROM and installed with the online documentation. The browser is installed in the $XILINX/bin/platform_name directory. The DynaText environment is defined by the ebtrc file. There is an ebtrc file for each environment supported by the Xilinx software. The environment files are located in the $XILINX/bin/platform_name directories.
To use the appropriate setup file, you must set the $EBTRC environment variable. Set this variable as follows.
setenv EBTRC $XILINX/bin/platform_name/ebtrc
The following is an example for a Solaris workstation.
setenv EBTRC $XILINX/bin/sol/ebtrc
In addition to the $EBTRC variable, one of the following workstation variables must be set, depending on your particular platform.
Set the variable as follows.
setenv platform_variable $XILINX/bin/platform_directory
To use the DynaText browser enter the following command.
dtext
If the $EBTRC or $XILINX environment variables are not set correctly, DynaText returns the following error.
Your .ebtrc does not point to a valid DATA_DIR
To fix this error, verify that the environment variable is set correctly and that the path it references can be accessed from the machine running DynaText.
Some warning messages may be displayed on your screen. These warnings indicate missing font information and are due to the platform independence of the DynaText browser. Not all fonts are available on all platforms, as shown in the following example. You can safely ignore these warnings.
Warning: Missing charsets in String to FontSet
conversion
Warning: Cannot convert string
“-dt-application-bold-r-*-*-*-140-*-*-p-*-*-*,-sgi-
screen-bold-r-*-*-*-160-*-*-m-*-*-*,-*-
lucidatypewriter-bold-r-*-*-*-120-*-*-*-*-*-*” to
type FontSet
For more information on system requirements for running the DynaText browser, and how to make a local copy of the .ebtrc file for customizing, see the “Workstation Installation” chapter of the Release Document.
To increase the font size of the screen text in DynaText on the PC, select the following to display the Preferences dialog box. Increase the value in the Zoom field to enlarge the text on the screen.
File 
Preferences
To define a list of printers, select the following in the DynaText window.
File Preferences Printers
You can also configure your browser to print various page sizes and orientations by updating the $XILINX/data/dtext/data/ps/config.dat file. Your System Administrator can update this file.
The config.dat file uses an SGML syntax, with the SPOOLER, FONT, and TYPEFACE elements. The SPOOLER element is used to define both the list of printers and the print orientation. The syntax of the SPOOLER tag is as follows.
<SPOOLER NAME= PrintSpooler WIDTH= PointsWide HEIGHT=
PointsHigh COMMAND=”SysPrintCmd“>
These attributes are described in the following table.
| Attribute | Value | Description |
|---|---|---|
| NAME | PrintSpooler | UNIX print-spool name or “default” representing the default printer assigned by the PRINTER environment variable of the process running the browser. The value of this attribute appears in the File Preferences Printers menu. This value must be unique. |
| WIDTH | PointsWide | Width in points of the print output (72 points per inch; 28.35 points per centimeter), as in the following examples. 8.5 x 11 paper = 612 points wide* A4 paper = 598 points wide* |
| HEIGHT | PointsHigh | Height in points of the print output, as in the following examples. 8.5 x 11 paper = 792 points high* A4 paper = 845 points high* |
| COMMAND | SysPrintCmd | UNIX printing command for submitting a print job to the specified print spooler. |
| * The sample values given are for portrait orientation. To print in landscape orientation, switch the values for WIDTH and HEIGHT. | ||
The following are examples using the SPOOLER element to define the printer.
<SPOOLER name=default width=612 height=792 command=”lp”><SPOOLER name=mp1 width=612 height=792 command=”lpr -Pmp1”><SPOOLER name=mp1wide width=792 height=612 command=”lpr -Pmp1”>After the required environment variables are set, you should verify that they are set correctly. Enter the following command to test your setup.
par
If your setup is correct, PAR runs normally and returns command line information. If a variable is incorrectly set, you may get error messages similar to those in the following table.
| Error Message | Solution |
|---|---|
| par: Command not found | Setup has a variable incorrectly set. Check your path and XILINX environment variables. |
| ld.so: libbasgi.so.1: not found | Check the LD_LIBRARY_PATH environment variable if running Solaris, or the SHLIB_PATH environment variable if running HP-UX. |
| FATAL ERROR: The XILINX environment variable must be set. Exiting... | Check the XILINX environment variable. |
Refer to the “Using LogiBLOX with CAE Interfaces” appendix of this manual.
