Merge branch 'linus' into perf/core, to refresh the branch
[cascardo/linux.git] / Documentation / scsi / g_NCR5380.txt
1 README file for the Linux g_NCR5380 driver.
2
3 (c) 1993 Drew Eckhard
4 NCR53c400 extensions (c) 1994,1995,1996 Kevin Lentin
5
6 This file documents the NCR53c400 extensions by Kevin Lentin and some
7 enhancements to the NCR5380 core.
8
9 This driver supports both NCR5380 and NCR53c400 cards in port or memory
10 mapped modes. Currently this driver can only support one of those mapping
11 modes at a time but it does support both of these chips at the same time.
12 The next release of this driver will support port & memory mapped cards at
13 the same time. It should be able to handle multiple different cards in the
14 same machine.
15
16 The drivers/scsi/Makefile has an override in it for the most common
17 NCR53c400 card, the Trantor T130B in its default configuration:
18         Port: 0x350
19         IRQ : 5
20
21 The NCR53c400 does not support DMA but it does have Pseudo-DMA which is
22 supported by the driver.
23
24 If the default configuration does not work for you, you can use the kernel
25 command lines (eg using the lilo append command):
26         ncr5380=addr,irq
27         ncr53c400=addr,irq
28         ncr53c400a=addr,irq
29         dtc3181e=addr,irq
30
31 The driver does not probe for any addresses or ports other than those in
32 the OVERRIDE or given to the kernel as above.
33
34 This driver provides some information on what it has detected in
35 /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot
36 time. More info to come in the future.
37
38 This driver works as a module.
39 When included as a module, parameters can be passed on the insmod/modprobe
40 command line:
41   ncr_irq=xx   the interrupt
42   ncr_addr=xx  the port or base address (for port or memory
43                mapped, resp.)
44   ncr_5380=1   to set up for a NCR5380 board
45   ncr_53c400=1 to set up for a NCR53C400 board
46   ncr_53c400a=1 to set up for a NCR53C400A board
47   dtc_3181e=1  to set up for a Domex Technology Corp 3181E board
48   hp_c2502=1   to set up for a Hewlett Packard C2502 board
49 e.g.
50 modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1
51   for a port mapped NCR5380 board or
52 modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
53   for a memory mapped NCR53C400 board with interrupts disabled.
54
55 (255 should be specified for no or DMA interrupt, 254 to autoprobe for an 
56      IRQ line if overridden on the command line.)
57
58
59 Kevin Lentin
60 K.Lentin@cs.monash.edu.au