                        HW-130 README
                        -------------

IBM RS6000 Workstation Operating Instructions
---------------------------------------------

Please read this document carefully, it contains important information
useful in the operation of the HW-130 programmer and software.

This readme covers the following:

 - General Information.
 - Hardware and Software Requirements.
 - Installation Software.
 - Software Compatibility.

General Information
-------------------

The HW-130 is an easy to use, desktop unit for rapid programming of all
Xilinx non-volatile devices. Designed and supported by Xilinx, the HW-130
programmer allows prototyping with new Xilinx devices, with no time lost
waiting for third-party manufacturers.

1.   For proper operation of the HW-130 programmer, it is essential that
     the user remove any device from the socket adapter when:
        -    Powering the programmer ON or OFF
        -    Performing a programmer RESET
        -    Changing any COMMUNICATION options

2.   The checksum calculation on the HW-130 for the XC1700 serial PROMs,
     will not produce the same checksum as the HW-112 programmer.

3.   The checksum calculation on the HW-130, for the XC7236, XC7236A,
     XC7272 and XC7272A will not produce the same checksum as the HW-120
     programmer.

4.   All HW-120 socket adapters, except the HW-120-PRM (for serial PROMs),
     are fully compatible with the HW-130 programmer.


Hardware and Software Requirements
----------------------------------

The following system requirements are needed to run the HW-130 software:

-  6 MB of hard disk space.
-  Serial device with a DB 25 (male gender) connector.
-  X-based Windows Manager (X11R5 or higher).
-  Operating System, AIX 3.2.5.0 or higher.


Installation Software
---------------------

The software is shipped as a tar file on a CD-ROM.  To install the
software:

1. Check if your CD-ROM drive is mounted:

  % /etc/mount

   If the CD-ROM has been mounted, you should see the following line
   on the display:

    /cdrom on /dev/cd0

   If the CD-ROM is not mounted, you need to mount it with the following
   command.  You need root access to perform this command.
 
  # /etc/mount -v 'cdrfs' -r /dev/cd0 /cdrom

   This will mount the CD-ROM drive to the '/cdrom' directory.

2. Running the CD-ROM installation script.  To run the script, type the
   following command:

  % /cdrom/install.rs6

   Note: You must type the '.rs6' extension.  There is another install 
   script but is not applicable to this platform.

   Follow the instructions on your screen.  The install script will 
   untar the hw130 file in the /cdrom/rs6 directory to the specified 
   target directory.

   Note: If the install script fails to install the software, you may
   manually untar the HW-130 software from the CD-ROM. Change directory
   to your home or to root.  Type the following command from the command
   line:

  % tar xvf /cdrom/rs6/hw130

   This will create a '/hw130/rs6' directory in your home or root 
   directory and copy all the required files to run the software.

3. Launch the X-based Window Manager on your workstation if it is not
   already running.

4. Connect the programmer to the serial port of your workstation and 
   to the power supply.  Turn on the power switch on the back of the 
   HW-130 programmer.

5. Change directory to the directory where the software was installed
   and type the following at the command line:

  % hw130 &

   This will launch the HW-130 User Interface software and automatically
   search for the programmer through all the availible ports.  A search
   is performed through the following ports:

   /dev/ttya
   /dev/ttyb
   /dev/tty0
   /dev/tty1

   If you are using a serial device other than these, the software will
   not be able to automatically find the programmer.  A dialog will 
   appear informing you that the software cannot find the programmer.
   Click on the 'Setup' button and specify the path and device name 
   that you use, e.g. '/dev/tty00'. Check that you have read and write
   permissions on the device that you use.

   Note: The software may produce errors similar to the following which
   may be ignored:

     _aixXLoadIM : IM Load Error [C]
      _aixXLoadIM returns NULL
         Warning:
         Name: hw130
         Class: ApplicationShell
         Cannot open input method - using XLookupString

  If table translation warnings are displayed when launching the 
  application, the XKEYSYMDB environment variable must be specified 
  to point to the X11R5 XKeysymDB file as follows:

 % setenv XKEYSYMDB /usr/lib/X11/XKeysymDB

  where '/usr/lib/X11' is the location of the XKeysymDB file.  Note 
  that the location of these files might be different on your system.
  Please contact your system administrator for further help.


Software Compatibility
----------------------

The application should be upwards compatible to higher Operating System
versions.  Although not officially supported, the software will run 
under AIX 3.2.4.0 and X11R4.

This application was tested using the following:

  Station:
  IBM RS6000

  System models:
  7012/350
  7012/340

  Operating System:
  AIX 3.2.5.0
  AIX 4.1.4.0

  Windows Environment:
  Motif Window Manager version 2.1

Please contact your system administrator for further help.

================================================================================
