GPIO bit-bang driver for Linux

The GPIO bit-bang driver creates an interface to Linux GPIOs using the IOCTL API.

Basic 1-bit input and output is available along with accelerated multiple bit shift I/O.

GPIO bit-bang is well suited to PICMicro ICSP but not exclusively.

WARNING: The underlying kernel API this module uses may have been removed from your running kernel.


This module is built out of kernel and depends on the header files and tools found locally or may be cross compiled.

For cross compilation, an example Makefile named `' is provided which should work for Raspberry PI OS as explained here.

If the linux source directory was cross compiled and then copied to the target system to build the module, `' is provided to rebuild certain kernel header scripts locally. This is needed because some scripts are actually binary files on the foreign architecture.

Raspberry Pi OS

First install development tools and the kernel headers when using a regular kernel.

apt-get install raspberrypi-kernel-headers

If you updated the kernel with rpi-update, install rpi-source

Now install headers for kernel installed with rpi-update.

rpi-source --skip-space

Now install the kernel module.

hg clone
cd gpio-bb
make install


apt install linux-headers-current-sunxi
hg clone
cd gpio-bb
make install


Update the modprobe configuration to create the gpio-bb device node when the module is loaded. For example, add the following to /etc/modprobe.d/modprobe.conf

install gpio-bb modprobe --ignore-install gpio-bb && modprobe gpio-bb && mknod /dev/gpio-bb c 180 0 && chmod 666 /dev/gpio-bb

Lastly, add the following to /etc/modules and reboot.


Obsolete documentation


gpio-bb uses the kernel API to access pins, this API demands exclusive access to a pin per process. This means you cannot use gpio-bb and sysfs export simultaneously for a single pin.


This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies