1 .. SPDX-License-Identifier: GPL-2.0
2 .. include:: <isonum.txt>
3
4 ===================================
5 Adaptec Ultra320 Family Manager Set
6 ===================================
7
8 README for The Linux Operating System
9
10 .. The following information is available in t
11
12 1. Supported Hardware
13 2. Version History
14 3. Command Line Options
15 4. Additional Notes
16 5. Contacting Adaptec
17
18
19 1. Supported Hardware
20 =====================
21
22 The following Adaptec SCSI Host Adapters ar
23 driver set.
24
25 ============= ================
26 Ultra320 ASIC Description
27 ============= ================
28 AIC-7901A Single Channel 6
29 Ultra320 SCSI AS
30 AIC-7901B Single Channel 6
31 Ultra320 SCSI AS
32 AIC-7902A4 Dual Channel 64-
33 Ultra320 SCSI AS
34 AIC-7902B Dual Channel 64-
35 Ultra320 SCSI AS
36 ============= ================
37
38 ========================== ================
39 Ultra320 Adapters Description
40 ========================== ================
41 Adaptec SCSI Card 39320 Dual Channel 64-
42 Ultra320 SCSI Ca
43 68-pin, two inte
44 Adaptec SCSI Card 39320A Dual Channel 64-
45 Ultra320 SCSI Ca
46 68-pin, two inte
47 Adaptec SCSI Card 39320D Dual Channel 64-
48 Ultra320 SCSI Ca
49 and one internal
50 Adaptec SCSI Card 39320D Dual Channel 64-
51 Ultra320 SCSI Ca
52 and one internal
53 AIC-7902B ASIC
54 Adaptec SCSI Card 29320 Single Channel 6
55 Ultra320 SCSI Ca
56 68-pin, two inte
57 internal 50-pin)
58 Adaptec SCSI Card 29320A Single Channel 6
59 Ultra320 SCSI Ca
60 68-pin, two inte
61 internal 50-pin)
62 Adaptec SCSI Card 29320LP Single Channel 6
63 PCI-X 133MHz to
64 (One external VH
65 68-pin)
66 Adaptec SCSI Card 29320ALP Single Channel 6
67 PCI-X 133MHz to
68 (One external VH
69 68-pin)
70 ========================== ================
71
72 2. Version History
73 ==================
74
75
76 * 3.0 (December 1st, 2005)
77 - Updated driver to use SCSI transport
78 - Upported sequencer and core fixes fr
79 version 2.0.15 of the driver.
80
81 * 1.3.11 (July 11, 2003)
82 - Fix several deadlock issues.
83 - Add 29320ALP and 39320B Id's.
84
85 * 1.3.10 (June 3rd, 2003)
86 - Align the SCB_TAG field on a 16byte
87 SCB corruption on some PCI-33 busses
88 - Correct non-zero luns on Rev B. hard
89 - Update for change in 2.5.X SCSI proc
90 - When negotiation async via an 8bit W
91 an SDTR with an offset of 0 to be su
92 knows we are async. This works arou
93 in the Quantum Atlas 10K.
94 - Implement controller suspend and res
95 - Clear PCI error state during driver
96 don't disable memory mapped I/O due
97 by some other driver probe that occu
98 claimed the controller.
99
100 * 1.3.9 (May 22nd, 2003)
101 - Fix compiler errors.
102 - Remove S/G splitting for segments th
103 This is guaranteed not to happen in
104 - Add support for scsi_report_device_r
105 2.5.X kernels.
106 - Add 7901B support.
107 - Simplify handling of the packetized
108 - Correct and simplify handling of the
109 message. The previous code would fa
110 if the transaction data length was e
111 an IWR message.
112
113 * 1.3.8 (April 29th, 2003)
114 - Fix types accessed via the command l
115 - Perform a few firmware optimizations
116 - Fix "Unexpected PKT busfree" errors.
117 - Use a sequencer interrupt to notify
118 commands with bad status. We defer
119 until there are no outstanding selec
120 that the host is interrupted for as
121 possible.
122 - Remove pre-2.2.X support.
123 - Add support for new 2.5.X interrupt
124 - Correct big-endian architecture supp
125
126 * 1.3.7 (April 16th, 2003)
127 - Use del_timer_sync() to ensure that
128 are pending during controller shutdo
129 - For pre-2.5.X kernels, carefully adj
130 list size to avoid SCSI malloc pool
131 - Cleanup channel display in our /proc
132 - Workaround duplicate device entries
133 device list during add-single-device
134
135 * 1.3.6 (March 28th, 2003)
136 - Correct a double free in the Domain
137 - Correct a reference to free'ed memor
138 shutdown.
139 - Reset the bus on an SE->LVD change.
140 to reset our transceivers.
141
142 * 1.3.5 (March 24th, 2003)
143 - Fix a few register window mode bugs.
144 - Include read streaming in the PPR fl
145 diagnostics as well as /proc.
146 - Add PCI hot plug support for 2.5.X k
147 - Correct default precompensation valu
148 - Fix Domain Validation thread shutdow
149 - Add a firmware workaround to make th
150 brighter during packetized operation
151 - Correct /proc display of user read s
152 - Simplify driver locking by releasing
153 upon driver entry from the mid-layer
154 - Cleanup command line parsing and mov
155 to aiclib.
156
157 * 1.3.4 (February 28th, 2003)
158 - Correct a race condition in our erro
159 - Allow Test Unit Ready commands to ta
160 during Domain Validation.
161
162 * 1.3.2 (February 19th, 2003)
163 - Correct a Rev B. regression due to t
164 compatibility fix included in 1.3.1.
165
166 * 1.3.1 (February 11th, 2003)
167 - Add support for the 39320A.
168 - Improve recovery for certain PCI-X e
169 - Fix handling of LQ/DATA/LQ/DATA for
170 same write transaction that can occu
171 interveining training.
172 - Correct compatibility issues with th
173 enclosure services device.
174 - Correct data corruption issue that o
175 high tag depth write loads.
176 - Adapt to a change in the 2.5.X daemo
177 - Correct a "Missing case in ahd_handl
178
179 * 1.3.0 (January 21st, 2003)
180 - Full regression testing for all U320
181 - Added abort and target/lun reset err
182 interrupt coalescing.
183
184 * 1.2.0 (November 14th, 2002)
185 - Added support for Domain Validation
186 - Add support for the Hewlett-Packard
187 and AIC-7902 adapters.
188
189 Support for previous adapters has not
190 only be used at the customer's own ris
191
192 * 1.1.1 (September 24th, 2002)
193 - Added support for the Linux 2.5.X ke
194
195 * 1.1.0 (September 17th, 2002)
196 - Added support for four additional SC
197 ASC-39320, ASC-29320, ASC-29320LP, A
198
199 * 1.0.0 (May 30th, 2002)
200 - Initial driver release.
201
202 * 2.1. Software/Hardware Features
203 - Support for the SPI-4 "Ultra320" sta
204 - 320MB/s transfer rates
205 - Packetized SCSI Protocol at 160MB/
206 - Quick Arbitration Selection (QAS)
207 - Retained Training Information (Rev
208 - Interrupt Coalescing
209 - Initiator Mode (target mode not curr
210 supported)
211 - Support for the PCI-X standard up to
212 - Support for the PCI v2.2 standard
213 - Domain Validation
214
215 * 2.2. Operating System Support:
216 - Redhat Linux 7.2, 7.3, 8.0, Advanced
217 - SuSE Linux 7.3, 8.0, 8.1, Enterprise
218 - only Intel and AMD x86 supported at
219 - >4GB memory configurations supported
220
221 Refer to the User's Guide for more detail
222
223 3. Command Line Options
224 =======================
225
226 .. Warning::
227
228 ALTERING OR ADDING THESE DRIV
229 INCORRECTLY CAN RENDER YOUR S
230 USE THEM WITH CAUTION.
231
232 Put a .conf file in the /etc/modprobe.d/ di
233 line containing ``options aic79xx aic79xx=[
234 ``command`` is one or more of the following
235
236
237 verbose
238 :Definition: enable additional informative
239 :Possible Values: This option is a flag
240 :Default Value: disabled
241
242 debug:[value]
243 :Definition: Enables various levels of deb
244 The bit definitions for the d
245 be found in drivers/scsi/aic7
246 the "Debug" heading.
247 :Possible Values: 0x0000 = no debugging, 0
248 :Default Value: 0x0000
249
250 no_reset
251 :Definition: Do not reset the bus during t
252 phase
253 :Possible Values: This option is a flag
254 :Default Value: disabled
255
256 extended
257 :Definition: Force extended translation on
258 :Possible Values: This option is a flag
259 :Default Value: disabled
260
261 periodic_otag
262 :Definition: Send an ordered tag periodica
263 tag starvation. Needed for s
264 :Possible Values: This option is a flag
265 :Default Value: disabled
266
267 reverse_scan
268 :Definition: Probe the scsi bus in reverse
269 :Possible Values: This option is a flag
270 :Default Value: disabled
271
272 global_tag_depth
273 :Definition: Global tag depth for all targ
274 This option sets the default
275 may be selectively overridden
276 option.
277
278 :Possible Values: 1 - 253
279 :Default Value: 32
280
281 tag_info:{{value[,value...]}[,{value[,value...
282 :Definition: Set the per-target tagged que
283 per controller basis. Both c
284 may be omitted indicating tha
285 the default tag depth.
286
287 :Possible Values: 1 - 253
288 :Default Value: 32
289
290 Examples:
291
292
293 ::
294
295 tag_info:{{16,32,32,64,8,8,,32,32,
296
297 On Controller 0
298
299 - specifies a tag depth of 16 for
300 - specifies a tag depth of 64 for
301 - specifies a tag depth of 8 for t
302 - leaves target 6 at the default
303 - specifies a tag depth of 32 for
304
305 All other targets retain the default d
306
307 ::
308
309 tag_info:{{},{32,,32}}
310
311 On Controller 1
312
313 - specifies a tag depth of 32 for
314
315 All other targets retain the default d
316
317
318 rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]
319 :Definition: Enable read streaming on a pe
320 The rd_strm_bitmask is a 16 b
321 each bit represents a target.
322 bit to '1' enables read strea
323 target. Controllers may be o
324 they should retain the defaul
325
326 Examples:
327
328 ::
329
330 rd_strm:{0x0041}
331
332 On Controller 0
333
334 - enables read streaming for t
335 - disables read streaming for
336
337 All other targets retain the defau
338 streaming setting.
339
340 ::
341
342 rd_strm:{0x0023,,0xFFFF}
343
344 On Controller 0
345
346 - enables read streaming for t
347 - disables read streaming for
348
349 On Controller 2
350
351 - enables read streaming for a
352
353 All other targets retain the defau
354 streaming setting.
355
356 :Possible Values: 0x0000 - 0xffff
357 :Default Value: 0x0000
358
359 dv: {value[,value...]}
360 :Definition: Set Domain Validation Policy
361 Controllers may be omitted in
362 they should retain the defaul
363
364 :Possible Values:
365
366 ==== ===================
367 < 0 Use setting from se
368 0 Disable DV
369 > 0 Enable DV
370 ==== ===================
371
372 :Default Value: DV Serial EEPROM configura
373
374 Example:
375
376 ::
377
378 dv:{-1,0,,1,1,0}
379
380 - On Controller 0 leave DV at its defa
381 - On Controller 1 disable DV.
382 - Skip configuration on Controller 2.
383 - On Controllers 3 and 4 enable DV.
384 - On Controller 5 disable DV.
385
386 seltime:[value]
387 :Definition: Specifies the selection timeo
388 :Possible Values: 0 = 256ms, 1 = 128ms, 2
389 :Default Value: 0
390
391 .. Warning:
392
393 The following three options should only be
394 the direction of a technical support repre
395
396
397 precomp: {value[,value...]}
398 :Definition: Set IO Cell precompensation v
399 Controllers may be omitted in
400 they should retain the defaul
401
402 :Possible Values: 0 - 7
403 :Default Value: Varies based on chip revis
404
405 Examples:
406
407 ::
408
409 precomp:{0x1}
410
411 On Controller 0 set precompensation to
412
413 ::
414
415 precomp:{1,,7}
416
417 - On Controller 0 set precompensation
418 - On Controller 2 set precompensation
419
420 slewrate: {value[,value...]}
421 :Definition: Set IO Cell slew rate on a pe
422 Controllers may be omitt
423 they should retain the d
424
425 :Possible Values: 0 - 15
426 :Default Value: Varies based on chip revis
427
428 Examples:
429
430 ::
431
432 slewrate:{0x1}
433
434 - On Controller 0 set slew rate to 1.
435
436 ::
437
438 slewrate :{1,,8}
439
440 - On Controller 0 set slew rate to 1.
441 - On Controller 2 set slew rate to 8.
442
443 amplitude: {value[,value...]}
444 :Definition: Set IO Cell signal amplitude
445 Controllers may be omitted in
446 they should retain the defaul
447
448 :Possible Values: 1 - 7
449 :Default Value: Varies based on chip revis
450
451 Examples:
452
453 ::
454
455 amplitude:{0x1}
456
457 On Controller 0 set amplitude to 1.
458
459 ::
460
461 amplitude :{1,,7}
462
463 - On Controller 0 set amplitude to 1.
464 - On Controller 2 set amplitude to 7.
465
466 Example::
467
468 options aic79xx aic79xx=verbose,rd_strm:{{
469
470 enables verbose output in the driver and turns
471 for targets 0 and 6 of Controller 0.
472
473 4. Additional Notes
474 ===================
475
476 4.1. Known/Unresolved or FYI Issues
477 -----------------------------------
478
479 * Under SuSE Linux Enterprise 7, the d
480 correctly due to a problem with PCI
481 Linux kernel. Please contact SuSE f
482 kernel.
483
484 4.2. Third-Party Compatibility Issues
485 -------------------------------------
486
487 * Adaptec only supports Ultra320 hard
488 the latest firmware available. Pleas
489 your hard drive manufacturer to ensu
490 latest version.
491
492 4.3. Operating System or Technology Limitation
493 ----------------------------------------------
494
495 * PCI Hot Plug is untested and may cau
496 to stop responding.
497 * Luns that are not numbered contiguou
498 be automatically probed during syste
499 of the OS. Please contact your Linu
500 manually probing non-contiguous luns
501 * Using the Driver Update Disk version
502 installation under RedHat might resu
503 driver being installed into the syst
504 might cause problems with the /sbin/
505 other RPM packages that try to insta
506 way to correct this once the system
507 the latest RPM package version of th
508 http://www.adaptec.com.
509
510
511 5. Adaptec Customer Support
512 ===========================
513
514 A Technical Support Identification (TSID) N
515 Adaptec technical support.
516
517 - The 12-digit TSID can be found on the wh
518 included inside the box with your produc
519 provide more efficient service by accura
520 product and support status.
521
522 Support Options
523 - Search the Adaptec Support Knowledgebase
524 http://ask.adaptec.com for articles, tro
525 frequently asked questions about your pr
526 - For support via Email, submit your quest
527 Technical Support Specialists at http://
528
529 North America
530 - Visit our Web site at http://www.adaptec
531 - For information about Adaptec's support
532 408-957-2550, 24 hours a day, 7 days a w
533 - To speak with a Technical Support Specia
534
535 * For hardware products, call 408-934-72
536 Monday to Friday, 3:00 am to 5:00 pm,
537 * For RAID and Fibre Channel products, c
538 Monday to Friday, 3:00 am to 5:00 pm,
539
540 To expedite your service, have your comp
541 - To order Adaptec products, including acc
542 call 408-957-7274. To order cables onli
543 http://www.adaptec.com/buy-cables/.
544
545 Europe
546 - Visit our Web site at http://www.adaptec
547 - To speak with a Technical Support Specia
548
549 * German: +49 89 4366 5522, Monday-Frid
550 http://ask-de.adaptec.com/.
551 * French: +49 89 4366 5533, Monday-Frid
552 http://ask-fr.adaptec.com/.
553 * English: +49 89 4366 5544, Monday-Frid
554 http://ask.adaptec.com/.
555
556 - You can order Adaptec cables online at
557 http://www.adaptec.com/buy-cables/.
558
559 Japan
560 - Visit our web site at http://www.adaptec
561 - To speak with a Technical Support Specia
562 +81 3 5308 6120, Monday-Friday, 9:00 a.m
563 1:00 p.m. to 6:00 p.m.
564
565 Copyright |copy| 2003 Adaptec Inc. 691 S. Milp
566 All rights reserved.
567
568 You are permitted to redistribute, use and mod
569 or in part in conjunction with redistribution
570 General Public License, provided that the foll
571
572 1. Redistributions of README file must retain
573 notice, this list of conditions, and the fo
574 without modification.
575 2. The name of the author may not be used to e
576 derived from this software without specific
577 3. Modifications or new contributions must be
578 notice identifying the author ("Contributor
579 original copyright notice. The copyright no
580 identifying contributors and should not be
581 the permissions given by Adaptec.
582
583 THIS README FILE IS PROVIDED BY ADAPTEC AND CO
584 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
585 WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED
586 AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCL
587 ADAPTEC OR CONTRIBUTORS BE LIABLE FOR ANY DIRE
588 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (
589 TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICE
590 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAU
591 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILI
592 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OU
593 FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SU
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.