Devices esp(7D)
NAME
esp - ESP SCSI Host Bus Adapter Driver
SYNOPSIS
esp@sbus-slot,80000
DESCRIPTION
The esp Host Bus Adapter driver is a SCSA compliant nexus
driver that supports the Emulex family of esp SCSI chips
(esp100, esp100A, esp236, fas101, fas236).
The esp driver supports the standard functions provided by
the SCSA interface. The driver supports tagged and untagged
queuing, fast SCSI (on FAS esp's only), almost unlimited
transfer size (using a moving DVMA window approach), and
auto request sense; but it does not support linked commands.
CONFIGURATION
The esp driver can be configured by defining properties in
esp.conf which override the global SCSI settings. Supported
properties are: scsi-options, target-scsi-options, scsi-
reset-delay, scsi-watchdog-tick, scsi-tag-age-limit, scsi-
initiator-id.
target-scsi-options overrides the scsi-options property
value for target. can vary from 0 to 7.
Refer to scsihbaattach(9F) for details.
EXAMPLES
Example 1 A sample of esp configuration file.
Create a file /kernel/drv/esp.conf and add this line:
scsi-options=0x78;
This will disable tagged queuing, fast SCSI, and Wide mode
for all esp instances. To disable an option for one specific
esp (refer to driver.conf(4)):
name="esp"
parent="/iommu@f,e0000000/sbus@f,e0001000/espdma@f,400000"
reg=0xf,0x800000,0x40
SunOS 5.11 Last change: 7 Feb 1997 1
Devices esp(7D)
target1-scsi-options=0x58
scsi-options=0x178 scsi-initiator-id=6;
Note that the default initiator ID in OBP is 7 and that the
change to ID 6 will occur at attach time. It may be prefer-
able to change the initiator ID in OBP.
The above would set scsi-options for target 1 to 0x58 and
for all other targets on this SCSI bus to 0x178. The physi-
cal pathname of the parent can be determined using the /dev-
ices tree or following the link of the logical device name:
example# ls -l /dev/rdsk/c0t3d0s0
lrwxrwxrwx 1 root root 88 Aug 22 13:29 /dev/rdsk/c0t3d0s0 ->
../../devices/iommu@f,e0000000/sbus@f,e0001000/espdma@f,400000/
esp@f,800000/sd@3,0:a,raw
The register property values can be determined from
prtconf(1M) output (-v option):
esp, instance #0
....
Register Specifications:
Bus Type=0xf, Address=0x800000, Size=40
To set scsi-options more specifically per target:
target1-scsi-options=0x78;
device-type-scsi-options-list =
"SEAGATE ST32550W", "seagate-scsi-options" ;
seagate-scsi-options = 0x58;
scsi-options=0x3f8;
The above would set scsi-options for target 1 to 0x78 and
for all other targets on this SCSI bus to 0x378 except for
one specific disk type which will have scsi-options set to
0x58.
SunOS 5.11 Last change: 7 Feb 1997 2
Devices esp(7D)
scsi-options specified per target ID has the highest pre-
cedence, followed by scsi-options per device type. To get
the inquiry string run probe-scsi or probe-scsi-all command
at the ok prompt before booting the system.
Global, for example. for all esp instances, scsi-options per
bus has the lowest precedence.
The system needs to be rebooted before the specified scsi-
options take effect.
FILES
/kernel/drv/esp ELF Kernel Module
/kernel/drv/esp.conf Configuration file
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Architecture SBus-based systems with esp-based
SCSI port and SHA, SBE/S, FSBE/S,
and DSBE/S SBus SCSI Host Adapte
options
SEE ALSO
prtconf(1M), driver.conf(4), attributes(5), fas(7D),
scsiabort(9F), scsihbaattach(9F), scsiifgetcap(9F),
scsireset(9F), scsisyncpkt(9F), scsitransport(9F),
scsidevice(9S), scsiextendedsense(9S), scsiinquiry(9S),
scsipkt(9S)
Writing Device Drivers
SunOS 5.11 Last change: 7 Feb 1997 3
Devices esp(7D)
OpenBoot Command Reference
ANSI Small Computer System Interface-2 (SCSI-2)
ESP Technical Manuals, QLogic Corp.
DIAGNOSTICS
The messages described below are some that may appear on the
system console, as well as being logged.
The first four messages may be displayed while the esp
driver is trying to attach; these messages mean that the
esp driver was unable to attach. All of these messages are
preceded by "esp%d", where "%d" is the instance number of
the esp controller.
Device in slave-only slot
The SBus device has been placed in a slave-only slot and
will not be accessible; move to non-slave-only SBus
slot.
Device is using a hilevel intr
The device was configured with an interrupt level that
cannot be used with this esp driver. Check the SBus dev-
ice.
Unable to map registers
Driver was unable to map device registers; check for bad
hardware. Driver did not attach to device; SCSI devices
will be inaccessible.
Cannot find dma controller
Driver was unable to locate a dma controller. This is an
auto-configuration error.
Disabled TQ since disconnects are disabled
Tagged queuing was disabled because disconnects were
disabled in scsi-options.
SunOS 5.11 Last change: 7 Feb 1997 4
Devices esp(7D)
Bad clock frequency- setting 20mhz, asynchronous mode
Check for bad hardware.
Sync pkt failed
Syncing a SCSI packet failed. Refer to
scsisyncpkt(9F).
Slot %x: All tags in use!!!
The driver could not allocate another tag number. The
target devices do not properly support tagged queuing.
Target %d.%d cannot alloc tag queue\n
The driver could not allocate space for tag queue.
Gross error in esp status (%x)
The driver experienced severe SCSI bus problems. Check
cables and terminator.
Spurious interrupt
The driver received an interrupt while the hardware was
not interrupting.
Lost state in phasemanage
The driver is confused about the state of the SCSI bus.
Unrecoverable DMA error during selection
The DMA controller experienced host SBus problems. Check
for bad hardware.
Bad sequence step (0x%x) in selection
The esp hardware reported a bad sequence step. Check for
bad hardware.
SunOS 5.11 Last change: 7 Feb 1997 5
Devices esp(7D)
Undetermined selection failure
The selection of a target failed unexpectedly. Check for
bad hardware.
>2 reselection IDs on the bus
Two targets selected simultaneously, which is illegal.
Check for bad hardware.
Reconnect: unexpected bus free
A reconnect by a target failed. Check for bad hardware.
Timeout on receiving tag msg
Suspect target f/w failure in tagged queue handling.
Parity error in tag msg
A parity error was detected in a tag message. Suspect
SCSI bus problems.
Botched tag
The target supplied bad tag messages. Suspect target f/w
failure in tagged queue handling.
Parity error in reconnect msg's
The reconnect failed because of parity errors.
Target didn't disconnect after sending
The target unexpectedly did not disconnect after sending
.
No support for multiple segs
The esp driver can only transfer contiguous data.
No dma window?
SunOS 5.11 Last change: 7 Feb 1997 6
Devices esp(7D)
Moving the DVMA window failed unexpectedly.
No dma window on operation
Moving the DVMA window failed unexpectedly.
Cannot set new dma window
Moving the DVMA window failed unexpectedly.
Unable to set new window at for operation
Moving the DVMA window failed unexpectedly.
Illegal dma boundary? %x
An attempt was made to cross a boundary that the driver
could not handle.
Unwanted data out/in for Target
The target went into an unexpected phase.
Spurious phase from target
The target went into an unexpected phase.
SCSI bus DATA IN phase parity error
The driver detected parity errors on the SCSI bus.
SCSI bus MESAGE IN phase parity error
The driver detected parity errors on the SCSI bus.
SCSI bus STATUS phase parity error
The driver detected parity errors on the SCSI bus.
Premature end of extended message
An extended SCSI bus message did not complete. Suspect a
SunOS 5.11 Last change: 7 Feb 1997 7
Devices esp(7D)
target f/w problem.
Premature end of input message
A multibyte input message was truncated. Suspect a tar-
get f/w problem.
Input message botch
The driver is confused about messages coming from the
target.
Extended message is too long
The extended message sent by the target is longer than
expected.
message from Target garbled
Target sent message of value which the
driver did not understand.
Target rejects our message
Target rejected a message sent by the driver.
Rejecting message from Target
The driver rejected a message received from target
Cmd dma error
The driver was unable to send out command bytes.
Target refused message resend
The target did not accept a message resend.
Two-byte message rejected
The driver does not accept this two-byte message.
SunOS 5.11 Last change: 7 Feb 1997 8
Devices esp(7D)
Unexpected selection attempt
An attempt was made to select this host adapter by
another initiator.
Polled cmd failed (target busy)
A polled command failed because the target did not com-
plete outstanding commands within a reasonable time.
Polled cmd failed
A polled command failed because of timeouts or bus
errors.
Disconnected command timeout for Target .
A timeout occurred while target/lun was disconnected.
This is usually a target f/w problem. For tagged queuing
targets, commands were outstanding when the timeout
was detected.
Disconnected tagged cmds () timeout for Target .
A timeout occurred while target/lun was disconnected.
This is usually a target f/w problem. For tagged queuing
targets, commands were outstanding when the timeout
was detected.
Connected command timeout for Target .
This is usually a SCSI bus problem. Check cables and
termination.
Target . reverting to async. mode
A data transfer hang was detected. The driver attempts
to eliminate this problem by reducing the data transfer
rate.
Target . reducing sync. transfer rate
A data transfer hang was detected. The driver attempts
to eliminate this problem by reducing the data transfer
rate.
SunOS 5.11 Last change: 7 Feb 1997 9
Devices esp(7D)
Reverting to slow SCSI cable mode
A data transfer hang was detected. The driver attempts
to eliminate this problem by reducing the data transfer
rate.
Reset SCSI bus failed
An attempt to reset the SCSI bus failed.
External SCSI bus reset
Another initiator reset the SCSI bus.
WARNINGS
The esp hardware does not support Wide SCSI mode. Only
FAS-type esp's support fast SCSI (10 MB/sec).
NOTES
The esp driver exports properties indicating per target the
negotiated transfer speed (target-sync-speed) and whether
tagged queuing has been enabled (target-TQ). The sync-
speed property value is the data transfer rate in KB/sec.
The target-TQ property has no value. The existence of the
property indicates that tagged queuing has been enabled.
Refer to prtconf(1M) (verbose option) for viewing the esp
properties.
dma, instance #3
Register Specifications:
Bus Type=0x2, Address=0x81000, Size=10
esp, instance #3
Driver software properties:
name length <0> - .
name length <4>
value <0x00002710>.
name length <4>
value <0x000003f8>.
name length <4>
value <0x0000000a>.
name length <4>
value <0x00000008>.
name length <4>
value <0x00000bb8>.
SunOS 5.11 Last change: 7 Feb 1997 10
|
