Skip to content

Repository files navigation

gpiozero

Latest VersionBuild TestsCode Coverage

A simple interface to GPIO devices 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:

fromgpiozeroimportLEDfromtimeimportsleepled=LED(17)
whileTrue:
led.on()
sleep(1)
led.off()
sleep(1)

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

fromgpiozeroimportLED, Buttonfromsignalimportpauseled=LED(17)
button=Button(3)
button.when_pressed=led.onbutton.when_released=led.offpause()

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 ben@raspberrypi.org

Contributors

Core developers:

Other contributors:

About

A simple interface to everyday GPIO components used with Raspberry Pi

Resources

Contributing

Stars

1 star

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages