mirror of
https://github.com/KevinMidboe/python-gpiozero.git
synced 2025-10-29 17:50:37 +00:00
105 lines
2.4 KiB
Markdown
105 lines
2.4 KiB
Markdown
# GPIO Zero
|
|
|
|
A simple interface to everyday GPIO components used with Raspberry Pi.
|
|
|
|
Created by [Ben Nuttall](https://github.com/bennuttall) of the [Raspberry Pi
|
|
Foundation](https://www.raspberrypi.org/), [Dave
|
|
Jones](https://github.com/waveform80), 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:
|
|
|
|
```python
|
|
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:
|
|
|
|
```python
|
|
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:
|
|
|
|
```python
|
|
sudo apt-get install python-pip python3-pip python-spidev python3-spidev
|
|
```
|
|
|
|
Install with pip:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
sudo pip install gpiozero --upgrade
|
|
sudo pip-3.2 install gpiozero --upgrade
|
|
```
|
|
|
|
## Getting started
|
|
|
|
See the [input devices](inputs.md) and [output devices](outputs.md) to get
|
|
started. Also see the [boards & accessories](boards.md) page for examples of
|
|
using the included accessories.
|
|
|
|
For common programs using multiple components together, see the
|
|
[recipes](recipes.md) page.
|
|
|
|
## Development
|
|
|
|
This project is being developed on
|
|
[GitHub](https://github.com/RPi-Distro/python-gpiozero). Join in:
|
|
|
|
* Provide suggestions, report bugs and ask questions as
|
|
[Issues](https://github.com/RPi-Distro/python-gpiozero/issues)
|
|
* Provide examples we can use as
|
|
[recipes](http://pythonhosted.org/gpiozero/recipes/)
|
|
* Contribute to the code
|
|
|
|
Alternatively, email suggestions and feedback to ben@raspberrypi.org or add to
|
|
the [Google Doc](https://goo.gl/8zJLif).
|
|
|
|
## Contributors
|
|
|
|
- [Ben Nuttall](https://github.com/bennuttall) (project maintainer)
|
|
- [Dave Jones](https://github.com/waveform80)
|
|
- [Martin O'Hanlon](https://github.com/martinohanlon)
|