aic7880lib.html

vxworks相关论文

    return (OK);
    }
</pre>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>, <b><a href="./scsiLib.html#top">scsiLib</a></b>, <b><a href="./scsi2Lib.html#top">scsi2Lib</a></b>, <b><a href="./cacheLib.html#top">cacheLib</a></b>,  
<i>AIC-7880 Design In Handbook, </i>
<i>AIC-7880 Data Book, </i>
<i>Adaptec Hardware Interface Module (HIM) Specification, </i>
<i>VxWorks Programmer's Guide: I/O System</i>

<hr>
<a name="aic7880CtrlCreate"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880CtrlCreate</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880CtrlCreate</i>(&nbsp;)</strong> - create a control structure for the AIC 7880</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>AIC_7880_SCSI_CTRL * aic7880CtrlCreate
    (
    int busNo,    /* PCI bus Number */
    int devNo,    /* PCI device Number */
    int scsiBusId /* SCSI Host Adapter Bus Id */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine creates an <b>AIC_7880_SCSI_CTRL</b> structure and must be called 
before using the SCSI Host Adapter chip. It must be called exactly once for 
a specified Host Adapter. 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the <b>AIC_7880_SCSI_CTRL</b> structure, or NULL if memory
is unavailable or there are invalid parameters.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880ScbCompleted"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880ScbCompleted</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880ScbCompleted</i>(&nbsp;)</strong> - successfully completed execution of a client thread</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VOID aic7880ScbCompleted
    (
    sp_struct * pScb /* ptr to completed SCSI Command Block */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine is called from within the context of the ISR. The HIM calls
this routine passing in the pointer of the of the completed SCB. This
routine sets the thread status, handles the completed SCB and returns
program control back to the HIM which then returns from the PH_IntHandler 
routine.
<p>
This routine could be called more than once from the same PH_IntHandler
call. Each call to this routine indicates the completion of an SCB. For
each SCB completed, this routine sets the event type and calls the 
appropriate AIC-7880 event handler routines which sets the SCSI Controller,
SCSI Physical Device and SCSI Thread, state variables appropriately.
This routine also handles synchronization with the SCSI Manager so that
the next runnable thread can be scheduled for execution.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880EnableFast20"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880EnableFast20</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880EnableFast20</i>(&nbsp;)</strong> - enable double speed SCSI data transfers</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VOID aic7880EnableFast20
    (
    SCSI_CTRL * pScsiCtrl, /* ptr to SCSI controller */
    BOOL        enable     /* enable = 1 / disable = 0 */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine enables double speed SCSI data transfers for the SCSI host
adapter. This allows the host adapter to transfer data upto 20 MB/s for
an 8 bit device and upto 40 MB/s for a 16 bit device.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880dFifoThresholdSet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880dFifoThresholdSet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880dFifoThresholdSet</i>(&nbsp;)</strong> - set the data FIFO threshold.</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS aic7880dFifoThresholdSet
    (
    SCSI_CTRL * pScsiCtrl, /* ptr to SCSI controller */
    UBYTE       threshHold /* data FIFO threshold value */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine specifies to the AIC-7880 host adapter how to manage its
data FIFO. Below is a description of the threshold  values for SCSI
reads and writes.
<p>
</blockquote><h4>SCSI READS</h4><blockquote><p>
<ul>
<li>  0 Xfer data from FIFO as soon as it is available.</li>
<li>  1 Xfer data from FIFO as soon as the FIFO is half full.</li>
<li>  2 Xfer data from FIFO as soon as the FIFO is 75%  full.</li>
<li>   3 Xfer data from FIFO as soon as the FIFO is 100% full.
</ul>

<p>
</blockquote><h4>SCSI WRITES</h4><blockquote><p>
<p>
* .iP
0 Xfer data as soon as there is room in the FIFO.
<ul>
<li>  1 Xfer data to FIFO as soon as it is 50% empty. </li>
<li>  2 Xfer data to FIFO as soon as it is 75% empty.</li>
<li>   3 Xfer data to FIFO as soon as the FIFO is empty.
</ul>

<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
&nbsp;OK&nbsp;or&nbsp;ERROR&nbsp;if&nbsp;the&nbsp;threshold&nbsp;value&nbsp;is&nbsp;not&nbsp;within&nbsp;the&nbsp;valid&nbsp;range.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880GetNumOfBuses"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880GetNumOfBuses</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880GetNumOfBuses</i>(&nbsp;)</strong> - perform a PCI bus scan</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>

DWORD aic7880GetNumOfBuses ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides a callback mechanism from the HIM to the OSM
It allows the OSM to scan the PCI bus, before the HIM is allowed 
to perform the bus scan.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
0x55555555 if the OSM is not able to conduct its own bus scan
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880ReadConfig"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880ReadConfig</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880ReadConfig</i>(&nbsp;)</strong> - read from PCI config space</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>DWORD aic7880ReadConfig
    (
    cfp_struct * configPtr, /* ptr to cf_struct */
    UBYTE        busNo,     /* PCI bus number */
    UBYTE        devNo,     /* PCI device number */
    UBYTE        regNo      /* register */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides a callback mechanism from the HIM to the OSM.
The purpose of this routine is to allow the OSM to do its own Read
access of the PCI configuration space. If the OSM cannot successfully
complete the Read access, the OSM returns 0x55555555. If this happens
the HIM attempts to conduct the configuration space Read access.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
value read or 0x55555555, if the OSM is not able to conduct 
read access to the PCI configuration space.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

<hr>
<a name="aic7880WriteConfig"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>aic7880WriteConfig</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>aic7880WriteConfig</i>(&nbsp;)</strong> - read to PCI config space</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>DWORD aic7880WriteConfig
    (
    cfp_struct * config_ptr, /* ptr to cf_struct */
    UBYTE        busNo,      /* PCI bus number */
    UBYTE        devNo,      /* PCI device number */
    UBYTE        regNo,      /* register */
    DWORD        regVal      /* register value */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides a callback mechanism from the HIM to the OSM.
The purpose of this routine is to allow the OSM to do its own write
access of the PCI configuration space. If the OSM cannot successfully
complete the write access, the OSM returns 0x55555555. If this happens
the HIM attempts to conduct the configuration space write access.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or 0x55555555, if the OSM is not able to conduct write access 
to the PCI configuration space.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./aic7880Lib.html#top">aic7880Lib</a></b>

</body>
</html>