Subversion Repositories or1k

/* $Id: advansys.c,v 1.1 2005-12-20 10:17:45 jcastillo Exp $ */

#define ASC_VERSION "3.1E"    /* AdvanSys Driver Version */

/*

 * advansys.c - Linux Host Driver for AdvanSys SCSI Adapters

 *

 * Copyright (c) 1995-1998 Advanced System Products, Inc.

 * All Rights Reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that redistributions of source

 * code retain the above copyright notice and this comment without

 * modification.

 *

 * There is an AdvanSys Linux WWW page at:

 *  http://www.advansys.com/linux.html

 *

 * The latest version of the AdvanSys driver is available at:

 *  ftp://ftp.advansys.com/pub/linux/linux.tgz

 *

 * Please send questions, comments, bug reports to:

 *  bobf@advansys.com (Bob Frey)

 */

/*

  Documentation for the AdvanSys Driver

  A. Linux Kernel Testing

  B. Adapters Supported by this Driver

  C. Linux v1.2.X - Directions for Adding the AdvanSys Driver

  D. Linux v1.3.1 - v1.3.57 - Directions for Adding the AdvanSys Driver

  E. Linux v1.3.58 and Newer - Upgrading the AdvanSys Driver

  F. Source Comments

  G. Driver Compile Time Options and Debugging

  H. Driver LILO Option

  I. Release History

  J. Known Problems or Issues

  K. Credits

  L. AdvanSys Contact Information

  A. Linux Kernel Testing

     This driver has been tested in the following Linux kernels: v1.2.13,

     v1.3.57, v2.0.33, v2.1.77. These kernel versions are major releases

     of Linux or the latest Linux kernel versions available when this version

     of the driver was released. The driver should also work in earlier

     versions of the Linux kernel. Beginning with v1.3.58 the AdvanSys driver

     is included with all Linux kernels. Please refer to sections C, D, and

     E for instructions on adding or upgrading the AdvanSys driver.

  B. Adapters Supported by this Driver

     AdvanSys (Advanced System Products, Inc.) manufactures the following

     RISC-based, Bus-Mastering, Fast (10 Mhz) and Ultra (20 Mhz) Narrow

     (8-bit transfer) SCSI Host Adapters for the ISA, EISA, VL, and PCI

     buses and RISC-based, Bus-Mastering, Ultra (20 Mhz) Wide (16-bit

     transfer) SCSI Host Adapters for the PCI bus.

     The CDB counts below indicate the number of SCSI CDB (Command

     Descriptor Block) requests that can be stored in the RISC chip

     cache and board LRAM. A CDB is a single SCSI command. The driver

     detect routine will display the number of CDBs available for each

     adapter detected. The number of CDBs used by the driver can be

     lowered in the BIOS by changing the 'Host Queue Size' adapter setting.

     Connectivity Products:

        ABP510/5150 - Bus-Master ISA (240 CDB) (Footnote 1)

        ABP5140 - Bus-Master ISA PnP (16 CDB) (Footnote 1, 3)

        ABP5142 - Bus-Master ISA PnP with floppy (16 CDB) (Footnote 4)

        ABP920 - Bus-Master PCI (16 CDB)

        ABP930 - Bus-Master PCI (16 CDB) (Footnote 5)

        ABP930U - Bus-Master PCI Ultra (16 CDB)

        ABP930UA - Bus-Master PCI Ultra (16 CDB)

        ABP960 - Bus-Master PCI MAC/PC (16 CDB) (Footnote 2)

        ABP960U - Bus-Master PCI MAC/PC Ultra (16 CDB) (Footnote 2)

     Single Channel Products:

        ABP542 - Bus-Master ISA with floppy (240 CDB)

        ABP742 - Bus-Master EISA (240 CDB)

        ABP842 - Bus-Master VL (240 CDB)

        ABP940 - Bus-Master PCI (240 CDB)

        ABP940U - Bus-Master PCI Ultra (240 CDB)

        ABP970 - Bus-Master PCI MAC/PC (240 CDB)

        ABP970U - Bus-Master PCI MAC/PC Ultra (240 CDB)

        ABP940UW - Bus-Master PCI Ultra-Wide (240 CDB)

     Multi Channel Products:

        ABP752 - Dual Channel Bus-Master EISA (240 CDB Per Channel)

        ABP852 - Dual Channel Bus-Master VL (240 CDB Per Channel)

        ABP950 - Dual Channel Bus-Master PCI (240 CDB Per Channel)

        ABP980 - Four Channel Bus-Master PCI (240 CDB Per Channel)

        ABP980U - Four Channel Bus-Master PCI Ultra (240 CDB Per Channel)

     Footnotes:

       1. This board has been shipped by HP with the 4020i CD-R drive.

          The board has no BIOS so it cannot control a boot device, but

          it can control any secondary SCSI device.

       2. This board has been sold by Iomega as a Jaz Jet PCI adapter.

       3. This board has been sold by SIIG as the i540 SpeedMaster.

       4. This board has been sold by SIIG as the i542 SpeedMaster.

       5. This board has been sold by SIIG as the Fast SCSI Pro PCI.

  C. Linux v1.2.X - Directions for Adding the AdvanSys Driver

     These directions apply to v1.2.13. For versions that follow v1.2.13.

     but precede v1.3.57 some of the changes for Linux v1.3.X listed

     below may need to be modified or included. A patch is available

     for v1.2.13 from the AdvanSys WWW and FTP sites.

     There are two source files: advansys.h and advansys.c. Copy

     both of these files to the directory /usr/src/linux/drivers/scsi.

     1. Add the following line to /usr/src/linux/arch/i386/config.in

        after "comment 'SCSI low-level drivers'":

          bool 'AdvanSys SCSI support' CONFIG_SCSI_ADVANSYS y

     2. Add the following lines to /usr/src/linux/drivers/scsi/hosts.c

        after "#include "hosts.h"":

          #ifdef CONFIG_SCSI_ADVANSYS

          #include "advansys.h"

          #endif

        and after "static Scsi_Host_Template builtin_scsi_hosts[] =":

          #ifdef CONFIG_SCSI_ADVANSYS

          ADVANSYS,

          #endif

     3. Add the following lines to /usr/src/linux/drivers/scsi/Makefile:

          ifdef CONFIG_SCSI_ADVANSYS

          SCSI_SRCS := $(SCSI_SRCS) advansys.c

          SCSI_OBJS := $(SCSI_OBJS) advansys.o

          else

          SCSI_MODULE_OBJS := $(SCSI_MODULE_OBJS) advansys.o

          endif

     4. (Optional) If you would like to enable the LILO command line

        and /etc/lilo.conf 'advansys' option, make the following changes.

        This option can be used to disable I/O port scanning or to limit

        I/O port scanning to specific addresses. Refer to the 'Driver

        LILO Option' section below. Add the following lines to

        /usr/src/linux/init/main.c in the prototype section:

          extern void advansys_setup(char *str, int *ints);

        and add the following lines to the bootsetups[] array.

          #ifdef CONFIG_SCSI_ADVANSYS

             { "advansys=", advansys_setup },

          #endif

     5. If you have the HP 4020i CD-R driver and Linux v1.2.X you should

        add a fix to the CD-ROM target driver. This fix will allow

        you to mount CDs with the iso9660 file system. Linux v1.3.X

        already has this fix. In the file /usr/src/linux/drivers/scsi/sr.c

        and function get_sectorsize() after the line:

        if(scsi_CDs[i].sector_size == 0) scsi_CDs[i].sector_size = 2048;

        add the following line:

        if(scsi_CDs[i].sector_size == 2340) scsi_CDs[i].sector_size = 2048;

     6. In the directory /usr/src/linux run 'make config' to configure

        the AdvanSys driver, then run 'make vmlinux' or 'make zlilo' to

        make the kernel. If the AdvanSys driver is not configured, then

        a loadable module can be built by running 'make modules' and

        'make modules_install'. Use 'insmod' and 'rmmod' to install

        and remove advansys.o.

  D. Linux v1.3.1 - v1.3.57 - Directions for Adding the AdvanSys Driver

     These directions apply to v1.3.57. For versions that precede v1.3.57

     some of these changes may need to be modified or eliminated. A patch

     is available for v1.3.57 from the AdvanSys WWW and FTP sites.

     Beginning with v1.3.58 this driver is included with the Linux

     distribution eliminating the need for making any changes.

     There are two source files: advansys.h and advansys.c. Copy

     both of these files to the directory /usr/src/linux/drivers/scsi.

     1. Add the following line to /usr/src/linux/drivers/scsi/Config.in

        after "comment 'SCSI low-level drivers'":

          dep_tristate 'AdvanSys SCSI support' CONFIG_SCSI_ADVANSYS $CONFIG_SCSI

     2. Add the following lines to /usr/src/linux/drivers/scsi/hosts.c

        after "#include "hosts.h"":

          #ifdef CONFIG_SCSI_ADVANSYS

          #include "advansys.h"

          #endif

        and after "static Scsi_Host_Template builtin_scsi_hosts[] =":

          #ifdef CONFIG_SCSI_ADVANSYS

          ADVANSYS,

          #endif

     3. Add the following lines to /usr/src/linux/drivers/scsi/Makefile:

          ifeq ($(CONFIG_SCSI_ADVANSYS),y)

          L_OBJS += advansys.o

          else

            ifeq ($(CONFIG_SCSI_ADVANSYS),m)

            M_OBJS += advansys.o

            endif

          endif

     4. Add the following line to /usr/src/linux/include/linux/proc_fs.h

        in the enum scsi_directory_inos array:

          PROC_SCSI_ADVANSYS,

     5. (Optional) If you would like to enable the LILO command line

        and /etc/lilo.conf 'advansys' option, make the following changes.

        This option can be used to disable I/O port scanning or to limit

        I/O port scanning to specific addresses. Refer to the 'Driver

        LILO Option' section below. Add the following lines to

        /usr/src/linux/init/main.c in the prototype section:

          extern void advansys_setup(char *str, int *ints);

        and add the following lines to the bootsetups[] array.

          #ifdef CONFIG_SCSI_ADVANSYS

             { "advansys=", advansys_setup },

          #endif

     6. In the directory /usr/src/linux run 'make config' to configure

        the AdvanSys driver, then run 'make vmlinux' or 'make zlilo' to

        make the kernel. If the AdvanSys driver is not configured, then

        a loadable module can be built by running 'make modules' and

        'make modules_install'. Use 'insmod' and 'rmmod' to install

        and remove advansys.o.

  E. Linux v1.3.58 and Newer - Upgrading the AdvanSys Driver

     To upgrade the AdvanSys driver in a Linux v1.3.58 and newer

     kernel, first check the version of the current driver. The

     version is defined by the manifest constant ASC_VERSION at

     the beginning of advansys.c. The new driver should have a

     ASC_VERSION value greater than the current version. To install

     the new driver rename advansys.c and advansys.h in the Linux

     kernel source tree drivers/scsi directory to different names

     or save them to a different directory in case you want to revert

     to the old version of the driver. After the old driver is saved

     copy the new advansys.c and advansys.h to drivers/scsi, rebuild

     the kernel, and install the new kernel. No other changes are needed.

  F. Source Comments

     1. Use tab stops set to 4 for the source files. For vi use 'se tabstops=4'.

     2. This driver should be maintained in multiple files. But to make

        it easier to include with Linux and to follow Linux conventions,

        the whole driver is maintained in the source files advansys.h and

        advansys.c. In this file logical sections of the driver begin with

        a comment that contains '---'. The following are the logical sections

        of the driver below.

           --- Linux Version

           --- Linux Include Files

           --- Driver Options

           --- Debugging Header

           --- Asc Library Constants and Macros

           --- Adv Library Constants and Macros

           --- Driver Constants and Macros

           --- Driver Structures

           --- Driver Data

           --- Driver Function Prototypes

           --- Linux 'Scsi_Host_Template' and advansys_setup() Functions

           --- Loadable Driver Support

           --- Miscellaneous Driver Functions

           --- Functions Required by the Asc Library

           --- Functions Required by the Adv Library

           --- Tracing and Debugging Functions

           --- Asc Library Functions

           --- Adv Library Functions

     3. The string 'XXX' is used to flag code that needs to be re-written

        or that contains a problem that needs to be addressed.

     4. I have stripped comments from and reformatted the source for the

        Asc Library and Adv Library to reduce the size of this file. This

        source can be found under the following headings. The Asc Library

        is used to support Narrow Boards. The Adv Library is used to

        support Wide Boards.

           --- Asc Library Constants and Macros

           --- Adv Library Constants and Macros

           --- Asc Library Functions

           --- Adv Library Functions

  G. Driver Compile Time Options and Debugging

     In this source file the following constants can be defined. They are

     defined in the source below. Both of these options are enabled by

     default.

     1. ADVANSYS_ASSERT - Enable driver assertions (Def: Enabled)

        Enabling this option adds assertion logic statements to the

        driver. If an assertion fails a message will be displayed to

        the console, but the system will continue to operate. Any

        assertions encountered should be reported to the person

        responsible for the driver. Assertion statements may proactively

        detect problems with the driver and facilitate fixing these

        problems. Enabling assertions will add a small overhead to the

        execution of the driver.

     2. ADVANSYS_DEBUG - Enable driver debugging (Def: Disabled)

        Enabling this option adds tracing functions to the driver and

        the ability to set a driver tracing level at boot time. This

        option will also export symbols not required outside the driver to

        the kernel name space. This option is very useful for debugging

        the driver, but it will add to the size of the driver execution

        image and add overhead to the execution of the driver.

        The amount of debugging output can be controlled with the global

        variable 'asc_dbglvl'. The higher the number the more output. By

        default the debug level is 0.

        If the driver is loaded at boot time and the LILO Driver Option

        is included in the system, the debug level can be changed by

        specifying a 5th (ASC_NUM_IOPORT_PROBE + 1) I/O Port. The

        first three hex digits of the pseudo I/O Port must be set to

        'deb' and the fourth hex digit specifies the debug level: 0 - F.

        The following command line will look for an adapter at 0x330

        and set the debug level to 2.

           linux advansys=0x330,0,0,0,0xdeb2

        If the driver is built as a loadable module this variable can be

        defined when the driver is loaded. The following insmod command

        will set the debug level to one.

           insmod advansys.o asc_dbglvl=1

        Debugging Message Levels:

           0: Errors Only

           1: High-Level Tracing

           2-N: Verbose Tracing

        I don't know the approved way for turning on printk()s to the

        console. Here's a program I use to do this. Debug output is

        logged in /var/adm/messages.

          main()

          {

                  syscall(103, 7, 0, 0);

          }

        I found that increasing LOG_BUF_LEN to 40960 in kernel/printk.c

        prevents most level 1 debug messages from being lost.

     3. ADVANSYS_STATS - Enable statistics (Def: Enabled >= v1.3.0)

        Enabling this option adds statistics collection and display

        through /proc to the driver. The information is useful for

        monitoring driver and device performance. It will add to the

        size of the driver execution image and add minor overhead to

        the execution of the driver.

        Statistics are maintained on a per adapter basis. Driver entry

        point call counts and transfer size counts are maintained.

        Statistics are only available for kernels greater than or equal

        to v1.3.0 with the CONFIG_PROC_FS (/proc) file system configured.

        AdvanSys SCSI adapter files have the following path name format:

           /proc/scsi/advansys/[0-(ASC_NUM_BOARD_SUPPORTED-1)]

        This information can be displayed with cat. For example:

           cat /proc/scsi/advansys/0

        When ADVANSYS_STATS is not defined the AdvanSys /proc files only

        contain adapter and device configuration information.

  H. Driver LILO Option

     If init/main.c is modified as described in the 'Directions for Adding

     the AdvanSys Driver to Linux' section (B.4.) above, the driver will

     recognize the 'advansys' LILO command line and /etc/lilo.conf option.

     This option can be used to either disable I/O port scanning or to limit

     scanning to 1 - 4 I/O ports. Regardless of the option setting EISA and

     PCI boards will still be searched for and detected. This option only

     affects searching for ISA and VL boards.

     Examples:

       1. Eliminate I/O port scanning:

            boot: linux advansys=

              or

            boot: linux advansys=0x0

       2. Limit I/O port scanning to one I/O port:

            boot: linux advansys=0x110

       3. Limit I/O port scanning to four I/O ports:

            boot: linux advansys=0x110,0x210,0x230,0x330

     For a loadable module the same effect can be achieved by setting

     the 'asc_iopflag' variable and 'asc_ioport' array when loading

     the driver, e.g.

           insmod advansys.o asc_iopflag=1 asc_ioport=0x110,0x330

     If ADVANSYS_DEBUG is defined a 5th (ASC_NUM_IOPORT_PROBE + 1)

     I/O Port may be added to specify the driver debug level. Refer to

     the 'Driver Compile Time Options and Debugging' section above for

     more information.

  I. Release History

     BETA-1.0 (12/23/95):

         First Release

     BETA-1.1 (12/28/95):

         1. Prevent advansys_detect() from being called twice.

         2. Add LILO 0xdeb[0-f] option to set 'asc_dbglvl'.

     1.2 (1/12/96):

         1. Prevent re-entrancy in the interrupt handler which

            resulted in the driver hanging Linux.

         2. Fix problem that prevented ABP-940 cards from being

            recognized on some PCI motherboards.

         3. Add support for the ABP-5140 PnP ISA card.

         4. Fix check condition return status.

         5. Add conditionally compiled code for Linux v1.3.X.

     1.3 (2/23/96):

         1. Fix problem in advansys_biosparam() that resulted in the

            wrong drive geometry being returned for drives > 1GB with

            extended translation enabled.

         2. Add additional tracing during device initialization.

         3. Change code that only applies to ISA PnP adapter.

         4. Eliminate 'make dep' warning.

         5. Try to fix problem with handling resets by increasing their

            timeout value.

     1.4 (5/8/96):

         1. Change definitions to eliminate conflicts with other subsystems.

         2. Add versioning code for the shared interrupt changes.

         3. Eliminate problem in asc_rmqueue() with iterating after removing

            a request.

         4. Remove reset request loop problem from the "Known Problems or

            Issues" section. This problem was isolated and fixed in the

            mid-level SCSI driver.

     1.5 (8/8/96):

         1. Add support for ABP-940U (PCI Ultra) adapter.

         2. Add support for IRQ sharing by setting the SA_SHIRQ flag for

            request_irq and supplying a dev_id pointer to both request_irq()

            and free_irq().

         3. In AscSearchIOPortAddr11() restore a call to check_region() which

            should be used before I/O port probing.

         4. Fix bug in asc_prt_hex() which resulted in the displaying

            the wrong data.

         5. Incorporate miscellaneous Asc Library bug fixes and new microcode.

         6. Change driver versioning to be specific to each Linux sub-level.

         7. Change statistics gathering to be per adapter instead of global

            to the driver.

         8. Add more information and statistics to the adapter /proc file:

            /proc/scsi/advansys[0...].

         9. Remove 'cmd_per_lun' from the "Known Problems or Issues" list.

            This problem has been addressed with the SCSI mid-level changes

            made in v1.3.89. The advansys_select_queue_depths() function

            was added for the v1.3.89 changes.

     1.6 (9/10/96):

         1. Incorporate miscellaneous Asc Library bug fixes and new microcode.

     1.7 (9/25/96):

         1. Enable clustering and optimize the setting of the maximum number

            of scatter gather elements for any particular board. Clustering

            increases CPU utilization, but results in a relatively larger

            increase in I/O throughput.

         2. Improve the performance of the request queuing functions by

            adding a last pointer to the queue structure.

         3. Correct problems with reset and abort request handling that

            could have hung or crashed Linux.

         4. Add more information to the adapter /proc file:

            /proc/scsi/advansys[0...].

         5. Remove the request timeout issue form the driver issues list.

         6. Miscellaneous documentation additions and changes.

     1.8 (10/4/96):

         1. Make changes to handle the new v2.1.0 kernel memory mapping

            in which a kernel virtual address may not be equivalent to its

            bus or DMA memory address.

         2. Change abort and reset request handling to make it yet even

            more robust.

         3. Try to mitigate request starvation by sending ordered requests

            to heavily loaded, tag queuing enabled devices.

         4. Maintain statistics on request response time.

         5. Add request response time statistics and other information to

            the adapter /proc file: /proc/scsi/advansys[0...].

     1.9 (10/21/96):

         1. Add conditionally compiled code (ASC_QUEUE_FLOW_CONTROL) to

            make use of mid-level SCSI driver device queue depth flow

            control mechanism. This will eliminate aborts caused by a

            device being unable to keep up with requests and eliminate

            repeat busy or QUEUE FULL status returned by a device.

         2. Incorporate miscellaneous Asc Library bug fixes.

         3. To allow the driver to work in kernels with broken module

            support set 'cmd_per_lun' if the driver is compiled as a

            module. This change affects kernels v1.3.89 to present.

         4. Remove PCI BIOS address from the driver banner. The PCI BIOS

            is relocated by the motherboard BIOS and its new address can

            not be determined by the driver.

         5. Add mid-level SCSI queue depth information to the adapter

            /proc file: /proc/scsi/advansys[0...].

     2.0 (11/14/96):

         1. Change allocation of global structures used for device

            initialization to guarantee they are in DMA-able memory.

            Previously when the driver was loaded as a module these

            structures might not have been in DMA-able memory, causing

            device initialization to fail.

     2.1 (12/30/96):

         1. In advansys_reset(), if the request is a synchronous reset

            request, even if the request serial number has changed, then

            complete the request.

         2. Add Asc Library bug fixes including new microcode.

         3. Clear inquiry buffer before using it.

         4. Correct ifdef typo.

     2.2 (1/15/97):

         1. Add Asc Library bug fixes including new microcode.

         2. Add synchronous data transfer rate information to the

            adapter /proc file: /proc/scsi/advansys[0...].

         3. Change ADVANSYS_DEBUG to be disabled by default. This

            will reduce the size of the driver image, eliminate execution

            overhead, and remove unneeded symbols from the kernel symbol

            space that were previously added by the driver.

         4. Add new compile-time option ADVANSYS_ASSERT for assertion

            code that used to be defined within ADVANSYS_DEBUG. This

            option is enabled by default.

     2.8 (5/26/97):

         1. Change version number to 2.8 to synchronize the Linux driver

            version numbering with other AdvanSys drivers.

         2. Reformat source files without tabs to present the same view

            of the file to everyone regardless of the editor tab setting

            being used.

         3. Add Asc Library bug fixes.

     3.1A (1/8/98):

         1. Change version number to 3.1 to indicate that support for

            Ultra-Wide adapters (ABP-940UW) is included in this release.

         2. Add Asc Library (Narrow Board) bug fixes.

         3. Report an underrun condition with the host status byte set

            to DID_UNDERRUN. Currently DID_UNDERRUN is defined to 0 which

            causes the underrun condition to be ignored. When Linux defines

            its own DID_UNDERRUN the constant defined in this file can be

            removed.

         4. Add patch to AscWaitTixISRDone().

         5. Add support for up to 16 different AdvanSys host adapter SCSI

            channels in one system. This allows four cards with four channels

            to be used in one system.

     3.1B (1/9/98):

         1. Handle that PCI register base addresses are not always page

            aligned even though ioremap() requires that the address argument

            be page aligned.

     3.1C (1/10/98):

         1. Update latest BIOS version checked for from the /proc file.

         2. Don't set microcode SDTR variable at initialization. Instead

            wait until device capabilities have been detected from an Inquiry

            command.

     3.1D (1/21/98):

         1. Improve performance when the driver is compiled as module by

            allowing up to 64 scatter-gather elements instead of 8.

     3.1E (5/1/98):

         1. Set time delay in AscWaitTixISRDone() to 1000 ms.

         2. Include SMP locking changes.

         3. For v2.1.93 and newer kernels use CONFIG_PCI and new PCI BIOS

            access functions.

         4. Update board serial number printing.

         5. Try allocating an IRQ both with and without the SA_INTERRUPT

            flag set to allow IRQ sharing with drivers that do not set

            the SA_INTERRUPT flag. Also display a more descriptive error

            message if request_irq() fails.

         5. Update to latest Asc and Adv Libraries.

  J. Known Problems or Issues

         1. Remove conditional constants (ASC_QUEUE_FLOW_CONTROL) around

            the queue depth flow control code when mid-level SCSI changes

            are included in Linux.

  K. Credits

     Nathan Hartwell <mage@cdc3.cdc.net> provided the directions and

     basis for the Linux v1.3.X changes which were included in the

     1.2 release.

     Thomas E Zerucha <zerucha@shell.portal.com> pointed out a bug

     in advansys_biosparam() which was fixed in the 1.3 release.

     Erik Ratcliffe <erik@caldera.com> has done testing of the

     AdvanSys driver in the Caldera releases.

     Rik van Riel <H.H.vanRiel@fys.ruu.nl> provided a patch to

     AscWaitTixISRDone() which he found necessary to make the

     driver work with a SCSI-1 disk.

     Mark Moran <mmoran@mmoran.com> has helped test Ultra-Wide

     support in the 3.1A driver.

  L. AdvanSys Contact Information

     Mail:                   Advanced System Products, Inc.

                             1150 Ringwood Court

                             San Jose, CA 95131

     Operator:               1-408-383-9400

     FAX:                    1-408-383-9612

     Tech Support:           1-800-525-7440/1-408-467-2930

     BBS:                    1-408-383-9540 (14400,N,8,1)

     Interactive FAX:        1-408-383-9753

     Customer Direct Sales:  1-800-525-7443/1-408-383-5777

     Tech Support E-Mail:    support@advansys.com

     FTP Site:               ftp.advansys.com (login: anonymous)

     Web Site:               http://www.advansys.com

*/

