GPIO cleanup on exit in Raspberry Pi

Introduction

Cleaning up GPIO pins when your program ends helps avoid errors and keeps the pins ready for the next use.

When your Raspberry Pi program uses GPIO pins to control LEDs or buttons.

Before you stop or restart your program that controls hardware pins.

To prevent warnings or errors if you run your GPIO program multiple times.

When you want to make sure pins are set back to a safe state after your program finishes.

Syntax

Raspberry Pi

import RPi.GPIO as GPIO

# Setup pins
GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.OUT)

# Your code here

# Cleanup pins when done
GPIO.cleanup()

GPIO.cleanup() resets all used GPIO pins to input mode.

Call GPIO.cleanup() at the end of your program or when exiting.

Examples

Turn on an LED connected to pin 18, then clean up the pins after.

Raspberry Pi

import RPi.GPIO as GPIO

GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.OUT)

GPIO.output(18, GPIO.HIGH)

GPIO.cleanup()

Turn on pin 23 for 2 seconds, then always clean up even if interrupted.

Raspberry Pi

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(23, GPIO.OUT)

try:
    GPIO.output(23, GPIO.HIGH)
    time.sleep(2)
finally:
    GPIO.cleanup()

Sample Program

This program turns on an LED on pin 24 for 3 seconds, then turns it off and cleans up the GPIO pins safely.

Raspberry Pi

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(24, GPIO.OUT)

try:
    print('LED on pin 24 is ON')
    GPIO.output(24, GPIO.HIGH)
    time.sleep(3)
    print('LED on pin 24 is OFF')
    GPIO.output(24, GPIO.LOW)
finally:
    GPIO.cleanup()
    print('GPIO cleanup done')

Important Notes

Always use try...finally or similar to ensure GPIO.cleanup() runs even if your program crashes.

Cleaning up prevents warnings like "This channel is already in use" when you rerun your program.

Summary

Use GPIO.cleanup() to reset pins when your program ends.

Call cleanup inside finally to run it no matter what.

This keeps your Raspberry Pi GPIO pins safe and ready for next use.

Practice

1. Why is it important to call GPIO.cleanup() at the end of a Raspberry Pi GPIO program?

easy

A. It resets the GPIO pins to a safe state for future use.

B. It speeds up the program execution.

C. It increases the voltage output of the pins.

D. It disables the Raspberry Pi's network connection.

Solution

1. Step 1: Understand GPIO pin states

   GPIO pins can remain set as input or output after a program ends, which may cause issues.

2. Step 2: Purpose of GPIO.cleanup()

   Calling GPIO.cleanup() resets all pins to their default safe state, preventing conflicts in future programs.

3. Final Answer:

   It resets the GPIO pins to a safe state for future use. -> Option A

4. Quick Check:

   GPIO.cleanup() resets pins = B [OK]

Hint: Always reset pins with GPIO.cleanup() after use [OK]

Common Mistakes:

• Thinking cleanup speeds up code
• Believing cleanup changes voltage
• Confusing cleanup with network settings

2. Which of the following is the correct way to ensure GPIO.cleanup() runs even if your program encounters an error?

easy

A. Place GPIO.cleanup() inside a try block only.

B. Place GPIO.cleanup() inside a finally block.

C. Call GPIO.cleanup() before setting up pins.

D. Call GPIO.cleanup() only if no errors occur.

Solution

1. Step 1: Understand try-finally structure

   The finally block runs no matter what, even if errors happen.

2. Step 2: Place cleanup in finally

   Putting GPIO.cleanup() in finally ensures pins reset even on exceptions.

3. Final Answer:

   Place GPIO.cleanup() inside a finally block. -> Option B

4. Quick Check:

   Cleanup in finally = A [OK]

Hint: Use finally block to always run cleanup [OK]

Common Mistakes:

• Putting cleanup only in try block
• Calling cleanup before setup
• Skipping cleanup on errors

3. What will be the output of this code snippet if an error occurs during the loop?

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.OUT)
try:
    for i in range(3):
        if i == 1:
            raise Exception('Error!')
        GPIO.output(18, GPIO.HIGH)
finally:
    GPIO.cleanup()
print('Program ended')

medium

A. Program ended

B. GPIO pins remain set high

C. No output, program hangs

D. Exception: Error!

Solution

1. Step 1: Analyze try block with error

   The loop raises an exception at i=1, but the finally block still runs.

2. Step 2: Effect of finally block

   GPIO.cleanup() runs regardless, resetting pins, but since there is no except block, the exception propagates after finally, so print('Program ended') does not execute. The output is the exception message.

3. Final Answer:

   Exception: Error! -> Option D

4. Quick Check:

   finally runs cleanup, exception prints = B [OK]

Hint: finally block runs even on errors [OK]

Common Mistakes:

• Thinking 'Program ended' prints on error
• Thinking pins stay set after error
• Ignoring finally block execution

4. Identify the error in this code that prevents GPIO pins from being cleaned up properly:

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BCM)
GPIO.setup(17, GPIO.OUT)
try:
    GPIO.output(17, GPIO.HIGH)
except:
    print('Error occurred')
finally:
    GPIO.cleanup()

medium

A. Missing parentheses after GPIO.cleanup in finally block.

B. GPIO.setup should be called after GPIO.cleanup.

C. GPIO.output should be inside except block.

D. No try-except block needed for GPIO.

Solution

1. Step 1: Check finally block syntax

   The code uses GPIO.cleanup without parentheses, so cleanup is not called.

2. Step 2: Effect of missing parentheses

   Without parentheses, cleanup is a reference, not a function call, so pins are not reset.

3. Final Answer:

   Missing parentheses after GPIO.cleanup in finally block. -> Option A

4. Quick Check:

   Call cleanup with () = D [OK]

Hint: Always add () to call GPIO.cleanup() [OK]

Common Mistakes:

• Forgetting parentheses on cleanup
• Calling setup after cleanup
• Misplacing GPIO.output inside except

5. You wrote a program controlling multiple GPIO pins with different modes. How should you structure your code to ensure all pins reset properly even if your program crashes unexpectedly?

hard

A. Use GPIO.cleanup() inside except block only.

B. Call GPIO.cleanup() only at the very start of the program.

C. Place all GPIO setup and output calls inside a try block, and call GPIO.cleanup() in a finally block.

D. Do not use GPIO.cleanup() to avoid resetting pins.

Solution

1. Step 1: Organize GPIO code with try-finally

   Put all GPIO setup and control inside try to catch errors and ensure cleanup.

2. Step 2: Use finally block for cleanup

   Call GPIO.cleanup() in finally so it runs no matter what, resetting all pins safely.

3. Final Answer:

   Place all GPIO setup and output calls inside a try block, and call GPIO.cleanup() in a finally block. -> Option C

4. Quick Check:

   try-finally with cleanup = C [OK]

Hint: Use try-finally to guarantee cleanup on exit [OK]

Common Mistakes:

• Calling cleanup only at start
• Skipping cleanup on errors
• Avoiding cleanup to keep pins set