Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 9 | This driver supports NCR5380 and NCR53c400 and compatible cards in port or |
| 10 | memory mapped modes. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 11 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 12 | Use of an interrupt is recommended, if supported by the board, as this will |
| 13 | allow targets to disconnect and thereby improve SCSI bus utilization. |
| 14 | |
| 15 | If the irq parameter is 254 or is omitted entirely, the driver will probe |
| 16 | for the correct IRQ line automatically. If the irq parameter is 0 or 255 |
| 17 | then no IRQ will be used. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 18 | |
| 19 | The NCR53c400 does not support DMA but it does have Pseudo-DMA which is |
| 20 | supported by the driver. |
| 21 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | This driver provides some information on what it has detected in |
| 23 | /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot |
| 24 | time. More info to come in the future. |
| 25 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 26 | This driver works as a module. |
| 27 | When included as a module, parameters can be passed on the insmod/modprobe |
| 28 | command line: |
Ondrej Zary | a8cfbca | 2016-09-27 21:00:25 +0200 | [diff] [blame] | 29 | irq=xx[,...] the interrupt(s) |
| 30 | base=xx[,...] the port or base address(es) (for port or memory mapped, resp.) |
| 31 | card=xx[,...] card type(s): |
| 32 | 0 = NCR5380, |
| 33 | 1 = NCR53C400, |
| 34 | 2 = NCR53C400A, |
| 35 | 3 = Domex Technology Corp 3181E (DTC3181E) |
| 36 | 4 = Hewlett Packard C2502 |
| 37 | |
| 38 | These old-style parameters can support only one card: |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 39 | ncr_irq=xx the interrupt |
| 40 | ncr_addr=xx the port or base address (for port or memory |
| 41 | mapped, resp.) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 42 | ncr_5380=1 to set up for a NCR5380 board |
| 43 | ncr_53c400=1 to set up for a NCR53C400 board |
Finn Thain | 9c41ab2 | 2016-03-23 21:10:28 +1100 | [diff] [blame] | 44 | ncr_53c400a=1 to set up for a NCR53C400A board |
| 45 | dtc_3181e=1 to set up for a Domex Technology Corp 3181E board |
| 46 | hp_c2502=1 to set up for a Hewlett Packard C2502 board |
Ondrej Zary | a8cfbca | 2016-09-27 21:00:25 +0200 | [diff] [blame] | 47 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 48 | E.g. Trantor T130B in its default configuration: |
| 49 | modprobe g_NCR5380 irq=5 base=0x350 card=1 |
| 50 | or alternatively, using the old syntax, |
| 51 | modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_53c400=1 |
Ondrej Zary | a8cfbca | 2016-09-27 21:00:25 +0200 | [diff] [blame] | 52 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 53 | E.g. a port mapped NCR5380 board, driver to probe for IRQ: |
| 54 | modprobe g_NCR5380 base=0x350 card=0 |
| 55 | or alternatively, |
| 56 | modprobe g_NCR5380 ncr_addr=0x350 ncr_5380=1 |
Ondrej Zary | a8cfbca | 2016-09-27 21:00:25 +0200 | [diff] [blame] | 57 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 58 | E.g. a memory mapped NCR53C400 board with no IRQ: |
| 59 | modprobe g_NCR5380 irq=255 base=0xc8000 card=1 |
| 60 | or alternatively, |
| 61 | modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 62 | |
Finn Thain | 70439e93 | 2016-12-05 01:07:20 -0500 | [diff] [blame] | 63 | E.g. two cards, DTC3181 (in non-PnP mode) at 0x240 with no IRQ |
| 64 | and HP C2502 at 0x300 with IRQ 7: |
| 65 | modprobe g_NCR5380 irq=0,7 base=0x240,0x300 card=3,4 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 66 | |
| 67 | Kevin Lentin |
| 68 | K.Lentin@cs.monash.edu.au |