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