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