cadp(7D) Devices cadp(7D)
NAME
cadp - Adaptec Ultra-2 SCSI host bus adapter driver
SYNOPSIS
scsi@unit-address
DESCRIPTION
The cadp host bus adapter driver is a SCSA-compliant nexus driver that supports the following Adaptec Ultra-2 SCSI devices:
o Adapters: Adaptec AHA-2940U2W, AHA-2940U2B, AHA-2940U2, AHA-2950U2B, AHA-3950U2B
o Chips: AIC-7896/AIC-7897, AIC-7890/AIC-7890A, AIC-7891, AIC-7890AB, AIC-7890A
The cadp driver supports standard functions provided by the SCSA interface, including tagged and untagged queuing, Wide/Fast/Ultra SCSI,
and auto request sense. The cadp driver does not support linked commands.
PRECONFIGURE
o The Plug N Play SCAM Support option is not supported.
o If the BIOS is enabled on the card, ensure that the Adaptec SCSISelect BIOS option Reset SCSI Bus at IC Initialization (under the
Advanced Configuration Options menu) is set to Enabled. Run the SCSISelect utility by pressing Ctrl-A when you see the Adaptec banner
during system boot.
o If the adapter is being used in a multi-initiator configuration, do the following:(1) Ensure that the system boot disk is not on the
shared (clustered) bus.(2) Set the Reset SCSI Bus at IC Initialization option to Disabled.(3) Set the Host Adapter BIOS option
(under the Advanced Configuration Options menu) to Disabled:Not scan.(4) Add the allow-bus-reset=0 property to the /ker-
nel/drv/cadp.conf file.
o Reboot the system after you install patches.
Known Problems and Limitations
o The cadp.bef realmode driver supports only ten adapters at boot time. Therefore, ensure that the boot disk is attached to one of the
first ten adapters. Note that all targets will be available for installation and use by the cadp driver.
o Running the format(1M) command on a Seagate ST19171W 9 GB disk drive fails.
o Some motherboards may have problems supporting channel B with boards based on the Adaptec AIC-7896 chip. The problem arises because
the BIOS doesn't properly assign two interrupts for PCI interrupts INTA and INTB on the slot containing the AIC-7896 chip. As a
result, timeouts and resets on those devices appear on the console. For some motherboards, you can work around the problem by setting
the Advanced/PCI IRQ Mapping feature to ISA Legacy IRQs.
o If you experience problems when using a narrow SCSI CD-ROM drive on the internal wide interface, disable "negotiate wide," "negotiate
sync," or both for that device in the Adaptec configuration utility.
o The Fujitsu narrow disk (M1603SAU) can reselect with an invalid queue tag ID. This violates the SCSI protocol and it causes the cadp
driver to behave erroneously. Because this is difficult to guard against, you should disable tagged queuing for these targets. Use the
iostat --E command to determine if you have a Fujitsu M1603S-512 disk. If you do, edit the /kernel/drv/cadp.conf file and add the
property targetn-scsi-options=0x1f78, where n is the target number.
o The IBM external wide disk (DFHSS2W, Revision 1717) is not supported.
o When setting up a SCSI bus configuration, avoid connecting wide devices to a narrow bus. However, if you have such a configuration,
add the following entry to the cadp.conf file: targetn-scsi-options=0x1df8 where n is the target ID of the wide device on the narrow
bus. This entry disables wide negotiation for the specified target. Also ensure that the upper 8 bits of the bus are properly termi-
nated at both ends of the SCSI chain.
o If you experience installation problems on systems with Intel 440BX/440GX motherboards, upgrade the motherboard BIOS with the latest
revision.
CONFIGURATION
You configure the cadp host bus adapter driver by defining the properties found in cadp.conf. The cadp.conf file contains properties that
you can modify, including: scsi-options, target<n>-scsi-options, scsi-reset-delay, and scsi-initiator-id. Properties in the cadp.conf
file override global SCSI settings.
The property target<n>-scsi-options overrides the scsi-options property value for target<n>, where <n> can vary from decimal 0 to 15. The
cadp driver supports the following scsi-options: SCSI_OPTIONS_DR, SCSI_OPTIONS_SYNC, SCSI_OPTIONS_TAG, SCSI_OPTIONS_FAST,
SCSI_OPTIONS_WIDE, SCSI_OPTIONS_FAST20, and SCSI_OPTIONS_FAST40.
You configure the SCSI devices using the Adaptec configuration utility. When configuring the devices, you should observe the following
guidelines:
o Configure each device using a unique SCSI ID. On the Advanced Configuration Options menu, set Plug N Play SCAM Support to Disabled.
Ensure that devices on either end of the SCSI chain are terminated. When mixing wide (16 bits) and narrow (8 bits) devices on the
same wide chain, ensure that a wide device is at the end of the chain. If you place a narrow device at the end of the chain, wide
devices on the same chain will terminate the low byte, resulting in a illegal configuration.
o If there is more than one controller, or an embedded controller, attempt to use one IRQ per controller.
o When prompted, enable bus mastering for the slot(s) with your host bus adapter(s.)
o Enable support for disks larger than 1 Gbyte, if applicable.
EXAMPLES
Create a file called /kernel/drv/cadp.conf, then add the following line:
scsi-options=0x78;
The above line disables tagged queuing, Fast/Ultra SCSI, and wide mode for all cadp instances.
To set scsi-options more specifically per target, add the following lines to /kernel/drv/cadp.conf:
target1-scsi-options=0x78;
device-type-scsi-options-list =
"SEAGATE ST32550W", "seagate-scsi-options" ;
seagate-scsi-options = 0x58;
scsi-options=0x3f8;
With the exception of one disk type that has scsi-options set to 0x58, the above example sets scsi-options for target 1 to 0x78, and all
remaining targets to 0x3f8.
The scsi-options properties that are specified per target ID have the highest precedence, followed by scsi-options per device type.
Global scsi-options for all cadp instances per bus have the lowest precedence. You must reboot the system for the specified scsi options to
take effect.
Driver Capabilities
To enable certain features on the cadp driver, the target driver must set capabilities. The following capabilities can be queried and modi-
fied by the target driver: synchronous, tagged-qing, wide-xfer, auto-rqsense, qfull-retries, and qfull-retry-interval. All other capa-
bilities are query only.
By default, the tagged-qing, auto-rqsense, and wide-xfer capabilities are disabled. The disconnect, synchronous, and untagged-qing capa-
bilities are always enabled. The cadp driver capabilities can only be assigned binary values (0 or 1). The default value for qfull-retries
is 10 and the default value for qfull-retry-interval is 100. The qfull-retries capability is au_char (0 to 255) while qfull-retry-inter-
val is a u_short (0 to 65535).
If a conflict occurs between the value of scsi-options and a capability, the value set in scsi-options prevails.
Only whom != 0 is supported in the scsi_ifsetcap(9F)call. See scsi_ifsetcap(9F) and scsi_ifgetcap(9F) for details.
FILES
/kernel/drv/cadp ELF kernel module
/kernel/drv/cadp.conf Optional configuration file
ATTRIBUTES
See attributes(5)
for a description of the following attribute:
+-----------------------------+-----------------------------+
|ATTRIBUTE TYPE |ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Architecture |x86 |
+-----------------------------+-----------------------------+
SEE ALSO
prtconf(1M), driver.conf(4), pci(4), attributes(5), scsi_abort(9F), scsi_hba_attach(9F), scsi_ifgetcap(9F), scsi_ifsetcap(9F),
scsi_reset(9F), scsi_sync_pkt(9F), scsi_transport(9F), scsi_device(9S), scsi_extended_sense(9S), scsi_inquiry(9S), scsi_pkt(9S)
Writing Device Drivers
Solaris (Intel Platform Edition) Hardware Compatibility List
ANSI Small Computer System Interface-2 (SCSI-2)
NOTES
The cadp driver supports the adapters and chipsets listed in this man page. For information on support of additional devices, see the
Solaris (Intel Platform Edition) Hardware Compatibility List a component of the Information Library for Solaris 8 (Intel Platform Edi-
tion).
The cadp driver exports properties indicating (per target) the negotiated transfer speed (target<n>-sync-speed), whether wide bus (tar-
get<n>-wide), is supported for that particular target (target<n>-scsi-options), and whether tagged queuing (target<n>-tag-queue) has been
enabled. The sync-speed property value is the data transfer rate in KB/sec. The target<n>-tag-queue and the target<n>-wide property have
value 1 to indicate that the corresponding capability is enabled, or 0 to indicate that the capability is disabled. See prtconf(1M) (ver-
bose option) for information on viewing the cadp properties.
Sample output is provided below:
pci9005,f500, instance #2
System software properties:
name <interrupt-priorities> length <4>
value <0x05000000>.
name <tape> length <5>
value <0x7363747000>.
name <disk> length <5>
value <0x7363646b00>.
name <queue> length <6>
value <0x71736f727400>.
name <flow_control> length <6>
value <0x646d756c7400>.
Driver properties:
name <target0-tag-queue> length <4>
value <0x01000000>.
name <target0-wide> length <4>
value <0x01000000>.
name <target0-sync-speed> length <4>
value <0x28000000>.
name <chosen-interrupt> length <8>
value <0x0100000000000000>.
name <scsi-selection-timeout> length <4>
value <0xfa000000>.
name <scsi-options> length <4>
value <0xf81f0000>.
name <scsi-watchdog-tick> length <4>
value <0x0a000000>.
name <scsi-tag-age-limit> length <4>
value <0x02000000>.
name <scsi-reset-delay> length <4>
value <0xb80b0000>.
SunOS 5.10 3 Aug 2001 cadp(7D)