               KGPSA-BC DOS DIAGNOSTIC UTILITY MANUAL
                               v8.4

1.   Description

The DOS Diagnostic Utility (LP6DUTIL) is a DOS-based program which 
provides facilities to test the different areas of the KGPSA-BC
PCI Host Adapter and to display information about the host adapter.  This
program is intended for use in a stand-alone environment.


2.   PC DOS Test Station Memory Requirements

The DOS diagnostic has different memory requirements based on which 
adapter card is being tested.

If a KGPSA-BC PCI Host Adapter card is detected, all communication with
the adapter is performed via I/O ports, and therefore there are no special
memory requirements.

   
3.   To Start LP6DUTIL

     At the DOS prompt enter:

        LP6DUTIL [o=outfilename] [i=infilename] [/nr] [d=xxxx]

     where 

        outfilename   - file where all output messages will be logged;
                        all messages except user's entered data begin
                        with a # symbol at the beginning of each line
                        of the output file to indicate a comment line; 
                        user-entered data appears on a line by itself 
                        without the preceding # symbol
        infilename    - script input file, which is read and execute 
                        by the program as if the data were entered 
                        from the keyboard; the program will skip over 
                        all lines in the input file that start with a 
                        # symbol
        /nr           - disable adapter reset, upon program start
        d=xxxx        - search for an alternate PCI device_id on
                        program start (where xxxx = alternate
                        device_id, ONLY NECESSARY FOR OEM SPECIAL firmware)

The scheme of allowing input and output files, enables the user to rerun 
previous sessions without reentering the data.  This is done by running 
LP6DUTIL and logging the session to an output file.  The user then can 
rerun the previous session by specifying the previous run's output file 
as the current run's input file.  Note that nesting of input files is 
currently not supported.

   
4.   LP6DUTIL Start-Up Procedure:

The following steps are taken by the LP6DUTIL before displaying the Main 
Menu of the LP6DUTIL.  If no host adapter is found, the LP6DUTIL program 
will exit.

 1.   Determine if PCI BIOS exists in the system.
 2.   Use the PCI BIOS functions to search for all LP6K/7K/8K PCI Host 
      Adapters.
 3.   Read BIU PCI Configuration information for all Host Adapters 
      found.
 4.   Read PCI configuration registers to identify IOmapped address space.
 5.   Run preliminary tests to check out host access paths to the 
      host adapters.  The tests to be run are SLIM Memory Tests, 
      BIU Registers Tests, and BIU Configuration Registers Tests.
 6.   Reset the host adapters and check the POST status of the host 
      adapters.
 7.   Determine if the host adapter is READY by checking the FF 
      READY and MAILBOX READY bits in the BIU Host Status Reg.
 8.   Display the status of all the host adapters and their current 
      operational firmware revision.
 9.   Display the resources of each host adapter.


5.   Sample Output of Start-Up Procedure

         WELCOME TO LP6DUTIL HOST DIAGNOSTIC UTILITY Revision 8.4

*******************************************************************************
* WARNING: This utility may not work with the Expanded Memory Manager         *
*          (EMM386). Please read LP6DUTIL documentation for further details.  *
*******************************************************************************

LP6000 Host Adapters found in the system: 1

PRELIMINARY TESTING of Host Adapter 1
        Host Adapter 1: PASS 0xA: SLIM Memory Tests 
        Host Adapter 1: PASS 0xA: BIU Registers Tests 
        Host Adapter 1: PASS 0xA: BIU Configuration Registers Tests 
Adapter 1 PASSED PRELIMINARY TESTS

Resetting Host Adapter 1

Host Adapter 1: POST Done.
Host Adapter 1 is READY. Functional Firmware Loaded.
        Diagnostic Firmware Version 2.00N3
        Functional Firmware Version FF1.00X8
        JEDEC ID = 11ACC057 (LP6K)

Hit RETURN or ENTER key to continue
<return>
                 HOST ADAPTER 1 Resources Info
pci_bus_num = 0                          pci_dev_num = 0xA0
slim_base_adr = 0x000D0000               reg_mem_base_adr = 0x000D1000
reg_io_base_adr = 0x0000FC00             IRQ = 0xB



6.   LP6DUTIL Main Menu

After LP6DUTIL goes through the start-up procedure, it displays the Main 
Menu and handles user requests.  The following sections show and 
describe the Main Menu and submenus.

NOTE: Enter 0 in 'Option:' prompt to display previous menu
NOTE: All values entered are hexadecimal

                         LP6DUTIL Main Menu Revision 8.4
1 - Test Host Adapters
2 - Modify Test Options
3 - Restart Host Adapters
4 - Input/Output
5 - Maintenance
6 - Show Host Adapters Info
7 - Quit
                                 Option: 

Note that if LP6DUTIL found two or more host adapters in the system, it 
will prompt the user to select which host adapter or host adapters to 
apply the user specified menu selection.

