📄 syslib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/sysLib.html - generated by refgen from /vobs/wpwr/target/config/doc/sysLib.c --> <title> sysLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>sysLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysLib</strong> - system-dependent library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./sysLib.html#sysClkConnect">sysClkConnect</a>( )</b> - connect a routine to the system clock interrupt<br><b><a href="./sysLib.html#sysClkDisable">sysClkDisable</a>( )</b> - turn off system clock interrupts<br><b><a href="./sysLib.html#sysClkEnable">sysClkEnable</a>( )</b> - turn on system clock interrupts<br><b><a href="./sysLib.html#sysClkRateGet">sysClkRateGet</a>( )</b> - get the system clock rate<br><b><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a>( )</b> - set the system clock rate<br><b><a href="./sysLib.html#sysAuxClkConnect">sysAuxClkConnect</a>( )</b> - connect a routine to the auxiliary clock interrupt<br><b><a href="./sysLib.html#sysAuxClkDisable">sysAuxClkDisable</a>( )</b> - turn off auxiliary clock interrupts<br><b><a href="./sysLib.html#sysAuxClkEnable">sysAuxClkEnable</a>( )</b> - turn on auxiliary clock interrupts<br><b><a href="./sysLib.html#sysAuxClkRateGet">sysAuxClkRateGet</a>( )</b> - get the auxiliary clock rate<br><b><a href="./sysLib.html#sysAuxClkRateSet">sysAuxClkRateSet</a>( )</b> - set the auxiliary clock rate<br><b><a href="./sysLib.html#sysIntDisable">sysIntDisable</a>( )</b> - disable a bus interrupt level<br><b><a href="./sysLib.html#sysIntEnable">sysIntEnable</a>( )</b> - enable a bus interrupt level<br><b><a href="./sysLib.html#sysBusIntAck">sysBusIntAck</a>( )</b> - acknowledge a bus interrupt<br><b><a href="./sysLib.html#sysBusIntGen">sysBusIntGen</a>( )</b> - generate a bus interrupt<br><b><a href="./sysLib.html#sysMailboxConnect">sysMailboxConnect</a>( )</b> - connect a routine to the mailbox interrupt<br><b><a href="./sysLib.html#sysMailboxEnable">sysMailboxEnable</a>( )</b> - enable the mailbox interrupt<br><b><a href="./sysLib.html#sysNvRamGet">sysNvRamGet</a>( )</b> - get the contents of non-volatile RAM<br><b><a href="./sysLib.html#sysNvRamSet">sysNvRamSet</a>( )</b> - write to non-volatile RAM<br><b><a href="./sysLib.html#sysModel">sysModel</a>( )</b> - return the model name of the CPU board<br><b><a href="./sysLib.html#sysBspRev">sysBspRev</a>( )</b> - return the BSP version and revision number<br><b><a href="./sysLib.html#sysHwInit">sysHwInit</a>( )</b> - initialize the system hardware<br><b><a href="./sysLib.html#sysPhysMemTop">sysPhysMemTop</a>( )</b> - get the address of the top of memory<br><b><a href="./sysLib.html#sysMemTop">sysMemTop</a>( )</b> - get the address of the top of logical memory<br><b><a href="./sysLib.html#sysToMonitor">sysToMonitor</a>( )</b> - transfer control to the ROM monitor<br><b><a href="./sysLib.html#sysProcNumGet">sysProcNumGet</a>( )</b> - get the processor number<br><b><a href="./sysLib.html#sysProcNumSet">sysProcNumSet</a>( )</b> - set the processor number<br><b><a href="./sysLib.html#sysBusTas">sysBusTas</a>( )</b> - test and set a location across the bus<br><b><a href="./sysLib.html#sysScsiBusReset">sysScsiBusReset</a>( )</b> - assert the RST line on the SCSI bus (Western Digital WD33C93 only)<br><b><a href="./sysLib.html#sysScsiInit">sysScsiInit</a>( )</b> - initialize an on-board SCSI port<br><b><a href="./sysLib.html#sysScsiConfig">sysScsiConfig</a>( )</b> - system SCSI configuration<br><b><a href="./sysLib.html#sysLocalToBusAdrs">sysLocalToBusAdrs</a>( )</b> - convert a local address to a bus address<br><b><a href="./sysLib.html#sysBusToLocalAdrs">sysBusToLocalAdrs</a>( )</b> - convert a bus address to a local address<br><b><a href="./sysLib.html#sysSerialHwInit">sysSerialHwInit</a>( )</b> - initialize the BSP serial devices to a quiesent state<br><b><a href="./sysLib.html#sysSerialHwInit2">sysSerialHwInit2</a>( )</b> - connect BSP serial device interrupts<br><b><a href="./sysLib.html#sysSerialReset">sysSerialReset</a>( )</b> - reset all SIO devices to a quiet state<br><b><a href="./sysLib.html#sysSerialChanGet">sysSerialChanGet</a>( )</b> - get the <b>SIO_CHAN</b> device associated with a serial channel<br><b><a href="./sysLib.html#sysNanoDelay">sysNanoDelay</a>( )</b> - delay for specified number of nanoseconds<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library provides board-specific routines.<p><b>NOTE:</b> This is a generic reference entry for a BSP-specific library; thisdescription contains general information only. For features and capabilitiesspecific to the system library included in your BSP, see your BSP'sreference entry for <b><a href="./sysLib.html#top">sysLib</a></b>. <p>The file <b>sysLib.c</b> provides the board-level interface on which VxWorks andapplication code can be built in a hardware-independent manner. Thefunctions addressed in this file include:<p> Initialization functions<br> - initialize the hardware to a known state<br> - identify the system<br> - initialize drivers, such as SCSI or custom drivers<p> Memory/address space functions<br> - get the on-board memory size<br> - make on-board memory accessible to external bus<br> - map local and bus address spaces<br> - enable/disable cache memory<br> - set/get nonvolatile RAM (NVRAM)<br> - define board's memory map (optional)<br> - virtual-to-physical memory map declarations for processors with MMUs<p> Bus interrupt functions<br> - enable/disable bus interrupt levels<br> - generate bus interrupts<p> Clock/timer functions<br> - enable/disable timer interrupts<br> - set the periodic rate of the timer<p> Mailbox/location monitor functions<br> - enable mailbox/location monitor interrupts for VME-based boards<p>The <b><a href="./sysLib.html#top">sysLib</a></b> library does not support every feature of every board; aparticular board may have various extensions to the capabilities describedhere. Conversely, some boards do not support every function provided bythis library. Some boards provide some of the functions of this libraryby means of hardware switches, jumpers, or PALs, instead ofsoftware-controllable registers.<p>Typically, most functions in this library are not called by the userapplication directly. The configuration modules <b>usrConfig.c</b> and<b>bootConfig.c</b> are responsible for invoking the routines at the appropriatetime. Device drivers may use some of the memory mapping routines and busfunctions.<p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>sysLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><p><i>VxWorks Programmer's Guide: Configuration and Build, </i>BSP-specific reference entry for <b><a href="./sysLib.html#top">sysLib</a></b><p><hr><a name="sysClkConnect"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysClkConnect( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysClkConnect( )</strong> - connect a routine to the system clock interrupt</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS sysClkConnect ( FUNCPTR routine, /* routine called at each system 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><a href="./usrConfig.html#usrRoot">usrRoot</a>( )</b> in <b>usrConfig.c</b> toconnect <b><a href="./usrConfig.html#usrClock">usrClock</a>( )</b> to the system clock interrupt.<p></blockquote><h4>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP's version of this routine, see the reference pages for your BSP.<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><a href="./intArchLib.html#intConnect">intConnect</a>( )</b>, <b><a href="./usrConfig.html#usrClock">usrClock</a>( )</b>, <b><a href="./sysLib.html#sysClkEnable">sysClkEnable</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysClkDisable"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysClkDisable( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysClkDisable( )</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>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP'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#sysClkEnable">sysClkEnable</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysClkEnable"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysClkEnable( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysClkEnable( )</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>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP'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#sysClkConnect">sysClkConnect</a>( )</b>, <b><a href="./sysLib.html#sysClkDisable">sysClkDisable</a>( )</b>, <b><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysClkRateGet"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysClkRateGet( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysClkRateGet( )</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>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP's version of this routine, see the reference pages for your BSP.<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><a href="./sysLib.html#sysClkEnable">sysClkEnable</a>( )</b>, <b><a href="./sysLib.html#sysClkRateSet">sysClkRateSet</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysClkRateSet"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysClkRateSet( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysClkRateSet( )</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><a href="./usrConfig.html#usrRoot">usrRoot</a>( )</b> in <b>usrConfig.c</b>.<p>There may be interactions between this routine and the POSIX <b><a href="./clockLib.html#top">clockLib</a></b>routines. Refer to the <b><a href="./clockLib.html#top">clockLib</a></b> reference entry.<p></blockquote><h4>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP's version of this routine, see the reference pages for your BSP.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR if the tick rate is invalid or the timer cannot beset.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./sysLib.html#top">sysLib</a></b>, <b><a href="./sysLib.html#sysClkEnable">sysClkEnable</a>( )</b>, <b><a href="./sysLib.html#sysClkRateGet">sysClkRateGet</a>( )</b>, <b><a href="./clockLib.html#top">clockLib</a></b>, and BSP-specific reference pages for this routine.<hr><a name="sysAuxClkConnect"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysAuxClkConnect( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysAuxClkConnect( )</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 clockinterrupts.<p></blockquote><h4>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP's version of this routine, see the reference pages for your BSP.<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><a href="./intArchLib.html#intConnect">intConnect</a>( )</b>, <b><a href="./sysLib.html#sysAuxClkEnable">sysAuxClkEnable</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysAuxClkDisable"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysAuxClkDisable( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysAuxClkDisable( )</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>NOTE </h4><blockquote><p>This is a generic page for a BSP-specific routine; thisdescription contains general information only. To determine if thisroutine is supported by your BSP, or for information specific to yourBSP'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#sysAuxClkEnable">sysAuxClkEnable</a>( )</b>, and BSP-specific reference pages for this routine.<hr><a name="sysAuxClkEnable"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sysAuxClkEnable( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sysAuxClkEnable( )</strong> - turn on auxiliary clock interrupts</p></blockquote><h4>SYNOPSIS</h4><blockquote><p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -