syslib.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysModel(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysModel(&nbsp;)</strong> - return the model name of the CPU board</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char *sysModel (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the model name of the CPU board.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to a string containing the board name.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysBspRev"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysBspRev(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysBspRev(&nbsp;)</strong> - return the BSP version and revision number</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * sysBspRev (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a pointer to a BSP version and revision number,
for example, 1.0/1.  <b>BSP_REV</b> is concatenated to
<b>BSP_VERSION</b> and returned.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the BSP version/revision string.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysHwInit"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysHwInit(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysHwInit(&nbsp;)</strong> - initialize the system hardware</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void sysHwInit (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine initializes various features of the board.
It is called from <b><a href="./usrConfig.html#usrInit">usrInit</a>(&nbsp;)</b> in <b>usrConfig.c</b>.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
This routine should not be called directly by the user application.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysPhysMemTop"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysPhysMemTop(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysPhysMemTop(&nbsp;)</strong> - get the address of the top of memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * sysPhysMemTop (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the address of the first missing byte of memory,
which indicates the top of memory.
<p>
Normally, the amount of physical memory is specified with the
macro <b>LOCAL_MEM_SIZE</b>.  BSPs that support run-time
memory sizing do so only if the macro <b>LOCAL_MEM_AUTOSIZE</b> is defined.
If not defined, then <b>LOCAL_MEM_SIZE</b> is assumed to be, and must be, the
true size of physical memory.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
Do no adjust <b>LOCAL_MEM_SIZE</b> to reserve memory for application
use.  See <b><a href="./sysLib.html#sysMemTop">sysMemTop</a>(&nbsp;)</b> for more information on reserving memory.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the top of physical memory.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, <b><a href="./sysLib.html#sysMemTop">sysMemTop</a>(&nbsp;)</b>,  
and BSP-specific reference pages for this routine.

<hr>
<a name="sysMemTop"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysMemTop(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysMemTop(&nbsp;)</strong> - get the address of the top of logical memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char *sysMemTop (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the address of the top of memory.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the top of memory.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysToMonitor"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysToMonitor(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysToMonitor(&nbsp;)</strong> - transfer control to the ROM monitor</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS sysToMonitor
    (
    int startType             /* parameter passed to ROM to tell it how */
                              /* to boot */ 
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine transfers control to the ROM monitor.  Normally, it is called
only by <b><a href="./rebootLib.html#reboot">reboot</a>(&nbsp;)</b>--which services ^X--and by bus errors at interrupt level.
However, in some circumstances, the user may wish to introduce a
<i>startType</i> to enable special boot ROM facilities.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Does not return.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysProcNumGet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysProcNumGet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysProcNumGet(&nbsp;)</strong> - get the processor number</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int sysProcNumGet (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the processor number for the CPU board, which is
set with <b><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a>(&nbsp;)</b>.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The processor number for the CPU board.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, <b><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a>(&nbsp;)</b>,  
and BSP-specific reference pages for this routine.

<hr>
<a name="sysProcNumSet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysProcNumSet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysProcNumSet(&nbsp;)</strong> - set the processor number</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void sysProcNumSet
    (
    int procNum               /* processor number */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sets the processor number for the CPU board.  Processor numbers
should be unique on a single backplane.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, <b><a href="./sysLib.html#sysProcNumGet">sysProcNumGet</a>(&nbsp;)</b>,  
and BSP-specific reference pages for this routine.

<hr>
<a name="sysBusTas"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysBusTas(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysBusTas(&nbsp;)</strong> - test and set a location across the bus</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>BOOL sysBusTas
    (
    char * adrs               /* address to be tested and set */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine performs a test-and-set instruction across the backplane.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
This routine is equivalent to <b><a href="./vxLib.html#vxTas">vxTas</a>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
TRUE if the value had not been set but is now, or FALSE if the
value was set already.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, <b><a href="./vxLib.html#vxTas">vxTas</a>(&nbsp;)</b>,  
and BSP-specific reference pages for this routine.

<hr>
<a name="sysScsiBusReset"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysScsiBusReset(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysScsiBusReset(&nbsp;)</strong> - assert the RST line on the SCSI bus (Western Digital WD33C93 only)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void sysScsiBusReset
    (
    WD_33C93_SCSI_CTRL * pSbic /* ptr to SBIC info */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine asserts the RST line on the SCSI bus, which causes all
connected devices to return to a quiescent state.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>, and BSP-specific reference pages for this routine.

<hr>
<a name="sysScsiInit"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sysScsiInit(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sysScsiInit(&nbsp;)</strong> - initialize an on-board SCSI port</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS sysScsiInit (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine creates and initializes a SCSI control structure, enabling
use of the on-board SCSI port.  It also connects the proper interrupt
service routine to the desired vector, and enables the interrupt at the
desired level.
<p>
If SCSI DMA is supported by the board and <b>INCLUDE_SCSI_DMA</b> is defined,
the DMA is also initialized.
<p>
</blockquote><h4>NOTE </h4><blockquote><p>
This is a generic page for a BSP-specific routine; this
description  contains general information only. To determine if this
routine is supported by your BSP, or for information specific to your
BSP's version of this routine, see the reference pages for your BSP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the control structure cannot be connected, the
controller cannot be initialized, or the DMA's interrupt cannot be connected.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>