mirror of
https://github.com/KevinMidboe/python-gpiozero.git
synced 2025-10-29 17:50:37 +00:00
f0eefdb8f2
Notes now works with embedded code sections, but the spacing is still wrong as is the language selection. Oh well, come back to it later...
81 lines
2.1 KiB
Markdown
81 lines
2.1 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.7.0 beta 2** released on 9th October 2015.
|
|
|
|
## About
|
|
|
|
With very little code, you can quickly get going connecting your physical
|
|
components together:
|
|
|
|
```python
|
|
from gpiozero import LED, Button
|
|
|
|
led = LED(2)
|
|
button = Button(3)
|
|
|
|
button.when_pressed = led.on
|
|
button.when_released = led.off
|
|
```
|
|
|
|
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
|
|
|
|
Install with pip:
|
|
|
|
```bash
|
|
sudo apt-get install python-pip python3-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:
|
|
|
|
```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)
|