Select host adapters by specifying a list of numbers from 1-2 separated
by spaces or use a '-' between two numbers to specify a range of host
adapters : 
<1 2>

The above message will not be seen if there is only one host adapter 
found by LP6DUTIL program.


6.1.      Test Host Adapters

This menu selection is used to run host-based loopback tests on the host 
adapters.  The BIU PCI Loopback and the Internal Loopback Tests
will always be run.  The user selects to run or not to run the External 
Loopback Tests.

Enable External Loopback? (0=No, 1=Yes, def=0): <return>

TESTING Host Adapter 1 (p=pause, c=cont, s=stop)
        Host Adapter 1: PASS 0xA: BIU PCI Loopback Tests 
        Host Adapter 1: PASS 0xA: Internal Loopback Tests 
Host Adapter 1 PASSED TESTS


6.2.      Modify Test Options
   
This menu allows the user to have more control over host-based tests 
selection and the number of passes to run the selected tests.

                                 Modify Test Options
1 - Select Tests To Run
2 - Select Test Options
3 - Start Testing
4 - Configure SRAM Test
                                 Option: 




6.2.1   Select Tests To Run

This menu is used to selected host-based tests to run.  Note that 
options 1-4 toggle the appropriate selection on or off.  Option 4 is 
used to select/deselect all tests.  Option 5 will display the list of 
enabled test names.

                                 Select Tests To Run

NOTE: Options 1-4 toggle the appropriate selection on or off 
      based on the current state (enable/disable) of the test.

1 - PCI Loopback
2 - Internal Loopback (Thru GLM)
3 - External Loopback
4 - All
5 - Display Tests Enabled
6 - BIU2 TX and TX DMA
7 - BIU2 GP DMA
8 - BIU2 CONCURRENT DMAs
9 - SRAM Test
                                 Option: 


6.2.1.5   Display Tests Enabled

Tests Enabled:
        PCI Loopback Test
        Internal Loopback Test


6.2.2   Select Test Options

Enter number of times to run selected tests (def=0xA, 0=infinity): 
<...>

Select action to take upon encountering errors (0=STOP, 1=REPEAT, 2=IGNORE, 
def=0): <...>


6.2.3   Start Testing

   Start executing user's requested tests.

Start Loopback Tests for Host Adapter 1 (p=pause, c=cont, s=stop)
PCI Loopback 0xA: Internal Loopback 0xA : External Loopback 0xA
Host Adapter 1 PASSED TESTS


6.3      Restart

This menu selection resets the FireFly chipset and causes the host 
adapter to reboot.

Resetting Host Adapter 1

Host Adapter 1: POST Done.
Host Adapter 1 is READY. Functional Firmware Loaded.
        Diagnostic Firmware Version 2.00N3  
        Functional Firmware Version FF1.00X8
        JEDEC ID = 11ACC057 (LP6K)



6.4      Input/Output

This menu is used to open or close input and output files.  The input 
file is interpreted and executed by the LP6DUTIL program.  The output 
file is where all messages are logged.  Nesting of input files is not 
supported.

                                 Input/Output
1 - Open/Interpret Input File
2 - Open Output File
3 - Close Output File
                                 Option: 


6.5      Maintenance

This menu is used to update firmware or non-volatile parameters in the 
Flash ROM.  It is also used to display program images stored in the host 
adapter's memory.

                                 Maintenance
1 - Update Firmware
2 - Display Program Load List
3 - Enable/Disable Boot BIOS
4 - Modify Soft Jumpers
                                 Option: 


6.5.1   Update Firmware

This menu selection is used to download a new version of firmware to the 
LP6000/LP7000 PCI Host Adapter.

Enter Firmware Image file name:

Begin Down Load Process for Host Adapter 1 (0=No, 1=Yes, def=0): <1>

Resetting Host Adapter 1

Host Adapter 1: POST Done.

Start DOWN LOADING Firmware Image to Host Adapter 1
Finished Down-Loading Code for Host Adapter 1
Reboot Host Adapter 1 for new functional firmware to take effect (0=No, 
1=Yes, def=1): <return>

Resetting Host Adapter 1

Host Adapter 1: POST Done.
Host Adapter 1 is READY. Functional Firmware Loaded.
        Diagnostic Firmware Version 2.20a1
        Functional Firmware Version FF2.00a2
        JEDEC ID = 11ACC057 (LP6K)

6.5.2   Display Program Load List

This menu is used to look at program images stored in the Flash ROM and 
to look at Flash ROM and RAM map.

                                 Display Program Load List
1 - Display Flash ROM Program List
2 - Display Flash ROM Map
3 - Display RAM Map
                                 Option: 


6.5.2.1   Display Flash ROM Program List

