RPi.GPIO library setup in Raspberry Pi

Introduction

The RPi.GPIO library helps you control the pins on a Raspberry Pi to connect with lights, buttons, and sensors.

When you want to turn an LED on or off using your Raspberry Pi.

When you need to read input from a button or switch connected to the Pi.

When you want to control motors or other devices with the Pi's pins.

When you are building a simple home automation project using Raspberry Pi.

When you want to learn how to interact with hardware using Python on Raspberry Pi.

Syntax

Raspberry Pi

import RPi.GPIO as GPIO

GPIO.setmode(GPIO.BCM)  # or GPIO.BOARD
GPIO.setup(pin_number, GPIO.OUT)  # or GPIO.IN

GPIO.setmode() chooses how you number the pins: BCM uses the chip's pin numbers, BOARD uses the physical pin numbers.

GPIO.setup() prepares a pin to be an input or output.

Examples

Set pin 18 as an output using BCM numbering.

Raspberry Pi

import RPi.GPIO as GPIO

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

Set physical pin 12 as an input using BOARD numbering.

Raspberry Pi

import RPi.GPIO as GPIO

GPIO.setmode(GPIO.BOARD)
GPIO.setup(12, GPIO.IN)

Sample Program

This program turns an LED connected to pin 18 on for 2 seconds, then turns it off. It cleans up the pin settings at the end.

Raspberry Pi

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)  # Use BCM pin numbering
GPIO.setup(18, GPIO.OUT)  # Set pin 18 as output

try:
    GPIO.output(18, GPIO.HIGH)  # Turn LED on
    print("LED is ON")
    time.sleep(2)  # Wait 2 seconds
    GPIO.output(18, GPIO.LOW)  # Turn LED off
    print("LED is OFF")
finally:
    GPIO.cleanup()  # Reset pins

Important Notes

Always call GPIO.cleanup() at the end to reset pins and avoid warnings next time you run your program.

Use GPIO.setmode() once at the start to choose your pin numbering style.

Make sure your Raspberry Pi has the RPi.GPIO library installed (usually pre-installed on Raspberry Pi OS).

Summary

RPi.GPIO lets you control Raspberry Pi pins with Python.

Use GPIO.setmode() to pick pin numbering style.

Use GPIO.setup() to prepare pins as input or output.

Practice

1. What is the purpose of the GPIO.setmode() function in the RPi.GPIO library?

easy

A. It sets the pin numbering system to use (BOARD or BCM).

B. It cleans up all GPIO pins after use.

C. It sets the direction of a specific pin (input or output).

D. It reads the current value of a GPIO pin.

Solution

1. Step 1: Understand the role of GPIO.setmode()

   This function tells the Raspberry Pi how to number the pins, either by physical board numbers (BOARD) or by Broadcom chip numbers (BCM).

2. Step 2: Differentiate from other functions

   Cleaning pins is done by GPIO.cleanup(), setting pin direction is GPIO.setup(), and reading pin value is done by GPIO.input().

3. Final Answer:

   It sets the pin numbering system to use (BOARD or BCM). -> Option A

4. Quick Check:

   GPIO.setmode() = sets pin numbering [OK]

Hint: Remember: setmode chooses pin numbering style [OK]

Common Mistakes:

• Confusing setmode() with cleanup()
• Thinking setmode() sets pin direction
• Mixing up setmode() with reading pin values

2. Which of the following is the correct way to import the RPi.GPIO library and set the pin numbering mode to BCM?

easy

A. import RPi.GPIO as GPIO\nGPIO.setmode(GPIO.BCM)

B. import RPi.GPIO as GPIO\nGPIO.setmode(GPIO.BOARD)

C. import GPIO\nGPIO.setmode(GPIO.BCM)

D. import RPi.GPIO\nGPIO.setmode(GPIO.BCM)

Solution

1. Step 1: Check the correct import syntax

   The standard way is to import RPi.GPIO as GPIO to use GPIO functions easily.

2. Step 2: Verify the setmode argument

   To set pin numbering to BCM, use GPIO.setmode(GPIO.BCM). import RPi.GPIO as GPIO\nGPIO.setmode(GPIO.BCM) matches both correct import and setmode usage.

