GPIO Driver

Overview

The MCUXpresso SDK provides a peripheral driver for the General-Purpose Input/Output (GPIO) module of MCUXpresso SDK devices.

Typical use case

Output Operation

Refer to the driver examples codes located at <SDK_ROOT>/boards/<BOARD>/driver_examples/gpio

Input Operation

Refer to the driver examples codes located at <SDK_ROOT>/boards/<BOARD>/driver_examples/gpio

GPIO Configuration
void	GPIO_PinInit (GPIO_Type *base, uint32_t pin, const gpio_pin_config_t *config)
	Initializes a GPIO pin used by the board. More...

GPIO Output Operations
static void	GPIO_PinWrite (GPIO_Type *base, uint32_t pin, uint8_t output)
	Sets the output level of the multiple GPIO pins to the logic 1 or 0. More...
static void	GPIO_PortSet (GPIO_Type *base, uint32_t mask)
	Sets the output level of the multiple GPIO pins to the logic 1. More...
static void	GPIO_PortClear (GPIO_Type *base, uint32_t mask)
	Sets the output level of the multiple GPIO pins to the logic 0. More...
static void	GPIO_PortToggle (GPIO_Type *base, uint32_t mask)
	Reverses the current output logic of the multiple GPIO pins. More...

GPIO Input Operations
static uint32_t	GPIO_PinRead (GPIO_Type *base, uint32_t pin)
	Reads the current input value of the GPIO port. More...

GPIO Interrupt
static void	GPIO_SetPinInterruptConfig (GPIO_Type *base, uint32_t pin, gpio_interrupt_config_t config)
	Configures the gpio pin interrupt/DMA request. More...
uint32_t	GPIO_GpioGetInterruptFlags (GPIO_Type *base)
	Read the GPIO interrupt status flags. More...
uint8_t	GPIO_PinGetInterruptFlag (GPIO_Type *base, uint32_t pin)
	Read individual pin's interrupt status flag. More...
void	GPIO_GpioClearInterruptFlags (GPIO_Type *base, uint32_t mask)
	Clears GPIO pin interrupt status flags. More...
void	GPIO_PinClearInterruptFlag (GPIO_Type *base, uint32_t pin)
	Clear GPIO individual pin's interrupt status flag. More...
static uint32_t	GPIO_GetPinsDMARequestFlags (GPIO_Type *base)
	Reads the GPIO DMA request flags. More...
static void	GPIO_SetMultipleInterruptPinsConfig (GPIO_Type *base, uint32_t mask, gpio_interrupt_config_t config)
	Sets the GPIO interrupt configuration in PCR register for multiple pins. More...

Function Documentation

void GPIO_PinInit	(	GPIO_Type *	base,
		uint32_t	pin,
		const gpio_pin_config_t *	config
	)

To initialize the GPIO, define a pin configuration, as either input or output, in the user file. Then, call the GPIO_PinInit() function.

This is an example to define an input pin or an output pin configuration.

* Define a digital input pin configuration,
* gpio_pin_config_t config =
* {
*   kGPIO_DigitalInput,
*   0,
* }
* Define a digital output pin configuration,
* gpio_pin_config_t config =
* {
*   kGPIO_DigitalOutput,
*   0,
* }
* 

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
pin	GPIO port pin number
config	GPIO pin configuration pointer

static void GPIO_PinWrite ( GPIO_Type *  base, uint32_t  pin, uint8_t  output  )

inlinestatic

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
pin	GPIO pin number
output	GPIO pin output logic level. 0: corresponding pin output low-logic level. 1: corresponding pin output high-logic level.

static void GPIO_PortSet ( GPIO_Type *  base, uint32_t  mask  )

inlinestatic

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
mask	GPIO pin number macro

static void GPIO_PortClear ( GPIO_Type *  base, uint32_t  mask  )

inlinestatic

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
mask	GPIO pin number macro

static void GPIO_PortToggle ( GPIO_Type *  base, uint32_t  mask  )

inlinestatic

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
mask	GPIO pin number macro

static uint32_t GPIO_PinRead ( GPIO_Type *  base, uint32_t  pin  )

inlinestatic

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
pin	GPIO pin number

Return values

GPIO	port input value 0: corresponding pin input low-logic level. 1: corresponding pin input high-logic level.

