Timer Library to work with Arduino DUE
- Download the Latest release from GitHub.
- Unzip and modify the Folder name to "DueTimer" (Remove the '-version')
- Paste the modified folder on your Library folder (On your
Librariesfolder inside Sketchbooks or Arduino software). - Re-open Arduino Software
To call a function handler every 1000 microseconds:
Timer3.attachInterrupt(handler).start(1000);
// or:
Timer3.attachInterrupt(handler).setPeriod(1000).start();
// or, to select whichever available timer:
Timer.getAvailable().attachInterrupt(handler).start(1000);To call a function handler 10 times a second:
Timer3.attachInterrupt(handler).setFrequency(10).start();In case you need to stop a timer, just do like this:
Timer3.stop();And to continue running:
Timer3.start();There are 9 Timer objects already instantiated for you:
Timer0, Timer1, Timer2, Timer3, Timer4, Timer5, Timer6, Timer7 and Timer8.
Timer4.attachInterrupt(handler).setFrequency(10).start();
// Is the same as:
Timer4.attachInterrupt(handler);
Timer4.setFrequency(10);
Timer4.start();
// To create a custom timer, refer to:
DueTimer myTimer = DueTimer(0); // Creates a Timer 0 object.
DueTimer myTimer = DueTimer(3); // Creates a Timer 3 object.
DueTimer myTimer = DueTimer(t); // Creates a Timer t object.
// Note: Maximum t allowed is 8, as there is only 9 timers [0..8];
Timer1.attachInterrupt(handler1).start(10);
Timer1.attachInterrupt(handler2).start(10);
DueTimer myTimer = DueTimer(1);
myTimer.attachInterrupt(handler3).start(20);
// Will run only handle3, on Timer 1 (You are just overriding the callback)
Timer.getAvailable().attachInterrupt(callback1).start(10);
// Start timer on first available timer
DueTimer::getAvailable().attachInterrupt(callback2).start(10);
// Start timer on second available timer
// And so on...Because Servo Library uses the same callbacks of DueTimer, we provides a custom solution for working with both of them. However, Timers 0,2,3,4 and 5 will not Work anymore.
You will need uncommend the line in DueTimer.h in DueTimer folder inside the Libraries folder. Uncomment the following line in DueTimer.h:
#define USING_SERVO_LIB true
-
getAvailable()- Get the first available Timer. -
attachInterrupt(void (*isr)())- Attach a interrupt (callback function) for the timer of the object. -
detachInterrupt()- Detach current callback of timer. -
start(long microseconds = -1)- Start the timer with an optional period parameter. -
stop()- Stop the timer -
setFrequency(long frequency)- Set the timer frequency -
long getFrequency()- Get the timer frequency -
setPeriod(long microseconds)- Set the timer period (in microseconds) -
long getPeriod()- Get the timer period (in microseconds)
-
unsigned short timer- Stores the object timer id (to access Timers struct array). -
DueTimer(unsigned short _timer)- Instantiate a new DueTimer object for Timer _timer (NOTE: All objects are already instantiated!). -
static const Timer Timers[]- Stores all timers information -
static void (*callbacks[])()- Stores all callbacks for all timers
More information on the Timer Counter module of the µC on the Arduino Due can be found in the documentation file TimerCounter.