Metadata-Version: 2.0
Name: wiringpi
Version: 2.32.1
Summary: A python interface to WiringPi 2.0 library which allows for
    easily interfacing with the GPIO pins of the Raspberry Pi. Also supports
    i2c and SPI
Home-page: https://github.com/WiringPi/WiringPi-Python/
Author: Philip Howard
Author-email: phil@gadgetoid.com
License: UNKNOWN
Platform: UNKNOWN

#WiringPi for Python

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

WiringPi 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

##Get/setup repo
```bash
git clone --recursive https://github.com/WiringPi/WiringPi-Python.git
cd WiringPi-Python
```

##Prerequisites
To rebuild the bindings
you **must** first have python-dev, python-setuptools and swig installed.
```bash
sudo apt-get install python-dev python-setuptools swig
```

##Build WiringPi
```bash
cd WiringPi
sudo ./build
```

##Generate Bindings
`swig2.0 -python wiringpi.i`
or
`swig3.0 -thread -python wiringpi.i`

##Build & install with
`sudo python setup.py install`

Or Python 3:
`sudo python3 setup.py install`

#Class-based Usage
Description incoming!

##Usage

	import wiringpi

	wiringpi.wiringPiSetup() # For sequential pin numbering, one of these MUST be called before using IO functions
	# OR
	wiringpi.wiringPiSetupSys() # For /sys/class/gpio with GPIO pin numbering
	# OR
	wiringpi.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):

	wiringpi.mcp23017Setup(65,0x20)
	wiringpi.pinMode(65,1)
	wiringpi.digitalWrite(65,1)

**General IO:**

	wiringpi.pinMode(6,1) # Set pin 6 to 1 ( OUTPUT )
	wiringpi.digitalWrite(6,1) # Write 1 ( HIGH ) to pin 6
	wiringpi.digitalRead(6) # Read pin 6

**Setting up a peripheral:**
WiringPi2 supports expanding your range of available "pins" by setting up a port expander. The implementation details of
your port expander will be handled transparently, and you can write to the additional pins ( starting from PIN_OFFSET >= 64 )
as if they were normal pins on the Pi.

	wiringpi.mcp23017Setup(PIN_OFFSET,I2C_ADDR)

**Soft Tone**

Hook a speaker up to your Pi and generate music with softTone. Also useful for generating frequencies for other uses such as modulating A/C.

	wiringpi.softToneCreate(PIN)
	wiringpi.softToneWrite(PIN,FREQUENCY)

**Bit shifting:**

	wiringpi.shiftOut(1,2,0,123) # Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2

**Serial:**

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

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