embeddedsw/XilinxProcessorIPLib/drivers/wdtps/doc/html/api/xwdtps_8h.html

514 lines
26 KiB
HTML
Raw Normal View History

<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>
Xilinx Driver wdtps v2_0: xwdtps.h File Reference
</title>
<link href="doxygen_kalyanidocs/doc/css/driver_api_doxygen.css" rel="stylesheet" type="text/css">
</head>
<h3 class="PageHeader">Xilinx Processor IP Library</h3>
<hl>Software Drivers</hl>
<hr class="whs1">
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File&nbsp;List</span></a></li>
<li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>xwdtps.h File Reference</h1><code>#include &quot;xil_types.h&quot;</code><br/>
<code>#include &quot;xil_assert.h&quot;</code><br/>
<code>#include &quot;xstatus.h&quot;</code><br/>
<code>#include &quot;<a class="el" href="xwdtps__hw_8h.html">xwdtps_hw.h</a>&quot;</code><br/>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="struct_x_wdt_ps___config.html">XWdtPs_Config</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a></td></tr>
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#ac766494d522d445e628dd65f01fe4130">XWDTPS_H</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#ad0b2439fb19478f1b1c1d14b76cd15cc">XWDTPS_RESET_SIGNAL</a>&nbsp;&nbsp;&nbsp;1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a1c3aaf158b04e2d1e77145d5b425c5d3">XWDTPS_IRQ_SIGNAL</a>&nbsp;&nbsp;&nbsp;2</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a4182ead880093d17d2b0962839821929">XWDTPS_CLK_PRESCALE</a>&nbsp;&nbsp;&nbsp;1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#ac055573454d39a7fadf5cbd1ed19aea5">XWDTPS_COUNTER_RESET</a>&nbsp;&nbsp;&nbsp;2</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a5ad51ea203fc3eb20ecd848117c2f930">XWdtPs_IsWdtExpired</a>(InstancePtr)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a89baace72a7b8abe477a8cfed4606a08">XWdtPs_RestartWdt</a>(InstancePtr)</td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="struct_x_wdt_ps___config.html">XWdtPs_Config</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a0d62ba7f1b495023ff468cff95e855cb">XWdtPs_LookupConfig</a> (u16 DeviceId)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a6a5297a4443512e9ac510b54f61a7018">XWdtPs_CfgInitialize</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr, <a class="el" href="struct_x_wdt_ps___config.html">XWdtPs_Config</a> *ConfigPtr, u32 EffectiveAddress)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a2ac689cec0d17cc916c509285635135b">XWdtPs_Start</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a4a8899689039c676ab3ad7ff80c9c750">XWdtPs_Stop</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a8f98775051f9ea2cb0a47da8a75f555a">XWdtPs_EnableOutput</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr, u8 Signal)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a0d6091a8ee48e49031cf0c8c92a87658">XWdtPs_DisableOutput</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr, u8 Signal)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">u32&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a007b92a62641b7db61edd11f8e4bc7dc">XWdtPs_GetControlValue</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr, u8 Control)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#a64f2de6079bde6e9b8c495401a555a64">XWdtPs_SetControlValue</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr, u8 Control, u32 Value)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="xwdtps_8h.html#abde8e7d36dd20f165444862f9146a0d4">XWdtPs_SelfTest</a> (<a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *InstancePtr)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="a4182ead880093d17d2b0962839821929"></a><!-- doxytag: member="xwdtps.h::XWDTPS_CLK_PRESCALE" ref="a4182ead880093d17d2b0962839821929" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWDTPS_CLK_PRESCALE&nbsp;&nbsp;&nbsp;1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Clock Prescale request </p>
</div>
</div>
<a class="anchor" id="ac055573454d39a7fadf5cbd1ed19aea5"></a><!-- doxytag: member="xwdtps.h::XWDTPS_COUNTER_RESET" ref="ac055573454d39a7fadf5cbd1ed19aea5" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWDTPS_COUNTER_RESET&nbsp;&nbsp;&nbsp;2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Counter Reset request </p>
</div>
</div>
<a class="anchor" id="ac766494d522d445e628dd65f01fe4130"></a><!-- doxytag: member="xwdtps.h::XWDTPS_H" ref="ac766494d522d445e628dd65f01fe4130" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWDTPS_H</td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a1c3aaf158b04e2d1e77145d5b425c5d3"></a><!-- doxytag: member="xwdtps.h::XWDTPS_IRQ_SIGNAL" ref="a1c3aaf158b04e2d1e77145d5b425c5d3" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWDTPS_IRQ_SIGNAL&nbsp;&nbsp;&nbsp;2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>IRQ signal request </p>
</div>
</div>
<a class="anchor" id="a5ad51ea203fc3eb20ecd848117c2f930"></a><!-- doxytag: member="xwdtps.h::XWdtPs_IsWdtExpired" ref="a5ad51ea203fc3eb20ecd848117c2f930" args="(InstancePtr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWdtPs_IsWdtExpired</td>
<td>(</td>
<td class="paramtype">InstancePtr&nbsp;</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<b>Value:</b><div class="fragment"><pre class="fragment">((<a class="code" href="xwdtps__hw_8h.html#ae41b46b220ba0da6a9f28e594c3c0a47">XWdtPs_ReadReg</a>((InstancePtr)-&gt;Config.BaseAddress, <a class="code" href="xwdtps__hw_8h.html#af91a6934748dedcd7f21665696277922">XWDTPS_SR_OFFSET</a>) &amp; \
<a class="code" href="xwdtps__hw_8h.html#a79c7165641f0f9b4e356675fc0d0960b">XWDTPS_SR_WDZ_MASK</a>) == <a class="code" href="xwdtps__hw_8h.html#a79c7165641f0f9b4e356675fc0d0960b">XWDTPS_SR_WDZ_MASK</a>)
</pre></div><p>Check if the watchdog timer has expired. This function is used for polled mode and it is also used to check if the last reset was caused by the watchdog timer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><ul>
<li>TRUE if the watchdog has expired.</li>
<li>FALSE if the watchdog has not expired.</li>
</ul>
</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>C-style signature: int <a class="el" href="xwdtps_8h.html#a5ad51ea203fc3eb20ecd848117c2f930">XWdtPs_IsWdtExpired(XWdtPs *InstancePtr)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ad0b2439fb19478f1b1c1d14b76cd15cc"></a><!-- doxytag: member="xwdtps.h::XWDTPS_RESET_SIGNAL" ref="ad0b2439fb19478f1b1c1d14b76cd15cc" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWDTPS_RESET_SIGNAL&nbsp;&nbsp;&nbsp;1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reset signal request </p>
</div>
</div>
<a class="anchor" id="a89baace72a7b8abe477a8cfed4606a08"></a><!-- doxytag: member="xwdtps.h::XWdtPs_RestartWdt" ref="a89baace72a7b8abe477a8cfed4606a08" args="(InstancePtr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define XWdtPs_RestartWdt</td>
<td>(</td>
<td class="paramtype">InstancePtr&nbsp;</td>
<td class="paramname"></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<b>Value:</b><div class="fragment"><pre class="fragment"><a class="code" href="xwdtps__hw_8h.html#ac1cc7282f826a550a7f5107f1e12523b">XWdtPs_WriteReg</a>((InstancePtr)-&gt;Config.BaseAddress, \
<a class="code" href="xwdtps__hw_8h.html#aa8bb5ca85ad74f2e5601444673e6ed09">XWDTPS_RESTART_OFFSET</a>, <a class="code" href="xwdtps__hw_8h.html#a798fcec0eac576d8309e3995e3597b3e">XWDTPS_RESTART_KEY_VAL</a>)
</pre></div><p>Restart the watchdog timer. An application needs to call this function periodically to keep the timer from asserting the enabled output.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>C-style signature: void <a class="el" href="xwdtps_8h.html#a89baace72a7b8abe477a8cfed4606a08">XWdtPs_RestartWdt(XWdtPs *InstancePtr)</a> </dd></dl>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a6a5297a4443512e9ac510b54f61a7018"></a><!-- doxytag: member="xwdtps.h::XWdtPs_CfgInitialize" ref="a6a5297a4443512e9ac510b54f61a7018" args="(XWdtPs *InstancePtr, XWdtPs_Config *ConfigPtr, u32 EffectiveAddress)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int XWdtPs_CfgInitialize </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps___config.html">XWdtPs_Config</a> *&nbsp;</td>
<td class="paramname"> <em>ConfigPtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u32&nbsp;</td>
<td class="paramname"> <em>EffectiveAddress</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialize a specific watchdog timer instance/driver. This function must be called before other functions of the driver are called.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ConfigPtr</em>&nbsp;</td><td>is the config structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>EffectiveAddress</em>&nbsp;</td><td>is the base address for the device. It could be a virtual address if address translation is supported in the system, otherwise it is the physical address.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><ul>
<li>XST_SUCCESS if initialization was successful.</li>
<li>XST_DEVICE_IS_STARTED if the device has already been started.</li>
</ul>
</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a0d6091a8ee48e49031cf0c8c92a87658"></a><!-- doxytag: member="xwdtps.h::XWdtPs_DisableOutput" ref="a0d6091a8ee48e49031cf0c8c92a87658" args="(XWdtPs *InstancePtr, u8 Signal)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void XWdtPs_DisableOutput </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u8&nbsp;</td>
<td class="paramname"> <em>Signal</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Disables the indicated signal/output. Performs a read/modify/write cycle to update the value correctly.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Signal</em>&nbsp;</td><td>is the desired signal/output. Valid Signal Values are XWDTPS_RESET_SIGNAL and XWDTPS_IRQ_SIGNAL Only one of them can be specified at a time.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a8f98775051f9ea2cb0a47da8a75f555a"></a><!-- doxytag: member="xwdtps.h::XWdtPs_EnableOutput" ref="a8f98775051f9ea2cb0a47da8a75f555a" args="(XWdtPs *InstancePtr, u8 Signal)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void XWdtPs_EnableOutput </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u8&nbsp;</td>
<td class="paramname"> <em>Signal</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enables the indicated signal/output. Performs a read/modify/write cycle to update the value correctly.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Signal</em>&nbsp;</td><td>is the desired signal/output. Valid Signal Values are XWDTPS_RESET_SIGNAL and XWDTPS_IRQ_SIGNAL. Only one of them can be specified at a time.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a007b92a62641b7db61edd11f8e4bc7dc"></a><!-- doxytag: member="xwdtps.h::XWdtPs_GetControlValue" ref="a007b92a62641b7db61edd11f8e4bc7dc" args="(XWdtPs *InstancePtr, u8 Control)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">u32 XWdtPs_GetControlValue </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u8&nbsp;</td>
<td class="paramname"> <em>Control</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the current control setting for the indicated signal/output. The register referenced is the Counter Control Register (XWDTPS_CCR_OFFSET)</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Control</em>&nbsp;</td><td>is the desired signal/output. Valid Control Values are XWDTPS_CLK_PRESCALE and XWDTPS_COUNTER_RESET. Only one of them can be specified at a time.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The contents of the requested control field in the Counter Control Register (XWDTPS_CCR_OFFSET). If the Control is XWDTPS_CLK_PRESCALE then use the defintions XWDTEPB_CCR_PSCALE_XXXX. If the Control is XWDTPS_COUNTER_RESET then the values are 0x0 to 0xFFF. This is the Counter Restart value in the CCR register.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a0d62ba7f1b495023ff468cff95e855cb"></a><!-- doxytag: member="xwdtps.h::XWdtPs_LookupConfig" ref="a0d62ba7f1b495023ff468cff95e855cb" args="(u16 DeviceId)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="struct_x_wdt_ps___config.html">XWdtPs_Config</a>* XWdtPs_LookupConfig </td>
<td>(</td>
<td class="paramtype">u16&nbsp;</td>
<td class="paramname"> <em>DeviceId</em></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Lookup the device configuration based on the unique device ID. The table contains the configuration info for each device in the system.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>DeviceId</em>&nbsp;</td><td>is the unique device ID of the device being looked up.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the configuration table entry corresponding to the given device ID, or NULL if no match is found.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="abde8e7d36dd20f165444862f9146a0d4"></a><!-- doxytag: member="xwdtps.h::XWdtPs_SelfTest" ref="abde8e7d36dd20f165444862f9146a0d4" args="(XWdtPs *InstancePtr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int XWdtPs_SelfTest </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Run a self-test on the timebase. This test verifies that the register access locking functions. This is tested by trying to alter a register without setting the key value and verifying that the register contents did not change.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><ul>
<li>XST_SUCCESS if self-test was successful.</li>
<li>XST_FAILURE if self-test was not successful.</li>
</ul>
</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a64f2de6079bde6e9b8c495401a555a64"></a><!-- doxytag: member="xwdtps.h::XWdtPs_SetControlValue" ref="a64f2de6079bde6e9b8c495401a555a64" args="(XWdtPs *InstancePtr, u8 Control, u32 Value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void XWdtPs_SetControlValue </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u8&nbsp;</td>
<td class="paramname"> <em>Control</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">u32&nbsp;</td>
<td class="paramname"> <em>Value</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Updates the current control setting for the indicated signal/output with the provided value.</p>
<p>Performs a read/modify/write cycle to update the value correctly. The register referenced is the Counter Control Register (XWDTPS_CCR_OFFSET)</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Control</em>&nbsp;</td><td>is the desired signal/output. Valid Control Values are XWDTPS_CLK_PRESCALE and XWDTPS_COUNTER_RESET. Only one of them can be specified at a time. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>Value</em>&nbsp;</td><td>is the desired control value. If the Control is XWDTPS_CLK_PRESCALE then use the defintions XWDTEPB_CCR_PSCALE_XXXX. If the Control is XWDTPS_COUNTER_RESET then the valid values are 0x0 to 0xFFF, this sets the counter restart value of the CCR register.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a2ac689cec0d17cc916c509285635135b"></a><!-- doxytag: member="xwdtps.h::XWdtPs_Start" ref="a2ac689cec0d17cc916c509285635135b" args="(XWdtPs *InstancePtr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void XWdtPs_Start </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Start the watchdog timer of the device.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
<a class="anchor" id="a4a8899689039c676ab3ad7ff80c9c750"></a><!-- doxytag: member="xwdtps.h::XWdtPs_Stop" ref="a4a8899689039c676ab3ad7ff80c9c750" args="(XWdtPs *InstancePtr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void XWdtPs_Stop </td>
<td>(</td>
<td class="paramtype"><a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> *&nbsp;</td>
<td class="paramname"> <em>InstancePtr</em></td>
<td>&nbsp;)&nbsp;</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Disable the watchdog timer.</p>
<p>It is the caller's responsibility to disconnect the interrupt handler of the watchdog timer from the interrupt source, typically an interrupt controller, and disable the interrupt in the interrupt controller.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>InstancePtr</em>&nbsp;</td><td>is a pointer to the <a class="el" href="struct_x_wdt_ps.html">XWdtPs</a> instance.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>None.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>None. </dd></dl>
</div>
</div>
</div>
<p class="Copyright">
Copyright &copy; 1995-2014 Xilinx, Inc. All rights reserved.
</p>
</body>
</html>