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