This menu selection is used to display all the program images store in 
the host adapter Flash ROM.  The following is a sample output of this 
menu selection.

Host Adapter 1 Flash ROM Program Entries
        1.  description = functional firmware: FF1.00X8
                id[0] = 0x02011042      id[1] = 0x00101101
        2.  description = test program: Endec LoopBack 
                id[0] = 0x00320000      id[1] = 0x00101F0F


6.5.2.2   Display Flash ROM Map

This menu selection is used to display the host adapter Flash ROM map.  
The following is a sample output of this menu selection.

Host Adapter 1 Flash ROM Map
        1.  start_adr = 0x01420000      description = FF1.00X8
        2.  start_adr = 0x01434200      description = Endec LoopBack 
        3.  start_adr = 0x01435EE4      description = SPACE AVAILABLE
        4.  start_adr = 0x0144A0E4      description = SPACE AVAILABLE
        5.  start_adr = 0x01450000      description = SPACE AVAILABLE
        6.  start_adr = 0x0145E2E4      description = SPACE AVAILABLE


6.5.2.3   Display RAM Map

This menu selection is used to display the host adapter RAM map.  The 
following is a sample output of this menu selection.

Host Adapter 1 RAM Map
        1.  start_adr = 0x00010000      len = 0x000144D8
                description = FF1.00X8
        2.  start_adr = 0x000244D8      len = 0x0000BB28
                description = SPACE AVAILABLE
        3.  start_adr = 0x0003A000      len = 0x00006000
                description = SPACE AVAILABLE
        4.  start_adr = 0x0004F000      len = 0x00000E00
                description = SPACE AVAILABLE
        5.  start_adr = 0x00052200      len = 0x0001CE00
                description = SPACE AVAILABLE
        6.  start_adr = 0x00074000      len = 0x00008000
                description = SPACE AVAILABLE
        7.  start_adr = 0x0007C800      len = 0x00003800
                description = SPACE AVAILABLE

6.5.3  Enable/Disable Boot BIOS

This menu selection is used to disable the Boot BIOS (if installed) or to
enable a previously disabled Boot BIOS (if installed).

6.5.4    Modify Soft Jumpers

This menu selection is used to change the state of the adapter soft jumpers, 
which can be used in place of the physical jumpers on the adapter. The user
may choose to use hardware default PCI information, or select to use one of 
the two alternate PCI configuration regions to provide PCI data.

6.5.C    Update Configuration Data

This hidden menu is used to update Configuration data stored in the 
Flash ROM.  The user selects one of the following configuration regions 
to be updated and the program prompts for a file which contains the 
configuration data to be written into the Flash ROM.

                                 Update Configuration Data
1 - Node Configuration A
2 - Node Configuration B
3 - Node Configuration C
4 - Node Configuration D
5 - Wake-Up Parameters
6 - Default PCI Configuration
7 - PCI Configuration Download 1
8 - PCI Configuration Download 2
9 - Reserved Configuration Regions
A - VPD Region
                                 Option: <...>

Enter Configuration Data file name: <...>


6.6      Show Host Adapter Info

This menu is used to display various information relating to the host 
adapter.


                                 Show Host Adapter Info
1 - BIU PCI Configuration Parameters     5 - Service Parameters
2 - Host Adapter Info and Status         6 - Status/Counters Info
3 - Adapter Revision Levels              7 - Link Status
4 - Display Configuration data           8 - Link Attention
                                 Option: 


6.6.1   BIU PCI Configuration Parameters

      PCI CONFIGURATION INFO FOR HOST ADAPTER 1
vendor_id = 0x10DF                       dev_id = 0x1AE5
cmd_stat = 0x0200011F                    rev_class = 0x0C040001
ha_req = 0x00002008                      slim_lbase_adr = 0x000D000C
slim_hbase_adr = 0x00000000              reg_mem_lbase_adr = 0x000D100C
reg_mem_hbase_adr = 0x00000000           reg_io_base_adr = 0x0000FC01
intrpt_info = 0x0004010B                 biu_feature_en = 0x00000000

Hit RETURN or ENTER key to continue
<return>


6.6.2   Host Adapter Info and Status

         HOST ADAPTER 1 Info
pci_bus_num = 0x0
pci_dev_num = 0xA0
ULA[0] = 0x10000000
ULA[1] = 0xC9030405
status = Functional Firmware Loaded
diagnostic firmware description = 2.00N3
functional firmware description = FF1.00X8

Hit RETURN or ENTER key to continue
<return>




6.6.3   Adapter Revisions
        
        Chipset Revision Levels:
BIU Revision = 0x00000002
Sequence Manager Revision = 0x11ACC057
Endec Revision = 0x21ACB057

        Firmware Revision Levels:
