Update README.md
1 file changed
tree: c301acc01ab16914eb3a262b1af77cd52608b5ee
  1. _wiringpi2/
  2. examples/
  3. tests/
  4. .gitignore
  5. .gitmodules
  6. bindings.i
  7. build.sh
  8. CHANGES.txt
  9. constants.py
  10. generate-bindings.py
  11. LICENSE.txt
  12. Makefile
  13. MANIFEST.in
  14. README.md
  15. setup.cfg
  16. setup.py
  17. wiringpi-class.py
  18. 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.

For support, comments, questions, etc please join the WiringPi Discord channel: https://discord.gg/SM4WUVG

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