original comment: +Wilson03172004,marked due to this pci host does not support MWI
[linux-2.4.git] / Documentation / cpqarray.txt
1 This driver is for Compaq's SMART2 Intelligent Disk Array Controllers.
2
3 Supported Cards:
4 ----------------
5
6 This driver is known to work with the following cards:
7
8         * SMART (EISA)
9         * SMART-2/E (EISA)
10         * SMART-2/P
11         * SMART-2DH
12         * SMART-2SL
13         * SMART-221
14         * SMART-3100ES
15         * SMART-3200
16         * Integrated Smart Array Controller
17         * SA 4200
18         * SA 4250ES
19         * SA 431
20         * RAID LC2 Controller
21
22 It should also work with some really old Disk array adapters, but I am
23 unable to test against these cards:
24
25         * IDA
26         * IDA-2
27         * IAES
28
29 Installing:
30 -----------
31
32 You need to build a new kernel to use this device, even if you want to
33 use a loadable module.  
34
35 Apply the patch to a 2.2.x kernel:
36
37 # cd linux
38 # patch -p1 <smart2.patch
39
40 Then build a new kernel and turn on Compaq SMART2 Disk Array support.
41 Create device nodes for the diskarray device:
42
43 # mkdev.ida [ctlrs]
44
45 Where ctlrs is the number of controllers you have (defaults to 1 if not
46 specified).
47
48 EISA Controllers:
49 -----------------
50
51 If you want to use an EISA controller you'll have to supply some
52 insmod/lilo paramaters.  If the driver is compiled into the kernel, must
53 give it the controller's IO port address at boot time (it is no longer
54 necessary to specifiy the IRQ).  For example, if you had two SMART-2/E
55 controllers, in EISA slots 1 and 2 you'd give it a boot argument like
56 this:
57
58         smart2=0x1000,0x2000
59
60 If you were loading the driver as a module, you'd give load it like this:
61
62         insmod cpqarray.o eisa=0x1000,0x2000
63
64 You can use EISA and PCI adapters at the same time.
65
66 Booting:
67 --------
68
69 You'll need to use a modified lilo if you want to boot from a disk array.
70 Its simply a version of lilo with some code added to tell it how to
71 understand Compaq diskarray devices.
72
73 Device Naming:
74 --------------
75
76 You need some entries in /dev for the ida device.  The mkdev.ida script
77 can make device nodes for you automatically.  Currently the device setup
78 is as follows:
79
80 Major numbers:
81         72      ida0
82         73      ida1
83         74      ida2
84         etc...
85
86 Minor numbers:
87         b7 b6 b5 b4 b3 b2 b1 b0
88         |----+----| |----+----|
89              |           |
90              |           +-------- Partition ID (0=wholedev, 1-15 partition)
91              |
92              +-------------------- Logical Volume number
93
94 The suggested device naming scheme is:
95 /dev/ida/c0d0           Controller 0, disk 0, whole device
96 /dev/ida/c0d0p1         Controller 0, disk 0, partition 1
97 /dev/ida/c0d0p2         Controller 0, disk 0, partition 2
98 /dev/ida/c0d0p3         Controller 0, disk 0, partition 3
99
100 /dev/ida/c1d1           Controller 1, disk 1, whole device
101 /dev/ida/c1d1p1         Controller 1, disk 1, partition 1
102 /dev/ida/c1d1p2         Controller 1, disk 1, partition 2
103 /dev/ida/c1d1p3         Controller 1, disk 1, partition 3