/*

 * --- Linux Version

 */

/* Convert Linux Version, Patch-level, Sub-level to LINUX_VERSION_CODE. */

#define ASC_LINUX_VERSION(V, P, S)    (((V) * 65536) + ((P) * 256) + (S))

#ifndef LINUX_VERSION_CODE

#include <linux/version.h>

#endif /* LINUX_VERSION_CODE */

/*

 * --- Linux Include Files

 */

#include <linux/config.h>

#if LINUX_VERSION_CODE >= ASC_LINUX_VERSION(1,3,0)

#ifdef MODULE

#include <linux/module.h>

#endif /* MODULE */

#endif /* version >= v1.3.0 */

#include <linux/string.h>

#include <linux/sched.h>

#include <linux/kernel.h>

#include <linux/head.h>

#include <linux/types.h>

#include <linux/ioport.h>

#include <linux/delay.h>

#include <linux/malloc.h>

#include <linux/mm.h>

#if LINUX_VERSION_CODE >= ASC_LINUX_VERSION(1,3,0)

#include <linux/proc_fs.h>

#endif /* version >= v1.3.0 */

#if LINUX_VERSION_CODE >= ASC_LINUX_VERSION(2,1,23)

#include <linux/init.h>

#endif /* version >= v2.1.23 */

#include <asm/io.h>

