dc395x.rst 3.79 KB
Newer Older
1 2 3
.. SPDX-License-Identifier: GPL-2.0

======================================
Linus Torvalds's avatar
Linus Torvalds committed
4
README file for the dc395x SCSI driver
5
======================================
Linus Torvalds's avatar
Linus Torvalds committed
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

Status
------
The driver has been tested with CD-R and CD-R/W drives. These should
be safe to use. Testing with hard disks has not been done to any
great degree and caution should be exercised if you want to attempt
to use this driver with hard disks.

This is a 2.5 only driver. For a 2.4 driver please see the original
driver (which this driver started from) at
http://www.garloff.de/kurt/linux/dc395/

Problems, questions and patches should be submitted to the mailing
list. Details on the list, including archives, are available at
http://lists.twibble.org/mailman/listinfo/dc395x/

Parameters
----------
24
The driver uses the settings from the EEPROM set in the SCSI BIOS
Linus Torvalds's avatar
Linus Torvalds committed
25
setup. If there is no EEPROM, the driver uses default values.
26
Both can be overridden by command line parameters (module or kernel
Linus Torvalds's avatar
Linus Torvalds committed
27 28 29 30
parameters).

The following parameters are available:

31
safe
Linus Torvalds's avatar
Linus Torvalds committed
32 33 34 35 36 37 38
   Default: 0, Acceptable values: 0 or 1

   If safe is set to 1 then the adapter will use conservative
   ("safe") default settings. This sets:

		shortcut for dc395x=7,4,9,15,2,10

39
adapter_id
Linus Torvalds's avatar
Linus Torvalds committed
40 41 42 43
   Default: 7, Acceptable values: 0 to 15

   Sets the host adapter SCSI ID.

44
max_speed
Linus Torvalds's avatar
Linus Torvalds committed
45
   Default: 1, Acceptable value: 0 to 7
46 47 48 49 50 51 52 53 54 55 56 57 58

   ==  ========
   0   20   Mhz
   1   12.2 Mhz
   2   10   Mhz
   3   8    Mhz
   4   6.7  Mhz
   5   5.8  Hhz
   6   5    Mhz
   7   4    Mhz
   ==  ========

dev_mode
Linus Torvalds's avatar
Linus Torvalds committed
59 60 61
   Bitmap for device configuration

   DevMode bit definition:
62 63

      === ======== ========  =========================================
Linus Torvalds's avatar
Linus Torvalds committed
64
      Bit Val(hex) Val(dec)  Meaning
65 66 67 68 69 70 71 72 73 74
      === ======== ========  =========================================
       0    0x01       1     Parity check
       1    0x02       2     Synchronous Negotiation
       2    0x04       4     Disconnection
       3    0x08       8     Send Start command on startup. (Not used)
       4    0x10      16     Tagged Command Queueing
       5    0x20      32     Wide Negotiation
      === ======== ========  =========================================

adapter_mode
Linus Torvalds's avatar
Linus Torvalds committed
75 76 77
   Bitmap for adapter configuration

   AdaptMode bit definition
78 79

    ===== ======== ========  ====================================================
Linus Torvalds's avatar
Linus Torvalds committed
80
      Bit Val(hex) Val(dec)  Meaning
81 82 83 84 85
    ===== ======== ========  ====================================================
       0    0x01       1     Support more than two drives. (Not used)
       1    0x02       2     Use DOS compatible mapping for HDs greater than 1GB.
       2    0x04       4     Reset SCSI Bus on startup.
       3    0x08       8     Active Negation: Improves SCSI Bus noise immunity.
Linus Torvalds's avatar
Linus Torvalds committed
86 87
       4    0x10      16     Immediate return on BIOS seek command. (Not used)
    (*)5    0x20      32     Check for LUNs >= 1.
88
    ===== ======== ========  ====================================================
Linus Torvalds's avatar
Linus Torvalds committed
89

90
tags
Linus Torvalds's avatar
Linus Torvalds committed
91
   Default: 3, Acceptable values: 0-5
92

Linus Torvalds's avatar
Linus Torvalds committed
93 94
   The number of tags is 1<<x, if x has been specified

95
reset_delay
Linus Torvalds's avatar
Linus Torvalds committed
96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
   Default: 1, Acceptable values: 0-180

   The seconds to not accept commands after a SCSI Reset


For the built  in driver the parameters should be prefixed with
dc395x. (eg "dc395x.safe=1")


Copyright
---------
The driver is free software. It is protected by the GNU General Public
License (GPL). Please read it, before using this driver. It should be
included in your kernel sources and with your distribution. It carries the
filename COPYING. If you don't have it, please ask me to send you one by
email.
112 113

Note: The GNU GPL says also something about warranty and liability.
Linus Torvalds's avatar
Linus Torvalds committed
114
Please be aware the following: While we do my best to provide a working and
115
reliable driver, there is a chance, that it will kill your valuable data.
Linus Torvalds's avatar
Linus Torvalds committed
116 117
We refuse to take any responsibility for that. The driver is provided as-is
and YOU USE IT AT YOUR OWN RESPONSIBILITY.