static void GPIO_SetPinInterruptConfig ( GPIO_Type *  base, uint32_t  pin, gpio_interrupt_config_t  config  )

inlinestatic

Parameters

base	GPIO peripheral base pointer.
pin	GPIO pin number.
config	GPIO pin interrupt configuration. kGPIO_InterruptStatusFlagDisabled: Interrupt/DMA request disabled. kGPIO_DMARisingEdge : DMA request on rising edge(if the DMA requests exit). kGPIO_DMAFallingEdge: DMA request on falling edge(if the DMA requests exit). kGPIO_DMAEitherEdge : DMA request on either edge(if the DMA requests exit). kGPIO_FlagRisingEdge : Flag sets on rising edge(if the Flag states exit). kGPIO_FlagFallingEdge : Flag sets on falling edge(if the Flag states exit). kGPIO_FlagEitherEdge : Flag sets on either edge(if the Flag states exit). kGPIO_InterruptLogicZero : Interrupt when logic zero. kGPIO_InterruptRisingEdge : Interrupt on rising edge. kGPIO_InterruptFallingEdge: Interrupt on falling edge. kGPIO_InterruptEitherEdge : Interrupt on either edge. kGPIO_InterruptLogicOne : Interrupt when logic one. kGPIO_ActiveHighTriggerOutputEnable : Enable active high-trigger output (if the trigger states exit). kGPIO_ActiveLowTriggerOutputEnable : Enable active low-trigger output (if the trigger states exit).

uint32_t GPIO_GpioGetInterruptFlags

(

GPIO_Type *

base

)

Parameters

base	GPIO peripheral base pointer. (GPIOA, GPIOB, GPIOC, and so on.)

Returns

The current GPIO's interrupt status flag. '1' means the related pin's flag is set, '0' means the related pin's flag not set. For example, the return value 0x00010001 means the pin 0 and 17 have the interrupt pending.

uint8_t GPIO_PinGetInterruptFlag	(	GPIO_Type *	base,
		uint32_t	pin
	)

Parameters

base	GPIO peripheral base pointer. (GPIOA, GPIOB, GPIOC, and so on)
pin	GPIO specific pin number.

Returns

The current selected pin's interrupt status flag.

void GPIO_GpioClearInterruptFlags	(	GPIO_Type *	base,
		uint32_t	mask
	)

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on.)
mask	GPIO pin number macro

void GPIO_PinClearInterruptFlag	(	GPIO_Type *	base,
		uint32_t	pin
	)

Parameters

base	GPIO peripheral base pointer (GPIOA, GPIOB, GPIOC, and so on).
pin	GPIO specific pin number.

static uint32_t GPIO_GetPinsDMARequestFlags ( GPIO_Type *  base )

inlinestatic

The corresponding flag will be cleared automatically at the completion of the requested DMA transfer

static void GPIO_SetMultipleInterruptPinsConfig ( GPIO_Type *  base, uint32_t  mask, gpio_interrupt_config_t  config  )

inlinestatic

Parameters

base	GPIO peripheral base pointer.
mask	GPIO pin number macro.
config	GPIO pin interrupt configuration. kGPIO_InterruptStatusFlagDisabled: Interrupt disabled. kGPIO_DMARisingEdge : DMA request on rising edge(if the DMA requests exit). kGPIO_DMAFallingEdge: DMA request on falling edge(if the DMA requests exit). kGPIO_DMAEitherEdge : DMA request on either edge(if the DMA requests exit). kGPIO_FlagRisingEdge : Flag sets on rising edge(if the Flag states exit). kGPIO_FlagFallingEdge : Flag sets on falling edge(if the Flag states exit). kGPIO_FlagEitherEdge : Flag sets on either edge(if the Flag states exit). kGPIO_InterruptLogicZero : Interrupt when logic zero. kGPIO_InterruptRisingEdge : Interrupt on rising edge. kGPIO_InterruptFallingEdge: Interrupt on falling edge. kGPIO_InterruptEitherEdge : Interrupt on either edge. kGPIO_InterruptLogicOne : Interrupt when logic one. kGPIO_ActiveHighTriggerOutputEnable : Enable active high-trigger output (if the trigger states exit). kGPIO_ActiveLowTriggerOutputEnable : Enable active low-trigger output (if the trigger states exit)..