<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Adaptec AHA-1520/1522 SCSI driver for Linux (aha152x) — The Linux Kernel documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=3918102e" />
<script src="../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../_static/doctools.js?v=9bcbadda"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Adaptec Ultra320 Family Manager Set" href="aic79xx.html" />
<link rel="prev" title="AdvanSys Driver Notes" href="advansys.html" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
</head><body>
<div class="document">
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/logo.svg" alt="Logo of The Linux Kernel"/>
</a></p>
<h1 class="logo"><a href="../index.html">The Linux Kernel</a></h1>
<p class="blurb">6.18.50</p>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<p>
<h3 class="kernel-toc-contents">Contents</h3>
<input type="checkbox" class="kernel-toc-toggle" id = "kernel-toc-toggle" checked>
<label class="kernel-toc-title" for="kernel-toc-toggle"></label>
<div class="kerneltoc" id="kerneltoc">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/development-process.html">Development process</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/submitting-patches.html">Submitting patches</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/code-of-conduct.html">Code of conduct</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintainer/index.html">Maintainer handbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="../process/index.html">All development-process docs</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../core-api/index.html">Core API</a></li>
<li class="toctree-l1"><a class="reference internal" href="../driver-api/index.html">Driver APIs</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../subsystem-apis.html">Subsystems</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#core-subsystems">Core subsystems</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#human-interfaces">Human interfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#networking-interfaces">Networking interfaces</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../subsystem-apis.html#storage-interfaces">Storage interfaces</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../filesystems/index.html">Filesystems in the Linux kernel</a></li>
<li class="toctree-l3"><a class="reference internal" href="../block/index.html">Block</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cdrom/index.html">CD-ROM</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="index.html">SCSI Subsystem</a></li>
<li class="toctree-l3"><a class="reference internal" href="../target/index.html">TCM Virtual Device</a></li>
<li class="toctree-l3"><a class="reference internal" href="../nvme/index.html">NVMe Subsystem</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../subsystem-apis.html#other-subsystems">Other subsystems</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../locking/index.html">Locking</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../process/license-rules.html">Licensing rules</a></li>
<li class="toctree-l1"><a class="reference internal" href="../doc-guide/index.html">Writing documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/index.html">Development tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev-tools/testing-overview.html">Testing guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kernel-hacking/index.html">Hacking guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../trace/index.html">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../fault-injection/index.html">Fault injection</a></li>
<li class="toctree-l1"><a class="reference internal" href="../livepatch/index.html">Livepatching</a></li>
<li class="toctree-l1"><a class="reference internal" href="../rust/index.html">Rust</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/index.html">Administration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../kbuild/index.html">Build system</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin-guide/reporting-issues.html">Reporting issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">Userspace tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../userspace-api/index.html">Userspace API</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../firmware-guide/index.html">Firmware</a></li>
<li class="toctree-l1"><a class="reference internal" href="../devicetree/index.html">Firmware and Devicetree</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../arch/index.html">CPU architectures</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../staging/index.html">Unsorted documentation</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../translations/index.html">Translations</a></li>
</ul>
</div>
<script type="text/javascript"> <!--
var sbar = document.getElementsByClassName("sphinxsidebar")[0];
let currents = document.getElementsByClassName("current")
if (currents.length) {
sbar.scrollTop = currents[currents.length - 1].offsetTop;
}
--> </script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/scsi/aha152x.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="adaptec-aha-1520-1522-scsi-driver-for-linux-aha152x">
<h1>Adaptec AHA-1520/1522 SCSI driver for Linux (aha152x)<a class="headerlink" href="#adaptec-aha-1520-1522-scsi-driver-for-linux-aha152x" title="Link to this heading">¶</a></h1>
<p>Copyright © 1993-1999 Jürgen Fischer <<a class="reference external" href="mailto:fischer%40norbit.de">fischer<span>@</span>norbit<span>.</span>de</a>></p>
<p>TC1550 patches by Luuk van Dijk (<a class="reference external" href="mailto:ldz%40xs4all.nl">ldz<span>@</span>xs4all<span>.</span>nl</a>)</p>
<p>In Revision 2 the driver was modified a lot (especially the
bottom-half handler <code class="xref c c-func broken_xref docutils literal notranslate"><span class="pre">complete()</span></code>).</p>
<p>The driver is much cleaner now, has support for the new
error handling code in 2.3, produced less cpu load (much
less polling loops), has slightly higher throughput (at
least on my ancient test box; a i486/33Mhz/20MB).</p>
<section id="configuration-arguments">
<h2>Configuration Arguments<a class="headerlink" href="#configuration-arguments" title="Link to this heading">¶</a></h2>
<table class="docutils align-default">
<tbody>
<tr class="row-odd"><td><p>IOPORT</p></td>
<td><p>base io address</p></td>
<td><p>(0x340/0x140)</p></td>
</tr>
<tr class="row-even"><td><p>IRQ</p></td>
<td><p>interrupt level</p></td>
<td><p>(9-12; default 11)</p></td>
</tr>
<tr class="row-odd"><td><p>SCSI_ID</p></td>
<td><p>scsi id of controller</p></td>
<td><p>(0-7; default 7)</p></td>
</tr>
<tr class="row-even"><td><p>RECONNECT</p></td>
<td><p>allow targets to disconnect from the bus</p></td>
<td><p>(0/1; default 1 [on])</p></td>
</tr>
<tr class="row-odd"><td><p>PARITY</p></td>
<td><p>enable parity checking</p></td>
<td><p>(0/1; default 1 [on])</p></td>
</tr>
<tr class="row-even"><td><p>SYNCHRONOUS</p></td>
<td><p>enable synchronous transfers</p></td>
<td><p>(0/1; default 1 [on])</p></td>
</tr>
<tr class="row-odd"><td><p>DELAY:</p></td>
<td><p>bus reset delay</p></td>
<td><p>(default 100)</p></td>
</tr>
<tr class="row-even"><td><p>EXT_TRANS:</p></td>
<td><p>enable extended translation
(see NOTES)</p></td>
<td><p>(0/1: default 0 [off])</p></td>
</tr>
</tbody>
</table>
</section>
<section id="compile-time-configuration">
<h2>Compile Time Configuration<a class="headerlink" href="#compile-time-configuration" title="Link to this heading">¶</a></h2>
<p>(go into AHA152X in drivers/scsi/Makefile):</p>
<ul class="simple">
<li><dl class="simple">
<dt>DAUTOCONF</dt><dd><p>use configuration the controller reports (AHA-152x only)</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>DSKIP_BIOSTEST</dt><dd><p>Don’t test for BIOS signature (AHA-1510 or disabled BIOS)</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>DSETUP0=”{ IOPORT, IRQ, SCSI_ID, RECONNECT, PARITY, SYNCHRONOUS, DELAY, EXT_TRANS }”</dt><dd><p>override for the first controller</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>DSETUP1=”{ IOPORT, IRQ, SCSI_ID, RECONNECT, PARITY, SYNCHRONOUS, DELAY, EXT_TRANS }”</dt><dd><p>override for the second controller</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>DAHA152X_DEBUG</dt><dd><p>enable debugging output</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>DAHA152X_STAT</dt><dd><p>enable some statistics</p>
</dd>
</dl>
</li>
</ul>
</section>
<section id="lilo-command-line-options">
<h2>LILO Command Line Options<a class="headerlink" href="#lilo-command-line-options" title="Link to this heading">¶</a></h2>
<blockquote>
<div><div class="highlight-none notranslate"><div class="highlight"><pre><span></span>aha152x=<IOPORT>[,<IRQ>[,<SCSI-ID>[,<RECONNECT>[,<PARITY>[,<SYNCHRONOUS>[,<DELAY> [,<EXT_TRANS]]]]]]]
</pre></div>
</div>
<p>The normal configuration can be overridden by specifying a command line.
When you do this, the BIOS test is skipped. Entered values have to be
valid (known). Don’t use values that aren’t supported under normal
operation. If you think that you need other values: contact me.
For two controllers use the aha152x statement twice.</p>
</div></blockquote>
</section>
<section id="symbols-for-module-configuration">
<h2>Symbols for Module Configuration<a class="headerlink" href="#symbols-for-module-configuration" title="Link to this heading">¶</a></h2>
<p>Choose from 2 alternatives:</p>
<ol class="arabic">
<li><p>specify everything (old):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>aha152x=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS
</pre></div>
</div>
</li>
</ol>
<blockquote>
<div><p>configuration override for first controller</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>aha152x1=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS
</pre></div>
</div>
<p>configuration override for second controller</p>
</div></blockquote>
<ol class="arabic simple" start="2">
<li><p>specify only what you need to (irq or io is required; new)</p></li>
</ol>
<dl class="simple">
<dt>io=IOPORT0[,IOPORT1]</dt><dd><p>IOPORT for first and second controller</p>
</dd>
<dt>irq=IRQ0[,IRQ1]</dt><dd><p>IRQ for first and second controller</p>
</dd>
<dt>scsiid=SCSIID0[,SCSIID1]</dt><dd><p>SCSIID for first and second controller</p>
</dd>
<dt>reconnect=RECONNECT0[,RECONNECT1]</dt><dd><p>allow targets to disconnect for first and second controller</p>
</dd>
<dt>parity=PAR0[PAR1]</dt><dd><p>use parity for first and second controller</p>
</dd>
<dt>sync=SYNCHRONOUS0[,SYNCHRONOUS1]</dt><dd><p>enable synchronous transfers for first and second controller</p>
</dd>
<dt>delay=DELAY0[,DELAY1]</dt><dd><p>reset DELAY for first and second controller</p>
</dd>
<dt>exttrans=EXTTRANS0[,EXTTRANS1]</dt><dd><p>enable extended translation for first and second controller</p>
</dd>
</dl>
<p>If you use both alternatives the first will be taken.</p>
</section>
<section id="notes-on-ext-trans">
<h2>Notes on EXT_TRANS<a class="headerlink" href="#notes-on-ext-trans" title="Link to this heading">¶</a></h2>
<p>SCSI uses block numbers to address blocks/sectors on a device.
The BIOS uses a cylinder/head/sector addressing scheme (C/H/S)
scheme instead. DOS expects a BIOS or driver that understands this
C/H/S addressing.</p>
<p>The number of cylinders/heads/sectors is called geometry and is required
as base for requests in C/H/S addressing. SCSI only knows about the
total capacity of disks in blocks (sectors).</p>
<p>Therefore the SCSI BIOS/DOS driver has to calculate a logical/virtual
geometry just to be able to support that addressing scheme. The geometry
returned by the SCSI BIOS is a pure calculation and has nothing to
do with the real/physical geometry of the disk (which is usually
irrelevant anyway).</p>
<p>Basically this has no impact at all on Linux, because it also uses block
instead of C/H/S addressing. Unfortunately C/H/S addressing is also used
in the partition table and therefore every operating system has to know
the right geometry to be able to interpret it.</p>
<p>Moreover there are certain limitations to the C/H/S addressing scheme,
namely the address space is limited to up to 255 heads, up to 63 sectors
and a maximum of 1023 cylinders.</p>
<p>The AHA-1522 BIOS calculates the geometry by fixing the number of heads
to 64, the number of sectors to 32 and by calculating the number of
cylinders by dividing the capacity reported by the disk by 64*32 (1 MB).
This is considered to be the default translation.</p>
<p>With respect to the limit of 1023 cylinders using C/H/S you can only
address the first GB of your disk in the partition table. Therefore
BIOSes of some newer controllers based on the AIC-6260/6360 support
extended translation. This means that the BIOS uses 255 for heads,
63 for sectors and then divides the capacity of the disk by 255*63
(about 8 MB), as soon it sees a disk greater than 1 GB. That results
in a maximum of about 8 GB addressable diskspace in the partition table
(but there are already bigger disks out there today).</p>
<p>To make it even more complicated the translation mode might/might
not be configurable in certain BIOS setups.</p>
<p>This driver does some more or less failsafe guessing to get the
geometry right in most cases:</p>
<ul class="simple">
<li><p>for disks<1GB: use default translation (C/32/64)</p></li>
<li><p>for disks>1GB:</p>
<ul>
<li><p>take current geometry from the partition table
(using scsicam_bios_param and accept only ‘valid’ geometries,
ie. either (C/32/64) or (C/63/255)). This can be extended translation
even if it’s not enabled in the driver.</p></li>
<li><p>if that fails, take extended translation if enabled by override,
kernel or module parameter, otherwise take default translation and
ask the user for verification. This might on not yet partitioned
disks.</p></li>
</ul>
</li>
</ul>
</section>
<section id="references-used">
<h2>References Used<a class="headerlink" href="#references-used" title="Link to this heading">¶</a></h2>
<blockquote>
<div><p>“AIC-6260 SCSI Chip Specification”, Adaptec Corporation.</p>
<p>“SCSI COMPUTER SYSTEM INTERFACE - 2 (SCSI-2)”, X3T9.2/86-109 rev. 10h</p>
<p>“Writing a SCSI device driver for Linux”, Rik Faith (<a class="reference external" href="mailto:faith%40cs.unc.edu">faith<span>@</span>cs<span>.</span>unc<span>.</span>edu</a>)</p>
<p>“Kernel Hacker’s Guide”, Michael K. Johnson (<a class="reference external" href="mailto:johnsonm%40sunsite.unc.edu">johnsonm<span>@</span>sunsite<span>.</span>unc<span>.</span>edu</a>)</p>
<p>“Adaptec 1520/1522 User’s Guide”, Adaptec Corporation.</p>
<p>Michael K. Johnson (<a class="reference external" href="mailto:johnsonm%40sunsite.unc.edu">johnsonm<span>@</span>sunsite<span>.</span>unc<span>.</span>edu</a>)</p>
<p>Drew Eckhardt (<a class="reference external" href="mailto:drew%40cs.colorado.edu">drew<span>@</span>cs<span>.</span>colorado<span>.</span>edu</a>)</p>
<p>Eric Youngdale (<a class="reference external" href="mailto:eric%40andante.org">eric<span>@</span>andante<span>.</span>org</a>)</p>
<p>special thanks to Eric Youngdale for the free(!) supplying the
documentation on the chip.</p>
</div></blockquote>
</section>
</section>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©The kernel development community.
|
Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.1.3</a>
& <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
|
<a href="../_sources/scsi/aha152x.rst.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>