scsi: docs: convert g_NCR5380.txt to ReST
Link: https://lore.kernel.org/r/a66e9ea704be6a7aa81b9864ad66a32b75ab808d.1583136624.git.mchehab+huawei@kernel.org Acked-by: Finn Thain <fthain@telegraphics.com.au> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Mauro Carvalho Chehab
Martin K. Petersen
parent
cc0d9d3ad7
commit
3c1e681bcd
|
|
@ -0,0 +1,93 @@
|
||||||
|
.. SPDX-License-Identifier: GPL-2.0
|
||||||
|
.. include:: <isonum.txt>
|
||||||
|
|
||||||
|
==========================================
|
||||||
|
README file for the Linux g_NCR5380 driver
|
||||||
|
==========================================
|
||||||
|
|
||||||
|
Copyright |copy| 1993 Drew Eckhard
|
||||||
|
|
||||||
|
NCR53c400 extensions Copyright |copy| 1994,1995,1996 Kevin Lentin
|
||||||
|
|
||||||
|
This file documents the NCR53c400 extensions by Kevin Lentin and some
|
||||||
|
enhancements to the NCR5380 core.
|
||||||
|
|
||||||
|
This driver supports NCR5380 and NCR53c400 and compatible cards in port or
|
||||||
|
memory mapped modes.
|
||||||
|
|
||||||
|
Use of an interrupt is recommended, if supported by the board, as this will
|
||||||
|
allow targets to disconnect and thereby improve SCSI bus utilization.
|
||||||
|
|
||||||
|
If the irq parameter is 254 or is omitted entirely, the driver will probe
|
||||||
|
for the correct IRQ line automatically. If the irq parameter is 0 or 255
|
||||||
|
then no IRQ will be used.
|
||||||
|
|
||||||
|
The NCR53c400 does not support DMA but it does have Pseudo-DMA which is
|
||||||
|
supported by the driver.
|
||||||
|
|
||||||
|
This driver provides some information on what it has detected in
|
||||||
|
/proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot
|
||||||
|
time. More info to come in the future.
|
||||||
|
|
||||||
|
This driver works as a module.
|
||||||
|
When included as a module, parameters can be passed on the insmod/modprobe
|
||||||
|
command line:
|
||||||
|
|
||||||
|
============= ===============================================================
|
||||||
|
irq=xx[,...] the interrupt(s)
|
||||||
|
base=xx[,...] the port or base address(es) (for port or memory mapped, resp.)
|
||||||
|
card=xx[,...] card type(s):
|
||||||
|
|
||||||
|
== ======================================
|
||||||
|
0 NCR5380,
|
||||||
|
1 NCR53C400,
|
||||||
|
2 NCR53C400A,
|
||||||
|
3 Domex Technology Corp 3181E (DTC3181E)
|
||||||
|
4 Hewlett Packard C2502
|
||||||
|
== ======================================
|
||||||
|
============= ===============================================================
|
||||||
|
|
||||||
|
These old-style parameters can support only one card:
|
||||||
|
|
||||||
|
============= =================================================
|
||||||
|
ncr_irq=xx the interrupt
|
||||||
|
ncr_addr=xx the port or base address (for port or memory
|
||||||
|
mapped, resp.)
|
||||||
|
ncr_5380=1 to set up for a NCR5380 board
|
||||||
|
ncr_53c400=1 to set up for a NCR53C400 board
|
||||||
|
ncr_53c400a=1 to set up for a NCR53C400A board
|
||||||
|
dtc_3181e=1 to set up for a Domex Technology Corp 3181E board
|
||||||
|
hp_c2502=1 to set up for a Hewlett Packard C2502 board
|
||||||
|
============= =================================================
|
||||||
|
|
||||||
|
E.g. Trantor T130B in its default configuration::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 irq=5 base=0x350 card=1
|
||||||
|
|
||||||
|
or alternatively, using the old syntax::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_53c400=1
|
||||||
|
|
||||||
|
E.g. a port mapped NCR5380 board, driver to probe for IRQ::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 base=0x350 card=0
|
||||||
|
|
||||||
|
or alternatively::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 ncr_addr=0x350 ncr_5380=1
|
||||||
|
|
||||||
|
E.g. a memory mapped NCR53C400 board with no IRQ::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 irq=255 base=0xc8000 card=1
|
||||||
|
|
||||||
|
or alternatively::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
|
||||||
|
|
||||||
|
E.g. two cards, DTC3181 (in non-PnP mode) at 0x240 with no IRQ
|
||||||
|
and HP C2502 at 0x300 with IRQ 7::
|
||||||
|
|
||||||
|
modprobe g_NCR5380 irq=0,7 base=0x240,0x300 card=3,4
|
||||||
|
|
||||||
|
Kevin Lentin
|
||||||
|
K.Lentin@cs.monash.edu.au
|
||||||
|
|
@ -1,68 +0,0 @@
|
||||||
README file for the Linux g_NCR5380 driver.
|
|
||||||
|
|
||||||
(c) 1993 Drew Eckhard
|
|
||||||
NCR53c400 extensions (c) 1994,1995,1996 Kevin Lentin
|
|
||||||
|
|
||||||
This file documents the NCR53c400 extensions by Kevin Lentin and some
|
|
||||||
enhancements to the NCR5380 core.
|
|
||||||
|
|
||||||
This driver supports NCR5380 and NCR53c400 and compatible cards in port or
|
|
||||||
memory mapped modes.
|
|
||||||
|
|
||||||
Use of an interrupt is recommended, if supported by the board, as this will
|
|
||||||
allow targets to disconnect and thereby improve SCSI bus utilization.
|
|
||||||
|
|
||||||
If the irq parameter is 254 or is omitted entirely, the driver will probe
|
|
||||||
for the correct IRQ line automatically. If the irq parameter is 0 or 255
|
|
||||||
then no IRQ will be used.
|
|
||||||
|
|
||||||
The NCR53c400 does not support DMA but it does have Pseudo-DMA which is
|
|
||||||
supported by the driver.
|
|
||||||
|
|
||||||
This driver provides some information on what it has detected in
|
|
||||||
/proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot
|
|
||||||
time. More info to come in the future.
|
|
||||||
|
|
||||||
This driver works as a module.
|
|
||||||
When included as a module, parameters can be passed on the insmod/modprobe
|
|
||||||
command line:
|
|
||||||
irq=xx[,...] the interrupt(s)
|
|
||||||
base=xx[,...] the port or base address(es) (for port or memory mapped, resp.)
|
|
||||||
card=xx[,...] card type(s):
|
|
||||||
0 = NCR5380,
|
|
||||||
1 = NCR53C400,
|
|
||||||
2 = NCR53C400A,
|
|
||||||
3 = Domex Technology Corp 3181E (DTC3181E)
|
|
||||||
4 = Hewlett Packard C2502
|
|
||||||
|
|
||||||
These old-style parameters can support only one card:
|
|
||||||
ncr_irq=xx the interrupt
|
|
||||||
ncr_addr=xx the port or base address (for port or memory
|
|
||||||
mapped, resp.)
|
|
||||||
ncr_5380=1 to set up for a NCR5380 board
|
|
||||||
ncr_53c400=1 to set up for a NCR53C400 board
|
|
||||||
ncr_53c400a=1 to set up for a NCR53C400A board
|
|
||||||
dtc_3181e=1 to set up for a Domex Technology Corp 3181E board
|
|
||||||
hp_c2502=1 to set up for a Hewlett Packard C2502 board
|
|
||||||
|
|
||||||
E.g. Trantor T130B in its default configuration:
|
|
||||||
modprobe g_NCR5380 irq=5 base=0x350 card=1
|
|
||||||
or alternatively, using the old syntax,
|
|
||||||
modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_53c400=1
|
|
||||||
|
|
||||||
E.g. a port mapped NCR5380 board, driver to probe for IRQ:
|
|
||||||
modprobe g_NCR5380 base=0x350 card=0
|
|
||||||
or alternatively,
|
|
||||||
modprobe g_NCR5380 ncr_addr=0x350 ncr_5380=1
|
|
||||||
|
|
||||||
E.g. a memory mapped NCR53C400 board with no IRQ:
|
|
||||||
modprobe g_NCR5380 irq=255 base=0xc8000 card=1
|
|
||||||
or alternatively,
|
|
||||||
modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
|
|
||||||
|
|
||||||
E.g. two cards, DTC3181 (in non-PnP mode) at 0x240 with no IRQ
|
|
||||||
and HP C2502 at 0x300 with IRQ 7:
|
|
||||||
modprobe g_NCR5380 irq=0,7 base=0x240,0x300 card=3,4
|
|
||||||
|
|
||||||
Kevin Lentin
|
|
||||||
K.Lentin@cs.monash.edu.au
|
|
||||||
|
|
@ -20,5 +20,6 @@ Linux SCSI Subsystem
|
||||||
dc395x
|
dc395x
|
||||||
dpti
|
dpti
|
||||||
FlashPoint
|
FlashPoint
|
||||||
|
g_NCR5380
|
||||||
|
|
||||||
scsi_transport_srp/figures
|
scsi_transport_srp/figures
|
||||||
|
|
|
||||||
|
|
@ -57,13 +57,13 @@ parameters may be changed at runtime by the command
|
||||||
See header of drivers/scsi/NCR_D700.c.
|
See header of drivers/scsi/NCR_D700.c.
|
||||||
|
|
||||||
ncr5380= [HW,SCSI]
|
ncr5380= [HW,SCSI]
|
||||||
See Documentation/scsi/g_NCR5380.txt.
|
See Documentation/scsi/g_NCR5380.rst.
|
||||||
|
|
||||||
ncr53c400= [HW,SCSI]
|
ncr53c400= [HW,SCSI]
|
||||||
See Documentation/scsi/g_NCR5380.txt.
|
See Documentation/scsi/g_NCR5380.rst.
|
||||||
|
|
||||||
ncr53c400a= [HW,SCSI]
|
ncr53c400a= [HW,SCSI]
|
||||||
See Documentation/scsi/g_NCR5380.txt.
|
See Documentation/scsi/g_NCR5380.rst.
|
||||||
|
|
||||||
ncr53c8xx= [HW,SCSI]
|
ncr53c8xx= [HW,SCSI]
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -11473,7 +11473,7 @@ M: Finn Thain <fthain@telegraphics.com.au>
|
||||||
M: Michael Schmitz <schmitzmic@gmail.com>
|
M: Michael Schmitz <schmitzmic@gmail.com>
|
||||||
L: linux-scsi@vger.kernel.org
|
L: linux-scsi@vger.kernel.org
|
||||||
S: Maintained
|
S: Maintained
|
||||||
F: Documentation/scsi/g_NCR5380.txt
|
F: Documentation/scsi/g_NCR5380.rst
|
||||||
F: drivers/scsi/NCR5380.*
|
F: drivers/scsi/NCR5380.*
|
||||||
F: drivers/scsi/arm/cumana_1.c
|
F: drivers/scsi/arm/cumana_1.c
|
||||||
F: drivers/scsi/arm/oak.c
|
F: drivers/scsi/arm/oak.c
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@
|
||||||
* Added ISAPNP support for DTC436 adapters,
|
* Added ISAPNP support for DTC436 adapters,
|
||||||
* Thomas Sailer, sailer@ife.ee.ethz.ch
|
* Thomas Sailer, sailer@ife.ee.ethz.ch
|
||||||
*
|
*
|
||||||
* See Documentation/scsi/g_NCR5380.txt for more info.
|
* See Documentation/scsi/g_NCR5380.rst for more info.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
#include <asm/io.h>
|
#include <asm/io.h>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue