General-Purpose Input/Output (GPIO)

Modules
	Port and Pin Definitions
	GPIO_Registers

Data Structures
struct	mxc_gpio_cfg_t

Typedefs
typedef void(*	mxc_gpio_callback_fn) (void *cbdata)

Enumerations
enum	mxc_gpio_func_t
enum	mxc_gpio_vssel_t
enum	mxc_gpio_pad_t
enum	mxc_gpio_int_mode_t
enum	mxc_gpio_int_pol_t

Functions
int	MXC_GPIO_Init (uint32_t portMask)
int	MXC_GPIO_Shutdown (uint32_t portMask)
int	MXC_GPIO_Reset (uint32_t portMask)
int	MXC_GPIO_Config (const mxc_gpio_cfg_t *cfg)
uint32_t	MXC_GPIO_InGet (mxc_gpio_regs_t *port, uint32_t mask)
void	MXC_GPIO_OutSet (mxc_gpio_regs_t *port, uint32_t mask)
void	MXC_GPIO_OutClr (mxc_gpio_regs_t *port, uint32_t mask)
uint32_t	MXC_GPIO_OutGet (mxc_gpio_regs_t *port, uint32_t mask)
void	MXC_GPIO_OutPut (mxc_gpio_regs_t *port, uint32_t mask, uint32_t val)
void	MXC_GPIO_OutToggle (mxc_gpio_regs_t *port, uint32_t mask)
int	MXC_GPIO_IntConfig (const mxc_gpio_cfg_t *cfg, mxc_gpio_int_pol_t pol)
void	MXC_GPIO_EnableInt (mxc_gpio_regs_t *port, uint32_t mask)
void	MXC_GPIO_DisableInt (mxc_gpio_regs_t *port, uint32_t mask)
uint32_t	MXC_GPIO_GetFlags (mxc_gpio_regs_t *port)
void	MXC_GPIO_ClearFlags (mxc_gpio_regs_t *port, uint32_t flags)
void	MXC_GPIO_RegisterCallback (const mxc_gpio_cfg_t *cfg, mxc_gpio_callback_fn callback, void *cbdata)
void	MXC_GPIO_Handler (unsigned int port)
int	MXC_GPIO_SetVSSEL (mxc_gpio_regs_t *port, mxc_gpio_vssel_t vssel, uint32_t mask)

Detailed Description

---

Data Structure Documentation

mxc_gpio_cfg_t

struct mxc_gpio_cfg_t

Structure type for configuring a GPIO port.

Data Fields
mxc_gpio_regs_t *	port
uint32_t	mask
mxc_gpio_func_t	func
mxc_gpio_pad_t	pad
mxc_gpio_vssel_t	vssel

Field Documentation

func

mxc_gpio_func_t func

Function type

mask

uint32_t mask

Pin mask (multiple pins may be set)

pad

mxc_gpio_pad_t pad

Pad type

port

mxc_gpio_regs_t* port

Pointer to GPIO regs

vssel

mxc_gpio_vssel_t vssel

Voltage select

Typedef Documentation

mxc_gpio_callback_fn

typedef void(* mxc_gpio_callback_fn) (void *cbdata)

Type alias for a GPIO callback function with prototype:

void callback_fn(void *cbdata);

Parameters

cbdata

A void pointer to the data type as registered when MXC_GPIO_RegisterCallback() was called.

Enumeration Type Documentation

mxc_gpio_func_t

enum mxc_gpio_func_t

Enumeration type for the GPIO Function Type.

Enumerator
MXC_GPIO_FUNC_IN	GPIO Input
MXC_GPIO_FUNC_OUT	GPIO Output
MXC_GPIO_FUNC_ALT1	Alternate Function Selection
MXC_GPIO_FUNC_ALT2	Alternate Function Selection
MXC_GPIO_FUNC_ALT3	Alternate Function Selection
MXC_GPIO_FUNC_ALT4	Alternate Function Selection

mxc_gpio_int_mode_t

enum mxc_gpio_int_mode_t

Enumeration type for the interrupt modes.

Enumerator
MXC_GPIO_INT_LEVEL	Interrupt is level sensitive
MXC_GPIO_INT_EDGE	Interrupt is edge sensitive

mxc_gpio_int_pol_t

enum mxc_gpio_int_pol_t

Enumeration type for the interrupt polarity.

Enumerator
MXC_GPIO_INT_FALLING	Interrupt triggers on falling edge
MXC_GPIO_INT_HIGH	Interrupt triggers when level is high
MXC_GPIO_INT_RISING	Interrupt triggers on rising edge
MXC_GPIO_INT_LOW	Interrupt triggers when level is low
MXC_GPIO_INT_BOTH	Interrupt triggers on either edge

mxc_gpio_pad_t

enum mxc_gpio_pad_t

Enumeration type for the type of GPIO pad on a given pin.

Enumerator
MXC_GPIO_PAD_NONE	No pull-up or pull-down
MXC_GPIO_PAD_PULL_UP	Set pad to weak pull-up
MXC_GPIO_PAD_PULL_DOWN	Set pad to weak pull-down

mxc_gpio_vssel_t

enum mxc_gpio_vssel_t

Enumeration type for the voltage level on a given pin.

Enumerator
MXC_GPIO_VSSEL_VDDIO	Set pin to VIDDIO voltage
MXC_GPIO_VSSEL_VDDIOH	Set pin to VIDDIOH voltage

Function Documentation

MXC_GPIO_ClearFlags()

void MXC_GPIO_ClearFlags	(	mxc_gpio_regs_t *	port,
		uint32_t	flags
	)

Gets the interrupt(s) status on a GPIO port.

Parameters

port	Pointer to the port requested
flags	The flags to clear

MXC_GPIO_Config()

int MXC_GPIO_Config

(

const mxc_gpio_cfg_t *

cfg

)

Configure GPIO pin(s).

Parameters

cfg	Pointer to configuration structure describing the pin.

Returns

E_NO_ERROR if everything is successful.

MXC_GPIO_DisableInt()

void MXC_GPIO_DisableInt	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Disables the specified GPIO interrupt.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to disable interrupt

MXC_GPIO_EnableInt()

void MXC_GPIO_EnableInt	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Enables the specified GPIO interrupt.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to enable interrupt

MXC_GPIO_GetFlags()

uint32_t MXC_GPIO_GetFlags

(

mxc_gpio_regs_t *

port

)

Gets the interrupt(s) status on a GPIO port.

Parameters

port	Pointer to the port requested

Returns

The requested interrupt status.

MXC_GPIO_Handler()

void MXC_GPIO_Handler

(

unsigned int

port

)

GPIO IRQ Handler.

Note

If a callback is registered for a given interrupt, the callback function will be called.

Parameters

port	number of the port that generated the interrupt service routine.

MXC_GPIO_InGet()

uint32_t MXC_GPIO_InGet	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Gets the pin(s) input state.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to read

Returns

The requested pin state.

MXC_GPIO_Init()

int MXC_GPIO_Init

(

uint32_t

portMask

)

Initialize GPIO.

Parameters

portMask

Mask for the port to be initialized

Returns

E_NO_ERROR if everything is successful.

MXC_GPIO_IntConfig()

int MXC_GPIO_IntConfig	(	const mxc_gpio_cfg_t *	cfg,
		mxc_gpio_int_pol_t	pol
	)

Configure GPIO interrupt(s)

Parameters

cfg	Pointer to configuration structure describing the pin.
pol	Requested interrupt polarity.

Returns

E_NO_ERROR if everything is successful.

MXC_GPIO_OutClr()

void MXC_GPIO_OutClr	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Clears the pin(s) to a low level output.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to clear

MXC_GPIO_OutGet()

uint32_t MXC_GPIO_OutGet	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Gets the pin(s) output state.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to read the output state of.

Returns

The state of the requested pin.

MXC_GPIO_OutPut()

void MXC_GPIO_OutPut	(	mxc_gpio_regs_t *	port,
		uint32_t	mask,
		uint32_t	val
	)

Write the pin(s) to a desired output level.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to set output level of
val	Desired output level of the pin(s). This will be masked with the configuration mask.

MXC_GPIO_OutSet()

void MXC_GPIO_OutSet	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Sets the pin(s) to a high level output.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to set

MXC_GPIO_OutToggle()

void MXC_GPIO_OutToggle	(	mxc_gpio_regs_t *	port,
		uint32_t	mask
	)

Toggles the the pin(s) output level.

Parameters

port	Pointer to GPIO port.
mask	Mask of the pin to toggle the output

MXC_GPIO_RegisterCallback()

void MXC_GPIO_RegisterCallback	(	const mxc_gpio_cfg_t *	cfg,
		mxc_gpio_callback_fn	callback,
		void *	cbdata
	)

Registers a callback for the interrupt on a given port and pin.

Parameters

cfg	Pointer to configuration structure describing the pin
callback	A pointer to a function of type mxc_gpio_callback_fn.
cbdata	The parameter to be passed to the callback function, mxc_gpio_callback_fn, when an interrupt occurs.

MXC_GPIO_Reset()

int MXC_GPIO_Reset

(

uint32_t

portMask

)

Reset GPIO.

Parameters

portMask

Mask for the port to reset

Returns

E_NO_ERROR if everything is successful.

MXC_GPIO_SetVSSEL()

int MXC_GPIO_SetVSSEL	(	mxc_gpio_regs_t *	port,
		mxc_gpio_vssel_t	vssel,
		uint32_t	mask
	)

Set Voltage select for pins to VDDIO or VDDIOH.

Parameters

	port	The GPIO port
[in]	vssel	VDDIO or VDDIOH to set the voltatge to
[in]	mask	Pins in the GPIO port that will be set to the voltage.

Returns

E_NO_ERROR if successful, E_BAD_PARAM otherwise.

MXC_GPIO_Shutdown()

int MXC_GPIO_Shutdown

(

uint32_t

portMask

)

Shutdown GPIO.

Parameters

portMask

Mask for the port to shutdown

Returns

E_NO_ERROR if everything is successful.