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