Back to home page

OSCL-LXR

 
 

    


0001 .. SPDX-License-Identifier: GPL-2.0
0002 .. include:: <isonum.txt>
0003 
0004 ========================================================
0005 Adaptec Aic7xxx Fast -> Ultra160 Family Manager Set v7.0
0006 ========================================================
0007 
0008 README for The Linux Operating System
0009 
0010 The following information is available in this file:
0011 
0012   1. Supported Hardware
0013   2. Version History
0014   3. Command Line Options
0015   4. Contacting Adaptec
0016 
0017 1. Supported Hardware
0018 =====================
0019 
0020    The following Adaptec SCSI Chips and Host Adapters are supported by
0021    the aic7xxx driver.
0022 
0023    ======== ===== ========= ======== ========= ===== ===============
0024    Chip     MIPS  Host Bus  MaxSync  MaxWidth  SCBs  Notes
0025    ======== ===== ========= ======== ========= ===== ===============
0026    aic7770  10    EISA/VL   10MHz    16Bit      4    1
0027    aic7850  10    PCI/32    10MHz    8Bit       3
0028    aic7855  10    PCI/32    10MHz    8Bit       3
0029    aic7856  10    PCI/32    10MHz    8Bit       3
0030    aic7859  10    PCI/32    20MHz    8Bit       3
0031    aic7860  10    PCI/32    20MHz    8Bit       3
0032    aic7870  10    PCI/32    10MHz    16Bit      16
0033    aic7880  10    PCI/32    20MHz    16Bit      16
0034    aic7890  20    PCI/32    40MHz    16Bit      16      3 4 5 6 7 8
0035    aic7891  20    PCI/64    40MHz    16Bit      16      3 4 5 6 7 8
0036    aic7892  20    PCI/64-66 80MHz    16Bit      16      3 4 5 6 7 8
0037    aic7895  15    PCI/32    20MHz    16Bit      16    2 3 4 5
0038    aic7895C 15    PCI/32    20MHz    16Bit      16    2 3 4 5     8
0039    aic7896  20    PCI/32    40MHz    16Bit      16    2 3 4 5 6 7 8
0040    aic7897  20    PCI/64    40MHz    16Bit      16    2 3 4 5 6 7 8
0041    aic7899  20    PCI/64-66 80MHz    16Bit      16    2 3 4 5 6 7 8
0042    ======== ===== ========= ======== ========= ===== ===============
0043 
0044    1.   Multiplexed Twin Channel Device - One controller servicing two
0045         busses.
0046    2.   Multi-function Twin Channel Device - Two controllers on one chip.
0047    3.   Command Channel Secondary DMA Engine - Allows scatter gather list
0048         and SCB prefetch.
0049    4.   64 Byte SCB Support - Allows disconnected, untagged request table
0050         for all possible target/lun combinations.
0051    5.   Block Move Instruction Support - Doubles the speed of certain
0052         sequencer operations.
0053    6.   'Bayonet' style Scatter Gather Engine - Improves S/G prefetch
0054         performance.
0055    7.   Queuing Registers - Allows queuing of new transactions without
0056         pausing the sequencer.
0057    8.   Multiple Target IDs - Allows the controller to respond to selection
0058         as a target on multiple SCSI IDs.
0059 
0060    ============== ======= =========== =============== =============== =========
0061    Controller      Chip   Host-Bus    Int-Connectors  Ext-Connectors  Notes
0062    ============== ======= =========== =============== =============== =========
0063    AHA-274X[A]    aic7770   EISA         SE-50M         SE-HD50F
0064    AHA-274X[A]W   aic7770   EISA         SE-HD68F       SE-HD68F
0065                                          SE-50M
0066    AHA-274X[A]T   aic7770   EISA       2 X SE-50M       SE-HD50F
0067    AHA-2842       aic7770    VL          SE-50M         SE-HD50F
0068    AHA-2940AU     aic7860   PCI/32       SE-50M         SE-HD50F
0069    AVA-2902I      aic7860   PCI/32       SE-50M
0070    AVA-2902E      aic7860   PCI/32       SE-50M
0071    AVA-2906       aic7856   PCI/32       SE-50M         SE-DB25F
0072    APC-7850       aic7850   PCI/32       SE-50M                       1
0073    AVA-2940       aic7860   PCI/32       SE-50M
0074    AHA-2920B      aic7860   PCI/32       SE-50M
0075    AHA-2930B      aic7860   PCI/32       SE-50M
0076    AHA-2920C      aic7856   PCI/32       SE-50M         SE-HD50F
0077    AHA-2930C      aic7860   PCI/32       SE-50M
0078    AHA-2930C      aic7860   PCI/32       SE-50M
0079    AHA-2910C      aic7860   PCI/32       SE-50M
0080    AHA-2915C      aic7860   PCI/32       SE-50M
0081    AHA-2940AU/CN  aic7860   PCI/32       SE-50M         SE-HD50F
0082    AHA-2944W      aic7870   PCI/32     HVD-HD68F        HVD-HD68F
0083                                        HVD-50M
0084    AHA-3940W      aic7870   PCI/32     2 X SE-HD68F     SE-HD68F        2
0085    AHA-2940UW     aic7880   PCI/32       SE-HD68F
0086                                          SE-50M         SE-HD68F
0087    AHA-2940U      aic7880   PCI/32       SE-50M         SE-HD50F
0088    AHA-2940D      aic7880   PCI/32
0089    aHA-2940 A/T   aic7880   PCI/32
0090    AHA-2940D A/T  aic7880   PCI/32
0091    AHA-3940UW     aic7880   PCI/32     2 X SE-HD68F     SE-HD68F          3
0092    AHA-3940UWD    aic7880   PCI/32     2 X SE-HD68F   2 X SE-VHD68F       3
0093    AHA-3940U      aic7880   PCI/32     2 X SE-50M       SE-HD50F          3
0094    AHA-2944UW     aic7880   PCI/32      HVD-HD68F       HVD-HD68F
0095                                         HVD-50M
0096    AHA-3944UWD    aic7880   PCI/32     2 X HVD-HD68F  2 X HVD-VHD68F      3
0097    AHA-4944UW     aic7880   PCI/32
0098    AHA-2930UW     aic7880   PCI/32
0099    AHA-2940UW Pro aic7880   PCI/32      SE-HD68F        SE-HD68F            4
0100                                         SE-50M
0101    AHA-2940UW/CN  aic7880   PCI/32
0102    AHA-2940UDual  aic7895   PCI/32
0103    AHA-2940UWDual aic7895   PCI/32
0104    AHA-3940UWD    aic7895   PCI/32
0105    AHA-3940AUW    aic7895   PCI/32
0106    AHA-3940AUWD   aic7895   PCI/32
0107    AHA-3940AU     aic7895   PCI/32
0108    AHA-3944AUWD   aic7895   PCI/32     2 X HVD-HD68F  2 X HVD-VHD68F
0109    AHA-2940U2B    aic7890   PCI/32      LVD-HD68F       LVD-HD68F
0110    AHA-2940U2 OEM aic7891   PCI/64
0111    AHA-2940U2W    aic7890   PCI/32      LVD-HD68F       LVD-HD68F
0112                                         SE-HD68F
0113                                         SE-50M
0114    AHA-2950U2B    aic7891   PCI/64      LVD-HD68F       LVD-HD68F
0115    AHA-2930U2     aic7890   PCI/32      LVD-HD68F       SE-HD50F
0116                                         SE-50M
0117    AHA-3950U2B    aic7897   PCI/64
0118    AHA-3950U2D    aic7897   PCI/64
0119    AHA-29160      aic7892   PCI/64-66
0120    AHA-29160 CPQ  aic7892   PCI/64-66
0121    AHA-29160N     aic7892   PCI/32      LVD-HD68F       SE-HD50F
0122                                         SE-50M
0123    AHA-29160LP    aic7892   PCI/64-66
0124    AHA-19160      aic7892   PCI/64-66
0125    AHA-29150LP    aic7892   PCI/64-66
0126    AHA-29130LP    aic7892   PCI/64-66
0127    AHA-3960D      aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
0128                                        LVD-50M
0129    AHA-3960D CPQ  aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
0130                                        LVD-50M
0131    AHA-39160      aic7899   PCI/64-66  2 X LVD-HD68F  2 X LVD-VHD68F
0132                                        LVD-50M
0133    ============== ======= =========== =============== =============== =========
0134 
0135    1. No BIOS support
0136    2. DEC21050 PCI-PCI bridge with multiple controller chips on secondary bus
0137    3. DEC2115X PCI-PCI bridge with multiple controller chips on secondary bus
0138    4. All three SCSI connectors may be used simultaneously without
0139       SCSI "stub" effects.
0140 
0141 2. Version History
0142 ==================
0143 
0144    * 7.0          (4th August, 2005)
0145         - Updated driver to use SCSI transport class infrastructure
0146         - Upported sequencer and core fixes from last adaptec released
0147           version of the driver.
0148 
0149    * 6.2.36 (June 3rd, 2003)
0150         - Correct code that disables PCI parity error checking.
0151         - Correct and simplify handling of the ignore wide residue
0152           message.  The previous code would fail to report a residual
0153           if the transaction data length was even and we received
0154           an IWR message.
0155         - Add support for the 2.5.X EISA framework.
0156         - Update for change in 2.5.X SCSI proc FS interface.
0157         - Correct Domain Validation command-line option parsing.
0158         - When negotiation async via an 8bit WDTR message, send
0159           an SDTR with an offset of 0 to be sure the target
0160           knows we are async.  This works around a firmware defect
0161           in the Quantum Atlas 10K.
0162         - Clear PCI error state during driver attach so that we
0163           don't disable memory mapped I/O due to a stray write
0164           by some other driver probe that occurred before we
0165           claimed the controller.
0166 
0167    * 6.2.35 (May 14th, 2003)
0168         - Fix a few GCC 3.3 compiler warnings.
0169         - Correct operation on EISA Twin Channel controller.
0170         - Add support for 2.5.X's scsi_report_device_reset().
0171 
0172    * 6.2.34 (May 5th, 2003)
0173         - Fix locking regression introduced in 6.2.29 that
0174           could cause a lock order reversal between the io_request_lock
0175           and our per-softc lock.  This was only possible on RH9,
0176           SuSE, and kernel.org 2.4.X kernels.
0177 
0178    * 6.2.33 (April 30th, 2003)
0179         - Dynamically disable PCI parity error reporting after
0180           10 errors are reported to the user.  These errors are
0181           the result of some other device issuing PCI transactions
0182           with bad parity.  Once the user has been informed of the
0183           problem, continuing to report the errors just degrades
0184           our performance.
0185 
0186    * 6.2.32 (March 28th, 2003)
0187         - Dynamically sized S/G lists to avoid SCSI malloc
0188           pool fragmentation and SCSI mid-layer deadlock.
0189 
0190    * 6.2.28 (January 20th, 2003)
0191         - Domain Validation Fixes
0192         - Add ability to disable PCI parity error checking.
0193         - Enhanced Memory Mapped I/O probe
0194 
0195    * 6.2.20 (November 7th, 2002)
0196         - Added Domain Validation.
0197 
0198 3. Command Line Options
0199 =======================
0200 
0201 
0202     .. Warning::
0203 
0204                  ALTERING OR ADDING THESE DRIVER PARAMETERS
0205                  INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
0206                  USE THEM WITH CAUTION.
0207 
0208    Put a .conf file in the /etc/modprobe.d directory and add/edit a
0209    line containing ``options aic7xxx aic7xxx=[command[,command...]]`` where
0210    ``command`` is one or more of the following:
0211 
0212 verbose
0213 
0214     :Definition: enable additional informative messages during driver operation.
0215     :Possible Values: This option is a flag
0216     :Default Value: disabled
0217 
0218 
0219 debug:[value]
0220 
0221     :Definition: Enables various levels of debugging information
0222     :Possible Values: 0x0000 = no debugging, 0xffff = full debugging
0223     :Default Value: 0x0000
0224 
0225 no_probe
0226 
0227 probe_eisa_vl
0228 
0229     :Definition: Do not probe for EISA/VLB controllers.
0230                  This is a toggle.  If the driver is compiled
0231                  to not probe EISA/VLB controllers by default,
0232                  specifying "no_probe" will enable this probing.
0233                  If the driver is compiled to probe EISA/VLB
0234                  controllers by default, specifying "no_probe"
0235                  will disable this probing.
0236 
0237     :Possible Values: This option is a toggle
0238     :Default Value: EISA/VLB probing is disabled by default.
0239 
0240 pci_parity
0241 
0242     :Definition: Toggles the detection of PCI parity errors.
0243                  On many motherboards with VIA chipsets,
0244                  PCI parity is not generated correctly on the
0245                  PCI bus.  It is impossible for the hardware to
0246                  differentiate between these "spurious" parity
0247                  errors and real parity errors.  The symptom of
0248                  this problem is a stream of the message::
0249 
0250                     "scsi0:     Data Parity Error Detected during address or write data phase"
0251 
0252                  output by the driver.
0253 
0254     :Possible Values: This option is a toggle
0255     :Default Value: PCI Parity Error reporting is disabled
0256 
0257 no_reset
0258 
0259     :Definition: Do not reset the bus during the initial probe
0260                  phase
0261 
0262     :Possible Values: This option is a flag
0263     :Default Value: disabled
0264 
0265 extended
0266 
0267     :Definition: Force extended translation on the controller
0268     :Possible Values: This option is a flag
0269     :Default Value: disabled
0270 
0271 periodic_otag
0272 
0273     :Definition: Send an ordered tag periodically to prevent
0274                  tag starvation.  Needed for some older devices
0275 
0276     :Possible Values: This option is a flag
0277     :Default Value: disabled
0278 
0279 reverse_scan
0280 
0281     :Definition: Probe the scsi bus in reverse order, starting
0282                 with target 15
0283 
0284     :Possible Values: This option is a flag
0285     :Default Value: disabled
0286 
0287 global_tag_depth:[value]
0288 
0289     :Definition: Global tag depth for all targets on all busses.
0290                  This option sets the default tag depth which
0291                  may be selectively overridden vi the tag_info
0292                  option.
0293 
0294     :Possible Values: 1 - 253
0295     :Default Value: 32
0296 
0297 tag_info:{{value[,value...]}[,{value[,value...]}...]}
0298 
0299     :Definition: Set the per-target tagged queue depth on a
0300                  per controller basis.  Both controllers and targets
0301                  may be omitted indicating that they should retain
0302                  the default tag depth.
0303 
0304     :Possible Values: 1 - 253
0305     :Default Value: 32
0306 
0307     Examples:
0308 
0309             ::
0310 
0311                 tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
0312 
0313             On Controller 0:
0314 
0315                 - specifies a tag depth of 16 for target 0
0316                 - specifies a tag depth of 64 for target 3
0317                 - specifies a tag depth of 8 for targets 4 and 5
0318                 - leaves target 6 at the default
0319                 - specifies a tag depth of 32 for targets 1,2,7-15
0320                 - All other targets retain the default depth.
0321 
0322             ::
0323 
0324                 tag_info:{{},{32,,32}}
0325 
0326             On Controller 1:
0327 
0328                 - specifies a tag depth of 32 for targets 0 and 2
0329                 - All other targets retain the default depth.
0330 
0331 seltime:[value]
0332 
0333     :Definition: Specifies the selection timeout value
0334     :Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
0335     :Default Value: 0
0336 
0337 dv: {value[,value...]}
0338 
0339     :Definition: Set Domain Validation Policy on a per-controller basis.
0340                  Controllers may be omitted indicating that
0341                  they should retain the default read streaming setting.
0342 
0343     :Possible Values:
0344 
0345                       ==== ===============================
0346                        < 0 Use setting from serial EEPROM.
0347                          0 Disable DV
0348                        > 0 Enable DV
0349                       ==== ===============================
0350 
0351 
0352     :Default Value: SCSI-Select setting on controllers with a SCSI Select
0353                     option for DV.  Otherwise, on for controllers supporting
0354                     U160 speeds and off for all other controller types.
0355 
0356     Example:
0357 
0358             ::
0359 
0360                 dv:{-1,0,,1,1,0}
0361 
0362            - On Controller 0 leave DV at its default setting.
0363            - On Controller 1 disable DV.
0364            - Skip configuration on Controller 2.
0365            - On Controllers 3 and 4 enable DV.
0366            - On Controller 5 disable DV.
0367 
0368 Example::
0369 
0370     options aic7xxx aic7xxx=verbose,no_probe,tag_info:{{},{,,10}},seltime:1
0371 
0372 enables verbose logging, Disable EISA/VLB probing,
0373 and set tag depth on Controller 1/Target 2 to 10 tags.
0374 
0375 4. Adaptec Customer Support
0376 ===========================
0377 
0378    A Technical Support Identification (TSID) Number is required for
0379    Adaptec technical support.
0380 
0381     - The 12-digit TSID can be found on the white barcode-type label
0382       included inside the box with your product.  The TSID helps us
0383       provide more efficient service by accurately identifying your
0384       product and support status.
0385 
0386    Support Options
0387     - Search the Adaptec Support Knowledgebase (ASK) at
0388       http://ask.adaptec.com for articles, troubleshooting tips, and
0389       frequently asked questions about your product.
0390     - For support via Email, submit your question to Adaptec's
0391       Technical Support Specialists at http://ask.adaptec.com/.
0392 
0393    North America
0394     - Visit our Web site at http://www.adaptec.com/.
0395     - For information about Adaptec's support options, call
0396       408-957-2550, 24 hours a day, 7 days a week.
0397     - To speak with a Technical Support Specialist,
0398 
0399       * For hardware products, call 408-934-7274,
0400         Monday to Friday, 3:00 am to 5:00 pm, PDT.
0401       * For RAID and Fibre Channel products, call 321-207-2000,
0402         Monday to Friday, 3:00 am to 5:00 pm, PDT.
0403 
0404       To expedite your service, have your computer with you.
0405     - To order Adaptec products, including accessories and cables,
0406       call 408-957-7274.  To order cables online go to
0407       http://www.adaptec.com/buy-cables/.
0408 
0409    Europe
0410     - Visit our Web site at http://www.adaptec.com/en-US/_common/world_index.
0411     - To speak with a Technical Support Specialist, call, or email,
0412 
0413       * German:  +49 89 4366 5522, Monday-Friday, 9:00-17:00 CET,
0414         http://ask-de.adaptec.com/.
0415       * French:  +49 89 4366 5533, Monday-Friday, 9:00-17:00 CET,
0416         http://ask-fr.adaptec.com/.
0417       * English: +49 89 4366 5544, Monday-Friday, 9:00-17:00 GMT,
0418         http://ask.adaptec.com/.
0419 
0420     - You can order Adaptec cables online at
0421       http://www.adaptec.com/buy-cables/.
0422 
0423    Japan
0424     - Visit our web site at http://www.adaptec.co.jp/.
0425     - To speak with a Technical Support Specialist, call
0426       +81 3 5308 6120, Monday-Friday, 9:00 a.m. to 12:00 p.m.,
0427       1:00 p.m. to 6:00 p.m.
0428 
0429 Copyright |copy| 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
0430 
0431 All rights reserved.
0432 
0433 You are permitted to redistribute, use and modify this README file in whole
0434 or in part in conjunction with redistribution of software governed by the
0435 General Public License, provided that the following conditions are met:
0436 
0437 1. Redistributions of README file must retain the above copyright
0438    notice, this list of conditions, and the following disclaimer,
0439    without modification.
0440 2. The name of the author may not be used to endorse or promote products
0441    derived from this software without specific prior written permission.
0442 3. Modifications or new contributions must be attributed in a copyright
0443    notice identifying the author ("Contributor") and added below the
0444    original copyright notice. The copyright notice is for purposes of
0445    identifying contributors and should not be deemed as permission to alter
0446    the permissions given by Adaptec.
0447 
0448 THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS`` AND
0449 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
0450 WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
0451 AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
0452 ADAPTEC OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
0453 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
0454 TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
0455 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
0456 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
0457 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS README
0458 FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.