From 231cc8c45deb010149b13c9a2d5bfb99d9fccf15 Mon Sep 17 00:00:00 2001 From: "Zachary J. Fields" Date: Tue, 4 Apr 2017 16:54:52 -0700 Subject: [PATCH] Add interrupt example to basics --- .../01.Basics/Interrupt/Interrupt.ino | 45 ++++++++++++++++++ .../01.Basics/Interrupt/Interrupt.txt | 1 + .../examples/01.Basics/Interrupt/layout.png | Bin 0 -> 41127 bytes .../01.Basics/Interrupt/schematic.png | Bin 0 -> 26364 bytes 4 files changed, 46 insertions(+) create mode 100644 build/shared/examples/01.Basics/Interrupt/Interrupt.ino create mode 100644 build/shared/examples/01.Basics/Interrupt/Interrupt.txt create mode 100644 build/shared/examples/01.Basics/Interrupt/layout.png create mode 100644 build/shared/examples/01.Basics/Interrupt/schematic.png diff --git a/build/shared/examples/01.Basics/Interrupt/Interrupt.ino b/build/shared/examples/01.Basics/Interrupt/Interrupt.ino new file mode 100644 index 00000000000..6c6588678d8 --- /dev/null +++ b/build/shared/examples/01.Basics/Interrupt/Interrupt.ino @@ -0,0 +1,45 @@ +/* + Interrupt + Use a pushbutton to control an LED; powered by interrupts. + + This sample uses an interrupt service routine (ISR) named `blink` to toggle + a global state variable and then uses the built-in LED to display the value + of the cached state to the user. The work of updating the cached state happens + asychronously in the interrupt service routine. + + This sample can easily be modified from behaving as a button into behaving as + a switch, by changing the interrupt mode from CHANGE to LOW. Futhermore, this + example can be modified to update the built-in LED from inside in the ISR, + which would allow the loop function to be empty yet still allow actions and + reactions to occur. + + This example code is in the public domain (adapted from + https://www.arduino.cc/en/Reference/attachInterrupt). + + adapted 1 APR 2017 + by Zachary J. Fields +*/ + +const byte interruptPin = 2; +volatile byte state = LOW; + +void blink () { + state = !state; // toggle the cached state +} + +// the setup function runs once when you press reset or power the board +void setup () { + // initialize digital pin LED_BUILTIN as an output. + pinMode(LED_BUILTIN, OUTPUT); + // initialize digital pin as input with pull-up resistor (i.e. always HIGH, unless deliberately pulled LOW) + pinMode(interruptPin, INPUT_PULLUP); + // attach an interrupt service routine to be executed when pin state changes + attachInterrupt(digitalPinToInterrupt(interruptPin), blink, CHANGE); +} + +// the loop function runs over and over again forever +void loop () { + // update the LED to reflect the cached state updated with interrupts + digitalWrite(LED_BUILTIN, state); +} + diff --git a/build/shared/examples/01.Basics/Interrupt/Interrupt.txt b/build/shared/examples/01.Basics/Interrupt/Interrupt.txt new file mode 100644 index 00000000000..6540c7a2bbd --- /dev/null +++ b/build/shared/examples/01.Basics/Interrupt/Interrupt.txt @@ -0,0 +1 @@ +Use a pushbutton to control an LED; powered by interrupts. diff --git a/build/shared/examples/01.Basics/Interrupt/layout.png b/build/shared/examples/01.Basics/Interrupt/layout.png new file mode 100644 index 0000000000000000000000000000000000000000..1a312f2f0e44683193d769cb0f064e128283feb5 GIT binary patch literal 41127 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

1Fe0H1F-jyAi9!C{)*> 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 literal 0 HcmV?d00001 diff --git a/build/shared/examples/01.Basics/Interrupt/schematic.png b/build/shared/examples/01.Basics/Interrupt/schematic.png new file mode 100644 index 0000000000000000000000000000000000000000..12964ff9895bc54c26705509231e7e8724db3494 GIT binary patch literal 26364 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