3. Final Answer:

   import RPi.GPIO as GPIO\nGPIO.setmode(GPIO.BCM) -> Option A

4. Quick Check:

   Import as GPIO + setmode BCM = import RPi.GPIO as GPIO\nGPIO.setmode(GPIO.BCM) [OK]

Hint: Import as GPIO and use GPIO.BCM for BCM mode [OK]

Common Mistakes:

• Forgetting 'as GPIO' in import
• Using BOARD instead of BCM when BCM is asked
• Importing just GPIO without RPi

3. What will be the output of this code snippet?

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BOARD)
GPIO.setup(7, GPIO.OUT)
print(GPIO.gpio_function(7))

Assuming pin 7 is set as output.

medium

A. 0

B. 3

C. 2

D. 1

Solution

1. Step 1: Understand GPIO.gpio_function()

   This function returns a number representing the pin's current function. For output pins, it returns 1.

2. Step 2: Check pin setup

   Pin 7 is set as GPIO.OUT, so gpio_function(7) returns 1.

3. Final Answer:

   1 -> Option D

4. Quick Check:

   Output pin function code = 1 [OK]

Hint: Output pins return 1 from gpio_function() [OK]

Common Mistakes:

• Assuming gpio_function returns pin number
• Confusing output code with input code
• Not setting pin mode before calling gpio_function

4. Identify the error in this code snippet:

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BOARD)
GPIO.setup(11, "OUT")
GPIO.output(11, True)
GPIO.cleanup()

medium

A. Calling GPIO.cleanup() before output.

B. Using string "OUT" instead of GPIO.OUT in setup.

C. Missing GPIO.setwarnings(False) before setup.

D. Not importing time module for delays.

Solution

1. Step 1: Check GPIO.setup() syntax

   The direction argument must be GPIO.OUT or GPIO.IN, not a string like "OUT".

2. Step 2: Verify other lines

   GPIO.setwarnings() is optional, cleanup is correctly called last, and time module is not needed here.

3. Final Answer:

   Using string "OUT" instead of GPIO.OUT in setup. -> Option B

4. Quick Check:

   Pin direction must be GPIO.OUT, not "OUT" [OK]

Hint: Use GPIO.OUT constant, not string "OUT" [OK]

Common Mistakes:

• Passing pin direction as string
• Calling cleanup too early
• Forgetting to import GPIO properly

5. You want to control an LED connected to pin 12 using BCM numbering. Which sequence of commands correctly sets up the pin and turns the LED on, then cleans up properly?

hard

A. GPIO.setmode(GPIO.BCM)\nGPIO.setup(18, GPIO.OUT)\nGPIO.output(18, True)\nGPIO.cleanup()

B. GPIO.setmode(GPIO.BOARD)\nGPIO.setup(12, GPIO.OUT)\nGPIO.output(12, True)\nGPIO.cleanup()

C. GPIO.setmode(GPIO.BCM)\nGPIO.setup(12, GPIO.OUT)\nGPIO.output(12, True)\nGPIO.cleanup()

D. GPIO.setmode(GPIO.BOARD)\nGPIO.setup(18, GPIO.OUT)\nGPIO.output(18, True)\nGPIO.cleanup()

Solution

1. Step 1: Match numbering mode with pin number

   Pin 12 in BCM mode corresponds to GPIO12, so setmode(GPIO.BCM) and setup(12) is correct.

2. Step 2: Confirm output setup and cleanup

   Pin is set as output, turned on with True, and cleanup is called last to reset pins.

3. Final Answer:

   GPIO.setmode(GPIO.BCM)\nGPIO.setup(12, GPIO.OUT)\nGPIO.output(12, True)\nGPIO.cleanup() -> Option C

4. Quick Check:

   BCM mode + pin 12 + output + cleanup = GPIO.setmode(GPIO.BCM)\nGPIO.setup(12, GPIO.OUT)\nGPIO.output(12, True)\nGPIO.cleanup() [OK]

Hint: Match setmode with pin number system [OK]

Common Mistakes:

• Mixing BOARD and BCM numbering
• Using wrong pin number for chosen mode
• Forgetting to call cleanup()