Arduino: Attachinterrupt (Interrupt, Function, Mode)
Arduino: Attachinterrupt (Interrupt, Function, Mode)
Arduino: Attachinterrupt (Interrupt, Function, Mode)
Arduino search
Buy | Download | Getting Started | Learning | Reference | Hardware | FAQ Blog » | Forum » | Playground »
Specifies a function to call when an external interrupt occurs. Replaces any previous function that was attached to the
interrupt. Most Arduino boards have two external interrupts: numbers 0 (on digital pin 2) and 1 (on digital pin 3). The
Arduino Mega has an additional four: numbers 2 (pin 21), 3 (pin 20), 4 (pin 19), and 5 (pin 18).
Parameters
function: the function to call when the interrupt occurs; this function must take no parameters and return nothing. This
function is sometimes referred to as an interrupt service routine.
mode defines when the interrupt should be triggered. Four contstants are predefined as valid values:
Returns
none
Note
Inside the attached function, delay() won't work and the value returned by millis() will not increment. Serial data received
while in the function may be lost. You should declare as volatile any variables that you modify within the attached function.
Using Interrupts
Interrupts are useful for making things happen automatically in microcontroller programs, and can help solve timing problems.
A good task for using an interrupt might be reading a rotary encoder, monitoring user input.
If you wanted to insure that a program always caught the pulses from a rotary encoder, never missing a pulse, it would
make it very tricky to write a program to do anything else, because the program would need to constantly poll the sensor
lines for the encoder, in order to catch pulses when they occurred. Other sensors have a similar interface dynamic too, such
as trying to read a sound sensor that is trying to catch a click, or an infrared slot sensor (photo-interrupter) trying to catch
a coin drop. In all of these situations, using an interrupt can free the microcontroller to get some other work done while not
missing the doorbell.
Example
int p in = 13;
vola t ile i nt st ate = LO W;
http://arduino.cc/en/Reference/AttachInterrupt Page 1 of 2
Arduino - AttachInterrupt 10/19/09 11:37 AM
void set up ()
{
pi n Mod e( pin , OUTP UT);
at t ach In ter ru pt(0 , bl ink, CHANG E);
}
void loo p( )
{
di g ita lW rit e( pin, sta te);
}
void bli nk ()
{
st a te = !st at e;
}
See also
detachInterrupt
Reference Home
The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in
the reference are released into the public domain.
Edit Page | Page History | Printable View | All Recent Site Changes
http://arduino.cc/en/Reference/AttachInterrupt Page 2 of 2