***************************************************************************** FCWIN98.TXT ***************************************************************************** Installation Guide for the LSI Logic FC Driver: SYMMPI.MPD V1.01.00.04 This file describes the features and use of the LSI Logic FC device driver for the Windows 98 operating system environment. It is divided into the following sections: Introduction for Windows 98 Features LSI Logic Devices Supported Description Installing the Driver(s) Existing System Installation Troubleshooting ........................................................................... 1.0 Introduction for Windows 98 WWindows 98 is an operating system designed to run on Intel processors using current technology. It provides a graphical user interface environment incorporating many high-level features. Refer to the Microsoft Windows 95/98 documentation for details. An I/O manager handles I/O requests in Windows 98. To address a Fibre Channel peripheral, the I/O manager goes through the appropriate drivers. Class drivers for hard disk, floptical, CD-ROM, printer, and scanner peripherals are provided in Windows 98. Other class drivers, provided by peripheral manufacturers, are added to support new devices. LSI Logic and Microsoft provide a miniport driver, called SYMMPI.MPD, to complete the path to a LSI Logic FC controller with an optional FC BIOS. The next sections describe this driver and its installation. ............................................................................ 1.1 Features o Supports 1Gbaud Fibre Channel transfers (for LSIFC909) o Supports 2Gbaud Fibre Channel transfers (for LSIFC929 and LSIFC919) o Support LSI Logic MPT common software interface o Supports multiple host adapters o Supports multiple Logical Unit Numbers (LUNs) o Supports Scatter-Gather o Supports SCSI pass-through functionality o Supports disk array configurations with no LUN 0 o Supports disk array configurations with non-contiguous LUNs o Auto request sense o Maximum block size support: 1 MB ............................................................................ 1.2 LSI Logic Devices Supported The SYMMPI.MPD driver is named "Symbios PCI SCSI MPI MiniPort Driver" for driver installation. It supports the following devices and LSI Logic host adapters based on those devices: o LSIFC909 (LSI40909 Host Adapter) o LSIFC929 (LSI40929 Host Adapter) o LSIFC919 (LSI40919 Host Adapter) ............................................................................ 1.3 Description SYMMPI.MPD is designed to Microsoft's specification for miniport drivers. This driver allows connection of Fibre Channel devices including disk drives, CD-ROMs, and tape drives for PCI-based machines. To support a different Fibre Channel device type, the Windows 98 architecture requires that a class driver for that type of device be present (usually supplied by Microsoft, or possibly by the peripheral manufacturer). No changes to SYMMPI.MPD are required. The driver is only supported under Windows 98, although similar versions are supported on Windows NT and Windows 2000. SCSI commands are passed directly from a Windows application to the FCP devices by using the SCSI pass-through facility. This allows applications to directly control and access devices by filling in a data structure and calling into the port or class driver. ............................................................................ 2.0 Installing the SYMMPI.MPD Driver This procedure installs the SYMMPI.MPD driver onto an existing Windows 98 system. Prior to installation, ensure that the LSI Logic driver diskette is available, and that it contains the following files and directories: \symmpi.mpd \symmpi.inf ............................................................................ 2.1 Existing System Installation Do the following to install the Symbios PCI SCSI MPI miniport driver: 1. Boot Windows 98. 2. Click on the Start button. Move to Settings-->Control Panel and click. 3. Double click on the System icon. 4. Click on the Device Manager tab. 5. Either double click on the SCSI controllers entry, or click once on the plus sign to the left of it. 6. Select the desired LSI Logic FC Host Adapter entry. Click the Properties button. 7. Click the Driver tab. Press the DRIVER FILE DETAILS button to get this information to appear. 8. Click the Update Driver... button. 9. After the Intro window appears, click on the NEXT button. 10. The Wizard provides a choice between having the Wizard search for a better driver than the one in use or displaying a list of drivers from a specific location. Choose "search..." and click on the NEXT button. 11. The next window allows the user to specify which device(s) will be searched, such as a floppy diskette, CD-ROM, or to specify a specific path. Select "Floppy disk drive" only and click on the NEXT button. 12. The next window queries the user about utilizing the currently installed driver. Mark "Install one of the other drivers" and click on the "View List" button. 13. Next, a list of drivers appears from the specified search devices and the currently installed driver. Highlight the driver of choice and click OK. 14. The previous window appears with the selected driver displayed as the driver to install. Click on the NEXT button. 15. The next window displays the chosen driver along with reference to the designated path to install it in. Click on the NEXT button. 16. A Safe Removal Dialogue box will appear, click on cancel. 17. The Wizard summary window appears. Click on the Finish button. ............................................................................ 2.1.1 Verifying Proper Installation After installing/updating with the SYMMPI.MPD drivers, verify proper operation of the driver. 1. Check that all devices on the FC Link are available using My Computer. Double click on the My Computer icon. Check that all logical SCSI hard drives and CD-ROM drives are shown. 2. Click on the Start button. Select Settings-->Control Panel. Double click on the System icon. Click the Device Manager tab. Check that no host adapter appears with a yellow or red symbol under the SCSI controllers entry. If there is, continue with the steps below to help determine the problem. 3. Either double click on the SCSI controllers entry, or click once on the plus sign to the left of it. One entry for each host adapter installed in the system is displayed. Select an entry, then click on the Properties button. The Device Status message should read "This device is working properly." If any other messages appear, continue with the steps below to get more information on the problem. 4. Click the Driver tab. Press Driver File Details. Two entries should appear: one for the INF and one for the MPD file. The INF file does not contain embedded version information, so the File Details are all Not Available. Select the MPD file. The file version of the driver is displayed. 5. Click Cancel to leave the Host Adapter Properties dialog box. Click on the Performance tab. A list of performance attributes appears. Below the list, you should see the message "Your system is configured for optimal performance." If any other messages appear, select each message and click on the Details button. This provides more information on why the system is not performing optimally and methods to correct the problem. If no problems are encountered in the above steps, the new driver is operating properly. Otherwise, consult the section on Troubleshooting for additional information. ............................................................................ 3.0 Troubleshooting The SYMMPI driver will log error messages to the system error log. For these errors, the system errorlog EventID will be 11, and the specific error code values will be displayed at offset 0x10. Data should be displayed in words. The error codes that are followed by an asterisk are extended error codes, only logged if extended error logging is enabled. The following error codes all have a value of 0x00000006 at address 0x34 in the error log details. Error Code Description .......... ......................................... 0x00000001 Could not read the PCI BARs correctly 0x00000002 Could not read the PCI IO address space correctly 0x00000003 Device would not come to the READY state 0x00000004 System did not provide non-cached memory to the driver 0x00000005 Device did not restart after a fatal error 0x00000006 Device would not transition to the Operational state. 0x00000007 Device would not transition from READY state within the SCSI Reset function 0x00000008 Device would not transition from RESET state within the SCSI Reset function 0x00000009 Device would not transition from FAILED state within the SCSI Reset function 0x0000000A Device would not transition to OPERATIONAL after running out of resources 0x0000000B Device would not transition to READY after kickstart 0x0000000C Driver wanted to reset the device but the NoBoardReset flag prevented it 0x0000000D Handshake of a IOCFacts message failed 0x0000000E* IOs were lost due to an external event 0x0000000F Handshake of PortFacts message failed 0x00000010 Handshake of IOCConfig message failed 0x00000011* IO returned because a CA condition is pending 0x00000012* IO returned for lack of Request resources 0x00000013* IO returned for lack of Request Sense Buffer resources 0x00000014* IO returned because of active reset condition 0x00000015* IO returned because of too many outstanding buffers or chain buffer resources 0x00000016* Issuing Task Management bus reset message 0x00000017* Received Task Management reply 0x00000018 PCI Peer device controls this device 0x00000019 Invalid Initiator ID set in device The following error codes all have a value of 0x00000005 at address 0x34 in the error log details. Error Code Description .......... ......................................... 0xXXXXXXXX Invalid function code detected within the reply message The following error codes all have a value of 0x00000009 at address 0x34 in the error log details. Error Code Description .......... ......................................... 0xXXXXXXXX The Log value was returned in the SCSI IO Error Reply Message The following error codes all have a value of 0x00000003 at address 0x34 in the error log details. Error Code Description .......... ......................................... 0xXXXXXXXX The Log value returned in the EventNotify Reply Message