#include <asm/system.h>

#include <asm/dma.h>

#if LINUX_VERSION_CODE < ASC_LINUX_VERSION(1,3,0)

#include "../block/blk.h"

#else /* version >= v1.3.0 */

#include <linux/blk.h>

#include <linux/stat.h>

#endif /* version >= v1.3.0 */

#if LINUX_VERSION_CODE >= ASC_LINUX_VERSION(2,1,95)

#include <asm/spinlock.h>

#endif /* version >= 2.1.95 */

#include "scsi.h"

#include "hosts.h"

#include "sd.h"

#include "advansys.h"

#if LINUX_VERSION_CODE >= ASC_LINUX_VERSION(2,1,93)

#ifdef CONFIG_PCI

#include <linux/pci.h>

#endif /* CONFIG_PCI */

#else /* version < v2.1.93 */

/*

 * For earlier than v2.1.93 the driver has its own PCI configuration.

 * If PCI is not needed in a kernel before v2.1.93 this define can be

 * turned-off to make the driver object smaller.

 */

#define ASC_CONFIG_PCI

#endif /* version < v2.1.93 */

/*

 * If Linux eventually defines a DID_UNDERRUN, the constant here can be

 * removed. The current value of zero for DID_UNDERRUN results in underrun

 * conditions being ignored.

 */

