syslib.html

vxworks相关论文

<p align=right>
<a href="rtnIndex.html"><i>ns486 :  Routines</i></a></p>

</blockquote><h1><i>sysSerialHwInit2</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysSerialHwInit2</i>(&nbsp;)</strong> - connect BSP serial device interrupts</p>

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

void sysSerialHwInit2 (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine connects the BSP serial device interrupts.  It is called from
<b><i><a href="./sysLib.html#sysHwInit2">sysHwInit2</a></i>(&nbsp;)</b>.  
<p>
Serial device interrupts cannot be connected in <b><i><a href="./sysLib.html#sysSerialHwInit">sysSerialHwInit</a></i>(&nbsp;)</b> because
the kernel memory allocator is not initialized at that point, and
<b><i><a href="../../ref/intArchLib.html#intConnect" >intConnect</a></i>(&nbsp;)</b> calls <b><i><a href="../../ref/memPartLib.html#malloc" >malloc</a></i>(&nbsp;)</b>.
<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><i><a href="./sysLib.html#sysHwInit2">sysHwInit2</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>sysSerialChanGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysSerialChanGet</i>(&nbsp;)</strong> - get the <b>SIO_CHAN</b> device associated with a serial channel</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>SIO_CHAN * sysSerialChanGet
    (
    int channel
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine gets the <b>SIO_CHAN</b> device associated with a specified serial
channel.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the <b>SIO_CHAN</b> structure for the channel, or ERROR
if the channel is invalid.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysModel</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysModel</i>(&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>RETURNS</h4><blockquote><p>
A pointer to the string "NS486".
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysBspRev</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysBspRev</i>(&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.1/0. <b>BSP_REV</b> is concatenated to <b>BSP_VERSION</b> and returned.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the BSP version/revision string.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysHwInit</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysHwInit</i>(&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 NS486 board.
It is called from <b><i><a href="../../ref/usrConfig.html#usrInit" >usrInit</a></i>(&nbsp;)</b> in <b>usrConfig.c</b>.
<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
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysHwInit2</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysHwInit2</i>(&nbsp;)</strong> - additional system configuration and initialization</p>

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

void sysHwInit2 (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine connects system interrupts and does any additional
configuration necessary.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysPhysMemTop</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysPhysMemTop</i>(&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>
Memory probing begins at the end of BSS; at every 4K boundary a byte
is read until it finds one that cannot be read, or
4 Mbytes have been probed, whichever is first.
<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>

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

</blockquote><h1><i>sysMemTop</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysMemTop</i>(&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 first unusable byte of memory.
VxWorks will not use any memory at or above this address.
<p>
The user can reserve local memory from the board by declaring the
macro <b>USER_RESERVED_MEM</b> with the amount of memory to reserve. This
routine will return a pointer to the first byte of the reserved memory
area.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the top of usable memory.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

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

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine transfers control to the ROM monitor.  It is usually called
only by <b><i><a href="../../../tornado/tools/windsh.html#reboot" >reboot</a></i>(&nbsp;)</b> -- which services ^X -- and by bus errors at interrupt
level.  However, in some circumstances, the user may wish to introduce a
new <i>startType</i> to enable special boot ROM facilities.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Does not return.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysIntDisable</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysIntDisable</i>(&nbsp;)</strong> - disable a bus interrupt level</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS sysIntDisable
    (
    int intLevel /* interrupt level to disable */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine disables a specified bus interrupt level.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
ERROR, always.
<p>
</blockquote><h4>ARGSUSED0</h4><blockquote><p>
SEE ALSO
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysIntEnable</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysIntEnable</i>(&nbsp;)</strong> - enable a bus interrupt level</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS sysIntEnable
    (
    int intLevel /* interrupt level to enable */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine enables a specified bus interrupt level.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
ERROR, always.
<p>
</blockquote><h4>ARGSUSED0</h4><blockquote><p>
SEE ALSO
<b><a href="./sysLib.html#top">sysLib</a></b>

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

</blockquote><h1><i>sysProcNumGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysProcNumGet</i>(&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><i><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a></i>(&nbsp;)</b>.
<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><i><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>sysProcNumSet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysProcNumSet</i>(&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>
Set the processor number for the CPU board.  Processor numbers should be
unique on a single backplane.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
By convention, only Processor 0 should dual-port its memory.
<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><i><a href="./sysLib.html#sysProcNumGet">sysProcNumGet</a></i>(&nbsp;)</b>

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

</blockquote><h1><i>sysDelay</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>sysDelay</i>(&nbsp;)</strong> - allow recovery time for port accesses</p>

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

void sysDelay (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides a brief delay used between accesses to the same serial
port chip.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./sysLib.html#top">sysLib</a></b>

</body>
</html>