Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A module to control Raspberry Pi GPIO channels

Project description

This package provides a class to control the GPIO on a Raspberry Pi.

Note that this module is unsuitable for real-time or timing critical applications. This is because you can not predict when Python will be busy garbage collecting. It also runs under the Linux kernel which is not suitable for real time applications - it is multitasking O/S and another process may be given priority over the CPU, causing jitter in your program. If you are after true real-time performance and predictability, buy yourself an Arduino !

Note that the current release does not support SPI, I2C, PWM or serial functionality on the RPi yet. This is planned for the near future - watch this space! One-wire functionality is also planned.

Example Usage :

import RPi.GPIO as GPIO

# to use Raspberry Pi board pin numbers

# set up GPIO output channel
GPIO.setup(12, GPIO.OUT)

# set RPi board pin 12 high
GPIO.output(12, GPIO.HIGH)

# set up GPIO output channel with an initial state
GPIO.setup(26, GPIO.OUT, initial=GPIO.LOW)

# set up GPIO input with pull-up control
#   (pull_up_down be PUD_OFF, PUD_UP or PUD_DOWN, default PUD_OFF)
GPIO.setup(11, GPIO.IN, pull_up_down=GPIO.PUD_UP)

# input from RPi board pin 11
input_value = GPIO.input(11)

# set up rising edge detection (EXPERIMENTAL)

# check for an event (EXPERIMENTAL)
if GPIO.event_detected(11):
    print('Rising edge detected!')

# set up falling edge detection (EXPERIMENTAL)
GPIO.set_rising_event(11, enable=False)  # disable rising edge detection (as set above)

# set up high detection (EXPERIMENTAL)
GPIO.set_falling_event(11, enable=False)  # disable falling edge detection (as set above)

# set up low detection (EXPERIMENTAL)
GPIO.set_high_event(11, enable=False)  # disable high detection (as set above)

# to change to BCM GPIO numbering

# to reset every channel that has been set up by this program to INPUT with no pullup/pulldown and no event detection.

Change Log


  • Fix for installing on Arch Linux (Python 3.3) (issue 20)
  • Initial value when setting a channel as an output (issue 19)


  • Added VERSION
  • Permit input() of channels set as outputs (Eric Ptak <>)


  • Added support for Revision 2 boards
  • Added cleanup() function and removed automatic reset functionality on program exit
  • Added get_function() to read existing GPIO channel functionality (suggestion from Eric Ptak <>)
  • Added set_rising_event()
  • Added set_falling_event()
  • Added set_high_event()
  • Added set_low_event()
  • Added event_detected()
  • Added test/
  • Converted debian to armhf
  • Fixed C function short_wait() (thanks to Thibault Porteboeuf <>)


  • Fixed critical bug with swapped high/low state on outputs
  • Added pull-up / pull-down setup functionality for inputs


  • Rewritten as a C extension
  • Now uses /dev/mem and SoC registers instead of /sys/class/gpio
  • Faster!
  • Make call to GPIO.setmode() mandatory
  • Added GPIO.HIGH and GPIO.LOW constants


  • Changed status from alpha to beta
  • Added setmode() to be able to use BCM GPIO 00.nn channel numbers
  • Renamed InvalidPinException to InvalidChannelException


  • Fixed direction bug
  • Added (to include missing file)
  • Changed GPIO channel number to pin number
  • Tested and working!


  • Added GPIO table
  • Refactored
  • Fixed a few critical bugs
  • Still completely untested!


  • Internal refactoring. Still completely untested!


  • First version. Completely untested until I can get hold of a Raspberry Pi!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for RPi.GPIO, version 0.4.2a
Filename, size File type Python version Upload date Hashes
Filename, size RPi.GPIO-0.4.2a.tar.gz (15.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page