#define DID_UNDERRUN 0

/*

 * --- Driver Options

 */

/* Enable driver assertions. */

#define ADVANSYS_ASSERT

/* Enable driver tracing. */

/* #define ADVANSYS_DEBUG */

/*

 * Because of no /proc to display them, statistics are disabled

 * for versions prior to v1.3.0.

 */

#if LINUX_VERSION_CODE < ASC_LINUX_VERSION(1,3,0)

#undef ADVANSYS_STATS /* Disable statistics */

#else /* version >= v1.3.0 */

#define ADVANSYS_STATS /* Enable statistics. */

#endif /* version >= v1.3.0 */

/*

 * --- Debugging Header

 */

#ifdef ADVANSYS_DEBUG

#define STATIC

#else /* ADVANSYS_DEBUG */

#define STATIC static

#endif /* ADVANSYS_DEBUG */

/*

 * --- Asc Library Constants and Macros

 */

#define ASC_LIB_VERSION_MAJOR  1

#define ASC_LIB_VERSION_MINOR  22

#define ASC_LIB_SERIAL_NUMBER  113

typedef unsigned char uchar;

#ifndef NULL

#define NULL     (0)

#endif

#ifndef TRUE

#define TRUE     (1)

#endif

#ifndef FALSE

#define FALSE    (0)

