This project implements a compatibility layer between RPi.GPIO syntax and libgpiod semantics.
RPi.GPIO requires non-standard kernel patches that expose the GPIO registers to userspace via
a character device
/dev/gpiomem. As this is not supported by the mainline Linux kernel, any
distribution targeting Raspberry Pi devices running the mainline kernel will not be compatible
with the RPi.GPIO library. As a large number of tutorials, especially those targeted at
beginners, demonstrate use of the RPi's GPIO pins by including RPi.GPIO syntax, this
incompatibility limits users to distributions build on a special downstream kernel maintained
by the Rapberry Pi foundation. We would like to enable beginners on any Linux distribution
by allowing them to follow easily available tutorials.
Using the provided module, one will be able to write python code to use the Raspberry Pi's GPIO pins as if they were using the API implemented by RPi.GPIO, but instead using libgpiod's python bindings. libgpiod provides a straightforward interface for interacting with GPIO pins on supported devices via the mainline Linux kernel interface.
For more detailed information on the design and implementation of this library, please refer to the functional and technical specification.
Do not install
pip3 as that will attempt to install the raspbian-only library
that motivated this project in the first place. If that package is installed alonside this one,
import RPi.GPIO will cause an error as python will attempt to import the wrong
To install the python development dependencies, run
pip install -r requirements.txt.
Use of a virtual env is recomended for a development setup. This will allow local installation
of the library via
pip install -e . in the repository root.
The libgpiod python bindings must be installed and accessible from the development environment.
This package is not available via
pip install and must be installed using the system package
To enable access non-root access to the gpio pins, use the provided
script. Upon successful execution, any user in Linux user group 'gpio' will be able to access
the gpio pins via this library.
To view the locations and surrounding lines of all TODOs, FIXMEs, and NOTEs in the codebase,
notes.sh script included with this project.
This project is free software, please refer to our LICENSE for further detail.