| commit | 1b9c63aa440c7d975c14c75e898d35f545fc61aa | [log] [tgz] |
|---|---|---|
| author | Joe Rickerby <joerick@mac.com> | Wed Jul 20 11:39:04 2016 +0100 |
| committer | GitHub <noreply@github.com> | Wed Jul 20 11:39:04 2016 +0100 |
| tree | fc9a335dba1c99afa2bfef07e9296dafc30a8dd3 | |
| parent | 321ca837fd62fb2feff87cefebc2b37acf41810c [diff] |
Add `apt-get install wiringpi` to README Fix #37
#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.
#Quick Build
A quick and dirty build script is supplied to install WiringPi-Python for Python 2 and 3. Just:
sudo apt-get install wiringpi git clone --recursive https://github.com/WiringPi/WiringPi-Python.git cd WiringPi-Python ./build.sh
#Manual Build
##Get/setup repo
git clone --recursive https://github.com/WiringPi/WiringPi-Python.git cd WiringPi-Python git submodule update --init
##Prerequisites To rebuild the bindings you must first have python-dev, python-setuptools and swig installed. Wiring Pi should also be installed system-wide for access to the gpio tool.
sudo apt-get install python-dev python-setuptools swig wiringpi
##Build WiringPi
cd WiringPi sudo ./build
##Generate Bindings
Return to the root directory of the repository and:
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
##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