#endif

#define  REG     register

#define rchar    REG __s8

#define rshort   REG __s16

#define rint     REG __s32

#define rlong    REG __s32

#define ruchar   REG __u8

#define rushort  REG __u16

#define ruint    REG __u32

#define rulong   REG __u32

#define NULLPTR  (void *)0

#define FNULLPTR (void *)0UL

#define EOF      (-1)

#define EOS      '\0'

#define ERR      (-1)

#define UB_ERR   (uchar)(0xFF)

#define UW_ERR   (uint)(0xFFFF)

#define UL_ERR   (ulong)(0xFFFFFFFFUL)

#define iseven_word(val)  ((((uint)val) & (uint)0x0001) == 0)

#define isodd_word(val)   ((((uint)val) & (uint)0x0001) != 0)

#define toeven_word(val)  (((uint)val) & (uint)0xFFFE)

#define biton(val, bits)   (((uint)(val >> bits) & (uint)0x0001) != 0)

#define bitoff(val, bits)  (((uint)(val >> bits) & (uint)0x0001) == 0)

#define lbiton(val, bits)  (((ulong)(val >> bits) & (ulong)0x00000001UL) != 0)

#define lbitoff(val, bits) (((ulong)(val >> bits) & (ulong)0x00000001UL) == 0)

