ℹ️️ Since 2024, GC2 has taken over maintenance of the project, supporting new OS versions as well as current hardware generations. We are dedicated to keeping the arguably best-performing GPIO Library for Raspberry Pi running smoothly. We strive to do our best, but please note that this is a community effort, and we cannot provide any guarantees or take responsibility for implementing specific features you may need.

⚠️️ 🚧 on Pi5, PWM support is currently under development and will not work at this point. If you're interested in the progress, please check the corresponding issue.

WiringPi

WiringPi is a performant GPIO access library written in C for Raspberry Pi boards.

To compile programs with wiringPi, you need to include wiringPi.h as well as link against wiringPi:

#include <wiringPi.h> // Include WiringPi library!

int main(void)
{
    wiringPiSetupGpio();
    ...
}

gcc -o myapp myapp.c -l wiringPi

Be sure to check out the examples, build them using Make:

cd examples
make <example-name | really-all>

The tool gpio can be used to set single pins as well as get the state of everything at once:

pi@wiringdemo:~ $ gpio readall
 +-----+-----+---------+------+---+---Pi 3B--+---+------+---------+-----+-----+
 | BCM | wPi |   Name  | Mode | V | Physical | V | Mode | Name    | wPi | BCM |
 +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
 |     |     |    3.3v |      |   |  1 || 2  |   |      | 5v      |     |     |
 |   2 |   8 |   SDA.1 |   IN | 1 |  3 || 4  |   |      | 5v      |     |     |
 |   3 |   9 |   SCL.1 |   IN | 1 |  5 || 6  |   |      | 0v      |     |     |
 |   4 |   7 | GPIO. 7 |   IN | 0 |  7 || 8  | 0 | IN   | TxD     | 15  | 14  |
 |     |     |      0v |      |   |  9 || 10 | 1 | IN   | RxD     | 16  | 15  |
 |  17 |   0 | GPIO. 0 |   IN | 1 | 11 || 12 | 1 | IN   | GPIO. 1 | 1   | 18  |
 |  27 |   2 | GPIO. 2 |   IN | 1 | 13 || 14 |   |      | 0v      |     |     |
 |  22 |   3 | GPIO. 3 |   IN | 1 | 15 || 16 | 0 | IN   | GPIO. 4 | 4   | 23  |
 |     |     |    3.3v |      |   | 17 || 18 | 1 | IN   | GPIO. 5 | 5   | 24  |
 |  10 |  12 |    MOSI |   IN | 0 | 19 || 20 |   |      | 0v      |     |     |
 |   9 |  13 |    MISO |   IN | 0 | 21 || 22 | 1 | IN   | GPIO. 6 | 6   | 25  |
 |  11 |  14 |    SCLK |   IN | 0 | 23 || 24 | 1 | IN   | CE0     | 10  | 8   |
 |     |     |      0v |      |   | 25 || 26 | 0 | IN   | CE1     | 11  | 7   |
 |   0 |  30 |   SDA.0 |   IN | 1 | 27 || 28 | 1 | IN   | SCL.0   | 31  | 1   |
 |   5 |  21 | GPIO.21 |   IN | 0 | 29 || 30 |   |      | 0v      |     |     |
 |   6 |  22 | GPIO.22 |   IN | 0 | 31 || 32 | 1 | IN   | GPIO.26 | 26  | 12  |
 |  13 |  23 | GPIO.23 |   IN | 1 | 33 || 34 |   |      | 0v      |     |     |
 |  19 |  24 | GPIO.24 |   IN | 1 | 35 || 36 | 1 | IN   | GPIO.27 | 27  | 16  |
 |  26 |  25 | GPIO.25 |   IN | 1 | 37 || 38 | 1 | IN   | GPIO.28 | 28  | 20  |
 |     |     |      0v |      |   | 39 || 40 | 1 | IN   | GPIO.29 | 29  | 21  |
 +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
 | BCM | wPi |   Name  | Mode | V | Physical | V | Mode | Name    | wPi | BCM |
 +-----+-----+---------+------+---+---Pi 3B--+---+------+---------+-----+-----+

Installing

You can either build it yourself or use the prebuilt binaries:

Prebuilt Binaries

Grab the latest release from here.

Unzip/use the portable prebuilt verison:

# unzip the archive
tar -xfv wiringpi_<version>.tar.gz

Install the dpkg package:

# install a dpkg
sudo dpkg -i <wiringpi_<version>.dpkg

From Source

sudo apt-get install git git-core

git clone https://github.com/wiringpi/wiringpi
cd wiringPi
./build

Ports

wiringPi has been wrapped for multiple languages:

• Node - https://github.com/WiringPi/WiringPi-Node
• Perl - https://github.com/WiringPi/WiringPi-Perl
• PHP - https://github.com/WiringPi/WiringPi-PHP
• Python - https://github.com/WiringPi/WiringPi-Python
• Ruby - https://github.com/WiringPi/WiringPi-Ruby

Support

Please use the issue system of GitHub.

Please do not email Gordon or @Gadgetoid.

Please don't email GC2 for reporting issues, you might contact us for anything that's not meant for the public.

History

This repository is the continuation of 'Gordon's wiringPi' which has been deprecated, a while ago.

• The last "old wiringPi" source of Gordon's release can be found at the final_source_2.50 tag.
• The default master branch contains code that has been written since version 2.5 to provide support for newer hardware as well as new features.

Debug

WIRINGPI_DEBUG=1 ./my_wiringpi_program WIRINGPI_DEBUG=1 ./gpio readall