README.rst

======
WiringPi 2 for Python
======

WiringPi: An implementation of most of the Arduino Wiring
	functions for the Raspberry Pi

WiringPi2: WiringPi version 2 implements new functions for managing IO expanders.

Testing:
========
Build with gcc version 4.6.3 (Debian 4.6.3-14+rpi1)
Built against Python 2.7.2, Python 3.2.3

Prerequisites:
==============
You must have python-dev and python-setuptools installed
If you manually rebuild the bindings with swig -python wiringpi.i

Get/setup repo:
===============
git clone https://github.com/Gadgetoid/WiringPi2-Python.git
cd WiringPi2-Python

Build & install with:
=====================
sudo python setup.py install

Or Python 3
sudo python3 setup.py install

Class-based Usage:
==================
Description incoming!

Usage:
======
import wiringpi2
wiringpi2.wiringPiSetup // For sequential pin numbering, one of these MUST be called before using IO functions
OR
wiringpi2.wiringPiSetupSys // For /sys/class/gpio with GPIO pin numbering
OR
wiringpi2.wiringPiSetupGpio // For GPIO pin numbering

Setting up IO expanders (This example was tested on a quick2wire board with one digital IO expansion board connected via I2C):
wiringpi2.mcp23017Setup(65,0x20)
wiringpi2.pinMode(65,1)
wiringpi2.digitalWrite(65,1)

General IO:
-----------
wiringpi2.pinMode(1,1) // Set pin 1 to output
wiringpi2.digitalWrite(1,1) // Write 1 HIGH to pin 1
wiringpi2.digitalRead(1) // Read pin 1

Bit shifting:
-------------
wiringpi2.shiftOut(1,2,0,123) // Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2

Serial:
-------
serial = wiringpi2.serialOpen('/dev/ttyAMA0',9600) // Requires device/baud and returns an ID
wiringpi2.serialPuts(serial,"hello")
wiringpi2.serialClose(serial) // Pass in ID

Full details at:
----------------
http://www.wiringpi.com