#define  absh(val)    ((val) < 0 ? -(val) : (val))

#define  swapbyte(ch)  ((((ch) << 4) | ((ch) >> 4)))

#ifndef GBYTE

#define GBYTE       (0x40000000UL)

#endif

#ifndef MBYTE

#define MBYTE       (0x100000UL)

#endif

#ifndef KBYTE

#define KBYTE       (0x400)

#endif

#define HI_BYTE(x) (*((__u8 *)(&x)+1))

#define LO_BYTE(x) (*((__u8 *)&x))

#define HI_WORD(x) (*((__u16 *)(&x)+1))

#define LO_WORD(x) (*((__u16 *)&x))

#ifndef MAKEWORD

#define MAKEWORD(lo, hi)    ((__u16) (((__u16) lo) | ((__u16) hi << 8)))

#endif

#ifndef MAKELONG

#define MAKELONG(lo, hi)    ((__u32) (((__u32) lo) | ((__u32) hi << 16)))

#endif

#define SwapWords(dWord)        ((__u32) ((dWord >> 16) | (dWord << 16)))

#define SwapBytes(word)         ((__u16) ((word >> 8) | (word << 8)))

#define BigToLittle(dWord) ((__u32) (SwapWords(MAKELONG(SwapBytes(LO_WORD(dWord)), SwapBytes(HI_WORD(dWord))))))

