1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 ================== !! 3 ======================================
4 dc395x SCSI driver !! 4 README file for the dc395x SCSI driver
5 ================== !! 5 ======================================
6 6
7 Status 7 Status
8 ------ 8 ------
9 The driver has been tested with CD-R and CD-R/ 9 The driver has been tested with CD-R and CD-R/W drives. These should
10 be safe to use. Testing with hard disks has no 10 be safe to use. Testing with hard disks has not been done to any
11 great degree and caution should be exercised i 11 great degree and caution should be exercised if you want to attempt
12 to use this driver with hard disks. 12 to use this driver with hard disks.
13 13
14 This driver is evolved from `the original 2.4 !! 14 This is a 2.5 only driver. For a 2.4 driver please see the original
15 <https://web.archive.org/web/20140129181343/ht !! 15 driver (which this driver started from) at
16 Problems, questions and patches should be subm !! 16 http://www.garloff.de/kurt/linux/dc395/
17 mailing list <linux-scsi@vger.kernel.org>`_. !! 17
>> 18 Problems, questions and patches should be submitted to the mailing
>> 19 list. Details on the list, including archives, are available at
>> 20 http://lists.twibble.org/mailman/listinfo/dc395x/
18 21
19 Parameters 22 Parameters
20 ---------- 23 ----------
21 The driver uses the settings from the EEPROM s 24 The driver uses the settings from the EEPROM set in the SCSI BIOS
22 setup. If there is no EEPROM, the driver uses 25 setup. If there is no EEPROM, the driver uses default values.
23 Both can be overridden by command line paramet 26 Both can be overridden by command line parameters (module or kernel
24 parameters). 27 parameters).
25 28
26 The following parameters are available: 29 The following parameters are available:
27 30
28 safe 31 safe
29 Default: 0, Acceptable values: 0 or 1 32 Default: 0, Acceptable values: 0 or 1
30 33
31 If safe is set to 1 then the adapter will u 34 If safe is set to 1 then the adapter will use conservative
32 ("safe") default settings. This sets: 35 ("safe") default settings. This sets:
33 36
34 shortcut for dc395x=7,4,9,15,2 37 shortcut for dc395x=7,4,9,15,2,10
35 38
36 adapter_id 39 adapter_id
37 Default: 7, Acceptable values: 0 to 15 40 Default: 7, Acceptable values: 0 to 15
38 41
39 Sets the host adapter SCSI ID. 42 Sets the host adapter SCSI ID.
40 43
41 max_speed 44 max_speed
42 Default: 1, Acceptable value: 0 to 7 45 Default: 1, Acceptable value: 0 to 7
43 46
44 == ======== 47 == ========
45 0 20 Mhz 48 0 20 Mhz
46 1 12.2 Mhz 49 1 12.2 Mhz
47 2 10 Mhz 50 2 10 Mhz
48 3 8 Mhz 51 3 8 Mhz
49 4 6.7 Mhz 52 4 6.7 Mhz
50 5 5.8 Hhz 53 5 5.8 Hhz
51 6 5 Mhz 54 6 5 Mhz
52 7 4 Mhz 55 7 4 Mhz
53 == ======== 56 == ========
54 57
55 dev_mode 58 dev_mode
56 Bitmap for device configuration 59 Bitmap for device configuration
57 60
58 DevMode bit definition: 61 DevMode bit definition:
59 62
60 === ======== ======== ================= 63 === ======== ======== =========================================
61 Bit Val(hex) Val(dec) Meaning 64 Bit Val(hex) Val(dec) Meaning
62 === ======== ======== ================= 65 === ======== ======== =========================================
63 0 0x01 1 Parity check 66 0 0x01 1 Parity check
64 1 0x02 2 Synchronous Negot 67 1 0x02 2 Synchronous Negotiation
65 2 0x04 4 Disconnection 68 2 0x04 4 Disconnection
66 3 0x08 8 Send Start comman 69 3 0x08 8 Send Start command on startup. (Not used)
67 4 0x10 16 Tagged Command Qu 70 4 0x10 16 Tagged Command Queueing
68 5 0x20 32 Wide Negotiation 71 5 0x20 32 Wide Negotiation
69 === ======== ======== ================= 72 === ======== ======== =========================================
70 73
71 adapter_mode 74 adapter_mode
72 Bitmap for adapter configuration 75 Bitmap for adapter configuration
73 76
74 AdaptMode bit definition 77 AdaptMode bit definition
75 78
76 ===== ======== ======== ================= 79 ===== ======== ======== ====================================================
77 Bit Val(hex) Val(dec) Meaning 80 Bit Val(hex) Val(dec) Meaning
78 ===== ======== ======== ================= 81 ===== ======== ======== ====================================================
79 0 0x01 1 Support more than 82 0 0x01 1 Support more than two drives. (Not used)
80 1 0x02 2 Use DOS compatibl 83 1 0x02 2 Use DOS compatible mapping for HDs greater than 1GB.
81 2 0x04 4 Reset SCSI Bus on 84 2 0x04 4 Reset SCSI Bus on startup.
82 3 0x08 8 Active Negation: 85 3 0x08 8 Active Negation: Improves SCSI Bus noise immunity.
83 4 0x10 16 Immediate return 86 4 0x10 16 Immediate return on BIOS seek command. (Not used)
84 (*)5 0x20 32 Check for LUNs >= 87 (*)5 0x20 32 Check for LUNs >= 1.
85 ===== ======== ======== ================= 88 ===== ======== ======== ====================================================
86 89
87 tags 90 tags
88 Default: 3, Acceptable values: 0-5 91 Default: 3, Acceptable values: 0-5
89 92
90 The number of tags is 1<<x, if x has been s 93 The number of tags is 1<<x, if x has been specified
91 94
92 reset_delay 95 reset_delay
93 Default: 1, Acceptable values: 0-180 96 Default: 1, Acceptable values: 0-180
94 97
95 The seconds to not accept commands after a 98 The seconds to not accept commands after a SCSI Reset
96 99
97 100
98 For the built in driver the parameters should 101 For the built in driver the parameters should be prefixed with
99 dc395x. (eg "dc395x.safe=1") 102 dc395x. (eg "dc395x.safe=1")
100 103
101 104
102 Copyright 105 Copyright
103 --------- 106 ---------
104 The driver is free software. It is protected b 107 The driver is free software. It is protected by the GNU General Public
105 License (GPL). Please read it, before using th 108 License (GPL). Please read it, before using this driver. It should be
106 included in your kernel sources and with your 109 included in your kernel sources and with your distribution. It carries the
107 filename COPYING. If you don't have it, please 110 filename COPYING. If you don't have it, please ask me to send you one by
108 email. 111 email.
109 112
110 Note: The GNU GPL says also something about wa 113 Note: The GNU GPL says also something about warranty and liability.
111 Please be aware the following: While we do my 114 Please be aware the following: While we do my best to provide a working and
112 reliable driver, there is a chance, that it wi 115 reliable driver, there is a chance, that it will kill your valuable data.
113 We refuse to take any responsibility for that. 116 We refuse to take any responsibility for that. The driver is provided as-is
114 and YOU USE IT AT YOUR OWN RESPONSIBILITY. 117 and YOU USE IT AT YOUR OWN RESPONSIBILITY.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.