Defined behavior

More...

Functions
uint32_t	gpio_set (PinName pin)
	Set the given pin as GPIO. More...

int	gpio_is_connected (const gpio_t *obj)
	Checks if gpio object is connected (pin was not initialized with NC) More...

void	gpio_init (gpio_t *obj, PinName pin)
	Initialize the GPIO pin. More...

void	gpio_mode (gpio_t *obj, PinMode mode)
	Set the input pin mode. More...

void	gpio_dir (gpio_t *obj, PinDirection direction)
	Set the pin direction. More...

void	gpio_write (gpio_t *obj, int value)
	Set the output value. More...

int	gpio_read (gpio_t *obj)
	Read the input value. More...

void	gpio_init_in (gpio_t *gpio, PinName pin)
	Init the input pin and set mode to PullDefault. More...

void	gpio_init_in_ex (gpio_t *gpio, PinName pin, PinMode mode)
	Init the input pin and set the mode. More...

void	gpio_init_out (gpio_t *gpio, PinName pin)
	Init the output pin as an output, with predefined output value 0. More...

void	gpio_init_out_ex (gpio_t *gpio, PinName pin, int value)
	Init the pin as an output and set the output value. More...

void	gpio_init_inout (gpio_t *gpio, PinName pin, PinDirection direction, PinMode mode, int value)
	Init the pin to be in/out. More...

Detailed Description

Defined behavior

gpio_init and other init functions can be called with NC or a valid PinName for the target - Verified by ::gpio_nc_test
gpio_is_connected can be used to test whether a gpio_t object was initialized with NC - Verified by ::gpio_nc_test

Undefined behavior

Calling any gpio_mode, gpio_dir, gpio_write or gpio_read on a gpio_t object that was initialized with NC.
Calling gpio_set with NC.

Function Documentation

void gpio_dir	(	gpio_t *	obj,
		PinDirection	direction
	)

Set the pin direction.

Parameters

obj	The GPIO object (must be connected)
direction	The pin direction to be set

void gpio_init	(	gpio_t *	obj,
		PinName	pin
	)

Initialize the GPIO pin.

Parameters

obj	The GPIO object to initialize
pin	The GPIO pin to initialize (may be NC)

void gpio_init_in	(	gpio_t *	gpio,
		PinName	pin
	)

Init the input pin and set mode to PullDefault.

Parameters

gpio	The GPIO object
pin	The pin name (may be NC)

void gpio_init_in_ex	(	gpio_t *	gpio,
		PinName	pin,
		PinMode	mode
	)

Init the input pin and set the mode.

Parameters

gpio	The GPIO object
pin	The pin name (may be NC)
mode	The pin mode to be set

void gpio_init_inout	(	gpio_t *	gpio,
		PinName	pin,
		PinDirection	direction,
		PinMode	mode,
		int	value
	)

Init the pin to be in/out.

Parameters

gpio	The GPIO object
pin	The pin name (may be NC)
direction	The pin direction to be set
mode	The pin mode to be set
value	The value to be set for an output pin

void gpio_init_out	(	gpio_t *	gpio,
		PinName	pin
	)

Init the output pin as an output, with predefined output value 0.

Parameters

gpio	The GPIO object
pin	The pin name (may be NC)

Returns: An integer value 1 or 0

void gpio_init_out_ex	(	gpio_t *	gpio,
		PinName	pin,
		int	value
	)

Init the pin as an output and set the output value.

Parameters

gpio	The GPIO object
pin	The pin name (may be NC)
value	The value to be set

int gpio_is_connected ( const gpio_t * obj )

Checks if gpio object is connected (pin was not initialized with NC)

Parameters

obj	The GPIO object

Returns: 0 if object was initialized with NC; non-zero if object was initialized with a valid PinName

void gpio_mode	(	gpio_t *	obj,
		PinMode	mode
	)

Set the input pin mode.

Parameters

obj	The GPIO object (must be connected)
mode	The pin mode to be set

int gpio_read ( gpio_t * obj )

Read the input value.

Parameters

obj	The GPIO object (must be connected)

Returns: An integer value 1 or 0

uint32_t gpio_set ( PinName pin )

Set the given pin as GPIO.

Parameters

pin	The pin to be set as GPIO

Returns: The GPIO port mask for this pin

void gpio_write	(	gpio_t *	obj,
		int	value
	)

Set the output value.

Parameters

obj	The GPIO object (must be connected)
value	The value to be set

Defined behavior

Functions

Detailed Description

Defined behavior

Undefined behavior

Function Documentation

Important Information for this Arm website