| commit | 2a1be1fccea30818b0e4fb3e3a0c89a182da7012 | [log] [tgz] |
|---|---|---|
| author | Philip Howard <phil@gadgetoid.com> | Wed Mar 09 10:59:23 2016 +0000 |
| committer | Philip Howard <phil@gadgetoid.com> | Wed Mar 09 10:59:23 2016 +0000 |
| tree | bdc06158e41c5f894f771b0cf862ac3ef34a678b | |
| parent | 9dbb08d313ba7a41c42c98018c96e3f357fdbb58 [diff] | |
| parent | 478d4717509b5530abff8b90be42ed3c537bf243 [diff] |
Merge pull request #34 from obtitus/master clarification of install instructions
#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
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.
sudo apt-get install python-dev python-setuptools swig
##Build WiringPi
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 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(6,1) # Set pin 6 to 1 ( OUTPUT ) wiringpi2.digitalWrite(6,1) # Write 1 ( HIGH ) to pin 6 wiringpi2.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.
wiringpi2.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.
wiringpi2.softToneCreate(PIN) wiringpi2.softToneWrite(PIN,FREQUENCY)
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