#define LittleToBig(dWord)      BigToLittle(dWord)

#define AscPCIConfigVendorIDRegister      0x0000

#define AscPCIConfigDeviceIDRegister      0x0002

#define AscPCIConfigCommandRegister       0x0004

#define AscPCIConfigStatusRegister        0x0006

#define AscPCIConfigRevisionIDRegister    0x0008

#define AscPCIConfigCacheSize             0x000C

#define AscPCIConfigLatencyTimer          0x000D

#define AscPCIIOBaseRegister              0x0010

#define AscPCICmdRegBits_IOMemBusMaster   0x0007

#define ASC_PCI_ID2BUS(id)    ((id) & 0xFF)

#define ASC_PCI_ID2DEV(id)    (((id) >> 11) & 0x1F)

#define ASC_PCI_ID2FUNC(id)   (((id) >> 8) & 0x7)

#define ASC_PCI_MKID(bus, dev, func) ((((dev) & 0x1F) << 11) | (((func) & 0x7) << 8) | ((bus) & 0xFF))

#define ASC_PCI_VENDORID                  0x10CD

#define ASC_PCI_DEVICEID_1200A            0x1100

#define ASC_PCI_DEVICEID_1200B            0x1200

#define ASC_PCI_DEVICEID_ULTRA            0x1300 

