Git Browser for ODROID
Code Review Sign In
git.odroid.com / WiringPi2-Python / 4051aab52a4783b6e3cd88adcbf80b106f02c355
commit4051aab52a4783b6e3cd88adcbf80b106f02c355[log] [tgz]
authorPhilip Howard <phil@gadgetoid.com>Sat Aug 12 10:12:04 2017 +0100
committerGitHub <noreply@github.com>Sat Aug 12 10:12:04 2017 +0100
treebc72b5043578d7a6f5a704a3c2b5a2e029d9ca92
parent380f9a906af00e5b483c9bcaa265ad0cf0c966c6 [diff]
parent1b9c63aa440c7d975c14c75e898d35f545fc61aa [diff]
Merge pull request #39 from joerick/patch-1

Add `apt-get install wiringpi` to README
tree: bc72b5043578d7a6f5a704a3c2b5a2e029d9ca92
  1. _wiringpi2/
  2. examples/
  3. tests/
  4. WiringPi
  5. .gitignore
  6. .gitmodules
  7. bindings.i
  8. build.sh
  9. CHANGES.txt
  10. constants.py
  11. generate-bindings.py
  12. LICENSE.txt
  13. Makefile
  14. MANIFEST.in
  15. README.md
  16. setup.cfg
  17. setup.py
  18. wiringpi-class.py
  19. wiringpi.i
README.md

Note

This is an unofficial port of Gordon's WiringPi library. Please do not email Gordon if you have issues, he will not be able to help.

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