Documentation/scsi/aic7xxx.txt

   1 ====================================================================
   2 =    Adaptec Aic7xxx Fast -> Ultra160 Family Manager Set v6.2.28   =
   3 =                            README for                            =
   4 =                     The Linux Operating System                   =
   5 ====================================================================
   6
   7 The following information is available in this file:
   8
   9   1. Supported Hardware
  10   2. Version History
  11   3. Command Line Options
  12   4. Contacting Adaptec
  13
  14 1. Supported Hardware
  15
  16    The following Adaptec SCSI Chips and Host Adapters are supported by
  17    the aic7xxx driver.
  18
  19    Chip    MIPS  Host Bus  MaxSync  MaxWidth  SCBs  Notes
  20    ---------------------------------------------------------------
  21    aic7770  10    EISA/VL   10MHz    16Bit      4   1
  22    aic7850  10    PCI/32    10MHz    8Bit       3
  23    aic7855  10    PCI/32    10MHz    8Bit       3
  24    aic7856  10    PCI/32    10MHz    8Bit       3
  25    aic7859  10    PCI/32    20MHz    8Bit       3
  26    aic7860  10    PCI/32    20MHz    8Bit       3
  27    aic7870  10    PCI/32    10MHz    16Bit      16
  28    aic7880  10    PCI/32    20MHz    16Bit      16
  29    aic7890  20    PCI/32    40MHz    16Bit      16      3 4 5 6 7 8
  30    aic7891  20    PCI/64    40MHz    16Bit      16      3 4 5 6 7 8
  31    aic7892  20   PCI/64-66  80MHz    16Bit      16      3 4 5 6 7 8
  32    aic7895  15    PCI/32    20MHz    16Bit      16    2 3 4 5
  33    aic7895C 15    PCI/32    20MHz    16Bit      16    2 3 4 5     8
  34    aic7896  20    PCI/32    40MHz    16Bit      16    2 3 4 5 6 7 8
  35    aic7897  20    PCI/64    40MHz    16Bit      16    2 3 4 5 6 7 8
  36    aic7899  20   PCI/64-66  80MHz    16Bit      16    2 3 4 5 6 7 8
  37
  38    1.   Multiplexed Twin Channel Device - One controller servicing two
  39         busses.
  40    2.   Multi-function Twin Channel Device - Two controllers on one chip.
  41    3.   Command Channel Secondary DMA Engine - Allows scatter gather list
  42         and SCB prefetch.
  43    4.   64 Byte SCB Support - Allows disconnected, unttagged request table
  44         for all possible target/lun combinations.
  45    5.   Block Move Instruction Support - Doubles the speed of certain
  46         sequencer operations.
  47    6.   `Bayonet' style Scatter Gather Engine - Improves S/G prefetch
  48         performance.
  49    7.   Queuing Registers - Allows queuing of new transactions without
  50         pausing the sequencer.
  51    8.   Multiple Target IDs - Allows the controller to respond to selection
  52         as a target on multiple SCSI IDs.
  53
  54    Controller      Chip   Host-Bus    Int-Connectors  Ext-Connectors  Notes
  55    --------------------------------------------------------------------------
  56    AHA-274X[A]    aic7770   EISA         SE-50M         SE-HD50F
  57    AHA-274X[A]W   aic7770   EISA         SE-HD68F       SE-HD68F
  58                                          SE-50M
  59    AHA-274X[A]T   aic7770   EISA       2 X SE-50M       SE-HD50F
  60    AHA-2842       aic7770    VL          SE-50M         SE-HD50F
  61    AHA-2940AU     aic7860   PCI/32       SE-50M         SE-HD50F
  62    AVA-2902I      aic7860   PCI/32       SE-50M
  63    AVA-2902E      aic7860   PCI/32       SE-50M
  64    AVA-2906       aic7856   PCI/32       SE-50M         SE-DB25F
  65    APC-7850       aic7850   PCI/32       SE-50M                       1
  66    AVA-2940       aic7860   PCI/32       SE-50M
  67    AHA-2920B      aic7860   PCI/32       SE-50M
  68    AHA-2930B      aic7860   PCI/32       SE-50M
  69    AHA-2920C      aic7856   PCI/32       SE-50M         SE-HD50F
  70    AHA-2930C      aic7860   PCI/32       SE-50M
  71    AHA-2930C      aic7860   PCI/32       SE-50M
  72    AHA-2910C      aic7860   PCI/32       SE-50M
  73    AHA-2915C      aic7860   PCI/32       SE-50M
  74    AHA-2940AU/CN  aic7860   PCI/32       SE-50M         SE-HD50F
  75    AHA-2944W      aic7870   PCI/32     HVD-HD68F        HVD-HD68F
  76                                         HVD-50M
  77    AHA-3940W      aic7870   PCI/32     2 X SE-HD68F     SE-HD68F        2
  78    AHA-2940UW     aic7880   PCI/32       SE-HD68F
  79                                          SE-50M         SE-HD68F
  80    AHA-2940U      aic7880   PCI/32       SE-50M         SE-HD50F
  81    AHA-2940D      aic7880   PCI/32
  82    aHA-2940 A/T   aic7880   PCI/32
  83    AHA-2940D A/T  aic7880   PCI/32
  84    AHA-3940UW     aic7880   PCI/32     2 X SE-HD68F     SE-HD68F          3
  85    AHA-3940UWD    aic7880   PCI/32     2 X SE-HD68F   2 X SE-VHD68F       3
  86    AHA-3940U      aic7880   PCI/32     2 X SE-50M       SE-HD50F          3
  87    AHA-2944UW     aic7880   PCI/32      HVD-HD68F       HVD-HD68F
  88                                          HVD-50M
  89    AHA-3944UWD    aic7880   PCI/32     2 X HVD-HD68F  2 X HVD-VHD68F      3
  90    AHA-4944UW     aic7880   PCI/32
  91    AHA-2930UW     aic7880   PCI/32
  92    AHA-2940UW Pro aic7880   PCI/32      SE-HD68F        SE-HD68F            4
  93                                          SE-50M
  94    AHA-2940UW/CN  aic7880   PCI/32
  95    AHA-2940UDual  aic7895   PCI/32
  96    AHA-2940UWDual aic7895   PCI/32
  97    AHA-3940UWD    aic7895   PCI/32
  98    AHA-3940AUW    aic7895   PCI/32
  99    AHA-3940AUWD   aic7895   PCI/32
 100    AHA-3940AU     aic7895   PCI/32
 101    AHA-3944AUWD   aic7895   PCI/32     2 X HVD-HD68F  2 X HVD-VHD68F
 102    AHA-2940U2B    aic7890   PCI/32      LVD-HD68F       LVD-HD68F
 103    AHA-2940U2 OEM aic7891   PCI/64
 104    AHA-2940U2W    aic7890   PCI/32      LVD-HD68F       LVD-HD68F
 105                                         SE-HD68F
 106                                          SE-50M
 107    AHA-2950U2B    aic7891   PCI/64      LVD-HD68F       LVD-HD68F
 108    AHA-2930U2     aic7890   PCI/32      LVD-HD68F       SE-HD50F
 109                                          SE-50M
 110    AHA-3950U2B    aic7897   PCI/64
 111    AHA-3950U2D    aic7897   PCI/64
 112    AHA-29160      aic7892   PCI/64-66
 113    AHA-29160 CPQ  aic7892   PCI/64-66
 114    AHA-29160N     aic7892   PCI/32      LVD-HD68F       SE-HD50F
 115                                          SE-50M
 116    AHA-29160LP    aic7892   PCI/64-66
 117    AHA-19160      aic7892   PCI/64-66
 118    AHA-29150LP    aic7892   PCI/64-66
 119    AHA-29130LP    aic7892   PCI/64-66
 120    AHA-3960D      aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
 121                                          LVD-50M
 122    AHA-3960D CPQ  aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
 123                                          LVD-50M
 124    AHA-39160      aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
 125                                          LVD-50M
 126
 127    1. No BIOS support
 128    2. DEC21050 PCI-PCI bridge with multiple controller chips on secondary bus
 129    3. DEC2115X PCI-PCI bridge with multiple controller chips on secondary bus
 130    4. All three SCSI connectors may be used simultaneously without
 131       SCSI "stub" effects.
 132
 133 2. Version History
 134    6.2.36 (June 3rd, 2003)
 135         - Correct code that disables PCI parity error checking.
 136         - Correct and simplify handling of the ignore wide residue
 137           message.  The previous code would fail to report a residual
 138           if the transaction data length was even and we received
 139           an IWR message.
 140         - Add support for the 2.5.X EISA framework.
 141         - Update for change in 2.5.X SCSI proc FS interface.
 142         - Correct Domain Validation command-line option parsing.
 143         - When negotiation async via an 8bit WDTR message, send
 144           an SDTR with an offset of 0 to be sure the target
 145           knows we are async.  This works around a firmware defect
 146           in the Quantum Atlas 10K.
 147         - Clear PCI error state during driver attach so that we
 148           don't disable memory mapped I/O due to a stray write
 149           by some other driver probe that occurred before we
 150           claimed the controller.
 151
 152    6.2.35 (May 14th, 2003)
 153         - Fix a few GCC 3.3 compiler warnings.
 154         - Correct operation on EISA Twin Channel controller.
 155         - Add support for 2.5.X's scsi_report_device_reset().
 156
 157    6.2.34 (May 5th, 2003)
 158         - Fix locking regression instroduced in 6.2.29 that
 159           could cuase a lock order reversal between the io_request_lock
 160           and our per-softc lock.  This was only possible on RH9,
 161           SuSE, and kernel.org 2.4.X kernels.
 162
 163    6.2.33 (April 30th, 2003)
 164         - Dynamically disable PCI parity error reporting after
 165           10 errors are reported to the user.  These errors are
 166           the result of some other device issuing PCI transactions
 167           with bad parity.  Once the user has been informed of the
 168           problem, continuing to report the errors just degrades
 169           our performance.
 170
 171    6.2.32 (March 28th, 2003)
 172         - Dynamically sized S/G lists to avoid SCSI malloc
 173           pool fragmentation and SCSI mid-layer deadlock.
 174
 175    6.2.28 (January 20th, 2003)
 176         - Domain Validation Fixes
 177         - Add ability to disable PCI parity error checking.
 178         - Enhanced Memory Mapped I/O probe
 179
 180    6.2.20 (November 7th, 2002)
 181         - Added Domain Validation.
 182
 183 3. Command Line Options
 184
 185         WARNING: ALTERING OR ADDING THESE DRIVER PARAMETERS
 186                  INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
 187                  USE THEM WITH CAUTION.
 188
 189    Edit the file "modprobe.conf" in the directory /etc and add/edit a
 190    line containing 'options aic7xxx aic7xxx=[command[,command...]]' where
 191    'command' is one or more of the following:
 192    -----------------------------------------------------------------
 193               Option: verbose
 194           Definition: enable additional informative messages during
 195                       driver operation.
 196      Possible Values: This option is a flag
 197        Default Value: disabled
 198    -----------------------------------------------------------------
 199               Option: debug:[value]
 200           Definition: Enables various levels of debugging information
 201      Possible Values: 0x0000 = no debugging, 0xffff = full debugging
 202        Default Value: 0x0000
 203    -----------------------------------------------------------------
 204               Option: no_probe
 205               Option: probe_eisa_vl
 206           Definition: Do not probe for EISA/VLB controllers.
 207                       This is a toggle.  If the driver is compiled
 208                       to not probe EISA/VLB controllers by default,
 209                       specifying "no_probe" will enable this probing.
 210                       If the driver is compiled to probe EISA/VLB
 211                       controllers by default, specifying "no_probe"
 212                       will disable this probing.
 213      Possible Values: This option is a toggle
 214        Default Value: EISA/VLB probing is disabled by default.
 215    -----------------------------------------------------------------
 216               Option: pci_parity
 217           Definition: Toggles the detection of PCI parity errors.
 218                       On many motherboards with VIA chipsets,
 219                       PCI parity is not generated correctly on the
 220                       PCI bus.  It is impossible for the hardware to
 221                       differentiate between these "spurious" parity
 222                       errors and real parity errors.  The symptom of
 223                       this problem is a stream of the message:
 224     "scsi0: Data Parity Error Detected during address or write data phase"
 225                       output by the driver.
 226      Possible Values: This option is a toggle
 227        Default Value: PCI Parity Error reporting is disabled
 228    -----------------------------------------------------------------
 229               Option: no_reset
 230           Definition: Do not reset the bus during the initial probe
 231                       phase
 232      Possible Values: This option is a flag
 233        Default Value: disabled
 234    -----------------------------------------------------------------
 235               Option: extended
 236           Definition: Force extended translation on the controller
 237      Possible Values: This option is a flag
 238        Default Value: disabled
 239    -----------------------------------------------------------------
 240               Option: periodic_otag
 241           Definition: Send an ordered tag periodically to prevent
 242                       tag starvation.  Needed for some older devices
 243      Possible Values: This option is a flag
 244        Default Value: disabled
 245    -----------------------------------------------------------------
 246               Option: reverse_scan
 247           Definition: Probe the scsi bus in reverse order, starting
 248                       with target 15
 249      Possible Values: This option is a flag
 250        Default Value: disabled
 251    -----------------------------------------------------------------
 252               Option: global_tag_depth:[value]
 253           Definition: Global tag depth for all targets on all busses.
 254                       This option sets the default tag depth which
 255                       may be selectively overridden vi the tag_info
 256                       option.
 257      Possible Values: 1 - 253
 258        Default Value: 32
 259    -----------------------------------------------------------------
 260               Option: tag_info:{{value[,value...]}[,{value[,value...]}...]}
 261           Definition: Set the per-target tagged queue depth on a
 262                       per controller basis.  Both controllers and targets
 263                       may be ommitted indicating that they should retain
 264                       the default tag depth.
 265             Examples: tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
 266                         On Controller 0
 267                           specifies a tag depth of 16 for target 0
 268                           specifies a tag depth of 64 for target 3
 269                           specifies a tag depth of 8 for targets 4 and 5
 270                           leaves target 6 at the default
 271                           specifies a tag depth of 32 for targets 1,2,7-15
 272                         All other targets retain the default depth.
 273
 274                       tag_info:{{},{32,,32}}
 275                         On Controller 1
 276                           specifies a tag depth of 32 for targets 0 and 2
 277                         All other targets retain the default depth.
 278
 279      Possible Values: 1 - 253
 280        Default Value: 32
 281    -----------------------------------------------------------------
 282               Option: seltime:[value]
 283           Definition: Specifies the selection timeout value
 284      Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
 285        Default Value: 0
 286    -----------------------------------------------------------------
 287               Option: dv: {value[,value...]}
 288           Definition: Set Domain Validation Policy on a per-controller basis.
 289                       Controllers may be ommitted indicating that
 290                       they should retain the default read streaming setting.
 291              Example: dv:{-1,0,,1,1,0}
 292                         On Controller 0 leave DV at its default setting.
 293                         On Controller 1 disable DV.
 294                         Skip configuration on Controller 2.
 295                         On Controllers 3 and 4 enable DV.
 296                         On Controller 5 disable DV.
 297
 298      Possible Values: < 0 Use setting from serial EEPROM.
 299                       0 Disable DV
 300                       > 0 Enable DV
 301
 302        Default Value: SCSI-Select setting on controllers with a SCSI Select
 303                       option for DV.  Otherwise, on for controllers supporting
 304                       U160 speeds and off for all other controller types.
 305    -----------------------------------------------------------------
 306
 307    Example:
 308    'options aic7xxx aic7xxx=verbose,no_probe,tag_info:{{},{,,10}},seltime:1"
 309         enables verbose logging, Disable EISA/VLB probing,
 310         and set tag depth on Controller 1/Target 2 to 10 tags.
 311
 312 3. Contacting Adaptec
 313
 314    A Technical Support Identification (TSID) Number is required for
 315    Adaptec technical support.
 316     - The 12-digit TSID can be found on the white barcode-type label
 317       included inside the box with your product. The TSID helps us
 318       provide more efficient service by accurately identifying your
 319       product and support status.
 320    Support Options
 321     - Search the Adaptec Support Knowledgebase (ASK) at
 322       http://ask.adaptec.com for articles, troubleshooting tips, and
 323       frequently asked questions for your product.
 324     - For support via Email, submit your question to Adaptec's
 325       Technical Support Specialists at http://ask.adaptec.com.
 326
 327    North America
 328     - Visit our Web site at http://www.adaptec.com.
 329     - To speak with a Fibre Channel/RAID/External Storage Technical
 330       Support Specialist, call 1-321-207-2000,
 331       Hours: Monday-Friday, 3:00 A.M. to 5:00 P.M., PST.
 332       (Not open on holidays)
 333     - For Technical Support in all other technologies including
 334       SCSI, call 1-408-934-7274,
 335       Hours: Monday-Friday, 6:00 A.M. to 5:00 P.M., PST.
 336       (Not open on holidays)
 337     - For after hours support, call 1-800-416-8066 ($99/call,
 338       $149/call on holidays)
 339     - To order Adaptec products including software and cables, call
 340       1-800-442-7274 or 1-408-957-7274. You can also visit our
 341       online store at http://www.adaptecstore.com
 342
 343    Europe
 344     - Visit our Web site at http://www.adaptec-europe.com.
 345     - English and French: To speak with a Technical Support
 346       Specialist, call one of the following numbers:
 347         - English: +32-2-352-3470
 348         - French:  +32-2-352-3460
 349       Hours: Monday-Thursday, 10:00 to 12:30, 13:30 to 17:30 CET
 350              Friday, 10:00 to 12:30, 13:30 to 16:30 CET
 351     - German: To speak with a Technical Support Specialist,
 352       call +49-89-456-40660
 353       Hours: Monday-Thursday, 09:30 to 12:30, 13:30 to 16:30 CET
 354              Friday, 09:30 to 12:30, 13:30 to 15:00 CET
 355     - To order Adaptec products, including accessories and cables:
 356         - UK: +0800-96-65-26 or fax +0800-731-02-95
 357         - Other European countries: +32-11-300-379
 358
 359    Australia and New Zealand
 360     - Visit our Web site at http://www.adaptec.com.au.
 361     - To speak with a Technical Support Specialist, call
 362       +612-9416-0698
 363       Hours: Monday-Friday, 10:00 A.M. to 4:30 P.M., EAT
 364       (Not open on holidays)
 365
 366    Japan
 367     - To speak with a Technical Support Specialist, call
 368       +81-3-5308-6120
 369       Hours: Monday-Friday, 9:00 a.m. to 12:00 p.m., 1:00 p.m. to
 370       6:00 p.m. TSC
 371
 372    Hong Kong and China
 373     - To speak with a Technical Support Specialist, call
 374       +852-2869-7200
 375       Hours: Monday-Friday, 10:00 to 17:00.
 376     - Fax Technical Support at +852-2869-7100.
 377
 378    Singapore
 379     - To speak with a Technical Support Specialist, call
 380       +65-245-7470
 381       Hours: Monday-Friday, 10:00 to 17:00.
 382     - Fax Technical Support at +852-2869-7100
 383
 384 -------------------------------------------------------------------
 385 /*
 386  * Copyright (c) 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
 387  * All rights reserved.
 388  *
 389  * You are permitted to redistribute, use and modify this README file in whole
 390  * or in part in conjunction with redistribution of software governed by the
 391  * General Public License, provided that the following conditions are met:
 392  * 1. Redistributions of README file must retain the above copyright
 393  *    notice, this list of conditions, and the following disclaimer,
 394  *    without modification.
 395  * 2. The name of the author may not be used to endorse or promote products
 396  *    derived from this software without specific prior written permission.
 397  * 3. Modifications or new contributions must be attributed in a copyright
 398  *    notice identifying the author ("Contributor") and added below the
 399  *    original copyright notice. The copyright notice is for purposes of
 400  *    identifying contributors and should not be deemed as permission to alter
 401  *    the permissions given by Adaptec.
 402  *
 403  * THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS'' AND
 404  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
 405  * WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
 406  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
 407  * ADAPTEC OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 408  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 409  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 410  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 411  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 412  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS README
 413  * FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 414  */