.. SPDX-License-Identifier: GPL-2.0
  
  ======================================

  README file for the dc395x SCSI driver

  ======================================

  
  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
  ----------

  The driver uses the settings from the EEPROM set in the SCSI BIOS

  setup. If there is no EEPROM, the driver uses default values.

  Both can be overridden by command line parameters (module or kernel

  parameters).
  
  The following parameters are available:

  safe

     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

  adapter_id

     Default: 7, Acceptable values: 0 to 15
  
     Sets the host adapter SCSI ID.

  max_speed

     Default: 1, Acceptable value: 0 to 7

  
     ==  ========
     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

     Bitmap for device configuration
  
     DevMode bit definition:

  
        === ======== ========  =========================================

        Bit Val(hex) Val(dec)  Meaning

        === ======== ========  =========================================
         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

     Bitmap for adapter configuration
  
     AdaptMode bit definition

  
      ===== ======== ========  ====================================================

        Bit Val(hex) Val(dec)  Meaning

      ===== ======== ========  ====================================================
         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.

         4    0x10      16     Immediate return on BIOS seek command. (Not used)
      (*)5    0x20      32     Check for LUNs >= 1.

      ===== ======== ========  ====================================================

  tags

     Default: 3, Acceptable values: 0-5

     The number of tags is 1<<x, if x has been specified

  reset_delay

     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.

  
  Note: The GNU GPL says also something about warranty and liability.

  Please be aware the following: While we do my best to provide a working and

  reliable driver, there is a chance, that it will kill your valuable data.

  We refuse to take any responsibility for that. The driver is provided as-is
  and YOU USE IT AT YOUR OWN RESPONSIBILITY.