0001 .. SPDX-License-Identifier: GPL-2.0
0002 .. include:: <isonum.txt>
0003
0004 ==========================================
0005 README file for the Linux g_NCR5380 driver
0006 ==========================================
0007
0008 Copyright |copy| 1993 Drew Eckhard
0009
0010 NCR53c400 extensions Copyright |copy| 1994,1995,1996 Kevin Lentin
0011
0012 This file documents the NCR53c400 extensions by Kevin Lentin and some
0013 enhancements to the NCR5380 core.
0014
0015 This driver supports NCR5380 and NCR53c400 and compatible cards in port or
0016 memory mapped modes.
0017
0018 Use of an interrupt is recommended, if supported by the board, as this will
0019 allow targets to disconnect and thereby improve SCSI bus utilization.
0020
0021 If the irq parameter is 254 or is omitted entirely, the driver will probe
0022 for the correct IRQ line automatically. If the irq parameter is 0 or 255
0023 then no IRQ will be used.
0024
0025 The NCR53c400 does not support DMA but it does have Pseudo-DMA which is
0026 supported by the driver.
0027
0028 This driver provides some information on what it has detected in
0029 /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot
0030 time. More info to come in the future.
0031
0032 This driver works as a module.
0033 When included as a module, parameters can be passed on the insmod/modprobe
0034 command line:
0035
0036 ============= ===============================================================
0037 irq=xx[,...] the interrupt(s)
0038 base=xx[,...] the port or base address(es) (for port or memory mapped, resp.)
0039 card=xx[,...] card type(s):
0040
0041 == ======================================
0042 0 NCR5380,
0043 1 NCR53C400,
0044 2 NCR53C400A,
0045 3 Domex Technology Corp 3181E (DTC3181E)
0046 4 Hewlett Packard C2502
0047 == ======================================
0048 ============= ===============================================================
0049
0050 These old-style parameters can support only one card:
0051
0052 ============= =================================================
0053 ncr_irq=xx the interrupt
0054 ncr_addr=xx the port or base address (for port or memory
0055 mapped, resp.)
0056 ncr_5380=1 to set up for a NCR5380 board
0057 ncr_53c400=1 to set up for a NCR53C400 board
0058 ncr_53c400a=1 to set up for a NCR53C400A board
0059 dtc_3181e=1 to set up for a Domex Technology Corp 3181E board
0060 hp_c2502=1 to set up for a Hewlett Packard C2502 board
0061 ============= =================================================
0062
0063 E.g. Trantor T130B in its default configuration::
0064
0065 modprobe g_NCR5380 irq=5 base=0x350 card=1
0066
0067 or alternatively, using the old syntax::
0068
0069 modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_53c400=1
0070
0071 E.g. a port mapped NCR5380 board, driver to probe for IRQ::
0072
0073 modprobe g_NCR5380 base=0x350 card=0
0074
0075 or alternatively::
0076
0077 modprobe g_NCR5380 ncr_addr=0x350 ncr_5380=1
0078
0079 E.g. a memory mapped NCR53C400 board with no IRQ::
0080
0081 modprobe g_NCR5380 irq=255 base=0xc8000 card=1
0082
0083 or alternatively::
0084
0085 modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
0086
0087 E.g. two cards, DTC3181 (in non-PnP mode) at 0x240 with no IRQ
0088 and HP C2502 at 0x300 with IRQ 7::
0089
0090 modprobe g_NCR5380 irq=0,7 base=0x240,0x300 card=3,4
0091
0092 Kevin Lentin
0093 K.Lentin@cs.monash.edu.au
