To compile this driver into the kernel,
place the following lines in your
kernel configuration file:
device scbusdevice 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
QlogicSCSI
cards found in most
SunUltra 1e
and
Ultra 2
machines.
For
QlogicPCISCSI
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
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.
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/FAS366SCSI
found in
SunUltra 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.
