Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/hid
[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 This driver provides some information on what it has detected in
25 /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot
26 time. More info to come in the future.
27
28 This driver works as a module.
29 When included as a module, parameters can be passed on the insmod/modprobe
30 command line:
31   irq=xx[,...]  the interrupt(s)
32   base=xx[,...] the port or base address(es) (for port or memory mapped, resp.)
33   card=xx[,...] card type(s):
34                 0 = NCR5380,
35                 1 = NCR53C400,
36                 2 = NCR53C400A,
37                 3 = Domex Technology Corp 3181E (DTC3181E)
38                 4 = Hewlett Packard C2502
39
40 These old-style parameters can support only one card:
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
50 e.g.
51 OLD: modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1
52 NEW: modprobe g_NCR5380 irq=5 base=0x350 card=0
53   for a port mapped NCR5380 board or
54
55 OLD: modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
56 NEW: modprobe g_NCR5380 irq=255 base=0xc8000 card=1
57   for a memory mapped NCR53C400 board with interrupts disabled or
58
59 NEW: modprobe g_NCR5380 irq=0,7 base=0x240,0x300 card=3,4
60   for two cards: DTC3181 (in non-PnP mode) at 0x240 with no IRQ
61              and HP C2502 at 0x300 with IRQ 7
62
63 (255 should be specified for no or DMA interrupt, 254 to autoprobe for an 
64      IRQ line if overridden on the command line.)
65
66
67 Kevin Lentin
68 K.Lentin@cs.monash.edu.au