205 lines · plain
1.. SPDX-License-Identifier: GPL-2.02.. include:: <isonum.txt>3 4=====================================================5Adaptec AHA-1520/1522 SCSI driver for Linux (aha152x)6=====================================================7 8Copyright |copy| 1993-1999 Jürgen Fischer <fischer@norbit.de>9 10TC1550 patches by Luuk van Dijk (ldz@xs4all.nl)11 12 13In Revision 2 the driver was modified a lot (especially the14bottom-half handler complete()).15 16The driver is much cleaner now, has support for the new17error handling code in 2.3, produced less cpu load (much18less polling loops), has slightly higher throughput (at19least on my ancient test box; a i486/33Mhz/20MB).20 21 22Configuration Arguments23=======================24 25============ ======================================== ======================26IOPORT base io address (0x340/0x140)27IRQ interrupt level (9-12; default 11)28SCSI_ID scsi id of controller (0-7; default 7)29RECONNECT allow targets to disconnect from the bus (0/1; default 1 [on])30PARITY enable parity checking (0/1; default 1 [on])31SYNCHRONOUS enable synchronous transfers (0/1; default 1 [on])32DELAY: bus reset delay (default 100)33EXT_TRANS: enable extended translation (0/1: default 0 [off])34 (see NOTES)35============ ======================================== ======================36 37Compile Time Configuration38==========================39 40(go into AHA152X in drivers/scsi/Makefile):41 42- DAUTOCONF43 use configuration the controller reports (AHA-152x only)44 45- DSKIP_BIOSTEST46 Don't test for BIOS signature (AHA-1510 or disabled BIOS)47 48- DSETUP0="{ IOPORT, IRQ, SCSI_ID, RECONNECT, PARITY, SYNCHRONOUS, DELAY, EXT_TRANS }"49 override for the first controller50 51- DSETUP1="{ IOPORT, IRQ, SCSI_ID, RECONNECT, PARITY, SYNCHRONOUS, DELAY, EXT_TRANS }"52 override for the second controller53 54- DAHA152X_DEBUG55 enable debugging output56 57- DAHA152X_STAT58 enable some statistics59 60 61LILO Command Line Options62=========================63 64 ::65 66 aha152x=<IOPORT>[,<IRQ>[,<SCSI-ID>[,<RECONNECT>[,<PARITY>[,<SYNCHRONOUS>[,<DELAY> [,<EXT_TRANS]]]]]]]67 68 The normal configuration can be overridden by specifying a command line.69 When you do this, the BIOS test is skipped. Entered values have to be70 valid (known). Don't use values that aren't supported under normal71 operation. If you think that you need other values: contact me.72 For two controllers use the aha152x statement twice.73 74 75Symbols for Module Configuration76================================77 78Choose from 2 alternatives:79 801. specify everything (old)::81 82 aha152x=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS83 84 configuration override for first controller85 86 ::87 88 aha152x1=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS89 90 configuration override for second controller91 922. specify only what you need to (irq or io is required; new)93 94io=IOPORT0[,IOPORT1]95 IOPORT for first and second controller96 97irq=IRQ0[,IRQ1]98 IRQ for first and second controller99 100scsiid=SCSIID0[,SCSIID1]101 SCSIID for first and second controller102 103reconnect=RECONNECT0[,RECONNECT1]104 allow targets to disconnect for first and second controller105 106parity=PAR0[PAR1]107 use parity for first and second controller108 109sync=SYNCHRONOUS0[,SYNCHRONOUS1]110 enable synchronous transfers for first and second controller111 112delay=DELAY0[,DELAY1]113 reset DELAY for first and second controller114 115exttrans=EXTTRANS0[,EXTTRANS1]116 enable extended translation for first and second controller117 118 119If you use both alternatives the first will be taken.120 121 122Notes on EXT_TRANS123==================124 125SCSI uses block numbers to address blocks/sectors on a device.126The BIOS uses a cylinder/head/sector addressing scheme (C/H/S)127scheme instead. DOS expects a BIOS or driver that understands this128C/H/S addressing.129 130The number of cylinders/heads/sectors is called geometry and is required131as base for requests in C/H/S addressing. SCSI only knows about the132total capacity of disks in blocks (sectors).133 134Therefore the SCSI BIOS/DOS driver has to calculate a logical/virtual135geometry just to be able to support that addressing scheme. The geometry136returned by the SCSI BIOS is a pure calculation and has nothing to137do with the real/physical geometry of the disk (which is usually138irrelevant anyway).139 140Basically this has no impact at all on Linux, because it also uses block141instead of C/H/S addressing. Unfortunately C/H/S addressing is also used142in the partition table and therefore every operating system has to know143the right geometry to be able to interpret it.144 145Moreover there are certain limitations to the C/H/S addressing scheme,146namely the address space is limited to up to 255 heads, up to 63 sectors147and a maximum of 1023 cylinders.148 149The AHA-1522 BIOS calculates the geometry by fixing the number of heads150to 64, the number of sectors to 32 and by calculating the number of151cylinders by dividing the capacity reported by the disk by 64*32 (1 MB).152This is considered to be the default translation.153 154With respect to the limit of 1023 cylinders using C/H/S you can only155address the first GB of your disk in the partition table. Therefore156BIOSes of some newer controllers based on the AIC-6260/6360 support157extended translation. This means that the BIOS uses 255 for heads,15863 for sectors and then divides the capacity of the disk by 255*63159(about 8 MB), as soon it sees a disk greater than 1 GB. That results160in a maximum of about 8 GB addressable diskspace in the partition table161(but there are already bigger disks out there today).162 163To make it even more complicated the translation mode might/might164not be configurable in certain BIOS setups.165 166This driver does some more or less failsafe guessing to get the167geometry right in most cases:168 169- for disks<1GB: use default translation (C/32/64)170 171- for disks>1GB:172 173 - take current geometry from the partition table174 (using scsicam_bios_param and accept only 'valid' geometries,175 ie. either (C/32/64) or (C/63/255)). This can be extended translation176 even if it's not enabled in the driver.177 178 - if that fails, take extended translation if enabled by override,179 kernel or module parameter, otherwise take default translation and180 ask the user for verification. This might on not yet partitioned181 disks.182 183 184References Used185===============186 187 "AIC-6260 SCSI Chip Specification", Adaptec Corporation.188 189 "SCSI COMPUTER SYSTEM INTERFACE - 2 (SCSI-2)", X3T9.2/86-109 rev. 10h190 191 "Writing a SCSI device driver for Linux", Rik Faith (faith@cs.unc.edu)192 193 "Kernel Hacker's Guide", Michael K. Johnson (johnsonm@sunsite.unc.edu)194 195 "Adaptec 1520/1522 User's Guide", Adaptec Corporation.196 197 Michael K. Johnson (johnsonm@sunsite.unc.edu)198 199 Drew Eckhardt (drew@cs.colorado.edu)200 201 Eric Youngdale (eric@andante.org)202 203 special thanks to Eric Youngdale for the free(!) supplying the204 documentation on the chip.205