0001 .. SPDX-License-Identifier: GPL-2.0
0002 .. include:: <isonum.txt>
0003
0004 ===================================
0005 Adaptec Ultra320 Family Manager Set
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. Additional Notes
0016 5. Contacting Adaptec
0017
0018
0019 1. Supported Hardware
0020 =====================
0021
0022 The following Adaptec SCSI Host Adapters are supported by this
0023 driver set.
0024
0025 ============= =========================================
0026 Ultra320 ASIC Description
0027 ============= =========================================
0028 AIC-7901A Single Channel 64-bit PCI-X 133MHz to
0029 Ultra320 SCSI ASIC
0030 AIC-7901B Single Channel 64-bit PCI-X 133MHz to
0031 Ultra320 SCSI ASIC with Retained Training
0032 AIC-7902A4 Dual Channel 64-bit PCI-X 133MHz to
0033 Ultra320 SCSI ASIC
0034 AIC-7902B Dual Channel 64-bit PCI-X 133MHz to
0035 Ultra320 SCSI ASIC with Retained Training
0036 ============= =========================================
0037
0038 ========================== ===================================== ============
0039 Ultra320 Adapters Description ASIC
0040 ========================== ===================================== ============
0041 Adaptec SCSI Card 39320 Dual Channel 64-bit PCI-X 133MHz to 7902A4/7902B
0042 Ultra320 SCSI Card (one external
0043 68-pin, two internal 68-pin)
0044 Adaptec SCSI Card 39320A Dual Channel 64-bit PCI-X 133MHz to 7902B
0045 Ultra320 SCSI Card (one external
0046 68-pin, two internal 68-pin)
0047 Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
0048 Ultra320 SCSI Card (two external VHDC
0049 and one internal 68-pin)
0050 Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
0051 Ultra320 SCSI Card (two external VHDC
0052 and one internal 68-pin) based on the
0053 AIC-7902B ASIC
0054 Adaptec SCSI Card 29320 Single Channel 64-bit PCI-X 133MHz to 7901A
0055 Ultra320 SCSI Card (one external
0056 68-pin, two internal 68-pin, one
0057 internal 50-pin)
0058 Adaptec SCSI Card 29320A Single Channel 64-bit PCI-X 133MHz to 7901B
0059 Ultra320 SCSI Card (one external
0060 68-pin, two internal 68-pin, one
0061 internal 50-pin)
0062 Adaptec SCSI Card 29320LP Single Channel 64-bit Low Profile 7901A
0063 PCI-X 133MHz to Ultra320 SCSI Card
0064 (One external VHDC, one internal
0065 68-pin)
0066 Adaptec SCSI Card 29320ALP Single Channel 64-bit Low Profile 7901B
0067 PCI-X 133MHz to Ultra320 SCSI Card
0068 (One external VHDC, one internal
0069 68-pin)
0070 ========================== ===================================== ============
0071
0072 2. Version History
0073 ==================
0074
0075
0076 * 3.0 (December 1st, 2005)
0077 - Updated driver to use SCSI transport class infrastructure
0078 - Upported sequencer and core fixes from adaptec released
0079 version 2.0.15 of the driver.
0080
0081 * 1.3.11 (July 11, 2003)
0082 - Fix several deadlock issues.
0083 - Add 29320ALP and 39320B Id's.
0084
0085 * 1.3.10 (June 3rd, 2003)
0086 - Align the SCB_TAG field on a 16byte boundary. This avoids
0087 SCB corruption on some PCI-33 busses.
0088 - Correct non-zero luns on Rev B. hardware.
0089 - Update for change in 2.5.X SCSI proc FS interface.
0090 - When negotiation async via an 8bit WDTR message, send
0091 an SDTR with an offset of 0 to be sure the target
0092 knows we are async. This works around a firmware defect
0093 in the Quantum Atlas 10K.
0094 - Implement controller suspend and resume.
0095 - Clear PCI error state during driver attach so that we
0096 don't disable memory mapped I/O due to a stray write
0097 by some other driver probe that occurred before we
0098 claimed the controller.
0099
0100 * 1.3.9 (May 22nd, 2003)
0101 - Fix compiler errors.
0102 - Remove S/G splitting for segments that cross a 4GB boundary.
0103 This is guaranteed not to happen in Linux.
0104 - Add support for scsi_report_device_reset() found in
0105 2.5.X kernels.
0106 - Add 7901B support.
0107 - Simplify handling of the packetized lun Rev A workaround.
0108 - Correct and simplify handling of the ignore wide residue
0109 message. The previous code would fail to report a residual
0110 if the transaction data length was even and we received
0111 an IWR message.
0112
0113 * 1.3.8 (April 29th, 2003)
0114 - Fix types accessed via the command line interface code.
0115 - Perform a few firmware optimizations.
0116 - Fix "Unexpected PKT busfree" errors.
0117 - Use a sequencer interrupt to notify the host of
0118 commands with bad status. We defer the notification
0119 until there are no outstanding selections to ensure
0120 that the host is interrupted for as short a time as
0121 possible.
0122 - Remove pre-2.2.X support.
0123 - Add support for new 2.5.X interrupt API.
0124 - Correct big-endian architecture support.
0125
0126 * 1.3.7 (April 16th, 2003)
0127 - Use del_timer_sync() to ensure that no timeouts
0128 are pending during controller shutdown.
0129 - For pre-2.5.X kernels, carefully adjust our segment
0130 list size to avoid SCSI malloc pool fragmentation.
0131 - Cleanup channel display in our /proc output.
0132 - Workaround duplicate device entries in the mid-layer
0133 device list during add-single-device.
0134
0135 * 1.3.6 (March 28th, 2003)
0136 - Correct a double free in the Domain Validation code.
0137 - Correct a reference to free'ed memory during controller
0138 shutdown.
0139 - Reset the bus on an SE->LVD change. This is required
0140 to reset our transceivers.
0141
0142 * 1.3.5 (March 24th, 2003)
0143 - Fix a few register window mode bugs.
0144 - Include read streaming in the PPR flags we display in
0145 diagnostics as well as /proc.
0146 - Add PCI hot plug support for 2.5.X kernels.
0147 - Correct default precompensation value for RevA hardware.
0148 - Fix Domain Validation thread shutdown.
0149 - Add a firmware workaround to make the LED blink
0150 brighter during packetized operations on the H2A4.
0151 - Correct /proc display of user read streaming settings.
0152 - Simplify driver locking by releasing the io_request_lock
0153 upon driver entry from the mid-layer.
0154 - Cleanup command line parsing and move much of this code
0155 to aiclib.
0156
0157 * 1.3.4 (February 28th, 2003)
0158 - Correct a race condition in our error recovery handler.
0159 - Allow Test Unit Ready commands to take a full 5 seconds
0160 during Domain Validation.
0161
0162 * 1.3.2 (February 19th, 2003)
0163 - Correct a Rev B. regression due to the GEM318
0164 compatibility fix included in 1.3.1.
0165
0166 * 1.3.1 (February 11th, 2003)
0167 - Add support for the 39320A.
0168 - Improve recovery for certain PCI-X errors.
0169 - Fix handling of LQ/DATA/LQ/DATA for the
0170 same write transaction that can occur without
0171 interveining training.
0172 - Correct compatibility issues with the GEM318
0173 enclosure services device.
0174 - Correct data corruption issue that occurred under
0175 high tag depth write loads.
0176 - Adapt to a change in the 2.5.X daemonize() API.
0177 - Correct a "Missing case in ahd_handle_scsiint" panic.
0178
0179 * 1.3.0 (January 21st, 2003)
0180 - Full regression testing for all U320 products completed.
0181 - Added abort and target/lun reset error recovery handler and
0182 interrupt coalescing.
0183
0184 * 1.2.0 (November 14th, 2002)
0185 - Added support for Domain Validation
0186 - Add support for the Hewlett-Packard version of the 39320D
0187 and AIC-7902 adapters.
0188
0189 Support for previous adapters has not been fully tested and should
0190 only be used at the customer's own risk.
0191
0192 * 1.1.1 (September 24th, 2002)
0193 - Added support for the Linux 2.5.X kernel series
0194
0195 * 1.1.0 (September 17th, 2002)
0196 - Added support for four additional SCSI products:
0197 ASC-39320, ASC-29320, ASC-29320LP, AIC-7901.
0198
0199 * 1.0.0 (May 30th, 2002)
0200 - Initial driver release.
0201
0202 * 2.1. Software/Hardware Features
0203 - Support for the SPI-4 "Ultra320" standard:
0204 - 320MB/s transfer rates
0205 - Packetized SCSI Protocol at 160MB/s and 320MB/s
0206 - Quick Arbitration Selection (QAS)
0207 - Retained Training Information (Rev B. ASIC only)
0208 - Interrupt Coalescing
0209 - Initiator Mode (target mode not currently
0210 supported)
0211 - Support for the PCI-X standard up to 133MHz
0212 - Support for the PCI v2.2 standard
0213 - Domain Validation
0214
0215 * 2.2. Operating System Support:
0216 - Redhat Linux 7.2, 7.3, 8.0, Advanced Server 2.1
0217 - SuSE Linux 7.3, 8.0, 8.1, Enterprise Server 7
0218 - only Intel and AMD x86 supported at this time
0219 - >4GB memory configurations supported.
0220
0221 Refer to the User's Guide for more details on this.
0222
0223 3. Command Line Options
0224 =======================
0225
0226 .. Warning::
0227
0228 ALTERING OR ADDING THESE DRIVER PARAMETERS
0229 INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
0230 USE THEM WITH CAUTION.
0231
0232 Put a .conf file in the /etc/modprobe.d/ directory and add/edit a
0233 line containing ``options aic79xx aic79xx=[command[,command...]]`` where
0234 ``command`` is one or more of the following:
0235
0236
0237 verbose
0238 :Definition: enable additional informative messages during driver operation.
0239 :Possible Values: This option is a flag
0240 :Default Value: disabled
0241
0242 debug:[value]
0243 :Definition: Enables various levels of debugging information
0244 The bit definitions for the debugging mask can
0245 be found in drivers/scsi/aic7xxx/aic79xx.h under
0246 the "Debug" heading.
0247 :Possible Values: 0x0000 = no debugging, 0xffff = full debugging
0248 :Default Value: 0x0000
0249
0250 no_reset
0251 :Definition: Do not reset the bus during the initial probe
0252 phase
0253 :Possible Values: This option is a flag
0254 :Default Value: disabled
0255
0256 extended
0257 :Definition: Force extended translation on the controller
0258 :Possible Values: This option is a flag
0259 :Default Value: disabled
0260
0261 periodic_otag
0262 :Definition: Send an ordered tag periodically to prevent
0263 tag starvation. Needed for some older devices
0264 :Possible Values: This option is a flag
0265 :Default Value: disabled
0266
0267 reverse_scan
0268 :Definition: Probe the scsi bus in reverse order, starting with target 15
0269 :Possible Values: This option is a flag
0270 :Default Value: disabled
0271
0272 global_tag_depth
0273 :Definition: Global tag depth for all targets on all busses.
0274 This option sets the default tag depth which
0275 may be selectively overridden vi the tag_info
0276 option.
0277
0278 :Possible Values: 1 - 253
0279 :Default Value: 32
0280
0281 tag_info:{{value[,value...]}[,{value[,value...]}...]}
0282 :Definition: Set the per-target tagged queue depth on a
0283 per controller basis. Both controllers and targets
0284 may be omitted indicating that they should retain
0285 the default tag depth.
0286
0287 :Possible Values: 1 - 253
0288 :Default Value: 32
0289
0290 Examples:
0291
0292
0293 ::
0294
0295 tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
0296
0297 On Controller 0
0298
0299 - specifies a tag depth of 16 for target 0
0300 - specifies a tag depth of 64 for target 3
0301 - specifies a tag depth of 8 for targets 4 and 5
0302 - leaves target 6 at the default
0303 - specifies a tag depth of 32 for targets 1,2,7-15
0304
0305 All other targets retain the default depth.
0306
0307 ::
0308
0309 tag_info:{{},{32,,32}}
0310
0311 On Controller 1
0312
0313 - specifies a tag depth of 32 for targets 0 and 2
0314
0315 All other targets retain the default depth.
0316
0317
0318 rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]}
0319 :Definition: Enable read streaming on a per target basis.
0320 The rd_strm_bitmask is a 16 bit hex value in which
0321 each bit represents a target. Setting the target's
0322 bit to '1' enables read streaming for that
0323 target. Controllers may be omitted indicating that
0324 they should retain the default read streaming setting.
0325
0326 Examples:
0327
0328 ::
0329
0330 rd_strm:{0x0041}
0331
0332 On Controller 0
0333
0334 - enables read streaming for targets 0 and 6.
0335 - disables read streaming for targets 1-5,7-15.
0336
0337 All other targets retain the default read
0338 streaming setting.
0339
0340 ::
0341
0342 rd_strm:{0x0023,,0xFFFF}
0343
0344 On Controller 0
0345
0346 - enables read streaming for targets 1,2, and 5.
0347 - disables read streaming for targets 3,4,6-15.
0348
0349 On Controller 2
0350
0351 - enables read streaming for all targets.
0352
0353 All other targets retain the default read
0354 streaming setting.
0355
0356 :Possible Values: 0x0000 - 0xffff
0357 :Default Value: 0x0000
0358
0359 dv: {value[,value...]}
0360 :Definition: Set Domain Validation Policy on a per-controller basis.
0361 Controllers may be omitted indicating that
0362 they should retain the default read streaming setting.
0363
0364 :Possible Values:
0365
0366 ==== ===============================
0367 < 0 Use setting from serial EEPROM.
0368 0 Disable DV
0369 > 0 Enable DV
0370 ==== ===============================
0371
0372 :Default Value: DV Serial EEPROM configuration setting.
0373
0374 Example:
0375
0376 ::
0377
0378 dv:{-1,0,,1,1,0}
0379
0380 - On Controller 0 leave DV at its default setting.
0381 - On Controller 1 disable DV.
0382 - Skip configuration on Controller 2.
0383 - On Controllers 3 and 4 enable DV.
0384 - On Controller 5 disable DV.
0385
0386 seltime:[value]
0387 :Definition: Specifies the selection timeout value
0388 :Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
0389 :Default Value: 0
0390
0391 .. Warning:
0392
0393 The following three options should only be changed at
0394 the direction of a technical support representative.
0395
0396
0397 precomp: {value[,value...]}
0398 :Definition: Set IO Cell precompensation value on a per-controller basis.
0399 Controllers may be omitted indicating that
0400 they should retain the default precompensation setting.
0401
0402 :Possible Values: 0 - 7
0403 :Default Value: Varies based on chip revision
0404
0405 Examples:
0406
0407 ::
0408
0409 precomp:{0x1}
0410
0411 On Controller 0 set precompensation to 1.
0412
0413 ::
0414
0415 precomp:{1,,7}
0416
0417 - On Controller 0 set precompensation to 1.
0418 - On Controller 2 set precompensation to 8.
0419
0420 slewrate: {value[,value...]}
0421 :Definition: Set IO Cell slew rate on a per-controller basis.
0422 Controllers may be omitted indicating that
0423 they should retain the default slew rate setting.
0424
0425 :Possible Values: 0 - 15
0426 :Default Value: Varies based on chip revision
0427
0428 Examples:
0429
0430 ::
0431
0432 slewrate:{0x1}
0433
0434 - On Controller 0 set slew rate to 1.
0435
0436 ::
0437
0438 slewrate :{1,,8}
0439
0440 - On Controller 0 set slew rate to 1.
0441 - On Controller 2 set slew rate to 8.
0442
0443 amplitude: {value[,value...]}
0444 :Definition: Set IO Cell signal amplitude on a per-controller basis.
0445 Controllers may be omitted indicating that
0446 they should retain the default read streaming setting.
0447
0448 :Possible Values: 1 - 7
0449 :Default Value: Varies based on chip revision
0450
0451 Examples:
0452
0453 ::
0454
0455 amplitude:{0x1}
0456
0457 On Controller 0 set amplitude to 1.
0458
0459 ::
0460
0461 amplitude :{1,,7}
0462
0463 - On Controller 0 set amplitude to 1.
0464 - On Controller 2 set amplitude to 7.
0465
0466 Example::
0467
0468 options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}
0469
0470 enables verbose output in the driver and turns read streaming on
0471 for targets 0 and 6 of Controller 0.
0472
0473 4. Additional Notes
0474 ===================
0475
0476 4.1. Known/Unresolved or FYI Issues
0477 -----------------------------------
0478
0479 * Under SuSE Linux Enterprise 7, the driver may fail to operate
0480 correctly due to a problem with PCI interrupt routing in the
0481 Linux kernel. Please contact SuSE for an updated Linux
0482 kernel.
0483
0484 4.2. Third-Party Compatibility Issues
0485 -------------------------------------
0486
0487 * Adaptec only supports Ultra320 hard drives running
0488 the latest firmware available. Please check with
0489 your hard drive manufacturer to ensure you have the
0490 latest version.
0491
0492 4.3. Operating System or Technology Limitations
0493 -----------------------------------------------
0494
0495 * PCI Hot Plug is untested and may cause the operating system
0496 to stop responding.
0497 * Luns that are not numbered contiguously starting with 0 might not
0498 be automatically probed during system startup. This is a limitation
0499 of the OS. Please contact your Linux vendor for instructions on
0500 manually probing non-contiguous luns.
0501 * Using the Driver Update Disk version of this package during OS
0502 installation under RedHat might result in two versions of this
0503 driver being installed into the system module directory. This
0504 might cause problems with the /sbin/mkinitrd program and/or
0505 other RPM packages that try to install system modules. The best
0506 way to correct this once the system is running is to install
0507 the latest RPM package version of this driver, available from
0508 http://www.adaptec.com.
0509
0510
0511 5. Adaptec Customer Support
0512 ===========================
0513
0514 A Technical Support Identification (TSID) Number is required for
0515 Adaptec technical support.
0516
0517 - The 12-digit TSID can be found on the white barcode-type label
0518 included inside the box with your product. The TSID helps us
0519 provide more efficient service by accurately identifying your
0520 product and support status.
0521
0522 Support Options
0523 - Search the Adaptec Support Knowledgebase (ASK) at
0524 http://ask.adaptec.com for articles, troubleshooting tips, and
0525 frequently asked questions about your product.
0526 - For support via Email, submit your question to Adaptec's
0527 Technical Support Specialists at http://ask.adaptec.com/.
0528
0529 North America
0530 - Visit our Web site at http://www.adaptec.com/.
0531 - For information about Adaptec's support options, call
0532 408-957-2550, 24 hours a day, 7 days a week.
0533 - To speak with a Technical Support Specialist,
0534
0535 * For hardware products, call 408-934-7274,
0536 Monday to Friday, 3:00 am to 5:00 pm, PDT.
0537 * For RAID and Fibre Channel products, call 321-207-2000,
0538 Monday to Friday, 3:00 am to 5:00 pm, PDT.
0539
0540 To expedite your service, have your computer with you.
0541 - To order Adaptec products, including accessories and cables,
0542 call 408-957-7274. To order cables online go to
0543 http://www.adaptec.com/buy-cables/.
0544
0545 Europe
0546 - Visit our Web site at http://www.adaptec.com/en-US/_common/world_index.
0547 - To speak with a Technical Support Specialist, call, or email,
0548
0549 * German: +49 89 4366 5522, Monday-Friday, 9:00-17:00 CET,
0550 http://ask-de.adaptec.com/.
0551 * French: +49 89 4366 5533, Monday-Friday, 9:00-17:00 CET,
0552 http://ask-fr.adaptec.com/.
0553 * English: +49 89 4366 5544, Monday-Friday, 9:00-17:00 GMT,
0554 http://ask.adaptec.com/.
0555
0556 - You can order Adaptec cables online at
0557 http://www.adaptec.com/buy-cables/.
0558
0559 Japan
0560 - Visit our web site at http://www.adaptec.co.jp/.
0561 - To speak with a Technical Support Specialist, call
0562 +81 3 5308 6120, Monday-Friday, 9:00 a.m. to 12:00 p.m.,
0563 1:00 p.m. to 6:00 p.m.
0564
0565 Copyright |copy| 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
0566 All rights reserved.
0567
0568 You are permitted to redistribute, use and modify this README file in whole
0569 or in part in conjunction with redistribution of software governed by the
0570 General Public License, provided that the following conditions are met:
0571
0572 1. Redistributions of README file must retain the above copyright
0573 notice, this list of conditions, and the following disclaimer,
0574 without modification.
0575 2. The name of the author may not be used to endorse or promote products
0576 derived from this software without specific prior written permission.
0577 3. Modifications or new contributions must be attributed in a copyright
0578 notice identifying the author ("Contributor") and added below the
0579 original copyright notice. The copyright notice is for purposes of
0580 identifying contributors and should not be deemed as permission to alter
0581 the permissions given by Adaptec.
0582
0583 THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS`` AND
0584 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
0585 WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
0586 AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
0587 ADAPTEC OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
0588 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
0589 TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
0590 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
0591 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
0592 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS README
0593 FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
