Emulated GPIO

Emulated GPIO backend API. More...

Functions
int	gpio_emul_input_set_masked (const struct device *port, gpio_port_pins_t pins, gpio_port_value_t values)
	Modify the values of one or more emulated GPIO input pins.
static int	gpio_emul_input_set (const struct device *port, gpio_pin_t pin, int value)
	Modify the value of one emulated GPIO input pin.
int	gpio_emul_output_get_masked (const struct device *port, gpio_port_pins_t pins, gpio_port_value_t *values)
	Read the value of one or more emulated GPIO output pins.
static int	gpio_emul_output_get (const struct device *port, gpio_pin_t pin)
	Read the value of one emulated GPIO output pin.
int	gpio_emul_flags_get (const struct device *port, gpio_pin_t pin, gpio_flags_t *flags)
	Get flags for a given emulated GPIO pin.

Detailed Description

Emulated GPIO backend API.

Behaviour of emulated GPIO is application-defined. As-such, each application may

• define a Device Tree overlay file to indicate the number of GPIO controllers as well as the number of pins for each controller
• register a callback with the GPIO controller using gpio_add_callback to emulate "wiring"
• asynchronously call gpio_emul_input_set and / or gpio_emul_input_set_masked in order to emulate GPIO events

An example of an appropriate Device Tree overlay file is in tests/drivers/gpio/gpio_basic_api/boards/native_sim.overlay.

An example of registering a callback to emulate "wiring" as well as an example of calling gpio_emul_input_set is in the file tests/drivers/gpio/gpio_basic_api/src/main.c .

Function Documentation

gpio_emul_flags_get()

int gpio_emul_flags_get	(	const struct device *	port,
		gpio_pin_t	pin,
		gpio_flags_t *	flags
	)

#include <zephyr/drivers/gpio/gpio_emul.h>

Get flags for a given emulated GPIO pin.

For more information on available flags, see GPIO Driver APIs.

Parameters

port	The emulated GPIO port
pin	The pin to retrieve flags for
flags	a pointer to where the flags for pin will be stored

Returns

0 on success

-EINVAL if an invalid argument is provided

gpio_emul_input_set()

static int gpio_emul_input_set ( const struct device *  port, gpio_pin_t  pin, int  value  )

inlinestatic

#include <zephyr/drivers/gpio/gpio_emul.h>

Modify the value of one emulated GPIO input pin.

Parameters

port	The emulated GPIO port
pin	The pin to modify
value	New values to assign to pin

Returns

0 on success

-EINVAL if an invalid argument is provided

gpio_emul_input_set_masked()

int gpio_emul_input_set_masked	(	const struct device *	port,
		gpio_port_pins_t	pins,
		gpio_port_value_t	values
	)

#include <zephyr/drivers/gpio/gpio_emul.h>

Modify the values of one or more emulated GPIO input pins.

Parameters

port	The emulated GPIO port
pins	The mask of pins that have changed
values	New values to assign to pins

Returns

0 on success

-EINVAL if an invalid argument is provided

gpio_emul_output_get()

static int gpio_emul_output_get ( const struct device *  port, gpio_pin_t  pin  )

inlinestatic

#include <zephyr/drivers/gpio/gpio_emul.h>

Read the value of one emulated GPIO output pin.

Parameters

port	The emulated GPIO port
pin	The pin to read

Returns

0 or 1 on success

-EINVAL if an invalid argument is provided

gpio_emul_output_get_masked()

int gpio_emul_output_get_masked	(	const struct device *	port,
		gpio_port_pins_t	pins,
		gpio_port_value_t *	values
	)

#include <zephyr/drivers/gpio/gpio_emul.h>

Read the value of one or more emulated GPIO output pins.

Parameters

port	The emulated GPIO port
pins	The mask of pins that have changed
values	A pointer to where the value of pins will be stored

Returns

0 on success

-EINVAL if an invalid argument is provided