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