gpiod-sysfs-proxy 0.1.2

User-space compatibility layer for linux GPIO sysfs interface

gpiod-sysfs-proxy

libgpiod-based compatibility layer for the linux GPIO sysfs interface.

It uses FUSE (Filesystem in User Space) in order to expose a filesystem that can be mounted over /sys/class/gpio to simulate the kernel interface.

Running

Running the script with a mountpoint parameter will mount the simulated gpio class directory and then exit. The script can also be run with -f or -d switches for foreground or debug operation respectively.

The recommended command-line mount options to use are:

gpiod-sysfs-proxy <mountpoint> -o nonempty -o allow_other -o default_permissions -o entry_timeout=0

This allows to mount the compatibility layer on non-empty /sys/class/gpio, allows non-root users to access it, enables permission checks by the kernel and disables caching of entry stats (for when we remove directories from the script while the kernel doesn't know it).

For a complete list of available command-line options, please run:

gpiod-sysfs-proxy --help

Caveats

Due to how FUSE works, there are certain limitations to the level of compatibility we can assure as well as some other issues the user may need to have to work around.

Non-existent /sys/class/gpio

If the GPIO sysfs interface is disabled in Kconfig, the /sys/class/gpio directory will not exist and the user-space can't create directories inside of sysfs. There are two solutions: either the user can use a different mountpount or - for full backward compatibility - they can use overlayfs on top of /sys/class providing the missing gpio directory.

Example:

mkdir -p /run/gpio/sys /run/gpio/class/gpio /run/gpio/work
mount -t sysfs sysfs /run/gpio/sys
mount -t overlay overlay -o lowerdir=/run/gpio/sys/class,upperdir=/run/gpio/class,workdir=/run/gpio/work,ro
gpiod-sysfs-proxy /sys/class/gpio <options>

Links in /sys/class/gpio

The kernel sysfs interface at /sys/class/gpio contains links to directories living elsewhere (specifically: under the relevant device entries) in sysfs. For obvious reasons we cannot replicate that so, instead we expose actual directories representing GPIO chips and exported GPIO lines.

Polling of the value attribute

We currently don't support multiple users polling the value attribute at once. Also: unlike the kernel interface, reading from value will not block after the value has been read once.

Static GPIO base number

Some legacy GPIO drivers hard-code the base GPIO number. We don't yet support it but it's planned as a future extension in the form of an argument that will allow to associate a hard-coded base with a GPIO chip by its label.