GPIO Zero

A simple interface to everyday GPIO components used with Raspberry Pi.

Created by Ben Nuttall of the Raspberry Pi Foundation, Dave Jones, and other contributors.

Latest release

The latest release is v0.7.0 beta 2 released on 9th October 2015.

About

With very little code, you can quickly get going connecting your physical components together:

from gpiozero import LED, Button

led = LED(2)
button = Button(3)

button.when_pressed = led.on
button.when_released = led.off

The library includes interfaces to many simple everyday components, as well as some more complex things like sensors, analogue-to-digital converters, full colour LEDs, robotics kits and more.

Install

Install with pip:

sudo apt-get install python-pip python3-pip
sudo pip install gpiozero
sudo pip-3.2 install gpiozero

Both Python 3 and Python 2 are supported. Python 3 is recommended!

Upgrade

Upgrade to the latest version with:

sudo pip install gpiozero --upgrade
sudo pip-3.2 install gpiozero --upgrade

Getting started

See the input devices and output devices to get started. Also see the boards & accessories page for examples of using the included accessories.

For common programs using multiple components together, see the recipes page.

Development

This project is being developed on GitHub. Join in:

Provide suggestions, report bugs and ask questions as Issues
Provide examples we can use as recipes
Contribute to the code

Alternatively, email suggestions and feedback to ben@raspberrypi.org or add to the Google Doc.

Contributors

Ben Nuttall (project maintainer)
Dave Jones
Martin O'Hanlon

2.1 KiB Raw Blame History