Linux User Mode GPIO Driver

Implementation of GPIO access from Linux User Space. More...

Detailed Description

Implementation of GPIO access from Linux User Space.

This module allows to connect a RIOT application that runs on a Linux host to the physical GPIO pins of that host. To do so, the application has to be compiled for the native board in a Linux environment.

GPIO support is automatically included if either a module requiring the periph_gpio feature is added to the application or if it is explicitly listed as FEATURES_REQUIRED in the application's Makefile.

At runtime, the process has to be connected to a specific GPIO bank on the host machine. GPIO banks are exposed as /dev/gpiochipN character files, where N is the bank ID to which several GPIO pins are connected.

Example:

$ ./riot_native_app --gpio=/dev/gpiochip0 --gpio=/dev/gpiochip1

This will add /dev/gpiochip0 and /dev/gpiochip1 as PORT(0) and PORT(1) in RIOT. The first pin can be used with PIN(0,0) as gpio_t, the second one on the first port would be PIN(0,1) and so on.

Please refer to your board's documentation for the mapping of the pins.

Files
file	gpiodev_linux.h
	Implementation of GPIO access from Linux User Space.

Functions
int	gpio_linux_setup (const char *device)
	register /dev/gpiochip* device to be used for GPIO
void	gpio_linux_teardown (void)
	shutdown GPIO subsystem

Function Documentation

gpio_linux_setup()

int gpio_linux_setup

(

const char *

device

)

register /dev/gpiochip* device to be used for GPIO

Parameters

[in]

device

The gpiochip device to open.

Returns

0 on success, error otherwise

gpio_linux_teardown()

void gpio_linux_teardown

(

void

)

shutdown GPIO subsystem

This closes all GPIO fds.