0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 ======================================
0004 README file for the dc395x SCSI driver
0005 ======================================
0006
0007 Status
0008 ------
0009 The driver has been tested with CD-R and CD-R/W drives. These should
0010 be safe to use. Testing with hard disks has not been done to any
0011 great degree and caution should be exercised if you want to attempt
0012 to use this driver with hard disks.
0013
0014 This is a 2.5 only driver. For a 2.4 driver please see the original
0015 driver (which this driver started from) at
0016 http://www.garloff.de/kurt/linux/dc395/
0017
0018 Problems, questions and patches should be submitted to the mailing
0019 list. Details on the list, including archives, are available at
0020 http://lists.twibble.org/mailman/listinfo/dc395x/
0021
0022 Parameters
0023 ----------
0024 The driver uses the settings from the EEPROM set in the SCSI BIOS
0025 setup. If there is no EEPROM, the driver uses default values.
0026 Both can be overridden by command line parameters (module or kernel
0027 parameters).
0028
0029 The following parameters are available:
0030
0031 safe
0032 Default: 0, Acceptable values: 0 or 1
0033
0034 If safe is set to 1 then the adapter will use conservative
0035 ("safe") default settings. This sets:
0036
0037 shortcut for dc395x=7,4,9,15,2,10
0038
0039 adapter_id
0040 Default: 7, Acceptable values: 0 to 15
0041
0042 Sets the host adapter SCSI ID.
0043
0044 max_speed
0045 Default: 1, Acceptable value: 0 to 7
0046
0047 == ========
0048 0 20 Mhz
0049 1 12.2 Mhz
0050 2 10 Mhz
0051 3 8 Mhz
0052 4 6.7 Mhz
0053 5 5.8 Hhz
0054 6 5 Mhz
0055 7 4 Mhz
0056 == ========
0057
0058 dev_mode
0059 Bitmap for device configuration
0060
0061 DevMode bit definition:
0062
0063 === ======== ======== =========================================
0064 Bit Val(hex) Val(dec) Meaning
0065 === ======== ======== =========================================
0066 0 0x01 1 Parity check
0067 1 0x02 2 Synchronous Negotiation
0068 2 0x04 4 Disconnection
0069 3 0x08 8 Send Start command on startup. (Not used)
0070 4 0x10 16 Tagged Command Queueing
0071 5 0x20 32 Wide Negotiation
0072 === ======== ======== =========================================
0073
0074 adapter_mode
0075 Bitmap for adapter configuration
0076
0077 AdaptMode bit definition
0078
0079 ===== ======== ======== ====================================================
0080 Bit Val(hex) Val(dec) Meaning
0081 ===== ======== ======== ====================================================
0082 0 0x01 1 Support more than two drives. (Not used)
0083 1 0x02 2 Use DOS compatible mapping for HDs greater than 1GB.
0084 2 0x04 4 Reset SCSI Bus on startup.
0085 3 0x08 8 Active Negation: Improves SCSI Bus noise immunity.
0086 4 0x10 16 Immediate return on BIOS seek command. (Not used)
0087 (*)5 0x20 32 Check for LUNs >= 1.
0088 ===== ======== ======== ====================================================
0089
0090 tags
0091 Default: 3, Acceptable values: 0-5
0092
0093 The number of tags is 1<<x, if x has been specified
0094
0095 reset_delay
0096 Default: 1, Acceptable values: 0-180
0097
0098 The seconds to not accept commands after a SCSI Reset
0099
0100
0101 For the built in driver the parameters should be prefixed with
0102 dc395x. (eg "dc395x.safe=1")
0103
0104
0105 Copyright
0106 ---------
0107 The driver is free software. It is protected by the GNU General Public
0108 License (GPL). Please read it, before using this driver. It should be
0109 included in your kernel sources and with your distribution. It carries the
0110 filename COPYING. If you don't have it, please ask me to send you one by
0111 email.
0112
0113 Note: The GNU GPL says also something about warranty and liability.
0114 Please be aware the following: While we do my best to provide a working and
0115 reliable driver, there is a chance, that it will kill your valuable data.
0116 We refuse to take any responsibility for that. The driver is provided as-is
0117 and YOU USE IT AT YOUR OWN RESPONSIBILITY.