******************************************************************************
LsiUtil_ReadMe.txt
******************************************************************************
This file presents general information about the LsiUtil utility for Windows,
Linux and Solaris.
This file is divided into the following sections:
Introduction
Features
LSI Logic Devices Supported
Description
Menu Operation
Command Line Operation
1.0 Introduction
................
LsiUtil is a firmware download and diagnostic utility that can be used with
Windows, Linux, Solaris and DOS environments.
1.1 Features
............
LsiUtil supports:
o All SCSI, SAS and Fiobre Channel Host Adapters from LSI NSPG.
o Identifies and updates the firmware or BIOS images.
o Allows Flash to be completely erased.
o Allows configuration of all HBA and firmware parameters.
o Provides system level debug tools.
o Supports command line execution.
1.2 LSI Logic FC Devices Supported
...................................
o All LSI MPT Fusion (tm) SCSI chips and HBAs
o All LSI Fibre Channel chips and HBAs
o All LSI SAS chips and HBAs
2.0 Description
...............
LsiUtil supports updating the LSI Logic Fusion-MPT (TM) based Firmware
and/or BIOS, for chips and HBAs that use FLASH.
The utility is supported with binaries in several OS environments:
Windows: lsiutil.exe
Linux: lsiutil
Solaris: lsiutil
DOS: lsiutil.exe
The utility requires the LSI host adapter driver to be installed and
loaded.
To run LsiUtil:
Copy lsiutil to C:\ or /usr/sbin/ Windows or Linux respectively.
Open and command prompt.
Command prompt C:\>.
Type lsiutil and press Enter.
2.1 Operation
.............
The main window provides a selction of chip/HBA ports. 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:
C:\>lsiutil
LSI Logic MPT Configuration Utility, Version 1.52, September 7, 2007
6 MPT Ports found
Port Name Chip Vendor/Type/Rev MPT Rev Firmware Rev IOC
1. Scsi Port 0 LSI Logic 53C1030 B2 102 01032700 0
2. Scsi Port 1 LSI Logic 53C1030 B2 102 01032700 1
3. Scsi Port 5 LSI Logic FC949E A1 105 01031400 0
4. Scsi Port 6 LSI Logic FC949E A1 105 01031400 1
5. Scsi Port 7 LSI Logic FC919X A0 103 01021700 0
6. Scsi Port 8 LSI Logic SAS1068 B0 105 01160000 0
Select a device: [1-6 or 0 to quit] 0
Once a chip has been chosen, another menu list will be displayed as follows:
1. Identify firmware, BIOS, and/or FCode
2. Download firmware (update the FLASH)
4. Download/erase BIOS and/or FCode (update the FLASH)
8. Scan for devices
10. Change IOC settings (interrupt coalescing, EEDP)
13. Change FC Port settings
16. Display logged-in devices
20. Diagnostics
21. RAID actions
22. Reset bus
23. Reset target
30. Beacon on
31. Beacon off
42. Display operating system names for devices
43. Diagnostic Buffer actions
60. Show non-default settings
61. Restore default settings
69. Show board manufacturing information
98. Reset FC link
99. Reset port
e Enable expert mode in menus
p Enable paged mode in menus
w Enable logging
Main menu, select an option: [1-99 or e for expert or 0 to quit]
- The Identify firmware, BIOS, and/or FCode option displays the version
number of the current Fusion-MPT Firmware or the Fusion-MPT BIOS residing on
the adapter. If multiple BIOS images are present (Fusion-MPT BIOS w/EFI BSD
or Fusion-MPT BIOS w/FCode), this option will all versions.
- The Download firmware option prompts for a file name to download.
Example: "Enter firmware filename: it_1030.fw"
The firmware file to download may be in the same directory as the lsiutil
executable, or a full pathname can be provided.
Example: Enter firmware filename:
C:\Fusion-MPT_IT_FW10327_BIOS_50703pt_FLASH_10304\it_1030.fw
- The Download BIOS and/or FCode option also prompts for a file name to download.
Example:
"Enter x86 BIOS filename: mptbios.rom"
"Enter FCode filename: lsi1030f.rom"
"Enter EFI BIOS filename:lsimpt.rom"
If no file is entered and there is currently a version on the card, the current
BIOS version will be displayed.
Example: MPTBIOS-x.xx.xx (xxxx.xx.xx)
Do you want to preserve the current x86 BIOS? [Yes or No, default is Yes]
3.0 Command Line Operation
..........................
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. When no
command line options are specified, the interactive (menu) is displayed.
-e Turn on Expert Mode (more menu options).
-w, -ww, -www Log internal operations to lsiutil.log, for debug.
-y Answer yes to yes/no questions whose default is yes.
-n Answer no to yes/no questions whose default is no.
-j type[,type] Include just ports of type 'type' (FC, SCSI, SAS).
-x Concatenate SAS firmware and NVDATA files.
Display Options
usage: lsiutil [ -p portNumber ] [ -u ][ -s ] [ -d ] [ -i ] [ -b ]
-p portNumber Specify the port number to operate on.
If not specified, all ports are used.
-u Use untagged, rather than tagged, SCSI commands.
-s Scan for and display all targets.
-d Dump all config pages.
-i Display port settings.
-b Show board manufacturing information.
-m freq[,time] Monitor port performance, updating the display
every 'freq' seconds, for 'time' seconds.
Examples:
1. to display the port settings and targets for port 1:
lsiutil -p 1 -i -s
2. to display the targets found on all known ports:
lsiutil -s
Operational Options
usage: lsiutil -p portNumber [ -l linkSpeed ] [ -t topology ]
[ -c timeout,depth ] [ -r ]
-p portNumber Specify the port number to operate on.
Required parameter for operational options.
-l linkSpeed Set link speed. Valid options for linkSpeed are:
'a' Auto link speed negotiation
'1' Force 1Gb link speed
'2' Force 2Gb link speed
'4' Force 4Gb link speed
-t topology Set topology. Valid options for topology are:
'a' Auto topology negotiation
'1' Force NL_Port topology
'2' Force N_Port topology
-c timeout,depth Set interrupt coalescing values.
Timeout is a value in microseconds between
1 and 1000. Depth is a value between 1 and 128.
Setting either or both values to zero will
disable interrupt coalescing for that port.
-r Perform a chip reset on the given port.
-z Perform an FC link reset on the given port.
NOTE: In order for linkSpeed, topology, or interrupt coalescing
settings to take effect, a chip reset is necessary.
Examples:
1. to force linkspeed to 1Gb on port 2:
lsiutil -p 2 -l 1
2. to set interrupt coalescing to a timeout of 200ms with
a depth of 9 and to force N_Port topology on port 1:
lsiutil -p 1 -c 200,9 -t 2
