Skip to main content

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 Install

PyPI version badge

The library is packaged on PyPI and can be installed with pip:

pip install odroid-wiringpi

Usage

import odroid_wiringpi as wiringpi

# One of the following MUST be called before using IO functions:
wiringpi.wiringPiSetup()      # For sequential pin numbering
# OR
wiringpi.wiringPiSetupSys()   # For /sys/class/gpio with GPIO pin numbering
# OR
wiringpi.wiringPiSetupGpio()  # For GPIO pin numbering

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:

WiringPi 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)

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)

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

SPI:

The wiringPiSPIDataRW() function needs to be passed a bytes object in Python 3. In Python 2, it takes a string. The following should work in either Python 2 or 3:

wiringpi.wiringPiSPISetup(channel, speed)
buf = bytes([your data here])
retlen, retdata = wiringpi.wiringPiSPIDataRW(0, buf)

Now, retlen will contain the number of bytes received/read by the call. retdata will contain the data itself, and in Python 3, buf will have been modified to contain it as well (that won’t happen in Python 2, because then buf is a string, and strings are immutable).

Full details of the API at: http://www.wiringpi.com

Manual Build

Get/setup repo

git clone --recursive https://github.com/WiringPi/WiringPi-Python.git
cd WiringPi-Python

Don’t forget the --recursive; it is required to also pull in the WiringPi C code from its own repository.

Prerequisites

To rebuild the bindings you must first have installed swig, python-dev, and python-setuptools (or their python3- equivalents). WiringPi should also be installed system-wide for access to the gpio tool.

sudo apt-get install python-dev python-setuptools swig wiringpi

Build & install with

sudo python setup.py install

Or Python 3:

sudo python3 setup.py install

Release files for odroid-wiringpi 3.17.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for odroid-wiringpi 3.17.1
File Size Uploaded
odroid_wiringpi-3.17.1.tar.gz 173.4 kB Details

Release files / odroid_wiringpi-3.17.1.tar.gz

Download URL odroid_wiringpi-3.17.1.tar.gz
Size 173.4 kB
Tags Source
SHA-256 checksum
How to use checksums
721acf62d39c588ff1ab6d8e1ee033c1e544bc163abee84a4fa34b65f66c75ba
BLAKE2b-256 checksum
How to use checksums
7a6478589cb95634f8cad85675d4be23da14ddff6a9e29bfeb224d2d4de87e52
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 colorama/0.4.4 importlib-metadata/4.6.4 keyring/23.5.0 pkginfo/1.8.2 readme-renderer/34.0 requests-toolbelt/0.9.1 requests/2.25.1 rfc3986/1.5.0 tqdm/4.57.0 urllib3/1.26.5 CPython/3.10.12

Release history Release notifications | RSS feed

This release

3.17.1 This release

1 release file

3.17.0

1 release file

3.16.4

1 release file

3.16.2

1 release file

3.16.1

1 release file

3.15.3

1 release file

3.15.0

1 release file

3.14.6

1 release file

3.14.5

1 release file

3.14.4

1 release file

3.14.0

1 release file

3.13.6

1 release file

3.13.5

1 release file

3.13.2

1 release file

3.8

1 release file

3.7

2 release files

3.6

1 release file

3.4

1 release file

3.3-1

2 release files

3.3

1 release file

3.2-2

2 release files

3.2-1

1 release file

3.2

1 release file

3.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page