Installation
rpi-lgpio is distributed in several formats. The following sections detail installation from a variety of formats. But first a warning:
Warning
You cannot install rpi-lgpio and rpi-gpio (aka RPi.GPIO, the library it
emulates) at the same time, in the same Python environment. Both packages
attempt to install a module named RPi.GPIO
and obviously this will not
work.
apt/deb package
If your distribution includes rpi-lgpio in its archive of apt packages, then you can simply:
$ sudo apt remove python3-rpi.gpio
$ sudo apt install python3-rpi-lgpio
If you wish to go back to rpi-gpio:
$ sudo apt remove python3-rpi-lgpio
$ sudo apt install python3-rpi.gpio
wheel package
If your distribution does not include a “native” packaging of rpi-lgpio, you can also install using pip (preferably in a Python virtual environment):
$ pip uninstall rpi-gpio
$ pip install rpi-lgpio
On some platforms you may need to use a Python 3 specific alias of pip:
$ pip3 uninstall rpi-gpio
$ pip3 install rpi-lgpio
The instructions above assume that rpi-gpio is already installed by pip as well, but this may not be the case. For instance, you may have rpi-gpio installed from, say, apt, but your particular distro doesn’t also include rpi-lgpio. In this case you may need to remove rpi-gpio from apt first:
$ sudo apt remove python3-rpi.gpio
$ pip3 install rpi-lgpio
If you wish to install system-wide with pip, you may need to place sudo
in
front of the pip
(or pip3
) commands too. Please be aware that on modern
versions of pip you will need to explicitly accept the risk of trying to
co-exist apt
and pip
packages as follows:
$ sudo pip3 install --break-system-packages rpi-lgpio