Interrupt-driven button handling in Arduino - Deep Dive

Overview - Interrupt-driven button handling

What is it?

Interrupt-driven button handling is a way to detect when a button is pressed or released by using special signals called interrupts. Instead of constantly checking the button in a loop, the microcontroller reacts immediately when the button changes state. This makes the program more efficient and responsive.

Why it matters

Without interrupt-driven handling, the microcontroller wastes time checking the button repeatedly, which can slow down other tasks. Interrupts allow the device to respond quickly to button presses without missing any events, improving performance and user experience in real-time applications.

Where it fits

Before learning this, you should understand basic Arduino programming, digital input reading, and how buttons work. After this, you can learn about debouncing techniques, advanced interrupt handling, and multitasking on microcontrollers.

Mental Model

Core Idea

Interrupt-driven button handling lets the microcontroller pause its current work and immediately respond when the button changes state.

Think of it like...

It's like a doorbell: instead of checking the door every few seconds, you just wait for the bell to ring and then answer the door right away.

Main Program Loop
  │
  ▼
[Doing other tasks]
  │
  ├─> Button Press Interrupt Triggered
  │       │
  │       ▼
  │   [Interrupt Service Routine]
  │       │
  │       ▼
  │   [Handle Button Press]
  │       │
  │       ▼
  └─────> Return to Main Loop

Build-Up - 6 Steps

1

Foundation

Understanding Buttons and Digital Input

Concept: Learn how buttons work and how to read their state using Arduino digital input pins.

A button connects or disconnects a circuit when pressed. On Arduino, you connect a button to a digital pin and read its state as HIGH or LOW. When pressed, the pin reads LOW or HIGH depending on wiring. You use pinMode() to set the pin as INPUT_PULLUP or INPUT and digitalRead() to check the button state.

Result

You can detect when a button is pressed or released by reading the pin state in your program.

Knowing how to read button states is the base for any button handling, including interrupts.

2

Foundation

What Are Interrupts on Arduino?

Concept: Introduce interrupts as signals that pause the main program to run special code immediately.

Interrupts let Arduino stop what it's doing and run a small function called an Interrupt Service Routine (ISR) when a specific event happens, like a pin changing state. You set up interrupts using attachInterrupt() with a pin number and a function to run on events like RISING, FALLING, or CHANGE.

Result

Arduino can react instantly to events without waiting for the main loop to check them.

Understanding interrupts is key to writing responsive programs that don't waste time polling.

3

Intermediate

Setting Up Interrupts for Button Presses

🤔Before reading on: do you think you should use RISING, FALLING, or CHANGE to detect a button press? Commit to your answer.

Concept: Learn how to configure interrupts specifically for button presses and releases.

Buttons can cause interrupts on RISING (button release), FALLING (button press), or CHANGE (both). Usually, FALLING is used if the button connects the pin to ground when pressed with INPUT_PULLUP. You write an ISR to handle the button event and attach it with attachInterrupt(digitalPinToInterrupt(pin), ISR, mode).

Result

Your program immediately runs the ISR when the button is pressed or released, without delay.

Choosing the right interrupt mode ensures you detect the exact button event you want.

4

Intermediate

Handling Button Bounce in Interrupts

🤔Before reading on: do you think interrupts automatically handle button bounce, or do you need extra code? Commit to your answer.

Concept: Button presses often cause rapid on/off signals called bounce; learn how to manage this in interrupts.

Mechanical buttons don't switch cleanly; they 'bounce' causing multiple interrupts quickly. To avoid false triggers, you can ignore interrupts for a short time after the first one (debouncing). This is done by recording the last interrupt time with millis() and skipping new interrupts if too soon.

Result

Your program reacts only once per button press, avoiding multiple false triggers.

Knowing how to debounce in interrupts prevents bugs and erratic behavior in button handling.

5

Advanced

Writing Safe Interrupt Service Routines

🤔Before reading on: do you think you can use delay() or Serial.print() inside an ISR? Commit to your answer.

Concept: Learn the rules for writing ISRs that don't break your program.

ISRs must be very fast and cannot use functions like delay() or Serial.print() because they pause the main program. Use only simple, quick operations and volatile variables to communicate with the main loop. Keep ISRs short to avoid missing other interrupts or causing crashes.

Result

Your program remains stable and responsive even with interrupts.

Understanding ISR limitations is crucial for reliable interrupt-driven programs.

6

Expert

Combining Interrupts with Main Loop Logic

🤔Before reading on: do you think ISRs should do all the work or just signal the main loop? Commit to your answer.

Concept: Learn how to use interrupts to signal events and handle complex logic safely in the main loop.

ISRs should only set flags or update variables marked volatile. The main loop checks these flags and performs the heavier work like updating displays or processing data. This separation keeps ISRs fast and the program organized. Use noInterrupts() and interrupts() carefully if you need to protect shared data.

Result

Your program handles button events efficiently and safely without missing inputs or crashing.

Knowing how to split work between ISR and main loop is key for scalable interrupt-driven designs.

Under the Hood

When a button connected to an interrupt pin changes state, the microcontroller hardware detects this and immediately pauses the main program. It saves the current position and runs the Interrupt Service Routine (ISR) linked to that interrupt. After the ISR finishes, the microcontroller resumes the main program exactly where it left off. This hardware-level signal bypasses normal program flow, allowing instant reaction.

Why designed this way?

Interrupts were designed to handle urgent events without delay, unlike polling which wastes time checking repeatedly. This design allows microcontrollers to multitask efficiently, responding to inputs or sensors instantly while still running other code. Alternatives like polling were simpler but less efficient and could miss fast events.

┌─────────────────────────────┐
│        Main Program          │
│  (doing normal tasks)        │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│  Hardware detects pin change │
│  (interrupt triggered)       │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│  Save current program state  │
│  Run Interrupt Service       │
│  Routine (ISR)               │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│  Restore program state       │
│  Resume main program         │
└─────────────────────────────┘

Myth Busters - 4 Common Misconceptions

Quick: Do interrupts automatically fix button bounce without extra code? Commit yes or no.

Common Belief: Interrupts handle button bounce automatically, so no extra debouncing is needed.

Reality: Interrupts trigger on every bounce, causing multiple rapid calls unless you add debouncing code.

Why it matters: Without debouncing, your program may behave erratically, reacting multiple times to a single press.

Quick: Can you safely use delay() inside an ISR? Commit yes or no.

Common Belief: You can use delay() or Serial.print() inside an ISR to debug or wait.

Reality: Using delay() or Serial.print() inside an ISR causes the program to freeze or crash because ISRs must be very fast and cannot wait.

Why it matters: Misusing ISRs leads to unresponsive or unstable programs.

Quick: Does attachInterrupt() work on any Arduino pin? Commit yes or no.

Common Belief: You can attach interrupts to any digital pin on Arduino.

Reality: Only specific pins support hardware interrupts; using others will not work or cause errors.

Why it matters: Trying to use unsupported pins wastes time and causes bugs.

Quick: Does the ISR run in parallel with the main program? Commit yes or no.

Common Belief: ISR runs in parallel, so both ISR and main program run at the same time.

Reality: ISR pauses the main program; they do not run simultaneously but sequentially with the ISR interrupting the main flow.

Why it matters: Misunderstanding this can cause incorrect assumptions about timing and data safety.

Expert Zone

1

Volatile variables are essential to share data between ISR and main code because the compiler otherwise optimizes away repeated reads.

2

Nested interrupts can occur if enabled inside an ISR, but this is rarely needed and can cause complex bugs.

3

Using pin change interrupts instead of external interrupts allows more pins to trigger interrupts but requires more complex handling.

When NOT to use

Interrupt-driven button handling is not ideal for very simple programs where polling is sufficient or when buttons are very noisy and debouncing is complex. In such cases, using polling with software debouncing or dedicated hardware debouncers is better.

Production Patterns

In real devices, interrupts are combined with debouncing timers and state machines to handle multiple buttons reliably. ISRs only set flags, and the main loop handles UI updates and logic. Critical sections protect shared data with noInterrupts() calls. Sometimes, low-power modes use interrupts to wake the microcontroller on button press.

Connections

Event-driven programming

Interrupt-driven button handling is a hardware-level example of event-driven programming where code reacts to events instead of running sequentially.

Understanding interrupts helps grasp how event loops and callbacks work in software frameworks.

Real-time operating systems (RTOS)

Interrupts are fundamental to RTOS design, enabling immediate response to hardware events and task switching.

Knowing interrupt handling prepares you for understanding multitasking and scheduling in RTOS.

Human reflexes in biology

Interrupts are like biological reflexes where the nervous system reacts instantly to stimuli without conscious thought.

This analogy shows how systems prioritize urgent events to improve survival or performance.

Common Pitfalls

#1 Ignoring button bounce causes multiple triggers.

Wrong approach:

void ISR() { buttonPressed = true; } // no debounce

Correct approach:

volatile unsigned long lastInterruptTime = 0;
void ISR() {
unsigned long currentTime = millis();
if (currentTime - lastInterruptTime > 50) {
buttonPressed = true;
lastInterruptTime = currentTime;
}
}

Root cause:

Not accounting for mechanical bounce leads to multiple interrupts firing rapidly.

#2 Using delay() inside ISR freezes program.

Wrong approach:

void ISR() { delay(100); buttonPressed = true; }

Correct approach:

void ISR() { buttonPressed = true; } // keep ISR short and fast

Root cause:

ISRs must be quick; delay() waits and blocks the processor.

#3 Attaching interrupt to unsupported pin causes failure.

Wrong approach:

attachInterrupt(digitalPinToInterrupt(3), ISR, FALLING); // pin 3 not interrupt-capable on some boards

Correct approach:

attachInterrupt(digitalPinToInterrupt(2), ISR, FALLING); // pin 2 is interrupt-capable

Root cause:

Not all pins support hardware interrupts; board-specific knowledge is needed.

Key Takeaways

Interrupt-driven button handling lets your Arduino react instantly to button presses without wasting time checking repeatedly.

You must debounce button inputs even when using interrupts to avoid false multiple triggers.

Interrupt Service Routines must be short, fast, and avoid functions like delay() or Serial.print().

Use volatile variables to safely share data between ISRs and the main program.

Separating quick ISR signaling from main loop processing leads to reliable and maintainable code.