Current Operational Firmware = Initial Operational Firmware
Kernel Revision = LP6K 2.20n1
Initial Operational Firmware Revision = Initial Load 2.00n5 (FS2.00N5)
SLI-1 Revision = LP6K SLI-1 Overlay 2.00n5 (sli1ol)
SLI-2 Revision = LP6K SLI-2 Overlay 2.00n5 (sli2ol)

        FC-PH Version Supported:
Highest FC-PH Version Supported = 4.3
Lowest FC-PH Version Supported = 4.3

Hit RETURN or ENTER key to continue
<return>


6.6.4   Display Configuration Data

This menu is used to display the current configuration data entry within 
the user selected configuration region.

                                 Display Configuration Data
1 - Node Configuration A
2 - Node Configuration B
3 - Node Configuration C
4 - Node Configuration D
5 - Wake-Up Parameters
6 - Default PCI Configuration
7 - PCI Configuration Download 1
8 - PCI Configuration Download 2
9 - Boot BIOS Extension Region
A - Reserved Configuration Regions
B - VPD Data
                                 Option: <...>

Enter byte offset within selected Entry (0-0xffff, def=0): <5>

Finished DUMP Configuration Data for Host Adapter 1
................ == 01474000 02 01 05 00, 00 10 11 01, 00 00 00 00, 00 00 00 00
................ == 01474010 00 00 00 00, 00 00 00 00, 00 00 00 00, 00 00 00 00
................ == 01474020 00 00 00 00, 00 00 00 00, 00 00 00 00, 00 00 00 00
............     == 01474030 00 00 00 00, 00 00 00 00, 00 00 00 00             

Hit RETURN or ENTER key to continue
<return>




6.6.5   Service Parameters

Finished Reading Service parameters for Host Adapter 1
Common Service Parameters:
        FCPHhigh 0x9    FCPHlow 0x8     BBCred 0x0      RcvFsize 0x800
        AltBBcrd 0x1    FPort 0x0       RandOff 0x0     IncOff 0x1
        TotCSeq 0xFF    RObyCat 0xFFFF  E_D_TOV 0x2710
Name Fields:
        Node name[0,1]          0x10000000, 0xC9030405
        N_Port name[0,1]        0x10000000, 0xC9030405

Hit RETURN or ENTER key to continue
<return>

Class 0x1 Parameters:
        Word 0 (31:0) 0xC0000000        Word 1 (31:0) 0x80000800
        ConCurrentSeq 0xFF      End-EndCredit 0x20      OpenSeq/Exch 0x0
Class 0x2 Parameters:
        Word 0 (31:0) 0x80000000        Word 1 (31:0) 0x80000800
        ConCurrentSeq 0xFF      End-EndCredit 0xC       OpenSeq/Exch 0x0
Class 0x3 Parameters:
        Word 0 (31:0) 0x80000000        Word 1 (31:0) 0x00000800
        ConCurrentSeq 0xFF      End-EndCredit 0x0       OpenSeq/Exch 0x0

Hit RETURN or ENTER key to continue
<return>

vendor_version[0] = 0x00000000           vendor_version[1] = 0x00000000
vendor_version[2] = 0x00000000           vendor_version[3] = 0x00000000

Hit RETURN or ENTER key to continue
<return>


6.6.6   Status/Counters Info

Enter option to Clear Counters (0=No, 1=Yes, def=0): <...>

Finished Reading Status for Host Adapter 1
active_RPI_cnt = 0x0                             active_XRI_cnt = 0x0
xmt_byte_cnt = 0x00000000                        rcv_byte_cnt = 0x00000000
xmt_frame_cnt = 0x00000000                       rcv_frame_cnt = 0x00000000
xmt_seq_cnt = 0x00000000                         rcv_seq_cnt = 0x00000000
total_orig_xchgs = 0x00000000                    total_resp_xchgs = 0x00000000
rcv_PBSY_cnt = 0x00000000                        rcv_FBSY_cnt = 0x00000000

Hit RETURN or ENTER key to continue
<return>


6.6.7   Link Status

Finished Reading Link Status for Host Adapter 1
link_failure_cnt = 0x00000000                    loss_sync_cnt = 0x00000000
loss_signal_cnt = 0x00000000                     prim_seq_err_cnt = 0x00000000
invalid_xmit_word = 0x00000000                   crc_cnt = 0x00000000
prim_seq_timeout = 0x00000000                    elastic_overrun = 0x00000000
arb_timeout = 0x00000000

Hit RETURN or ENTER key to continue
<return>




6.6.8   Link Attention

Finished Reading Link Attention for Host Adapter 1
event_tag = 0x1
attn_type = Link Down
topology  = FC-AL

Hit RETURN or ENTER key to continue
<return>


6.7   Quit

This menu selection is used to exit the LP6DUTIL program.

Note that if this program encountered errors during the session, it will 
display the following message when the program exits.

        *** ERRORS have been detected during this session ***







	LP6DUTIL Manual	Page 8






