scsi: docs: convert advansys.txt to ReST
Link: https://lore.kernel.org/r/3c697a046e641c81cdfd0784f037d41d54766931.1583136624.git.mchehab+huawei@kernel.org 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:
parent
dd9cc1447a
commit
cb32240894
|
@ -1,3 +1,9 @@
|
||||||
|
.. SPDX-License-Identifier: GPL-2.0
|
||||||
|
|
||||||
|
=====================
|
||||||
|
AdvanSys Driver Notes
|
||||||
|
=====================
|
||||||
|
|
||||||
AdvanSys (Advanced System Products, Inc.) manufactures the following
|
AdvanSys (Advanced System Products, Inc.) manufactures the following
|
||||||
RISC-based, Bus-Mastering, Fast (10 Mhz) and Ultra (20 Mhz) Narrow
|
RISC-based, Bus-Mastering, Fast (10 Mhz) and Ultra (20 Mhz) Narrow
|
||||||
(8-bit transfer) SCSI Host Adapters for the ISA, EISA, VL, and PCI
|
(8-bit transfer) SCSI Host Adapters for the ISA, EISA, VL, and PCI
|
||||||
|
@ -12,50 +18,51 @@ adapter detected. The number of CDBs used by the driver can be
|
||||||
lowered in the BIOS by changing the 'Host Queue Size' adapter setting.
|
lowered in the BIOS by changing the 'Host Queue Size' adapter setting.
|
||||||
|
|
||||||
Laptop Products:
|
Laptop Products:
|
||||||
ABP-480 - Bus-Master CardBus (16 CDB)
|
- ABP-480 - Bus-Master CardBus (16 CDB)
|
||||||
|
|
||||||
Connectivity Products:
|
Connectivity Products:
|
||||||
ABP510/5150 - Bus-Master ISA (240 CDB)
|
- ABP510/5150 - Bus-Master ISA (240 CDB)
|
||||||
ABP5140 - Bus-Master ISA PnP (16 CDB)
|
- ABP5140 - Bus-Master ISA PnP (16 CDB)
|
||||||
ABP5142 - Bus-Master ISA PnP with floppy (16 CDB)
|
- ABP5142 - Bus-Master ISA PnP with floppy (16 CDB)
|
||||||
ABP902/3902 - Bus-Master PCI (16 CDB)
|
- ABP902/3902 - Bus-Master PCI (16 CDB)
|
||||||
ABP3905 - Bus-Master PCI (16 CDB)
|
- ABP3905 - Bus-Master PCI (16 CDB)
|
||||||
ABP915 - Bus-Master PCI (16 CDB)
|
- ABP915 - Bus-Master PCI (16 CDB)
|
||||||
ABP920 - Bus-Master PCI (16 CDB)
|
- ABP920 - Bus-Master PCI (16 CDB)
|
||||||
ABP3922 - Bus-Master PCI (16 CDB)
|
- ABP3922 - Bus-Master PCI (16 CDB)
|
||||||
ABP3925 - Bus-Master PCI (16 CDB)
|
- ABP3925 - Bus-Master PCI (16 CDB)
|
||||||
ABP930 - Bus-Master PCI (16 CDB)
|
- ABP930 - Bus-Master PCI (16 CDB)
|
||||||
ABP930U - Bus-Master PCI Ultra (16 CDB)
|
- ABP930U - Bus-Master PCI Ultra (16 CDB)
|
||||||
ABP930UA - Bus-Master PCI Ultra (16 CDB)
|
- ABP930UA - Bus-Master PCI Ultra (16 CDB)
|
||||||
ABP960 - Bus-Master PCI MAC/PC (16 CDB)
|
- ABP960 - Bus-Master PCI MAC/PC (16 CDB)
|
||||||
ABP960U - Bus-Master PCI MAC/PC Ultra (16 CDB)
|
- ABP960U - Bus-Master PCI MAC/PC Ultra (16 CDB)
|
||||||
|
|
||||||
Single Channel Products:
|
Single Channel Products:
|
||||||
ABP542 - Bus-Master ISA with floppy (240 CDB)
|
- ABP542 - Bus-Master ISA with floppy (240 CDB)
|
||||||
ABP742 - Bus-Master EISA (240 CDB)
|
- ABP742 - Bus-Master EISA (240 CDB)
|
||||||
ABP842 - Bus-Master VL (240 CDB)
|
- ABP842 - Bus-Master VL (240 CDB)
|
||||||
ABP940 - Bus-Master PCI (240 CDB)
|
- ABP940 - Bus-Master PCI (240 CDB)
|
||||||
ABP940U - Bus-Master PCI Ultra (240 CDB)
|
- ABP940U - Bus-Master PCI Ultra (240 CDB)
|
||||||
ABP940UA/3940UA - Bus-Master PCI Ultra (240 CDB)
|
- ABP940UA/3940UA - Bus-Master PCI Ultra (240 CDB)
|
||||||
ABP970 - Bus-Master PCI MAC/PC (240 CDB)
|
- ABP970 - Bus-Master PCI MAC/PC (240 CDB)
|
||||||
ABP970U - Bus-Master PCI MAC/PC Ultra (240 CDB)
|
- ABP970U - Bus-Master PCI MAC/PC Ultra (240 CDB)
|
||||||
ABP3960UA - Bus-Master PCI MAC/PC Ultra (240 CDB)
|
- ABP3960UA - Bus-Master PCI MAC/PC Ultra (240 CDB)
|
||||||
ABP940UW/3940UW - Bus-Master PCI Ultra-Wide (253 CDB)
|
- ABP940UW/3940UW - Bus-Master PCI Ultra-Wide (253 CDB)
|
||||||
ABP970UW - Bus-Master PCI MAC/PC Ultra-Wide (253 CDB)
|
- ABP970UW - Bus-Master PCI MAC/PC Ultra-Wide (253 CDB)
|
||||||
ABP3940U2W - Bus-Master PCI LVD/Ultra2-Wide (253 CDB)
|
- ABP3940U2W - Bus-Master PCI LVD/Ultra2-Wide (253 CDB)
|
||||||
|
|
||||||
Multi-Channel Products:
|
Multi-Channel Products:
|
||||||
ABP752 - Dual Channel Bus-Master EISA (240 CDB Per Channel)
|
- ABP752 - Dual Channel Bus-Master EISA (240 CDB Per Channel)
|
||||||
ABP852 - Dual Channel Bus-Master VL (240 CDB Per Channel)
|
- ABP852 - Dual Channel Bus-Master VL (240 CDB Per Channel)
|
||||||
ABP950 - Dual Channel Bus-Master PCI (240 CDB Per Channel)
|
- ABP950 - Dual Channel Bus-Master PCI (240 CDB Per Channel)
|
||||||
ABP950UW - Dual Channel Bus-Master PCI Ultra-Wide (253 CDB Per Channel)
|
- ABP950UW - Dual Channel Bus-Master PCI Ultra-Wide (253 CDB Per Channel)
|
||||||
ABP980 - Four Channel Bus-Master PCI (240 CDB Per Channel)
|
- ABP980 - Four Channel Bus-Master PCI (240 CDB Per Channel)
|
||||||
ABP980U - Four Channel Bus-Master PCI Ultra (240 CDB Per Channel)
|
- ABP980U - Four Channel Bus-Master PCI Ultra (240 CDB Per Channel)
|
||||||
ABP980UA/3980UA - Four Channel Bus-Master PCI Ultra (16 CDB Per Chan.)
|
- ABP980UA/3980UA - Four Channel Bus-Master PCI Ultra (16 CDB Per Chan.)
|
||||||
ABP3950U2W - Bus-Master PCI LVD/Ultra2-Wide and Ultra-Wide (253 CDB)
|
- ABP3950U2W - Bus-Master PCI LVD/Ultra2-Wide and Ultra-Wide (253 CDB)
|
||||||
ABP3950U3W - Bus-Master PCI Dual LVD2/Ultra3-Wide (253 CDB)
|
- ABP3950U3W - Bus-Master PCI Dual LVD2/Ultra3-Wide (253 CDB)
|
||||||
|
|
||||||
Driver Compile Time Options and Debugging
|
Driver Compile Time Options and Debugging
|
||||||
|
=========================================
|
||||||
|
|
||||||
The following constants can be defined in the source file.
|
The following constants can be defined in the source file.
|
||||||
|
|
||||||
|
@ -88,26 +95,30 @@ The following constants can be defined in the source file.
|
||||||
first three hex digits of the pseudo I/O Port must be set to
|
first three hex digits of the pseudo I/O Port must be set to
|
||||||
'deb' and the fourth hex digit specifies the debug level: 0 - F.
|
'deb' and the fourth hex digit specifies the debug level: 0 - F.
|
||||||
The following command line will look for an adapter at 0x330
|
The following command line will look for an adapter at 0x330
|
||||||
and set the debug level to 2.
|
and set the debug level to 2::
|
||||||
|
|
||||||
linux advansys=0x330,0,0,0,0xdeb2
|
linux advansys=0x330,0,0,0,0xdeb2
|
||||||
|
|
||||||
If the driver is built as a loadable module this variable can be
|
If the driver is built as a loadable module this variable can be
|
||||||
defined when the driver is loaded. The following insmod command
|
defined when the driver is loaded. The following insmod command
|
||||||
will set the debug level to one.
|
will set the debug level to one::
|
||||||
|
|
||||||
insmod advansys.o asc_dbglvl=1
|
insmod advansys.o asc_dbglvl=1
|
||||||
|
|
||||||
Debugging Message Levels:
|
Debugging Message Levels:
|
||||||
0: Errors Only
|
|
||||||
1: High-Level Tracing
|
|
||||||
2-N: Verbose Tracing
|
==== ==================
|
||||||
|
0 Errors Only
|
||||||
|
1 High-Level Tracing
|
||||||
|
2-N Verbose Tracing
|
||||||
|
==== ==================
|
||||||
|
|
||||||
To enable debug output to console, please make sure that:
|
To enable debug output to console, please make sure that:
|
||||||
|
|
||||||
a. System and kernel logging is enabled (syslogd, klogd running).
|
a. System and kernel logging is enabled (syslogd, klogd running).
|
||||||
b. Kernel messages are routed to console output. Check
|
b. Kernel messages are routed to console output. Check
|
||||||
/etc/syslog.conf for an entry similar to this:
|
/etc/syslog.conf for an entry similar to this::
|
||||||
|
|
||||||
kern.* /dev/console
|
kern.* /dev/console
|
||||||
|
|
||||||
|
@ -120,8 +131,11 @@ The following constants can be defined in the source file.
|
||||||
|
|
||||||
Alternatively you can enable printk() to console with this
|
Alternatively you can enable printk() to console with this
|
||||||
program. However, this is not the 'official' way to do this.
|
program. However, this is not the 'official' way to do this.
|
||||||
|
|
||||||
Debug output is logged in /var/log/messages.
|
Debug output is logged in /var/log/messages.
|
||||||
|
|
||||||
|
::
|
||||||
|
|
||||||
main()
|
main()
|
||||||
{
|
{
|
||||||
syscall(103, 7, 0, 0);
|
syscall(103, 7, 0, 0);
|
||||||
|
@ -144,11 +158,11 @@ The following constants can be defined in the source file.
|
||||||
Statistics are only available for kernels greater than or equal
|
Statistics are only available for kernels greater than or equal
|
||||||
to v1.3.0 with the CONFIG_PROC_FS (/proc) file system configured.
|
to v1.3.0 with the CONFIG_PROC_FS (/proc) file system configured.
|
||||||
|
|
||||||
AdvanSys SCSI adapter files have the following path name format:
|
AdvanSys SCSI adapter files have the following path name format::
|
||||||
|
|
||||||
/proc/scsi/advansys/{0,1,2,3,...}
|
/proc/scsi/advansys/{0,1,2,3,...}
|
||||||
|
|
||||||
This information can be displayed with cat. For example:
|
This information can be displayed with cat. For example::
|
||||||
|
|
||||||
cat /proc/scsi/advansys/0
|
cat /proc/scsi/advansys/0
|
||||||
|
|
||||||
|
@ -156,6 +170,7 @@ The following constants can be defined in the source file.
|
||||||
contain adapter and device configuration information.
|
contain adapter and device configuration information.
|
||||||
|
|
||||||
Driver LILO Option
|
Driver LILO Option
|
||||||
|
==================
|
||||||
|
|
||||||
If init/main.c is modified as described in the 'Directions for Adding
|
If init/main.c is modified as described in the 'Directions for Adding
|
||||||
the AdvanSys Driver to Linux' section (B.4.) above, the driver will
|
the AdvanSys Driver to Linux' section (B.4.) above, the driver will
|
||||||
|
@ -167,17 +182,30 @@ affects searching for ISA and VL boards.
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
1. Eliminate I/O port scanning:
|
1. Eliminate I/O port scanning:
|
||||||
boot: linux advansys=
|
|
||||||
or
|
boot::
|
||||||
boot: linux advansys=0x0
|
|
||||||
|
linux advansys=
|
||||||
|
|
||||||
|
or::
|
||||||
|
|
||||||
|
boot: linux advansys=0x0
|
||||||
|
|
||||||
2. Limit I/O port scanning to one I/O port:
|
2. Limit I/O port scanning to one I/O port:
|
||||||
boot: linux advansys=0x110
|
|
||||||
|
boot::
|
||||||
|
|
||||||
|
linux advansys=0x110
|
||||||
|
|
||||||
3. Limit I/O port scanning to four I/O ports:
|
3. Limit I/O port scanning to four I/O ports:
|
||||||
boot: linux advansys=0x110,0x210,0x230,0x330
|
|
||||||
|
boot::
|
||||||
|
|
||||||
|
linux advansys=0x110,0x210,0x230,0x330
|
||||||
|
|
||||||
For a loadable module the same effect can be achieved by setting
|
For a loadable module the same effect can be achieved by setting
|
||||||
the 'asc_iopflag' variable and 'asc_ioport' array when loading
|
the 'asc_iopflag' variable and 'asc_ioport' array when loading
|
||||||
the driver, e.g.
|
the driver, e.g.::
|
||||||
|
|
||||||
insmod advansys.o asc_iopflag=1 asc_ioport=0x110,0x330
|
insmod advansys.o asc_iopflag=1 asc_ioport=0x110,0x330
|
||||||
|
|
||||||
|
@ -187,6 +215,7 @@ the 'Driver Compile Time Options and Debugging' section above for
|
||||||
more information.
|
more information.
|
||||||
|
|
||||||
Credits (Chronological Order)
|
Credits (Chronological Order)
|
||||||
|
=============================
|
||||||
|
|
||||||
Bob Frey <bfrey@turbolinux.com.cn> wrote the AdvanSys SCSI driver
|
Bob Frey <bfrey@turbolinux.com.cn> wrote the AdvanSys SCSI driver
|
||||||
and maintained it up to 3.3F. He continues to answer questions
|
and maintained it up to 3.3F. He continues to answer questions
|
|
@ -9,5 +9,6 @@ Linux SCSI Subsystem
|
||||||
|
|
||||||
53c700
|
53c700
|
||||||
aacraid
|
aacraid
|
||||||
|
advansys
|
||||||
|
|
||||||
scsi_transport_srp/figures
|
scsi_transport_srp/figures
|
||||||
|
|
|
@ -540,7 +540,7 @@ M: Matthew Wilcox <willy@infradead.org>
|
||||||
M: Hannes Reinecke <hare@suse.com>
|
M: Hannes Reinecke <hare@suse.com>
|
||||||
L: linux-scsi@vger.kernel.org
|
L: linux-scsi@vger.kernel.org
|
||||||
S: Maintained
|
S: Maintained
|
||||||
F: Documentation/scsi/advansys.txt
|
F: Documentation/scsi/advansys.rst
|
||||||
F: drivers/scsi/advansys.c
|
F: drivers/scsi/advansys.c
|
||||||
|
|
||||||
ADXL34X THREE-AXIS DIGITAL ACCELEROMETER DRIVER (ADXL345/ADXL346)
|
ADXL34X THREE-AXIS DIGITAL ACCELEROMETER DRIVER (ADXL345/ADXL346)
|
||||||
|
|
Loading…
Reference in New Issue