#define ASC_PCI_REVISION_3150             0x02

#define ASC_PCI_REVISION_3050             0x03

#define  ASC_DVCLIB_CALL_DONE     (1)

#define  ASC_DVCLIB_CALL_FAILED   (0)

#define  ASC_DVCLIB_CALL_ERROR    (-1)

#define PortAddr            unsigned short    /* port address size  */

#define Ptr2Func            ulong

#define inp(port)           inb(port)

#define inpw(port)          inw(port)

#define inpl(port)          inl(port)

#define outp(port, byte)    outb((byte), (port))

#define outpw(port, word)   outw((word), (port))

#define outpl(port, long)   outl((long), (port))

#define ASC_MAX_SG_QUEUE    7

#define ASC_MAX_SG_LIST     SG_ALL

#define ASC_CS_TYPE  unsigned short

#ifndef asc_ptr_type

#define asc_ptr_type

#endif

#ifndef ASC_GET_PTR2FUNC

#define ASC_GET_PTR2FUNC(fun)  (Ptr2Func)(fun)

#endif

#define FLIP_BYTE_NIBBLE(x)    (((x<<4)& 0xFF) | (x>>4))

#define ASC_IS_ISA          (0x0001)

#define ASC_IS_ISAPNP       (0x0081)

#define ASC_IS_EISA         (0x0002)

#define ASC_IS_PCI          (0x0004)

#define ASC_IS_PCI_ULTRA    (0x0104)

#define ASC_IS_PCMCIA       (0x0008)

#define ASC_IS_MCA          (0x0020)

#define ASC_IS_VL           (0x0040)

#define ASC_ISA_PNP_PORT_ADDR  (0x279)

#define ASC_ISA_PNP_PORT_WRITE (ASC_ISA_PNP_PORT_ADDR+0x800)

#define ASC_IS_WIDESCSI_16  (0x0100)

#define ASC_IS_WIDESCSI_32  (0x0200)

#define ASC_IS_BIG_ENDIAN   (0x8000)

#define ASC_CHIP_MIN_VER_VL      (0x01)

#define ASC_CHIP_MAX_VER_VL      (0x07)

#define ASC_CHIP_MIN_VER_PCI     (0x09)

#define ASC_CHIP_MAX_VER_PCI     (0x0F)

#define ASC_CHIP_VER_PCI_BIT     (0x08)

#define ASC_CHIP_MIN_VER_ISA     (0x11)

#define ASC_CHIP_MIN_VER_ISA_PNP (0x21)

#define ASC_CHIP_MAX_VER_ISA     (0x27)

#define ASC_CHIP_VER_ISA_BIT     (0x30)

#define ASC_CHIP_VER_ISAPNP_BIT  (0x20)

#define ASC_CHIP_VER_ASYN_BUG    (0x21)

#define ASC_CHIP_VER_PCI             0x08

#define ASC_CHIP_VER_PCI_ULTRA_3150  (ASC_CHIP_VER_PCI | 0x02)

#define ASC_CHIP_VER_PCI_ULTRA_3050  (ASC_CHIP_VER_PCI | 0x03)

#define ASC_CHIP_MIN_VER_EISA (0x41)

#define ASC_CHIP_MAX_VER_EISA (0x47)

#define ASC_CHIP_VER_EISA_BIT (0x40)

#define ASC_CHIP_LATEST_VER_EISA   ((ASC_CHIP_MIN_VER_EISA - 1) + 3)

#define ASC_MAX_LIB_SUPPORTED_ISA_CHIP_VER   0x21

#define ASC_MAX_LIB_SUPPORTED_PCI_CHIP_VER   0x0A

#define ASC_MAX_VL_DMA_ADDR     (0x07FFFFFFL)

#define ASC_MAX_VL_DMA_COUNT    (0x07FFFFFFL)

#define ASC_MAX_PCI_DMA_ADDR    (0xFFFFFFFFL)

#define ASC_MAX_PCI_DMA_COUNT   (0xFFFFFFFFL)

#define ASC_MAX_ISA_DMA_ADDR    (0x00FFFFFFL)

#define ASC_MAX_ISA_DMA_COUNT   (0x00FFFFFFL)

#define ASC_MAX_EISA_DMA_ADDR   (0x07FFFFFFL)

#define ASC_MAX_EISA_DMA_COUNT  (0x07FFFFFFL)

#ifndef inpw_noswap

#define inpw_noswap(port)         inpw(port)

#endif

#ifndef outpw_noswap

#define outpw_noswap(port, data)  outpw(port, data)

#endif

#define ASC_SCSI_ID_BITS  3

#define ASC_SCSI_TIX_TYPE     uchar

#define ASC_ALL_DEVICE_BIT_SET  0xFF

#ifdef ASC_WIDESCSI_16