<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Procyon AVRlib: timer.h Source File</title>
<link href="dox.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.2 -->
<div class="qindex"><a class="qindex" href="main.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
<h1>timer.h</h1><a href="timer_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="comment">/*! \file timer.h \brief System Timer function library. */</span>
00002 <span class="comment">//*****************************************************************************</span>
00003 <span class="comment">//</span>
00004 <span class="comment">// File Name : 'timer.h'</span>
00005 <span class="comment">// Title : System Timer function library</span>
00006 <span class="comment">// Author : Pascal Stang - Copyright (C) 2000-2002</span>
00007 <span class="comment">// Created : 11/22/2000</span>
00008 <span class="comment">// Revised : 02/10/2003</span>
00009 <span class="comment">// Version : 1.1</span>
00010 <span class="comment">// Target MCU : Atmel AVR Series</span>
00011 <span class="comment">// Editor Tabs : 4</span>
00012 <span class="comment">//</span>
00013 <span class="comment">// This code is distributed under the GNU Public License</span>
00014 <span class="comment">// which can be found at http://www.gnu.org/licenses/gpl.txt</span>
00015 <span class="comment">//</span><span class="comment"></span>
00016 <span class="comment">/// \ingroup driver_avr</span>
00017 <span class="comment">/// \defgroup timer Timer Function Library (timer.c)</span>
00018 <span class="comment">/// \code #include "timer.h" \endcode</span>
00019 <span class="comment">/// \par Overview</span>
00020 <span class="comment">/// This library provides functions for use with the timers internal</span>
00021 <span class="comment">/// to the AVR processors. Functions include initialization, set prescaler,</span>
00022 <span class="comment">/// calibrated pause function (in milliseconds), attaching and detaching of</span>
00023 <span class="comment">/// user functions to interrupts, overflow counters, PWM. Arbitrary</span>
00024 <span class="comment">/// frequency generation has been moved to the Pulse Library.</span>
00025 <span class="comment">///</span>
00026 <span class="comment">/// \par About Timers</span>
00027 <span class="comment">/// The Atmel AVR-series processors each contain at least one</span>
00028 <span class="comment">/// hardware timer/counter. Many of the processors contain 2 or 3</span>
00029 <span class="comment">/// timers. Generally speaking, a timer is a hardware counter inside</span>
00030 <span class="comment">/// the processor which counts at a rate related to the main CPU clock</span>
00031 <span class="comment">/// frequency. Because the counter value increasing (counting up) at</span>
00032 <span class="comment">/// a precise rate, we can use it as a timer to create or measure </span>
00033 <span class="comment">/// precise delays, schedule events, or generate signals of a certain</span>
00034 <span class="comment">/// frequency or pulse-width.</span>
00035 <span class="comment">/// \par</span>
00036 <span class="comment">/// As an example, the ATmega163 processor has 3 timer/counters.</span>
00037 <span class="comment">/// Timer0, Timer1, and Timer2 are 8, 16, and 8 bits wide respectively.</span>
00038 <span class="comment">/// This means that they overflow, or roll over back to zero, at a</span>
00039 <span class="comment">/// count value of 256 for 8bits or 65536 for 16bits. A prescaler is</span>
00040 <span class="comment">/// avaiable for each timer, and the prescaler allows you to pre-divide</span>
00041 <span class="comment">/// the main CPU clock rate down to a slower speed before feeding it to</span>
00042 <span class="comment">/// the counting input of a timer. For example, if the CPU clock</span>
00043 <span class="comment">/// frequency is 3.69MHz, and Timer0's prescaler is set to divide-by-8,</span>
00044 <span class="comment">/// then Timer0 will "tic" at 3690000/8 = 461250Hz. Because Timer0 is</span>
00045 <span class="comment">/// an 8bit timer, it will count to 256 in just 256/461250Hz = 0.555ms.</span>
00046 <span class="comment">/// In fact, when it hits 255, it will overflow and start again at</span>
00047 <span class="comment">/// zero. In this case, Timer0 will overflow 461250/256 = 1801.76</span>
00048 <span class="comment">/// times per second.</span>
00049 <span class="comment">/// \par</span>
00050 <span class="comment">/// Timer0 can be used a number of ways simultaneously. First, the</span>
00051 <span class="comment">/// value of the timer can be read by accessing the CPU register \c TCNT0.</span>
00052 <span class="comment">/// We could, for example, figure out how long it takes to execute a</span>
00053 <span class="comment">/// C command by recording the value of \c TCNT0 before and after</span>
00054 <span class="comment">/// execution, then subtract (after-before) = time elapsed. Or we can</span>
00055 <span class="comment">/// enable the overflow interrupt which goes off every time T0</span>
00056 <span class="comment">/// overflows and count out longer delays (multiple overflows), or</span>
00057 <span class="comment">/// execute a special periodic function at every overflow.</span>
00058 <span class="comment">/// \par</span>
00059 <span class="comment">/// The other timers (Timer1 and Timer2) offer all the abilities of</span>
00060 <span class="comment">/// Timer0 and many more features. Both T1 and T2 can operate as</span>
00061 <span class="comment">/// general-purpose timers, but T1 has special hardware allowing it to</span>
00062 <span class="comment">/// generate PWM signals, while T2 is specially designed to help count</span>
00063 <span class="comment">/// out real time (like hours, minutes, seconds). See the</span>
00064 <span class="comment">/// Timer/Counter section of the processor datasheet for more info.</span>
00065 <span class="comment">///</span>
00066 <span class="comment"></span><span class="comment">//*****************************************************************************</span><span class="comment"></span>
00067 <span class="comment">//@{</span>
00068 <span class="comment"></span>
00069 <span class="preprocessor">#ifndef TIMER_H</span>
00070 <span class="preprocessor"></span><span class="preprocessor">#define TIMER_H</span>
00071 <span class="preprocessor"></span>
00072 <span class="preprocessor">#include "<a class="code" href="global_8h.html">global.h</a>"</span>
00073
00074 <span class="comment">// constants/macros/typdefs</span>
00075
00076 <span class="comment">// processor compatibility fixes</span>
00077 <span class="preprocessor">#ifdef __AVR_ATmega323__</span>
00078 <span class="preprocessor"></span> <span class="comment">// redefinition for the Mega323</span>
00079 <span class="preprocessor"> #define CTC1 CTC10</span>
00080 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
00081 <span class="preprocessor"></span><span class="preprocessor">#ifndef PWM10</span>
00082 <span class="preprocessor"></span> <span class="comment">// mega128 PWM bits</span>
00083 <span class="preprocessor"> #define PWM10 WGM10</span>
00084 <span class="preprocessor"></span><span class="preprocessor"> #define PWM11 WGM11</span>
00085 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
00086 <span class="preprocessor"></span>
00087
00088 <span class="comment">// Timer/clock prescaler values and timer overflow rates</span>
00089 <span class="comment">// tics = rate at which the timer counts up</span>
00090 <span class="comment">// 8bitoverflow = rate at which the timer overflows 8bits (or reaches 256)</span>
00091 <span class="comment">// 16bit [overflow] = rate at which the timer overflows 16bits (65536)</span>
00092 <span class="comment">// </span>
00093 <span class="comment">// overflows can be used to generate periodic interrupts</span>
00094 <span class="comment">//</span>
00095 <span class="comment">// for 8MHz crystal</span>
00096 <span class="comment">// 0 = STOP (Timer not counting)</span>
00097 <span class="comment">// 1 = CLOCK tics= 8MHz 8bitoverflow= 31250Hz 16bit= 122.070Hz</span>
00098 <span class="comment">// 2 = CLOCK/8 tics= 1MHz 8bitoverflow= 3906.25Hz 16bit= 15.259Hz</span>
00099 <span class="comment">// 3 = CLOCK/64 tics= 125kHz 8bitoverflow= 488.28Hz 16bit= 1.907Hz</span>
00100 <span class="comment">// 4 = CLOCK/256 tics= 31250Hz 8bitoverflow= 122.07Hz 16bit= 0.477Hz</span>
00101 <span class="comment">// 5 = CLOCK/1024 tics= 7812.5Hz 8bitoverflow= 30.52Hz 16bit= 0.119Hz</span>
00102 <span class="comment">// 6 = External Clock on T(x) pin (falling edge)</span>
00103 <span class="comment">// 7 = External Clock on T(x) pin (rising edge)</span>
00104
00105 <span class="comment">// for 4MHz crystal</span>
00106 <span class="comment">// 0 = STOP (Timer not counting)</span>
00107 <span class="comment">// 1 = CLOCK tics= 4MHz 8bitoverflow= 15625Hz 16bit= 61.035Hz</span>
00108 <span class="comment">// 2 = CLOCK/8 tics= 500kHz 8bitoverflow= 1953.125Hz 16bit= 7.629Hz</span>
00109 <span class="comment">// 3 = CLOCK/64 tics= 62500Hz 8bitoverflow= 244.141Hz 16bit= 0.954Hz</span>
00110 <span class="comment">// 4 = CLOCK/256 tics= 15625Hz 8bitoverflow= 61.035Hz 16bit= 0.238Hz</span>
00111 <span class="comment">// 5 = CLOCK/1024 tics= 3906.25Hz 8bitoverflow= 15.259Hz 16bit= 0.060Hz</span>
00112 <span class="comment">// 6 = External Clock on T(x) pin (falling edge)</span>
00113 <span class="comment">// 7 = External Clock on T(x) pin (rising edge)</span>
00114
00115 <span class="comment">// for 3.69MHz crystal</span>
00116 <span class="comment">// 0 = STOP (Timer not counting)</span>
00117 <span class="comment">// 1 = CLOCK tics= 3.69MHz 8bitoverflow= 14414Hz 16bit= 56.304Hz</span>
00118 <span class="comment">// 2 = CLOCK/8 tics= 461250Hz 8bitoverflow= 1801.758Hz 16bit= 7.038Hz</span>
00119 <span class="comment">// 3 = CLOCK/64 tics= 57625.25Hz 8bitoverflow= 225.220Hz 16bit= 0.880Hz</span>
00120 <span class="comment">// 4 = CLOCK/256 tics= 14414.063Hz 8bitoverflow= 56.305Hz 16bit= 0.220Hz</span>
00121 <span class="comment">// 5 = CLOCK/1024 tics= 3603.516Hz 8bitoverflow= 14.076Hz 16bit= 0.055Hz</span>
00122 <span class="comment">// 6 = External Clock on T(x) pin (falling edge)</span>
00123 <span class="comment">// 7 = External Clock on T(x) pin (rising edge)</span>
00124
00125 <span class="comment">// for 32.768KHz crystal on timer 2 (use for real-time clock)</span>
00126 <span class="comment">// 0 = STOP</span>
00127 <span class="comment">// 1 = CLOCK tics= 32.768kHz 8bitoverflow= 128Hz</span>
00128 <span class="comment">// 2 = CLOCK/8 tics= 4096kHz 8bitoverflow= 16Hz</span>
00129 <span class="comment">// 3 = CLOCK/32 tics= 1024kHz 8bitoverflow= 4Hz</span>
00130 <span class="comment">// 4 = CLOCK/64 tics= 512Hz 8bitoverflow= 2Hz</span>
00131 <span class="comment">// 5 = CLOCK/128 tics= 256Hz 8bitoverflow= 1Hz</span>
00132 <span class="comment">// 6 = CLOCK/256 tics= 128Hz 8bitoverflow= 0.5Hz</span>
00133 <span class="comment">// 7 = CLOCK/1024 tics= 32Hz 8bitoverflow= 0.125Hz</span>
00134
<a name="l00135"></a><a class="code" href="group__timer.html#ga15">00135</a> <span class="preprocessor">#define TIMER_CLK_STOP 0x00 </span><span class="comment">///< Timer Stopped</span>
<a name="l00136"></a><a class="code" href="group__timer.html#ga16">00136</a> <span class="comment"></span>#define TIMER_CLK_DIV1 0x01 <span class="comment">///< Timer clocked at F_CPU</span>
<a name="l00137"></a><a class="code" href="group__timer.html#ga17">00137</a> <span class="comment"></span>#define TIMER_CLK_DIV8 0x02 <span class="comment">///< Timer clocked at F_CPU/8</span>
<a name="l00138"></a><a class="code" href="group__timer.html#ga18">00138</a> <span class="comment"></span>#define TIMER_CLK_DIV64 0x03 <span class="comment">///< Timer clocked at F_CPU/64</span>
<a name="l00139"></a><a class="code" href="group__timer.html#ga19">00139</a> <span class="comment"></span>#define TIMER_CLK_DIV256 0x04 <span class="comment">///< Timer clocked at F_CPU/256</span>
<a name="l00140"></a><a class="code" href="group__timer.html#ga20">00140</a> <span class="comment"></span>#define TIMER_CLK_DIV1024 0x05 <span class="comment">///< Timer clocked at F_CPU/1024</span>
<a name="l00141"></a><a class="code" href="group__timer.html#ga21">00141</a> <span class="comment"></span>#define TIMER_CLK_T_FALL 0x06 <span class="comment">///< Timer clocked at T falling edge</span>
<a name="l00142"></a><a class="code" href="group__timer.html#ga22">00142</a> <span class="comment"></span>#define TIMER_CLK_T_RISE 0x07 <span class="comment">///< Timer clocked at T rising edge</span>
<a name="l00143"></a><a class="code" href="group__timer.html#ga23">00143</a> <span class="comment"></span>#define TIMER_PRESCALE_MASK 0x07 <span class="comment">///< Timer Prescaler Bit-Mask</span>
00144 <span class="comment"></span>
<a name="l00145"></a><a class="code" href="group__timer.html#ga24">00145</a> <span class="preprocessor">#define TIMERRTC_CLK_STOP 0x00 </span><span class="comment">///< RTC Timer Stopped</span>
<a name="l00146"></a><a class="code" href="group__timer.html#ga25">00146</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV1 0x01 <span class="comment">///< RTC Timer clocked at F_CPU</span>
<a name="l00147"></a><a class="code" href="group__timer.html#ga26">00147</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV8 0x02 <span class="comment">///< RTC Timer clocked at F_CPU/8</span>
<a name="l00148"></a><a class="code" href="group__timer.html#ga27">00148</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV32 0x03 <span class="comment">///< RTC Timer clocked at F_CPU/32</span>
<a name="l00149"></a><a class="code" href="group__timer.html#ga28">00149</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV64 0x04 <span class="comment">///< RTC Timer clocked at F_CPU/64</span>
<a name="l00150"></a><a class="code" href="group__timer.html#ga29">00150</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV128 0x05 <span class="comment">///< RTC Timer clocked at F_CPU/128</span>
<a name="l00151"></a><a class="code" href="group__timer.html#ga30">00151</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV256 0x06 <span class="comment">///< RTC Timer clocked at F_CPU/256</span>
<a name="l00152"></a><a class="code" href="group__timer.html#ga31">00152</a> <span class="comment"></span>#define TIMERRTC_CLK_DIV1024 0x07 <span class="comment">///< RTC Timer clocked at F_CPU/1024</span>
<a name="l00153"></a><a class="code" href="group__timer.html#ga32">00153</a> <span class="comment"></span>#define TIMERRTC_PRESCALE_MASK 0x07 <span class="comment">///< RTC Timer Prescaler Bit-Mask</span>
00154 <span class="comment"></span>
00155 <span class="comment">// default prescale settings for the timers</span>
00156 <span class="comment">// these settings are applied when you call</span>
00157 <span class="comment">// timerInit or any of the timer<x>Init</span>
<a name="l00158"></a><a class="code" href="group__timer.html#ga33">00158</a> <span class="preprocessor">#define TIMER0PRESCALE TIMER_CLK_DIV8 </span><span class="comment">///< timer 0 prescaler default</span>
<a name="l00159"></a><a class="code" href="group__timer.html#ga34">00159</a> <span class="comment"></span>#define TIMER1PRESCALE TIMER_CLK_DIV64 <span class="comment">///< timer 1 prescaler default</span>
<a name="l00160"></a><a class="code" href="group__timer.html#ga35">00160</a> <span class="comment"></span>#define TIMER2PRESCALE TIMERRTC_CLK_DIV64 <span class="comment">///< timer 2 prescaler default</span>
00161 <span class="comment"></span>
00162 <span class="comment">// interrupt macros for attaching user functions to timer interrupts</span>
00163 <span class="comment">// use these with timerAttach( intNum, function )</span>
00164 <span class="preprocessor">#define TIMER0OVERFLOW_INT 0</span>
00165 <span class="preprocessor"></span><span class="preprocessor">#define TIMER1OVERFLOW_INT 1</span>
00166 <span class="preprocessor"></span><span class="preprocessor">#define TIMER1OUTCOMPAREA_INT 2</span>
00167 <span class="preprocessor"></span><span class="preprocessor">#define TIMER1OUTCOMPAREB_INT 3</span>
00168 <span class="preprocessor"></span><span class="preprocessor">#define TIMER1INPUTCAPTURE_INT 4</span>
00169 <span class="preprocessor"></span><span class="preprocessor">#define TIMER2OVERFLOW_INT 5</span>
00170 <span class="preprocessor"></span><span class="preprocessor">#define TIMER2OUTCOMPARE_INT 6</span>
00171 <span class="preprocessor"></span><span class="preprocessor">#ifdef OCR0 // for processors that support output compare on Timer0</span>
00172 <span class="preprocessor"></span><span class="preprocessor">#define TIMER0OUTCOMPARE_INT 7</span>
00173 <span class="preprocessor"></span><span class="preprocessor">#define TIMER_NUM_INTERRUPTS 8</span>
00174 <span class="preprocessor"></span><span class="preprocessor">#else</span>
00175 <span class="preprocessor"></span><span class="preprocessor">#define TIMER_NUM_INTERRUPTS 7</span>
00176 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
00177 <span class="preprocessor"></span>
00178 <span class="comment">// default type of interrupt handler to use for timers</span>
00179 <span class="comment">// *do not change unless you know what you're doing</span>
00180 <span class="comment">// Value may be SIGNAL or INTERRUPT</span>
00181 <span class="preprocessor">#ifndef TIMER_INTERRUPT_HANDLER</span>
00182 <span class="preprocessor"></span><span class="preprocessor">#define TIMER_INTERRUPT_HANDLER SIGNAL</span>
00183 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
00184 <span class="preprocessor"></span>
00185 <span class="comment">// functions</span>
00186 <span class="preprocessor">#define delay delay_us</span>
00187 <span class="preprocessor"></span><span class="preprocessor">#define delay_ms timerPause</span>
00188 <span class="preprocessor"></span><span class="keywordtype">void</span> delay_us(<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> time_us);
00189 <span class="comment"></span>
00190 <span class="comment">//! initializes timing system (all timers)</span>
00191 <span class="comment"></span><span class="comment">// runs all timer init functions</span>
00192 <span class="comment">// sets all timers to default prescale values #defined in systimer.c</span>
00193 <span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga1">timerInit</a>(<span class="keywordtype">void</span>);
00194
00195 <span class="comment">// default initialization routines for each timer</span>
00196 <span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga2">timer0Init</a>(<span class="keywordtype">void</span>); <span class="comment">///< initialize timer0</span>
00197 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga3">timer1Init</a>(<span class="keywordtype">void</span>); <span class="comment">///< initialize timer1</span>
00198 <span class="comment"></span><span class="preprocessor">#ifdef TCNT2 // support timer2 only if it exists</span>
00199 <span class="preprocessor"></span><span class="keywordtype">void</span> timer2Init(<span class="keywordtype">void</span>); <span class="comment">///< initialize timer2</span>
00200 <span class="comment"></span><span class="preprocessor">#endif</span>
00201 <span class="preprocessor"></span>
00202 <span class="comment">// Clock prescaler set/get commands for each timer/counter</span>
00203 <span class="comment">// For setting the prescaler, you should use one of the #defines</span>
00204 <span class="comment">// above like TIMER_CLK_DIVx, where [x] is the division rate</span>
00205 <span class="comment">// you want.</span>
00206 <span class="comment">// When getting the current prescaler setting, the return value</span>
00207 <span class="comment">// will be the [x] division value currently set.</span>
00208 <span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga4">timer0SetPrescaler</a>(u08 prescale); <span class="comment">///< set timer0 prescaler</span>
00209 <span class="comment"></span>u16 <a class="code" href="group__timer.html#ga5">timer0GetPrescaler</a>(<span class="keywordtype">void</span>); <span class="comment">///< get timer0 prescaler</span>
00210 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga6">timer1SetPrescaler</a>(u08 prescale); <span class="comment">///< set timer1 prescaler</span>
00211 <span class="comment"></span>u16 <a class="code" href="group__timer.html#ga7">timer1GetPrescaler</a>(<span class="keywordtype">void</span>); <span class="comment">///< get timer0 prescaler</span>
00212 <span class="comment"></span><span class="preprocessor">#ifdef TCNT2 // support timer2 only if it exists</span>
00213 <span class="preprocessor"></span><span class="keywordtype">void</span> <a class="code" href="group__timer128.html#ga8">timer2SetPrescaler</a>(u08 prescale); <span class="comment">///< set timer2 prescaler</span>
00214 <span class="comment"></span>u16 <a class="code" href="group__timer128.html#ga12">timer2GetPrescaler</a>(<span class="keywordtype">void</span>); <span class="comment">///< get timer2 prescaler</span>
00215 <span class="comment"></span><span class="preprocessor">#endif</span>
00216 <span class="preprocessor"></span>
00217
00218 <span class="comment">// TimerAttach and Detach commands</span>
00219 <span class="comment">// These functions allow the attachment (or detachment) of any user function</span>
00220 <span class="comment">// to a timer interrupt. "Attaching" one of your own functions to a timer</span>
00221 <span class="comment">// interrupt means that it will be called whenever that interrupt happens.</span>
00222 <span class="comment">// Using attach is better than rewriting the actual INTERRUPT() function</span>
00223 <span class="comment">// because your code will still work and be compatible if the timer library</span>
00224 <span class="comment">// is updated. Also, using Attach allows your code and any predefined timer</span>
00225 <span class="comment">// code to work together and at the same time. (ie. "attaching" your own</span>
00226 <span class="comment">// function to the timer0 overflow doesn't prevent timerPause from working,</span>
00227 <span class="comment">// but rather allows you to share the interrupt.)</span>
00228 <span class="comment">//</span>
00229 <span class="comment">// timerAttach(TIMER1OVERFLOW_INT, myOverflowFunction);</span>
00230 <span class="comment">// timerDetach(TIMER1OVERFLOW_INT)</span>
00231 <span class="comment">//</span>
00232 <span class="comment">// timerAttach causes the myOverflowFunction() to be attached, and therefore</span>
00233 <span class="comment">// execute, whenever an overflow on timer1 occurs. timerDetach removes the</span>
00234 <span class="comment">// association and executes no user function when the interrupt occurs.</span>
00235 <span class="comment">// myOverflowFunction must be defined with no return value and no arguments:</span>
00236 <span class="comment">//</span>
00237 <span class="comment">// void myOverflowFunction(void) { ... }</span>
00238 <span class="comment"></span>
00239 <span class="comment">//! Attach a user function to a timer interrupt</span>
00240 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga8">timerAttach</a>(u08 interruptNum, <span class="keywordtype">void</span> (*userFunc)(<span class="keywordtype">void</span>) );<span class="comment"></span>
00241 <span class="comment">//! Detach a user function from a timer interrupt</span>
00242 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga9">timerDetach</a>(u08 interruptNum);
00243
00244
00245 <span class="comment">// timing commands</span><span class="comment"></span>
00246 <span class="comment">/// A timer-based delay/pause function</span>
00247 <span class="comment">/// @param pause_ms Number of integer milliseconds to wait.</span>
00248 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga10">timerPause</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> pause_ms);
00249
00250 <span class="comment">// overflow counters</span>
00251 <span class="keywordtype">void</span> <a class="code" href="group__timer.html#ga11">timer0ClearOverflowCount</a>(<span class="keywordtype">void</span>); <span class="comment">///< Clear timer0's overflow counter. </span>
00252 <span class="comment"></span><span class="keywordtype">long</span> <a class="code" href="group__timer.html#ga12">timer0GetOverflowCount</a>(<span class="keywordtype">void</span>); <span class="comment">///< read timer0's overflow counter</span>
00253 <span class="comment"></span><span class="preprocessor">#ifdef TCNT2 // support timer2 only if it exists</span>
00254 <span class="preprocessor"></span><span class="keywordtype">void</span> timer2ClearOverflowCount(<span class="keywordtype">void</span>); <span class="comment">///< clear timer2's overflow counter</span>
00255 <span class="comment"></span><span class="keywordtype">long</span> timer2GetOverflowCount(<span class="keywordtype">void</span>); <span class="comment">///< read timer0's overflow counter</span>
00256 <span class="comment"></span><span class="preprocessor">#endif</span>
00257 <span class="preprocessor"></span><span class="comment"></span>
00258 <span class="comment">/// @defgroup timerpwm Timer PWM Commands</span>
00259 <span class="comment">/// @ingroup timer</span>
00260 <span class="comment">/// These commands control PWM functionality on timer1</span>
00261 <span class="comment"></span><span class="comment">// PWM initialization and set commands for timer1</span>
00262 <span class="comment">// timer1PWMInit()</span>
00263 <span class="comment">// configures the timer1 hardware for PWM mode on pins OC1A and OC1B.</span>
00264 <span class="comment">// bitRes should be 8,9,or 10 for 8,9,or 10bit PWM resolution</span>
00265 <span class="comment">//</span>
00266 <span class="comment">// timer1PWMOff()</span>
00267 <span class="comment">// turns off all timer1 PWM output and set timer mode to normal state</span>
00268 <span class="comment">//</span>
00269 <span class="comment">// timer1PWMAOn() and timer1PWMBOn()</span>
00270 <span class="comment">// turn on output of PWM signals to OC1A or OC1B pins</span>
00271 <span class="comment">// NOTE: Until you define the OC1A and OC1B pins as outputs, and run</span>
00272 <span class="comment">// this "on" command, no PWM output will be output</span>
00273 <span class="comment">//</span>
00274 <span class="comment">// timer1PWMAOff() and timer1PWMBOff()</span>
00275 <span class="comment">// turn off output of PWM signals to OC1A or OC1B pins</span>
00276 <span class="comment">//</span>
00277 <span class="comment">// timer1PWMASet() and timer1PWMBSet()</span>
00278 <span class="comment">// sets the PWM duty cycle for each channel</span>
00279 <span class="comment">// NOTE: <pwmDuty> should be in the range 0-255 for 8bit PWM</span>
00280 <span class="comment">// <pwmDuty> should be in the range 0-511 for 9bit PWM</span>
00281 <span class="comment">// <pwmDuty> should be in the range 0-1023 for 10bit PWM</span>
00282 <span class="comment">// NOTE: the PWM frequency can be controlled in increments by setting the</span>
00283 <span class="comment">// prescaler for timer1</span><span class="comment"></span>
00284 <span class="comment">//@{</span>
00285 <span class="comment"></span>
00286 <span class="comment"></span>
00287 <span class="comment">/// Enter standard PWM Mode on timer1.</span>
00288 <span class="comment">/// \param bitRes indicates the period/resolution to use for PWM output in timer bits.</span>
00289 <span class="comment">/// Must be either 8, 9, or 10 bits corresponding to PWM periods of 256, 512, or 1024 timer tics.</span>
00290 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga0">timer1PWMInit</a>(u08 bitRes);
00291 <span class="comment"></span>
00292 <span class="comment">/// Enter PWM Mode on timer1 with a specific top-count value.</span>
00293 <span class="comment">/// \param topcount indicates the desired PWM period in timer tics.</span>
00294 <span class="comment">/// Can be a number between 1 and 65535 (16-bit).</span>
00295 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga1">timer1PWMInitICR</a>(u16 topcount);
00296 <span class="comment"></span>
00297 <span class="comment">/// Turn off all timer1 PWM output and set timer mode to normal.</span>
00298 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga2">timer1PWMOff</a>(<span class="keywordtype">void</span>);
00299 <span class="comment"></span>
00300 <span class="comment">/// Turn on/off Timer1 PWM outputs.</span>
00301 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga3">timer1PWMAOn</a>(<span class="keywordtype">void</span>); <span class="comment">///< Turn on timer1 Channel A (OC1A) PWM output.</span>
00302 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga4">timer1PWMBOn</a>(<span class="keywordtype">void</span>); <span class="comment">///< Turn on timer1 Channel B (OC1B) PWM output.</span>
00303 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga5">timer1PWMAOff</a>(<span class="keywordtype">void</span>); <span class="comment">///< turn off timer1 Channel A (OC1A) PWM output</span>
00304 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga6">timer1PWMBOff</a>(<span class="keywordtype">void</span>); <span class="comment">///< turn off timer1 Channel B (OC1B) PWM output</span>
00305 <span class="comment"></span>
00306 <span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga7">timer1PWMASet</a>(u16 pwmDuty); <span class="comment">///< set duty of timer1 Channel A (OC1A) PWM output</span>
00307 <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="group__timerpwm.html#ga8">timer1PWMBSet</a>(u16 pwmDuty); <span class="comment">///< set duty of timer1 Channel B (OC1B) PWM output</span>
00308 <span class="comment"></span><span class="comment"></span>
00309 <span class="comment">//@}</span>
00310 <span class="comment"></span><span class="comment">//@}</span>
00311 <span class="comment"></span>
00312 <span class="comment">// Pulse generation commands have been moved to the pulse.c library</span>
00313
00314 <span class="preprocessor">#endif</span>
</pre></div><hr size="1"><address style="align: right;"><small>Generated on Sun Oct 29 03:41:07 2006 for Procyon AVRlib by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.2 </small></address>
</body>
</html>
|