Skip to content
This repository

Python API for controlling GPIO and I2C devices connected to the Raspberry Pi

branch: master

selector example marked up for code-guide, plus improvements to blink…

… and button-blink examples
latest commit c5e21e9d80
Nat Pryce authored
Octocat-spinner-32 doc Update getting-started-with-gpio.md March 24, 2013
Octocat-spinner-32 examples selector example marked up for code-guide, plus improvements to blink… June 03, 2013
Octocat-spinner-32 quick2wire make selector, timer and semaphore lazy-initialise the file descripto… June 01, 2013
Octocat-spinner-32 tools upgraded virtualenv to 1.9.1 (security fix) March 11, 2013
Octocat-spinner-32 .gitignore create versioned tgz in dist/ and check that version in setup.py corr… March 29, 2013
Octocat-spinner-32 DEVELOPMENT-CHECKLIST.md Update DEVELOPMENT-CHECKLIST.md January 26, 2013
Octocat-spinner-32 DEVELOPMENT.md Update DEVELOPMENT.md January 10, 2013
Octocat-spinner-32 GPL.txt initial import of gpio code and python development environment stuff … May 03, 2012
Octocat-spinner-32 LGPL.txt initial import of gpio code and python development environment stuff … May 03, 2012
Octocat-spinner-32 LICENSE.md initial import of gpio code and python development environment stuff … May 03, 2012
Octocat-spinner-32 MANIFEST.in initial import of gpio code and python development environment stuff … May 03, 2012
Octocat-spinner-32 MIT_LICENSE.txt initial import of gpio code and python development environment stuff … May 03, 2012
Octocat-spinner-32 Makefile start generating example documentation with code-guide (http://github… May 30, 2013
Octocat-spinner-32 README.md removed old OS compatability warning April 02, 2013
Octocat-spinner-32 pytest.ini only run timerfd tests if 'timer' device is activated January 31, 2013
Octocat-spinner-32 requirements.txt use pip -r requirements.txt to manage dependencies December 17, 2012
Octocat-spinner-32 setup.py stop setup.py blowing up when run from outside the git repo May 30, 2013
README.md

Quick2Wire Python API

A Python library for controlling the hardware attached to the Raspberry Pi's header pins, without running as the root user.

Dependencies

The library depends on Python 3. To install Python 3 run this command from an administrator account, such as pi:

sudo apt-get install python3

You'll also find the python tools virtualenv and pip useful:

sudo apt-get install python-pip
sudo apt-get install python-virtualenv

The GPIO API depends on Quick2Wire GPIO Admin. To install Quick2Wire GPIO Admin, follow the instructions at http://github.com/quick2wire/quick2wire-gpio-admin

The I2C and SPI API depend on support in the kernel. Recent raspbian kernels should be fine.

Installation

The library is currently under active development, so we do not recommend installing it into the system-wide Python libraries. Instead, you can either use it without installation or install it into an isolated Python development environment created with virtualenv.

To use the library without installation, add the full path of the source tree to the PYTHONPATH environment variable. For example:

export QUICK2WIRE_API_HOME=[the directory cloned from Git or unpacked from the source archive]
export PYTHONPATH=$PYTHONPATH:$QUICK2WIRE_API_HOME

If you're using virtualenv, make your virtualenv active, and then run:

python3 setup.py install

Getting Started

Help and Support

There is a discussion group in which you can ask questions about the library.

If you have discovered a bug or would like to request a feature, raise an issue in the issue tracker.

Something went wrong with that request. Please try again.