gpiozero¶
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.
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(17)
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(17)
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, update your repositories list:
sudo apt-get update
Then install the package of your choice. Both Python 3 and Python 2 are supported. Python 3 is recommended:
sudo apt-get install python3-gpiozero
or:
sudo apt-get install python-gpiozero
Documentation¶
Comprehensive documentation is available at https://gpiozero.readthedocs.io/.
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 mailto:ben@raspberrypi.org
Contributors¶
- Ben Nuttall (project maintainer)
- Dave Jones
- Martin O’Hanlon
- Andrew Scheller
- Schelto vanDoorn
Table of Contents¶
- Recipes
- Pin Numbering
- LED
- LED with variable brightness
- Button
- Button controlled LED
- Button controlled camera
- Shutdown button
- LEDBoard
- LEDBarGraph
- Traffic Lights
- Travis build LED indicator
- Push button stop motion
- Reaction Game
- GPIO Music Box
- All on when pressed
- Full color LED
- Motion sensor
- Light sensor
- Distance sensor
- Motors
- Robot
- Button controlled robot
- Keyboard controlled robot
- Motion sensor robot
- Potentiometer
- Measure temperature with an ADC
- Full color LED controlled by 3 potentiometers
- Controlling the Pi’s own LEDs
- Notes
- Contributing
- Input Devices
- Output Devices
- SPI Devices
- Boards and Accessories
- Internal Devices
- Generic Classes
- Source Tools
- Pins
- Exceptions
- Changelog
- Release 1.3.1 (2016-08-31 ... later)
- Release 1.3.0 (2016-08-31)
- Release 1.2.0 (2016-04-10)
- Release 1.1.0 (2016-02-08)
- Release 1.0.0 (2015-11-16)
- Release 0.9.0 (2015-10-25)
- Release 0.8.0 (2015-10-16)
- Release 0.7.0 (2015-10-09)
- Release 0.6.0 (2015-09-28)
- Release 0.5.0 (2015-09-24)
- Release 0.4.0 (2015-09-23)
- Release 0.3.0 (2015-09-22)
- Release 0.2.0 (2015-09-21)
- License