esp.4freebsd

Langue: en

Version: 300841 (debian - 07/07/09)

Section: 4 (Pilotes et protocoles réseau)


BSD mandoc

NAME

esp - Qlogic FEPS and FAS366 SCSI driver

SYNOPSIS

To compile this driver into the kernel, place the following lines in your kernel configuration file:
device scbus device esp

HARDWARE

The driver provides support for the Qlogic FAS216 and FAS408 SCSI controller chips found in a wide variety of systems and peripheral boards. This includes the Qlogic SCSI cards found in most Sun Ultra 1e and Ultra 2 machines.

For Qlogic PCI SCSI host adapters, the isp(4) driver should be used in place of the driver.

IMPLEMENTATION NOTES

During the boot sequence, the driver searches the linked list for LUN info by LUN ID. At this point the driver will attach on that instance, and then attempt to attach every sub-device.

There are at least 4 variations of the configuration 3 register. A second config register must be loaded to inquire the chip revision, otherwise the Fn ncr53c9x_reset function will not set the defaults correctly.

The drive attach routine attempts to set the appropriate bit to put the chip into Fast SCSI mode so that it does not have to be figured out each time. This will then be stored in the NCR registers for later use.

The driver makes use of the LSI 64854 DMA engine which contains three independent channels designed to interface with an NCR539X SCSI controller; an AM7990 Ethernet controller; and certain types of parallel port hardware. As such this driver may eventually replace the amd(4) driver for network hardware.

DIAGNOSTICS

The following driver specific error messages may be reported:
"esp: cannot map %d segments"
The device was unable to map segments while mapping the SCSI devices in DMA mode.
"unknown variant %d, devices not attached"
An unknown version of the card was found and devices will not be attached.
"Unhandled function code %d"
The device returned a function code which the driver is unable to handle, most likely during negotiation.
"esp:%d:%d: selection failed %d left in FIFO"
The target left the command phase prematurely. If a command did not reach the device then it will be reported as shown above.
"invalid state: %d"
The device has reached an invalid state.

SEE ALSO

amd(4), isp(4), scbus(4), camcontrol(8)
http://www.qlc.com/
http://www.sun.com/

HISTORY

The driver was written for Nx by An Eric S. Hvozda . The driver was then ported to Fx 5.3 by An Scott Long Aq scottl@FreeBSD.org .

AUTHORS

This manual page was written by An Tom Rhodes Aq trhodes@FreeBSD.org instead of porting the original from Nx .

BUGS

The driver includes the sbus front-end but lacks the PCI front-end. Thus it can only support the FEPS/FAS366 SCSI found in Sun Ultra 1e and Ultra 2 machines at this time.

This driver should eventually replace the amd(4) driver, but that requires porting the PCI front-end mentioned above.