Button press detection in Raspberry Pi - Mini Project: Build & Apply

Button press detection

📖 Scenario: You have a Raspberry Pi connected to a physical button. When you press the button, the Raspberry Pi should detect the press and respond.

🎯 Goal: Build a simple program that detects when the button is pressed and prints a message.

📋 What You'll Learn

Use the gpiozero library to interact with the button.

Create a Button object connected to GPIO pin 2.

Detect when the button is pressed.

Print a message when the button is pressed.

💡 Why This Matters

🌍 Real World

Detecting button presses is common in physical computing projects like home automation, games, or interactive devices.

💼 Career

Understanding hardware input handling is useful for roles in embedded systems, IoT development, and robotics.

1

Set up the button

Import the Button class from the gpiozero library and create a button object connected to GPIO pin 2.

Raspberry Pi

# Import Button and create button on pin 2
# Your code here

Hint

Use from gpiozero import Button and then button = Button(2).

2

Create a press handler

Define a function called on_press that prints "Button was pressed!" when called.

Raspberry Pi

from gpiozero import Button

button = Button(2)

# Define on_press function
# Your code here

Hint

Define a function named on_press that prints the message.

3

Connect the handler to the button press

Assign the on_press function to the when_pressed property of the button object.

Raspberry Pi

from gpiozero import Button

button = Button(2)

def on_press():
    print("Button was pressed!")

# Connect on_press to button.when_pressed
# Your code here

Hint

Use button.when_pressed = on_press to connect the function.

4

Keep the program running

Import pause from signal and call pause() to keep the program running and listening for button presses.

Raspberry Pi

from gpiozero import Button

button = Button(2)

def on_press():
    print("Button was pressed!")

button.when_pressed = on_press

# Import pause and call it to keep program running
# Your code here

Hint

Use from signal import pause and then call pause() at the end.

Practice

1. What does setting a Raspberry Pi GPIO pin as input with a pull-up resistor do when detecting a button press?

easy

A. It keeps the pin at HIGH until the button connects it to LOW when pressed.

B. It keeps the pin at LOW until the button connects it to HIGH when pressed.

C. It disables the pin to save power when the button is not pressed.

D. It makes the pin output a signal when the button is pressed.

Solution

1. Step 1: Understand pull-up resistor behavior

   A pull-up resistor keeps the input pin at a HIGH voltage level by default.

2. Step 2: Detect button press effect on pin

   When the button is pressed, it connects the pin to ground, making the input LOW.

3. Final Answer:

   It keeps the pin at HIGH until the button connects it to LOW when pressed. -> Option A

4. Quick Check:

   Pull-up resistor means default HIGH, press pulls LOW [OK]

Hint: Pull-up means default HIGH, press pulls pin LOW [OK]

Common Mistakes:

• Thinking pull-up sets pin LOW by default
• Confusing input with output pin modes
• Assuming button press sets pin HIGH

2. Which of the following is the correct Python code snippet to set GPIO pin 17 as input with a pull-up resistor on Raspberry Pi?

easy

A. GPIO.setup(17, GPIO.IN, pull_up_down=GPIO.PUD_UP)

B. GPIO.setup(17, GPIO.OUT, pull_up_down=GPIO.PUD_UP)

C. GPIO.setup(17, GPIO.IN)

D. GPIO.setup(17, GPIO.OUT)

Solution

1. Step 1: Identify pin mode for button input

   Button pins must be set as input to read their state.

2. Step 2: Add pull-up resistor parameter

   Use pull_up_down=GPIO.PUD_UP to enable internal pull-up resistor.

3. Final Answer:

   GPIO.setup(17, GPIO.IN, pull_up_down=GPIO.PUD_UP) -> Option A

4. Quick Check:

   Input pin with pull-up resistor = GPIO.IN + PUD_UP [OK]

Hint: Input pin with pull-up uses GPIO.IN and PUD_UP [OK]

Common Mistakes:

• Using GPIO.OUT instead of GPIO.IN
• Omitting pull_up_down parameter
• Setting pull-up resistor on output pin

3. What will be the output of this Python code snippet when the button connected to GPIO 18 is pressed?

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.IN, pull_up_down=GPIO.PUD_UP)

if GPIO.input(18) == GPIO.LOW:
    print("Button Pressed")
else:
    print("Button Not Pressed")

medium

A. No output

B. Button Not Pressed

C. SyntaxError

D. Button Pressed

Solution

1. Step 1: Understand pin setup and input reading

   Pin 18 is set as input with pull-up resistor, so default is HIGH.

2. Step 2: Check condition when button is pressed

   Pressing button pulls pin LOW, so condition GPIO.input(18) == GPIO.LOW is True.

3. Final Answer:

   Button Pressed -> Option D

4. Quick Check:

   Pressed button pulls pin LOW, prints "Button Pressed" [OK]

Hint: Pressed button reads LOW on pull-up input pin [OK]

Common Mistakes:

• Assuming pressed button reads HIGH
• Confusing pull-up with pull-down resistor
• Expecting syntax or runtime errors

4. Identify the error in this Raspberry Pi button press detection code:

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(23, GPIO.IN, pull_up_down=GPIO.PUD_UP)

while True:
    if GPIO.input(23) == GPIO.HIGH:
        print("Button Pressed")
    time.sleep(0.1)

medium

A. time.sleep(0.1) should be before the if statement.

B. The pull_up_down parameter is missing in GPIO.setup.

C. The code should check for GPIO.LOW to detect button press.

D. GPIO.setmode(GPIO.BCM) is incorrect and should be GPIO.BOARD.

Solution

1. Step 1: Review button wiring and logic

   With pull-up resistor, button press pulls pin LOW, not HIGH.

2. Step 2: Check condition in if statement

   Code incorrectly checks for GPIO.HIGH to detect press; should check GPIO.LOW.

3. Final Answer:

   The code should check for GPIO.LOW to detect button press. -> Option C

4. Quick Check:

   Pull-up input reads LOW when pressed, so check GPIO.LOW [OK]

Hint: Pressed button reads LOW on pull-up input pin [OK]

Common Mistakes:

• Checking for HIGH instead of LOW on button press
• Forgetting pull_up_down parameter
• Misplacing sleep causing missed presses

5. You want to detect a button press on GPIO 21 and print "Pressed" only once per press, avoiding multiple prints while the button is held down. Which code snippet correctly implements this behavior?

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(21, GPIO.IN, pull_up_down=GPIO.PUD_UP)

pressed = False
while True:
    if GPIO.input(21) == GPIO.LOW and not pressed:
        print("Pressed")
        pressed = True
    elif GPIO.input(21) == GPIO.HIGH:
        pressed = False
    time.sleep(0.05)

hard

A. This code never prints anything because pressed is always True.

B. This code prints "Pressed" once per press and avoids repeats while held.

C. This code prints "Pressed" continuously while button is held down.

D. This code causes a syntax error due to missing colon.

Solution

1. Step 1: Understand the pressed flag usage

   The variable 'pressed' tracks if the button press was already detected to avoid repeats.

2. Step 2: Analyze the if-elif logic

   When button is LOW and not pressed, it prints once and sets pressed True; when released (HIGH), resets pressed to False.

3. Final Answer:

   This code prints "Pressed" once per press and avoids repeats while held. -> Option B

4. Quick Check:

   pressed flag prevents multiple prints during hold [OK]

Hint: Use a flag variable to print once per press [OK]

Common Mistakes:

• Printing inside loop without flag causes repeated prints
• Not resetting flag on button release
• Syntax errors from missing colons or indentation