File Name: redhat.txt IBM Ultra320 SCSI Controller 2 p/n 13N2249, FRU p/n 13N2250 Red Hat Linux v7.x and Red Hat Advanced Server v2.1 IBM eServer xSeries CONTENTS --------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Command Line Options 5.0 Additional Notes 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer 1.0 Overview ------------ This package contains the Adaptec Ultra320 Family Manager Set v2.0.13 for Red Hat Linux v7.x and REd Hat Advanced Server v2.1 1.1 Supported Hardware Ultra320 ASIC Description ---------------------------------------------------------------- AIC-7901A Single Channel 64-bit PCI-X 133MHz to Ultra320 SCSI ASIC AIC-7901B Single Channel 64-bit PCI-X 133MHz to Ultra320 SCSI ASIC with Retained Training AIC-7902A4 Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI ASIC AIC-7902B Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI ASIC with Retained Training Ultra320 Adapters Description ---------------------------------------------------------------- Adaptec SCSI Card 39320 Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (one external 68-pin, two internal 68-pin) Adaptec SCSI Card 39320A Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (one external 68-pin, two internal 68-pin) Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (two external VHDC and one internal 68-pin) Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (two external VHDC and one internal 68-pin) based on the AIC-7902B ASIC Adaptec SCSI Card 29320 Single Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (one external 68-pin, two internal 68-pin, one internal 50-pin) Adaptec SCSI Card 29320A Single Channel 64-bit PCI-X 133MHz to Ultra320 SCSI Card (one external 68-pin, two internal 68-pin, one internal 50-pin) Adaptec SCSI Card 29320LP Single Channel 64-bit Low Profile PCI-X 133MHz to Ultra320 SCSI Card (One external VHDC, one internal 68-pin) Adaptec SCSI Card 29320ALP Single Channel 64-bit Low Profile PCI-X 133MHz to Ultra320 SCSI Card (One external VHDC, one internal 2.0 Change History ------------------ 2.0.13 (July 22, 2004) - Fix a compilation issue due to the changed location and name of the "hosts.h" file. Now it resides as - Add support for 16 byte CDBs. 2.0.12 (May 13th, 2004) - Flag driver threads with PF_FREEZE to support software suspend. 2.0.11 (May 7th, 2004) - Avoid split-completion bugs in certain PCI-X chipsets by breaking up large completion entry DMAs on ADB boundaries. 2.0.10 (April 9th, 2004) - Return "command timeout" status instead of "selection timeout status" to the SCSI mid-layer in response to selection timeouts. While the latter may seem more correct, the mid-layer will not offline devices suffering from persistent selection timeouts. This leads to extremely long recovery times for devices that go missing. Returning command timeout status causes the mid-layer to enter recovery and eventually offline persistently missing devices. 2.0.9 (March 29th, 2004) - Abort all pending transactions on a target in response to a selection timeout. This greatly increases the speed with which we recover when a device "goes missing". 2.0.8 (March 7th, 2004) - Fix PCI device/vendor ID mask for the 7901B probe entry so the driver will successfully attach to 7901B parts down on motherboards. 2.0.7 (February 24th, 2004) - Implement delay on I/O after delivery of a Target Reset. - Correct deregistration of sysrq handler when multiple controllers are detected. 2.0.6 (February 6th, 2004) - Force a renegotiation on all inqury commands so that the negotiated transfer parameters are correct even if the device has been externally reset since our last command. Devices are not allowed to report unit attention conditions in response to inquiry requests otherwise we'd not need to treat inquiry commands specially. - Remove all vestiges of pre-2.4.X support. - Close a very rare race-condition in RevA 790X controllers. If both FIFOs are allocated before the sequencer's idle loop is able to service the FIFO that was allocated first, the sequencer could handle them out of order. This could lead to a deadlock where the FIFO attached to the SCSI bus is being serviced by the sequencer, but the other FIFO is required to handle a snapshot. The sequencer now detects this condition and always handles FIFOs that are not currently on the bus first. - Close a few race conditions by adding critical section markers into the firmware. These windows might have caused issues during error recovery. - Switch the complete DMA SCB list to a tailq so that multiple SCBs completing with non-zero status do not interfere with the state for the SCB currently being uploaded. - Use the comparison of a kernel and a sequencer qfreeze count to control the freezing of outgoing selections. This allows the kernel to handle non-zero SCB completions without having to clear firmware critical sections. - Change the completion FIFO mechanism so that all completion entries are guaranteed aligned on a 64bit boundary. This avoids SCB DMA engine bugs that are triggered if the transfer is interrupted (e.g. PCI disconnect) on a non-aligned boundary. In some cases, these bugs would result in duplicate completions. - Use one byte in the new completion entry to indicate if the SCB completed without a residual or non-zero SCSI status. This avoids an extra memory reference in our interrupt handler. 2.0.5 (December 22nd, 2003) - Correct a bug preventing the driver from renegotiating during auto-request sense operations when a check condition occurred for a zero length command. - Sniff sense information returned by targets for unit attention errors that may indicate that the device has been changed. If we see such status for non Domain Validation related commands, start a DV scan for the target. In the past, DV would only occur for hot-plugged devices if no target had been previously probed for a particular ID. This change guarantees that the DV process will occur even if the user swaps devices without any interveining I/O to tell us that a device has gone missing. The old behavior, among other things, would fail to spin up drives that were hot-plugged since the Linux mid-layer will only spin-up drives on initial attach. - Correct several issues in the rundown of the good status FIFO during error recovery. The typical failure scenario evidenced by this defect was the loss of several commands under high load when several queue full conditions occured back to back. 2.0.4 (November 6th, 2003) - Support the 2.6.0-test9 kernel - Fix rare deadlock caused by using del_timer_sync from within a timer handler. 2.0.3 (October 21st, 2003) - On 7902A4 hardware, use the slow slew rate for transfer rates slower than U320. This behavior matches the Windows driver. - Fix some issues with the ahd_flush_qoutfifo() routine. - Add a delay in the loop waiting for selection activity to cease. Otherwise we may exhaust the loop counter too quickly on fast machines. - Return to processing bad status completions through the qoutfifo. This reduces the amount of time the controller is paused for these kinds of errors. - Move additional common routines to the aiclib OSM library to reduce code duplication. - Leave removal of softcs from the global list of softcs to the OSM. This allows us to avoid holding the list_lock during device destruction. - Enforce a bus settle delay for bus resets that the driver initiates. - Fall back to basic DV for U160 devices that lack an echo buffer. 2.0.2 (September 4th, 2003) - Move additional common routines to the aiclib OSM library to reduce code duplication. - Avoid an inadvertant reset of the controller during the memory mapped I/O test should the controller be left in the reset state prior to driver initialization. On some systems, this extra reset resulted in a system hang due to a chip access that occurred too soon after reset. - Correct an endian bug in ahd_swap_with_next_hscb. This corrects strong-arm support. - Reset the bus for transactions that timeout waiting for the bus to go free after a disconnect or command complete message. 2.0.1 (August 26th, 2003) - Add magic sysrq handler that causes a card dump to be output to the console for each controller. - Avoid waking the mid-layer's error recovery handler during timeout recovery by returning DID_ERROR instead of DID_TIMEOUT for timed-out commands that have been aborted. - Move additional common routines to the aiclib OSM library to reduce code duplication. 2.0.0 (August 20th, 2003) - Remove MMAPIO definition and allow memory mapped I/O for any platform that supports PCI. - Avoid clearing ENBUSFREE during single stepping to avoid spurious "unexpected busfree while idle" messages. - Correct deadlock in ahd_run_qoutfifo() processing. - Optimize support for the 7901B. - Correct a few cases where an explicit flush of pending register writes was required to ensure acuracy in delays. - Correct problems in manually flushing completed commands on the controller. The FIFOs are now flushed to ensure that completed commands that are still draining to the host are completed correctly. - Correct incomplete CDB delivery detection on the 790XB. - Ignore the cmd->underflow field since userland applications using the legacy command pass-thru interface do not set it correctly. Honoring this field led to spurious errors when users used the "scsi_unique_id" program. - Perform timeout recovery within the driver instead of relying on the Linux SCSI mid-layer to perform this function. The mid-layer does not know the full state of the SCSI bus and is therefore prone to looping for several minutes to effect recovery. The new scheme recovers within 15 seconds of the failure. - Correct support for manual termination settings. - Increase maximum wait time for serial eeprom writes allowing writes to function correctly. 1.3.12 (August 11, 2003) - Implement new error recovery thread that supercedes the existing Linux SCSI error recovery code. - Fix termination logic for 29320ALP. - Fix SEEPROM delay to compensate for write ops taking longer. 1.3.11 (July 11, 2003) - Fix several deadlock issues. - Add 29320ALP and 39320B Id's. 1.3.10 (June 3rd, 2003) - Align the SCB_TAG field on a 16byte boundary. This avoids SCB corruption on some PCI-33 busses. - Correct non-zero luns on Rev B. hardware. - Update for change in 2.5.X SCSI proc FS interface. - When negotiation async via an 8bit WDTR message, send an SDTR with an offset of 0 to be sure the target knows we are async. This works around a firmware defect in the Quantum Atlas 10K. - Implement controller susupend and resume. - Clear PCI error state during driver attach so that we don't disable memory mapped I/O due to a stray write by some other driver probe that occurred before we claimed the controller. 1.3.9 (May 22nd, 2003) - Fix compiler errors. - Remove S/G splitting for segments that cross a 4GB boundary. This is guaranteed not to happen in Linux. - Add support for scsi_report_device_reset() found in 2.5.X kernels. - Add 7901B support. - Simplify handling of the packtized lun Rev A workaround. - Correct and simplify handling of the ignore wide residue message. The previous code would fail to report a residual if the transaction data length was even and we received an IWR message. 1.3.8 (April 29th, 2003) - Fix types accessed via the command line interface code. - Perform a few firmware optimizations. - Fix "Unexpected PKT busfree" errors. - Use a sequencer interrupt to notify the host of commands with bad status. We defer the notification until there are no outstanding selections to ensure that the host is interrupted for as short a time as possible. - Remove pre-2.2.X support. - Add support for new 2.5.X interrupt API. - Correct big-endian architecture support. 1.3.7 (April 16th, 2003) - Use del_timer_sync() to ensure that no timeouts are pending during controller shutdown. - For pre-2.5.X kernels, carefully adjust our segment list size to avoid SCSI malloc pool fragmentation. - Cleanup channel display in our /proc output. - Workaround duplicate device entries in the mid-layer devlice list during add-single-device. 1.3.6 (March 28th, 2003) - Correct a double free in the Domain Validation code. - Correct a reference to free'ed memory during controller shutdown. - Reset the bus on an SE->LVD change. This is required to reset our transcievers. 1.3.5 (March 24th, 2003) - Fix a few register window mode bugs. - Include read streaming in the PPR flags we display in diagnostics as well as /proc. - Add PCI hot plug support for 2.5.X kernels. - Correct default precompensation value for RevA hardware. - Fix Domain Validation thread shutdown. - Add a firmware workaround to make the LED blink brighter during packetized operations on the H2A4. - Correct /proc display of user read streaming settings. - Simplify driver locking by releasing the io_request_lock upon driver entry from the mid-layer. - Cleanup command line parsing and move much of this code to aiclib. 1.3.4 (February 28th, 2003) - Correct a race condition in our error recovery handler. - Allow Test Unit Ready commands to take a full 5 seconds during Domain Validation. 1.3.2 (February 19th, 2003) - Correct a Rev B. regression due to the GEM318 compatibility fix included in 1.3.1. 1.3.1 (February 11th, 2003) - Add support for the 39320A. - Improve recovery for certain PCI-X errors. - Fix handling of LQ/DATA/LQ/DATA for the same write transaction that can occur without interveining training. - Correct compatibility issues with the GEM318 enclosure services device. - Correct data corruption issue that occurred under high tag depth write loads. - Adapt to a change in the 2.5.X daemonize() API. - Correct a "Missing case in ahd_handle_scsiint" panic. 1.3.0 (January 21st, 2003) - Full regression testing for all U320 products completed. - Added abort and target/lun reset error recovery handler and interrupt coalessing. 1.2.0 (November 14th, 2002) - Added support for Domain Validation - Add support for the Hewlett-Packard version of the 39320D and AIC-7902 adapters. Support for previous adapters has not been fully tested and should only be used at the customer's own risk. 1.1.1 (September 24th, 2002) - Added support for the Linux 2.5.X kernel series 1.1.0 (September 17th, 2002) - Added support for four additional SCSI products: ASC-39320, ASC-29320, ASC-29320LP, AIC-7901. 1.0.0 (May 30th, 2002) - Initial driver release. 2.1. Software/Hardware Features - Support for the SPI-4 "Ultra320" standard: - 320MB/s transfer rates - Packetized SCSI Protocol at 160MB/s and 320MB/s - Quick Arbitration Selection (QAS) - Retained Training Information (Rev B. ASIC only) - Interrupt Coalessing - Initiator Mode (target mode not currently supported) - Support for the PCI-X standard up to 133MHz - Support for the PCI v2.2 standard - Domain Validation 2.2. Operating System Support: - Redhat Linux 7.2, 7.3, 8.0, Advanced Server 2.1 - SuSE Linux 7.3, 8.0, 8.1, Enterprise Server 7 - only Intel and AMD x86 supported at this time - >4GB memory configurations supported. 3.0 Installation and Setup Instructions ----------------------------------------- 1 Boot off of the Red Hat Linux 7.x CD. Refer to the instructions for your operating system. Follow the standard installation steps with the exceptions noted below. 2 At the boot prompt, type: linux dd You will have about 10 seconds to type the command; otherwise, you will go directly to the standard installation screen and you will not be able to use the driver diskette. 3 When the Do You Have a Driver Diskette screen appears, select Yes and follow the on-screen instructions. Use the diskette created in x-ref. Note: If you are installing Red Hat 7.3 or Red Hat Advanced Server 2.1, continue with normal installation. If you are installing Red Hat 7.2, continue with Step 4. 4 When the Boot Loader Configuration menu appears, select Use GRUB as the Boot Loader. 5 When the Boot Disk Creation menu appears, select Skip Boot Disk Creation. Note: If you do not select this option, you will copy over the driver disk and you will not be able to complete the final steps. Note: If you are installing Red Hat 7.2 , continue with normal installation. If you are installing Red Hat 7.3 or Red Hat Advanced Server 2.1, go to Step 11. 6 At the Congratulations screen, press Crl+Alt+F2. 7 At the prompt, type: chroot /mnt/sysimage 8 Type: mount /dev/fd0 /mnt 9 Type: /mnt/fixup.sh 10 Press Alt+F7. The program returns you to the installation window. 11 Click Exit to complete the installation. 4.0 Command Line Options ------------------------ WARNING: ALTERING OR ADDING THESE DRIVER PARAMETERS INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE. USE THEM WITH CAUTION. Edit the file "modules.conf" in the directory /etc and add/edit a line containing 'options aic79xx aic79xx=[command[,command...]]' where 'command' is one or more of the following: ----------------------------------------------------------------- Option: verbose Definition: enable additional informative messages during driver operation. Possible Values: This option is a flag Default Value: disabled ----------------------------------------------------------------- Option: debug:[value] Definition: Enables various levels of debugging information The bit definitions for the debugging mask can be found in drivers/scsi/aic7xxx/aic79xx.h under the "Debug" heading. Possible Values: 0x0000 = no debugging, 0xffff = full debugging Default Value: 0x0000 ----------------------------------------------------------------- Option: no_reset Definition: Do not reset the bus during the initial probe phase Possible Values: This option is a flag Default Value: disabled ----------------------------------------------------------------- Option: extended Definition: Force extended translation on the controller Possible Values: This option is a flag Default Value: disabled ----------------------------------------------------------------- Option: periodic_otag Definition: Send an ordered tag periodically to prevent tag starvation. Needed for some older devices Possible Values: This option is a flag Default Value: disabled ----------------------------------------------------------------- Option: reverse_scan Definition: Probe the scsi bus in reverse order, starting with target 15 Possible Values: This option is a flag Default Value: disabled ----------------------------------------------------------------- Option: global_tag_depth Definition: Global tag depth for all targets on all busses. This option sets the default tag depth which may be selectively overridden vi the tag_info option. Possible Values: 1 - 253 Default Value: 32 ----------------------------------------------------------------- Option: tag_info:{{value[,value...]}[,{value[,value...]}...]} Definition: Set the per-target tagged queue depth on a per controller basis. Both controllers and targets may be ommitted indicating that they should retain the default tag depth. Examples: tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32} On Controller 0 specifies a tag depth of 16 for target 0 specifies a tag depth of 64 for target 3 specifies a tag depth of 8 for targets 4 and 5 leaves target 6 at the default specifies a tag depth of 32 for targets 1,2,7-15 All other targets retain the default depth. tag_info:{{},{32,,32}} On Controller 1 specifies a tag depth of 32 for targets 0 and 2 All other targets retain the default depth. Possible Values: 1 - 253 Default Value: 32 ----------------------------------------------------------------- Option: rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]} Definition: Enable read streaming on a per target basis. The rd_strm_bitmask is a 16 bit hex value in which each bit represents a target. Setting the target's bit to '1' enables read streaming for that target. Controllers may be ommitted indicating that they should retain the default read streaming setting. Example: rd_strm:{0x0041} On Controller 0 enables read streaming for targets 0 and 6. disables read streaming for targets 1-5,7-15. All other targets retain the default read streaming setting. Example: rd_strm:{0x0023,,0xFFFF} On Controller 0 enables read streaming for targets 1,2, and 5. disables read streaming for targets 3,4,6-15. On Controller 2 enables read streaming for all targets. All other targets retain the default read streaming setting. Possible Values: 0x0000 - 0xffff Default Value: 0x0000 ----------------------------------------------------------------- Option: dv: {value[,value...]} Definition: Set Domain Validation Policy on a per-controller basis. Controllers may be ommitted indicating that they should retain the default read streaming setting. Example: dv:{-1,0,,1,1,0} On Controller 0 leave DV at its default setting. On Controller 1 disable DV. Skip configuration on Controller 2. On Controllers 3 and 4 enable DV. On Controller 5 disable DV. Possible Values: < 0 Use setting from serial EEPROM. 0 Disable DV > 0 Enable DV Default Value: DV Serial EEPROM configuration setting. ----------------------------------------------------------------- Option: seltime:[value] Definition: Specifies the selection timeout value Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms Default Value: 0 ----------------------------------------------------------------- *** The following three options should only be changed at *** *** the direction of a technical support representative. *** ----------------------------------------------------------------- Option: precomp: {value[,value...]} Definition: Set IO Cell precompensation value on a per-controller basis. Controllers may be ommitted indicating that they should retain the default precompensation setting. Example: precomp:{0x1} On Controller 0 set precompensation to 1. Example: precomp:{1,,7} On Controller 0 set precompensation to 1. On Controller 2 set precompensation to 8. Possible Values: 0 - 7 Default Value: Varies based on chip revision ----------------------------------------------------------------- Option: slewrate: {value[,value...]} Definition: Set IO Cell slew rate on a per-controller basis. Controllers may be ommitted indicating that they should retain the default slew rate setting. Example: slewrate:{0x1} On Controller 0 set slew rate to 1. Example: slewrate :{1,,8} On Controller 0 set slew rate to 1. On Controller 2 set slew rate to 8. Possible Values: 0 - 15 Default Value: Varies based on chip revision ----------------------------------------------------------------- Option: amplitude: {value[,value...]} Definition: Set IO Cell signal amplitude on a per-controller basis. Controllers may be ommitted indicating that they should retain the default read streaming setting. Example: amplitude:{0x1} On Controller 0 set amplitude to 1. Example: amplitude :{1,,7} On Controller 0 set amplitude to 1. On Controller 2 set amplitude to 7. Possible Values: 1 - 7 Default Value: Varies based on chip revision ----------------------------------------------------------------- Example: 'options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}' enables verbose output in the driver and turns read streaming on for targets 0 and 6 of Controller 0. 5.0 Additional Notes -------------------- 5.1. Known/Unresolved or FYI Issues * Under SuSE Linux Enterprise 7, the driver may fail to operate correctly due to a problem with PCI interrupt routing in the Linux kernel. Please contact SuSE for an updated Linux kernel. 5.2. Third-Party Compatibility Issues * Adaptec only supports Ultra320 hard drives running the latest firmware available. Please check with your hard drive manufacturer to ensure you have the latest version. 5.3. Operating System or Technology Limitations * PCI Hot Plug is untested and may cause the operating system to stop responding. * Luns that are not numbered contiguously starting with 0 might not be automatically probed during system startup. This is a limitation of the OS. Please contact your Linux vendor for instructions on manually probing non-contiguous luns. * Using the Driver Update Disk version of this package during OS installation under RedHat might result in two versions of this driver being installed into the system module directory. This might cause problems with the /sbin/mkinitrd program and/or other RPM packages that try to install system modules. The best way to correct this once the system is running is to install the latest RPM package version of this driver. 6.0 WEB Sites and Support Phone Number -------------------------------------- 6.1 IBM Support Web Site: http://www.ibm.com/pc/support 6.2 IBM Marketing Netfinity Web Site: http://www.pc.ibm.com/netfinity 6.3 If you have any questions about this update, or problems applying the update go to the following Help Center World Telephone Numbers URL: 1-800-772-2227 http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html. 7.0 Trademarks and Notices -------------------------- 7.1 IBM and the e(logo) are registered trademarks of International Business Machines Corporation in the United States, other countries, or both. 7.2 This software contains the valuable trade secrets of Adaptec or its licensors. The software is protected under international copyright laws and treaties. This software may only be used in accordance with the terms of its accompanying license agreement. 7.3 Red Hat is a registered trademark of Red Hat Inc. 7.4 Linux is a registered trademark of Linus Torvalds 8.0 Disclaimer ---------------- 8.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 8.2 Note to Government Users Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.