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.9.0 beta 4 released on 25th October 2015.

About

Component interfaces are provided to allow a frictionless way to get started with physical computing:

from gpiozero import LED
from time import sleep

led = LED(2)

while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)

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

from gpiozero import LED, Button
from signal import pause

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

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

pause()

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

First, install the dependencies:

sudo apt-get install python-pip python3-pip python-spidev python3-spidev

Install with 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.4 KiB Raw Blame History