symhisl(7D) (man pages section 7: Device and Network Interfaces)

man pages section 7: Device and Network Interfaces

symhisl(7D)

NAME

symhisl- symhisl SCSI Host Bus Adapter Driver

SYNOPSIS

scsi@unit-address

DESCRIPTION

The symhisl host bus adapter driver supports the following SCSI devices: SYM22910 (channel A and B support SE and LVD mode), SYM21002 (channel A supports SE only, channel B supports both SE and LVD mode.)

The symhisl host bus adapter driver is a SCSA compliant nexus driver that supports the LSI Logic (formerly Symbios, Inc) SYM53C896 SCSI chipset.

It supports the standard functions provided by the SCSA interface such as tagged queuing and untagged queuing, 16 bit Wide transfer, Fast/Ultra/Ultra2 synchronous transfer, and auto request sense, but it does not support linked commands.

The symhisl hardware (SYM53C896) supports Wide, Fast, Ultra, and Ultra2 SCSI synchronous speeds. The maximum SCSI bandwidth that SYM53C896 support is 80 MB/sec.

PRECONFIGURATION

Known Problems and Limitations

For Ultra2 SCSI LVD transfer, use an Ultra2 SCSI LVD-compliant SCSI cable. For best performance, keep the devices six to eight inches apart.
If both the 53C896 chip and an older 53C8xx chip are embedded on the motherboard, the system BIOS recognizes the older 53C8xx chip first when the system is booted. All 53C8xx chips embedded on your motherboard are then recognized by the Symbios SDMS BIOS. To prevent the older BIOS utility from starting, reflash the older 53C8xx BIOS of the add-in controller. You can download the latest Symbios SDMS BIOS from http://www.symbios.com/techsupport/pci_sw.htm#Symbios CPI BIOS & Flash Utility.
Due to a hardware problem in revisions B0 and C0 of the 53C896 chip, the symhisl driver does not work properly with 64-bit PCI slots. The symhisl driver issues a SCSI bus reset when the problem occurs. To avoid this problem, upgrade to revision C1 of the 53C896 chip. Other revisions of the 53C896 chip might exhibit hardware incompatibilities with earlier PCI chips and designs. For a complete list of errata about each revision of the 53C896 chip, see the LSI Logic Web site at http://www.lsil.com.
Under some conditions, LVD technology may exhibit firmware incompatibilities. If you experience SCSI errors with a correctly configured LVD SCSI bus, contact the manufacturer for updated firmware.

CONFIGURATION

Configure the symhisl driver by defining properties in symhisl.conf. These properties override the global SCSI settings. The symhisl driver supports the following user-modifiable properties:

scsi-options
target<n>-scsi-options
scsi-reset-delay
scsi-watchdog-tick
scsi-initiator-id
symFlags

scsi-options: symhisl supports these scsi-options:

SCSI_OPTIONS_DR SCSI_OPTIONS_SYNC SCSI_OPTIONS_FAST SCSI_OPTIONS_FAST20 SCSI_OPTIONS_PARITY SCSI_OPTIONS_TAG SCSI_OPTIONS_WIDE

SCSI_OPTIONS_PARITY is supported for the scsi-options setting only and disables host adapter parity checking.

target<n>-scsi-options: Overrides the scsi-options property value for target<n>. <n> can vary from hex 0 to f.
scsi-reset-delay: SCSI bus or device reset recovery time, in milliseconds.
scsi-watchdog-tick: After periodic interval (seconds), the symhisl driver searches through all current and disconnected commands for timeouts.
scsi-initiator-id: The bus ID of the HBA.
symFlags: Driver specific bit-mask that can be used to enable or disable driver properties.

bit 0: When set, the driver will not reset the SCSI bus at initialization. Certain CD-ROM, tape, and other devices will not work properly when this bit is set. The default state for this bit is cleared.
bit 1: When set, the driver will not export the DMI ioctl interface. Only set this bit if you want to disable the ioctl interface for security reasons. The default state for this bit is cleared.
bit 2: When set, the driver will disable 64-bit addressing capability. When clear, the driver will enable 64-bit addressing capability. The default state for this bit is cleared.

Refer to scsi_hba_attach(9F) for more information on driver configuration.

EXAMPLES

Example 1 Edit the file `/kernel/drv/symhisl.conf` and add the following line:

scsi-options=0x78;

Example 2 This disables tagged queuing, Fast/Ultra/Ultra2 SCSI and wide mode for all `symhisl` instances.

The following example disables an option for one specific symhisl (refer to driver.conf(4) and pci(4) for more details):

name="symhisl" parent="/pci@1f,4000"
    unit-address="3"
    target1-scsi-options=0x58
    scsi-options=0x178 scsi-initiator-id=6;

Example 3 Note that the initiator ID can only be changed for `symhisl` adapters that don't use the LSI Logic Boot ROM Configuration Utility. For adapters that can use the LSI Logic Boot ROM Configuration Utility, `scsi-initiator-id` will have no effect.

The example above sets scsi-options for target 1 to 0x58 and all other targets on this SCSI bus to 0x178.

The physical pathname of the parent can be determined using the /devices tree or following the link of the logical device name:

 # ls -l /dev/rdsk/c0t0d0s0
 lrwxrwxrwx  1 root   root      45 May 16 10:08 /dev/rdsk/c0t0d0s0 ->
    . . / . . /devices/pci@1f,4000/scsi@3/sd@0,0:a,raw

Example 4 In this case, like the example above, the parent is `/pci@1f,4000` and the `unit-address` is the number bound to the `scsi@3` node.

scsi-options specified per target ID have the highest precedence, followed by scsi-options per device type. Global scsi-options (for all symhisl instances) per bus have the lowest precedence.

The system needs to be rebooted before the specified scsi-options take effect.

Driver Capabilities

The target driver needs to set capabilities in the symhisl driver in order to enable some driver features. The target driver can query and modify these capabilities: disconnect, synchronous, wide-xfer, tagged-qing, and auto-rqsense. All other capabilities can only be queried.

By default, tagged-qing capabilities are disabled, while disconnect, synchronous, wide-xfer, auto-rqsense, and untagged-qing are enabled. These capabilities can only have binary values (0 or 1).

The target driver needs to enable tagged-qing explicitly. The untagged-qing capability is always enabled and its value cannot be modified.

Whenever there is a conflict 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.

Refer to scsi_ifsetcap(9F) and scsi_ifgetcap(9F) for details.

FILES

/kernel/drv/symhisl: ELF Kernel Module
/kernel/drv/symhisl.conf: Required configuration file

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	Limited to PCI-based systems with LSI Logic (formerly Symbios Inc) SYM53C896 SCSI I/O processors.

NOTES

The symhisl hardware (SYM53C896) supports Wide, Fast, Ultra, and Ultra2 SCSI synchronous speeds. The maximum SCSI bandwidth is 80 MB/sec.

SunOS 5.8 Last Revised 19 Oct 2000