📄 syslib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/bsp/ns486/sysLib.html - generated by refgen from sysLib.i --> <title> sysLib [ns486] </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>BSP Reference : ns486</i></a></p></blockquote><h1>sysLib [ns486]</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysLib [ns486]</strong> - NS486 system-dependent library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><i><a href="./sysLib.html#sysIntDisablePIC">sysIntDisablePIC</a></i>( )</b> - disable a PIC interrupt level<br><b><i><a href="./sysLib.html#sysIntEnablePIC">sysIntEnablePIC</a></i>( )</b> - enable a PIC interrupt level<br><b><i><a href="./sysLib.html#sysIntLevel">sysIntLevel</a></i>( )</b> - Get interrupt level by reading Interrupt Service Register.<br><b><i><a href="./sysLib.html#sysIntLock">sysIntLock</a></i>( )</b> - lock out all PIC interrupts<br><b><i><a href="./sysLib.html#sysIntUnlock">sysIntUnlock</a></i>( )</b> - unlock the PIC interrupts<br><b><i><a href="./sysLib.html#sysClkConnect">sysClkConnect</a></i>( )</b> - connect a routine to the system clock interrupt<br><b><i><a href="./sysLib.html#sysClkDisable">sysClkDisable</a></i>( )</b> - turn off system clock interrupts<br><b><i><a href="./sysLib.html#sysClkEnable">sysClkEnable</a></i>( )</b> - turn on system clock interrupts<br><b><i><a href="./sysLib.html#sysClkRateGet">sysClkRateGet</a></i>( )</b> - get the system clock rate<br><b><i><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a></i>( )</b> - set the system clock rate<br><b><i><a href="./sysLib.html#sysAuxClkConnect">sysAuxClkConnect</a></i>( )</b> - connect a routine to the auxiliary clock interrupt<br><b><i><a href="./sysLib.html#sysAuxClkDisable">sysAuxClkDisable</a></i>( )</b> - turn off auxiliary clock interrupts<br><b><i><a href="./sysLib.html#sysAuxClkEnable">sysAuxClkEnable</a></i>( )</b> - turn on auxiliary clock interrupts<br><b><i><a href="./sysLib.html#sysAuxClkRateGet">sysAuxClkRateGet</a></i>( )</b> - get the auxiliary clock rate<br><b><i><a href="./sysLib.html#sysAuxClkRateSet">sysAuxClkRateSet</a></i>( )</b> - set the auxiliary clock rate<br><b><i><a href="./sysLib.html#sysNvRamGet">sysNvRamGet</a></i>( )</b> - get the contents of non-volatile RAM<br><b><i><a href="./sysLib.html#sysNvRamSet">sysNvRamSet</a></i>( )</b> - write to non-volatile RAM<br><b><i><a href="./sysLib.html#sysLocalToBusAdrs">sysLocalToBusAdrs</a></i>( )</b> - convert a local address to a bus address<br><b><i><a href="./sysLib.html#sysBusToLocalAdrs">sysBusToLocalAdrs</a></i>( )</b> - convert a bus address to a local address<br><b><i><a href="./sysLib.html#sysBusIntAck">sysBusIntAck</a></i>( )</b> - acknowledge a bus interrupt<br><b><i><a href="./sysLib.html#sysBusIntGen">sysBusIntGen</a></i>( )</b> - generate a bus interrupt<br><b><i><a href="./sysLib.html#sysMailboxConnect">sysMailboxConnect</a></i>( )</b> - connect a routine to the mailbox interrupt<br><b><i><a href="./sysLib.html#sysMailboxEnable">sysMailboxEnable</a></i>( )</b> - enable the mailbox interrupt<br><b><i><a href="./sysLib.html#sysBusTas">sysBusTas</a></i>( )</b> - test and set a location across the bus<br><b><i><a href="./sysLib.html#sysSerialHwInit">sysSerialHwInit</a></i>( )</b> - initialize the BSP serial devices to a quiescent state<br><b><i><a href="./sysLib.html#sysSerialHwInit2">sysSerialHwInit2</a></i>( )</b> - connect BSP serial device interrupts<br><b><i><a href="./sysLib.html#sysSerialChanGet">sysSerialChanGet</a></i>( )</b> - get the <b>SIO_CHAN</b> device associated with a serial channel<br><b><i><a href="./sysLib.html#sysModel">sysModel</a></i>( )</b> - return the model name of the CPU board<br><b><i><a href="./sysLib.html#sysBspRev">sysBspRev</a></i>( )</b> - return the BSP version and revision number<br><b><i><a href="./sysLib.html#sysHwInit">sysHwInit</a></i>( )</b> - initialize the system hardware<br><b><i><a href="./sysLib.html#sysHwInit2">sysHwInit2</a></i>( )</b> - additional system configuration and initialization<br><b><i><a href="./sysLib.html#sysPhysMemTop">sysPhysMemTop</a></i>( )</b> - get the address of the top of memory<br><b><i><a href="./sysLib.html#sysMemTop">sysMemTop</a></i>( )</b> - get the address of the top of logical memory<br><b><i><a href="./sysLib.html#sysToMonitor">sysToMonitor</a></i>( )</b> - transfer control to the ROM monitor<br><b><i><a href="./sysLib.html#sysIntDisable">sysIntDisable</a></i>( )</b> - disable a bus interrupt level<br><b><i><a href="./sysLib.html#sysIntEnable">sysIntEnable</a></i>( )</b> - enable a bus interrupt level<br><b><i><a href="./sysLib.html#sysProcNumGet">sysProcNumGet</a></i>( )</b> - get the processor number<br><b><i><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a></i>( )</b> - set the processor number<br><b><i><a href="./sysLib.html#sysDelay">sysDelay</a></i>( )</b> - allow recovery time for port accesses<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library provides board-specific routines. The chip drivers included are:<p> <b>i8250Sio.c</b> - Intel 8250 UART tty driver<br> <b>i8253Timer.c</b> - Intel 8253 timer library<br> <b>i8259Pic.c</b> - Intel 8259 Programmable Interrupt Controller (PIC) library<br> <b>nullNvRam.c</b> - null NVRAM library<br> <b>nullVme.c</b> - null VMEbus library<p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>sysLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <i>VxWorks Programmer's Guide: Configuration</i><hr><a name="sysIntDisablePIC"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysIntDisablePIC</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysIntDisablePIC</i>( )</strong> - disable a PIC interrupt level</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysIntDisablePIC ( int intLevel /* interrupt level to disable */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine disables a specified PIC interrupt level.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, always.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysIntEnablePIC">sysIntEnablePIC</a></i>( )</b><p>ARGSUSED0<hr><a name="sysIntEnablePIC"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysIntEnablePIC</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysIntEnablePIC</i>( )</strong> - enable a PIC interrupt level</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysIntEnablePIC ( int intLevel /* interrupt level to enable */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine enables a specified PIC interrupt level.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, always.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysIntDisablePIC">sysIntDisablePIC</a></i>( )</b><p>ARGSUSED0<hr><a name="sysIntLevel"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysIntLevel</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysIntLevel</i>( )</strong> - Get interrupt level by reading Interrupt Service Register.</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int sysIntLevel (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine is called to get an interrupt level in service.<p></blockquote><h4>RETURNS</h4><blockquote><p>0 - 15.<p></blockquote><h4>ARGSUSED0</h4><blockquote><p>SEE ALSO<b><a href="./sysLib.html#top">sysLib</a></b><hr><a name="sysIntLock"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysIntLock</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysIntLock</i>( )</strong> - lock out all PIC interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>VOID sysIntLock (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine saves the mask and locks out all PIC interrupts.It should be called in the interrupt disable state(IF bit is 0).<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysIntUnlock">sysIntUnlock</a></i>( )</b><p>ARGSUSED0<hr><a name="sysIntUnlock"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysIntUnlock</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysIntUnlock</i>( )</strong> - unlock the PIC interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>VOID sysIntUnlock (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine restores the mask and unlocks the PIC interruptsIt should be called in the interrupt disable state(IF bit is 0).<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysIntLock">sysIntLock</a></i>( )</b><p>ARGSUSED0<hr><a name="sysClkConnect"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysClkConnect</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysClkConnect</i>( )</strong> - connect a routine to the system clock interrupt</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysClkConnect ( FUNCPTR routine, /* routine to be called at each clock interrupt */ int arg /* argument with which to call routine */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine specifies the interrupt service routine to be called at eachclock interrupt. Normally, it is called from <b><i><a href="../../ref/usrConfig.html#usrRoot" >usrRoot</a></i>( )</b> in <b>usrConfig.c</b> to connect <b><i><a href="../../ref/usrConfig.html#usrClock" >usrClock</a></i>( )</b> to the system clock interrupt.<p></blockquote><h4>RETURN</h4><blockquote><p>OK, or ERROR if the routine cannot be connected to the interrupt.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="../../ref/intArchLib.html#intConnect" >intConnect</a></i>( )</b>, <b><i><a href="../../ref/usrConfig.html#usrClock" >usrClock</a></i>( )</b>, <b><i><a href="./sysLib.html#sysClkEnable">sysClkEnable</a></i>( )</b><hr><a name="sysClkDisable"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysClkDisable</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysClkDisable</i>( )</strong> - turn off system clock interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void sysClkDisable (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine disables system clock interrupts.<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#sysClkEnable">sysClkEnable</a></i>( )</b><hr><a name="sysClkEnable"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysClkEnable</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysClkEnable</i>( )</strong> - turn on system clock interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void sysClkEnable (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine enables system clock interrupts.<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#sysClkConnect">sysClkConnect</a></i>( )</b>, <b><i><a href="./sysLib.html#sysClkDisable">sysClkDisable</a></i>( )</b>, <b><i><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a></i>( )</b><hr><a name="sysClkRateGet"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysClkRateGet</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysClkRateGet</i>( )</strong> - get the system clock rate</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int sysClkRateGet (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine returns the system clock rate.<p></blockquote><h4>RETURNS</h4><blockquote><p>The number of ticks per second of the system clock.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysClkEnable">sysClkEnable</a></i>( )</b>, <b><i><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a></i>( )</b><hr><a name="sysClkRateSet"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysClkRateSet</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysClkRateSet</i>( )</strong> - set the system clock rate</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysClkRateSet ( int ticksPerSecond /* number of clock interrupts per second */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine sets the interrupt rate of the system clock.It is called by <b><i><a href="../../ref/usrConfig.html#usrRoot" >usrRoot</a></i>( )</b> in <b>usrConfig.c</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR if the tick rate is invalid or the timer cannot be set.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="./sysLib.html#sysClkEnable">sysClkEnable</a></i>( )</b>, <b><i><a href="./sysLib.html#sysClkRateGet">sysClkRateGet</a></i>( )</b><hr><a name="sysAuxClkConnect"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysAuxClkConnect</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysAuxClkConnect</i>( )</strong> - connect a routine to the auxiliary clock interrupt</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysAuxClkConnect ( FUNCPTR routine, /* routine called at each aux clock interrupt */ int arg /* argument to auxiliary clock interrupt routine */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine specifies the interrupt service routine to be called at eachauxiliary clock interrupt. It does not enable auxiliary clock interrupts.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR if the routine cannot be connected to the interrupt.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><i><a href="../../ref/intArchLib.html#intConnect" >intConnect</a></i>( )</b>, <b><i><a href="./sysLib.html#sysAuxClkEnable">sysAuxClkEnable</a></i>( )</b><hr><a name="sysAuxClkDisable"></a><p align=right><a href="rtnIndex.html"><i>ns486 : Routines</i></a></p></blockquote><h1><i>sysAuxClkDisable</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>sysAuxClkDisable</i>( )</strong> - turn off auxiliary clock interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void sysAuxClkDisable (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine disables auxiliary clock interrupts.<p></blockquote><h4>RETURNS</h4><blockquote><p>N/A<p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -