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
Родитель
cc0d9d3ad7
Коммит
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
|
||||
dpti
|
||||
FlashPoint
|
||||
g_NCR5380
|
||||
|
||||
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.
|
||||
|
||||
ncr5380= [HW,SCSI]
|
||||
See Documentation/scsi/g_NCR5380.txt.
|
||||
See Documentation/scsi/g_NCR5380.rst.
|
||||
|
||||
ncr53c400= [HW,SCSI]
|
||||
See Documentation/scsi/g_NCR5380.txt.
|
||||
See Documentation/scsi/g_NCR5380.rst.
|
||||
|
||||
ncr53c400a= [HW,SCSI]
|
||||
See Documentation/scsi/g_NCR5380.txt.
|
||||
See Documentation/scsi/g_NCR5380.rst.
|
||||
|
||||
ncr53c8xx= [HW,SCSI]
|
||||
|
||||
|
|
|
|||
|
|
@ -11473,7 +11473,7 @@ M: Finn Thain <fthain@telegraphics.com.au>
|
|||
M: Michael Schmitz <schmitzmic@gmail.com>
|
||||
L: linux-scsi@vger.kernel.org
|
||||
S: Maintained
|
||||
F: Documentation/scsi/g_NCR5380.txt
|
||||
F: Documentation/scsi/g_NCR5380.rst
|
||||
F: drivers/scsi/NCR5380.*
|
||||
F: drivers/scsi/arm/cumana_1.c
|
||||
F: drivers/scsi/arm/oak.c
|
||||
|
|
|
|||
|
|
@ -20,7 +20,7 @@
|
|||
* Added ISAPNP support for DTC436 adapters,
|
||||
* 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>
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче