********************* Using the Host Adapter Flash Utility ********************

This document provides information for the DOS based LSI Logic Flash Utility for
downloading firmware and BIOS images to LSI Logic's 53C1030/53C1020 based PCI to
SCSI adapter cards.  It contains a feature and description section. 

*  *  *  *  *  *  *  *  *  *  * Features *  *  *  *  *  *  *  *  *  *  *  *

o  Supports host adapter selection for updating.
o  Provides means to identify Firmware or BIOS image version on the adapter or 
   residing in a file. 
o  Provides for total flash part erasure.
o  Provides means to modify ASCII banner information in a BIOS image prior to
   downloading to an adapter or for writing back out to a file.
o  Supports command line execution.


*  *  *  *  *  *  *  *  *  *  *  Description *  *  *  *  *  *  *  *  *  *  *

This utility allows the user to update the LSI Logic MPT based Firmware and/or
SCSI BIOS on host adapters based on the SYM53C1030 SCSI chip. New versions of 
both images are released periodically. Your host adapter must have a flash on
board to use this utility.

The utility's executable name is FLSH1030.EXE. This utility requires the DOS 
extender, DOS4GW.EXE, to operate.  It is strongly recommended that both files
be placed on a DOS bootable diskette and the utility executed from this diskette.
Either MS-DOS or PC-DOS is acceptable and ideally, no memory manager or other
drivers beyond the minimum required should be installed via the config.sys file.
Execution from a hard drive is an option.  However, this drive should not be a
drive connected to a board to be updated and the DOS4GW extender should reside in
the same directory as the utility executable.

Insert the diskette into drive "a:". Boot the system to the DOS prompt a:\>. 
Type FLSH1030 and press Enter.  (DOS4GW will be loaded automatically if located in
the same directory as the utility or is in the defined path.)

The main window allows the user to choose which 53C1030 chip will be the path used
to perform the selected tasks through.  Dual channel cards will have two entries
(chips) displayed on this screen.  Since both channels of a dual channel board
share a flash part, only one of the paths needs to be chosen.  However, no harm 
will be done if separate updates are done through both. 
This screen appears as:


               Vendor     Device
    Choice     ID         ID        Bus     Device
    -------    ------     ------    ---     ------
       1        1000h      0030h     3h       10h
               LSI Logic, Inc.    SYMC1030 Ultra320 SCSI

       2        1000h      0030h     3h       11h
               LSI Logic, Inc.    SYMC1030 Ultra320 SCSI

       3   -   Refresh

    Which PCI chip (0 to quit)?


    
Once a chip has been chosen, another menu list will be displayed as follows:

    FLASH
           a - Identify
           b - Download Flash
           c - Upload Current Flash to a File
           d - Erase Flash

    Misc.
           z - Select PCI Chip
           q - Quit


- The Identify option will display the version number of current the MPT Firmware
  or the MPT BIOS residing on the adapter with the currently selected PCI chip. 
  It can do this same function on MPT Firmware/BIOS image files, requiring the 
  user to input the filename to check.  Currently, if the BIOS image area contains
  multiple images (MPT BIOS w/EFI BSD or MPT BIOS w/FCode), this option will only
  return the version of the MPT BIOS.

- The Download Flash option provides the user with choices for downloading images
  to the flash part on the adapter with the selected PCI chip.  Downloading of the
  MPT firmware and MPT BIOS images are separate choices requiring only the corresponding
  image file name as input. Additional choices allow the user to alter the ASCII 
  banner string in the MPT BIOS image, either just prior to downloading to the adapter
  or the altered image can be written out to a file.  The user will be prompted for
  the new banner contents and informed of the maximum length that can be entered.  Once
  the banner has been altered in an image, that image cannot be the input for this
  operation again as the location of the changeable string relies on the released LSI
  Logic banner contents.  Support has been added to handle MPT BIOS download files that
  contain multiple images (MPT BIOS w/EFI BSD or MPT BIOS w/FCode) concatenated together.

- The Upload option will upload the entire flash part contents and write it out to
  a file named by the user.  This image will contain both Firmware and BIOS images
  along with any unused areas of the flash part.  The separate images cannot be broken
  out at this time.  Current image size will be 512KB, it is the user's responsibility
  to ensure adequate disk space is available prior to selecting this option.  Truncated
  upload images can result if there is not enough room on the destination disk for
  the entire image.  A complete (512KB) image can be used as the input file when per-
  forming a MPT Firmware download operation.  This will allow a more streamlined process
  if the user wishes to download multiple adapters with identical firmware and BIOS
  images.   

- The Erase option will erase the entire flash part on the adapter with the currently
  selected chip.  Until replacement images are downloaded to an adapter after this
  operation, the adapter is inoperable.

  
The following command line options are supported by this utility and can be used to 
create an automated process to perform the utility's operations.

           -[/]a    Option to update all boards found with the images
                    specified with the /b and/or /f options.  Will cause
                    the /d option to be ignored if entered.  

           -[/]b:x  Download the BIOS image where x is the name of the input file.
                    If x is missing, this option is ignored.

           -[/]c:x  Concatenate this image with the /b image prior to down-
                    loading the resulting image to the flash part.  Must 
                    precede the /b option to be effective.  If the \o option
                    is also entered, the concatenated image will be redirected
                    to the filename specified.  If x is omitted, this is not
                    a valid option and will be ignored.

           -[/]d    Select current Adapter/chip.  This will require the user to make
                    a selection from a menu.  This selection will be used while pro-
                    cessing command line arguments following this one.  

           -[/]e    Erase the entire Flash part.

           -[/]f:x  Download the firmware image where x is the name of the input file.
                    If x is missing, this option is ignored.

           -[/]m    The BIOS image specified by the /b option contains multiple
                    images (legacy BIOS, EFI BIOS, etc.).  Must precede the /b
                    option to be effective.  Do not use this option in combination
                    with the \c option.

       **  -[/]o:x  Option to redirect the prepared BIOS image to a file with
                    the name x.  If x is missing, this option is ignored.
                    Must be entered in conjunction with, and must precede, the
                    /b option. The /a option (if entered) will be ignored.

           -[/]?    Displays this screen.


 **  -  When the user chooses to download a new BIOS image to a board, this utility 
        modifies certain fields in the image to reflect the chip type of the board 
        selected.  If the /o & /b options are input, the image specified via the /b
        option will be modified for the chip type of the board being processed and
        will then be written out to the file named via the /o option instead of being
        downloaded to the board.



*  *  *  *  *  *  *  *  *  *  *  MISC. *  *  *  *  *  *  *  *  *  *  *

Flash ROM part numbers and corresponding sizes are:

    xxxxx040  -  512K byte capacity


Host adapters supported: 

   53C1030 based - LSI21320
                   LSI22320

   53C1020 based - LSI20320