9a24a3184e
This patch updates the doxygen for the drivers spi,spips,srio,sysmon,tmrctr to include .h files in the listof files provided in the index.html file. Signed-off-by: Kedareswara rao Appana <appanad@xilinx.com>
95 lines
6.3 KiB
HTML
Executable file
95 lines
6.3 KiB
HTML
Executable file
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
|
|
<title>
|
|
Xilinx Driver tmrctr v3_0: tmrctr v3_0
|
|
</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 class="current"><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="contents">
|
|
<h1>tmrctr v3_0</h1><p>The Xilinx timer/counter component. This component supports the Xilinx timer/counter. More detailed description of the driver operation can be found in the <a class="el" href="xtmrctr_8c.html">xtmrctr.c</a> file.</p>
|
|
<p>The Xilinx timer/counter supports the following features:</p>
|
|
<ul>
|
|
<li>Polled mode.</li>
|
|
<li>Interrupt driven mode</li>
|
|
<li>enabling and disabling specific timers</li>
|
|
<li>PWM operation</li>
|
|
<li>Cascade Operation (This is to be used for getting a 64 bit timer and this feature is present in the latest versions of the axi_timer IP)</li>
|
|
</ul>
|
|
<p>The driver does not currently support the PWM operation of the device.</p>
|
|
<p>The timer counter operates in 2 primary modes, compare and capture. In either mode, the timer counter may count up or down, with up being the default.</p>
|
|
<p>Compare mode is typically used for creating a single time period or multiple repeating time periods in the auto reload mode, such as a periodic interrupt. When started, the timer counter loads an initial value, referred to as the compare value, into the timer counter and starts counting down or up. The timer counter expires when it rolls over/under depending upon the mode of counting. An external compare output signal may be configured such that a pulse is generated with this signal when it hits the compare value.</p>
|
|
<p>Capture mode is typically used for measuring the time period between external events. This mode uses an external capture input signal to cause the value of the timer counter to be captured. When started, the timer counter loads an initial value, referred to as the compare value,</p>
|
|
<p>The timer can be configured to either cause an interrupt when the count reaches the compare value in compare mode or latch the current count value in the capture register when an external input is asserted in capture mode. The external capture input can be enabled/disabled using the XTmrCtr_SetOptions function. While in compare mode, it is also possible to drive an external output when the compare value is reached in the count register The external compare output can be enabled/disabled using the XTmrCtr_SetOptions function.</p>
|
|
<p><b>Interrupts</b></p>
|
|
<p>It is the responsibility of the application to connect the interrupt handler of the timer/counter to the interrupt source. The interrupt handler function, XTmrCtr_InterruptHandler, is visible such that the user can connect it to the interrupt source. Note that this interrupt handler does not provide interrupt context save and restore processing, the user must perform this processing.</p>
|
|
<p>The driver services interrupts and passes timeouts to the upper layer software through callback functions. The upper layer software must register its callback functions during initialization. The driver requires callback functions for timers.</p>
|
|
<dl class="note"><dt><b>Note:</b></dt><dd>The default settings for the timers are:<ul>
|
|
<li>Interrupt generation disabled</li>
|
|
<li>Count up mode</li>
|
|
<li>Compare mode</li>
|
|
<li>Hold counter (will not reload the timer)</li>
|
|
<li>External compare output disabled</li>
|
|
<li>External capture input disabled</li>
|
|
<li>Pulse width modulation disabled</li>
|
|
<li>Timer disabled, waits for Start function to be called <br/>
|
|
<br/>
|
|
A timer counter device may contain multiple timer counters. The symbol XTC_DEVICE_TIMER_COUNT defines the number of timer counters in the device. The device currently contains 2 timer counters. <br/>
|
|
<br/>
|
|
This driver is intended to be RTOS and processor independent. It works with physical addresses only. Any needs for dynamic memory management, threads or thread mutual exclusion, virtual memory, or cache control must be satisfied by the layer above this driver.</li>
|
|
</ul>
|
|
</dd></dl>
|
|
<pre>
|
|
MODIFICATION HISTORY:</pre><pre> Ver Who Date Changes
|
|
----- ---- -------- -----------------------------------------------
|
|
1.00a ecm 08/16/01 First release
|
|
1.00b jhl 02/21/02 Repartitioned the driver for smaller files
|
|
1.10b mta 03/21/07 Updated to new coding style.
|
|
1.11a sdm 08/22/08 Removed support for static interrupt handlers from the MDD
|
|
file
|
|
2.00a ktn 10/30/09 Updated to use HAL API's. _m is removed from all the macro
|
|
definitions.
|
|
2.01a ktn 07/12/10 Renamed the macro XTimerCtr_ReadReg as XTmrCtr_ReadReg
|
|
for naming consistency (CR 559142).
|
|
2.02a sdm 09/28/10 Updated the driver tcl to generate the xparameters
|
|
for the timer clock frequency (CR 572679).
|
|
2.03a rvo 11/30/10 Added check to see if interrupt is enabled before further
|
|
processing for CR 584557.
|
|
2.04a sdm 07/12/11 Added support for cascade mode operation.
|
|
The cascade mode of operation is present in the latest
|
|
versions of the axi_timer IP. Please check the HW
|
|
Datasheet to see whether this feature is present in the
|
|
version of the IP that you are using.
|
|
2.05a adk 15/05/13 Fixed the CR:693066
|
|
Added the IsStartedTmrCtr0/IsStartedTmrCtr1 members to the
|
|
<a class="el" href="struct_x_tmr_ctr.html">XTmrCtr</a> instance structure.
|
|
The IsStartedTmrCtrX will be assigned XIL_COMPONENT_IS_STARTED in
|
|
the XTmrCtr_Start function.
|
|
The IsStartedTmrCtrX will be cleared in the XTmrCtr_Stop function.
|
|
There will be no Initialization done in the
|
|
XTmrCtr_Initialize if both the timers have already started and
|
|
the XST_DEVICE_IS_STARTED Status is returned.
|
|
Removed the logic in the XTmrCtr_Initialize function
|
|
which was checking the Register Value to know whether
|
|
a timer has started or not.
|
|
3.0 adk 19/12/13 Updated as per the New Tcl API's
|
|
</pre> </div>
|
|
<p class="Copyright">
|
|
Copyright © 1995-2014 Xilinx, Inc. All rights reserved.
|
|
</p>
|
|
</body>
|
|
</html>
|