mirror of
https://github.com/KevinMidboe/python-gpiozero.git
synced 2025-10-29 17:50:37 +00:00
100 lines
2.4 KiB
ReStructuredText
100 lines
2.4 KiB
ReStructuredText
========
|
|
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.
|
|
|
|
Latest release
|
|
==============
|
|
|
|
The latest release is 1.0 released on 16th November 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!
|
|
|
|
Documentation
|
|
=============
|
|
|
|
Comprehensive documentation is available at `pythonhosted.org/gpiozero`_.
|
|
|
|
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`_
|
|
|
|
|
|
.. _Ben Nuttall: https://github.com/bennuttall
|
|
.. _Raspberry Pi Foundation: https://www.raspberrypi.org/
|
|
.. _Dave Jones: https://github.com/waveform80
|
|
.. _pythonhosted.org/gpiozero: http://pythonhosted.org/gpiozero
|
|
.. _GitHub: https://github.com/RPi-Distro/python-gpiozero
|
|
.. _Issues: https://github.com/RPi-Distro/python-gpiozero/issues
|
|
.. _recipes: http://pythonhosted.org/gpiozero/recipes/
|
|
.. _Google Doc: https://goo.gl/8zJLif
|
|
.. _Ben Nuttall: https://github.com/bennuttall
|
|
.. _Dave Jones: https://github.com/waveform80
|
|
.. _Martin O'Hanlon: https://github.com/martinohanlon
|