xref: /OK3568_Linux_fs/kernel/Documentation/scsi/dc395x.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun======================================
4*4882a593SmuzhiyunREADME file for the dc395x SCSI driver
5*4882a593Smuzhiyun======================================
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunStatus
8*4882a593Smuzhiyun------
9*4882a593SmuzhiyunThe driver has been tested with CD-R and CD-R/W drives. These should
10*4882a593Smuzhiyunbe safe to use. Testing with hard disks has not been done to any
11*4882a593Smuzhiyungreat degree and caution should be exercised if you want to attempt
12*4882a593Smuzhiyunto use this driver with hard disks.
13*4882a593Smuzhiyun
14*4882a593SmuzhiyunThis is a 2.5 only driver. For a 2.4 driver please see the original
15*4882a593Smuzhiyundriver (which this driver started from) at
16*4882a593Smuzhiyunhttp://www.garloff.de/kurt/linux/dc395/
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunProblems, questions and patches should be submitted to the mailing
19*4882a593Smuzhiyunlist. Details on the list, including archives, are available at
20*4882a593Smuzhiyunhttp://lists.twibble.org/mailman/listinfo/dc395x/
21*4882a593Smuzhiyun
22*4882a593SmuzhiyunParameters
23*4882a593Smuzhiyun----------
24*4882a593SmuzhiyunThe driver uses the settings from the EEPROM set in the SCSI BIOS
25*4882a593Smuzhiyunsetup. If there is no EEPROM, the driver uses default values.
26*4882a593SmuzhiyunBoth can be overridden by command line parameters (module or kernel
27*4882a593Smuzhiyunparameters).
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunThe following parameters are available:
30*4882a593Smuzhiyun
31*4882a593Smuzhiyunsafe
32*4882a593Smuzhiyun   Default: 0, Acceptable values: 0 or 1
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun   If safe is set to 1 then the adapter will use conservative
35*4882a593Smuzhiyun   ("safe") default settings. This sets:
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun		shortcut for dc395x=7,4,9,15,2,10
38*4882a593Smuzhiyun
39*4882a593Smuzhiyunadapter_id
40*4882a593Smuzhiyun   Default: 7, Acceptable values: 0 to 15
41*4882a593Smuzhiyun
42*4882a593Smuzhiyun   Sets the host adapter SCSI ID.
43*4882a593Smuzhiyun
44*4882a593Smuzhiyunmax_speed
45*4882a593Smuzhiyun   Default: 1, Acceptable value: 0 to 7
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun   ==  ========
48*4882a593Smuzhiyun   0   20   Mhz
49*4882a593Smuzhiyun   1   12.2 Mhz
50*4882a593Smuzhiyun   2   10   Mhz
51*4882a593Smuzhiyun   3   8    Mhz
52*4882a593Smuzhiyun   4   6.7  Mhz
53*4882a593Smuzhiyun   5   5.8  Hhz
54*4882a593Smuzhiyun   6   5    Mhz
55*4882a593Smuzhiyun   7   4    Mhz
56*4882a593Smuzhiyun   ==  ========
57*4882a593Smuzhiyun
58*4882a593Smuzhiyundev_mode
59*4882a593Smuzhiyun   Bitmap for device configuration
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun   DevMode bit definition:
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun      === ======== ========  =========================================
64*4882a593Smuzhiyun      Bit Val(hex) Val(dec)  Meaning
65*4882a593Smuzhiyun      === ======== ========  =========================================
66*4882a593Smuzhiyun       0    0x01       1     Parity check
67*4882a593Smuzhiyun       1    0x02       2     Synchronous Negotiation
68*4882a593Smuzhiyun       2    0x04       4     Disconnection
69*4882a593Smuzhiyun       3    0x08       8     Send Start command on startup. (Not used)
70*4882a593Smuzhiyun       4    0x10      16     Tagged Command Queueing
71*4882a593Smuzhiyun       5    0x20      32     Wide Negotiation
72*4882a593Smuzhiyun      === ======== ========  =========================================
73*4882a593Smuzhiyun
74*4882a593Smuzhiyunadapter_mode
75*4882a593Smuzhiyun   Bitmap for adapter configuration
76*4882a593Smuzhiyun
77*4882a593Smuzhiyun   AdaptMode bit definition
78*4882a593Smuzhiyun
79*4882a593Smuzhiyun    ===== ======== ========  ====================================================
80*4882a593Smuzhiyun      Bit Val(hex) Val(dec)  Meaning
81*4882a593Smuzhiyun    ===== ======== ========  ====================================================
82*4882a593Smuzhiyun       0    0x01       1     Support more than two drives. (Not used)
83*4882a593Smuzhiyun       1    0x02       2     Use DOS compatible mapping for HDs greater than 1GB.
84*4882a593Smuzhiyun       2    0x04       4     Reset SCSI Bus on startup.
85*4882a593Smuzhiyun       3    0x08       8     Active Negation: Improves SCSI Bus noise immunity.
86*4882a593Smuzhiyun       4    0x10      16     Immediate return on BIOS seek command. (Not used)
87*4882a593Smuzhiyun    (*)5    0x20      32     Check for LUNs >= 1.
88*4882a593Smuzhiyun    ===== ======== ========  ====================================================
89*4882a593Smuzhiyun
90*4882a593Smuzhiyuntags
91*4882a593Smuzhiyun   Default: 3, Acceptable values: 0-5
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun   The number of tags is 1<<x, if x has been specified
94*4882a593Smuzhiyun
95*4882a593Smuzhiyunreset_delay
96*4882a593Smuzhiyun   Default: 1, Acceptable values: 0-180
97*4882a593Smuzhiyun
98*4882a593Smuzhiyun   The seconds to not accept commands after a SCSI Reset
99*4882a593Smuzhiyun
100*4882a593Smuzhiyun
101*4882a593SmuzhiyunFor the built  in driver the parameters should be prefixed with
102*4882a593Smuzhiyundc395x. (eg "dc395x.safe=1")
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun
105*4882a593SmuzhiyunCopyright
106*4882a593Smuzhiyun---------
107*4882a593SmuzhiyunThe driver is free software. It is protected by the GNU General Public
108*4882a593SmuzhiyunLicense (GPL). Please read it, before using this driver. It should be
109*4882a593Smuzhiyunincluded in your kernel sources and with your distribution. It carries the
110*4882a593Smuzhiyunfilename COPYING. If you don't have it, please ask me to send you one by
111*4882a593Smuzhiyunemail.
112*4882a593Smuzhiyun
113*4882a593SmuzhiyunNote: The GNU GPL says also something about warranty and liability.
114*4882a593SmuzhiyunPlease be aware the following: While we do my best to provide a working and
115*4882a593Smuzhiyunreliable driver, there is a chance, that it will kill your valuable data.
116*4882a593SmuzhiyunWe refuse to take any responsibility for that. The driver is provided as-is
117*4882a593Smuzhiyunand YOU USE IT AT YOUR OWN RESPONSIBILITY.
118