Functions
static uint32_t	GPIO_readDio (uint32_t dioNumber)
	Reads a specific DIO. More...

static uint32_t	GPIO_readMultiDio (uint32_t dioMask)
	Reads the input value for the specified DIOs. More...

static void	GPIO_writeDio (uint32_t dioNumber, uint32_t value)
	Writes a value to a specific DIO. More...

static void	GPIO_writeMultiDio (uint32_t dioMask, uint32_t bitVectoredValue)
	Writes masked data to the specified DIOs. More...

static void	GPIO_setDio (uint32_t dioNumber)
	Sets a specific DIO to 1 (high). More...

static void	GPIO_setMultiDio (uint32_t dioMask)
	Sets the specified DIOs to 1 (high). More...

static void	GPIO_clearDio (uint32_t dioNumber)
	Clears a specific DIO to 0 (low). More...

static void	GPIO_clearMultiDio (uint32_t dioMask)
	Clears the specified DIOs to 0 (low). More...

static void	GPIO_toggleDio (uint32_t dioNumber)
	Toggles a specific DIO. More...

static void	GPIO_toggleMultiDio (uint32_t dioMask)
	Toggles the specified DIOs. More...

static uint32_t	GPIO_getOutputEnableDio (uint32_t dioNumber)
	Gets the output enable status of a specific DIO. More...

static uint32_t	GPIO_getOutputEnableMultiDio (uint32_t dioMask)
	Gets the output enable setting of the specified DIOs. More...

static void	GPIO_setOutputEnableDio (uint32_t dioNumber, uint32_t outputEnableValue)
	Sets output enable of a specific DIO. More...

static void	GPIO_setOutputEnableMultiDio (uint32_t dioMask, uint32_t bitVectoredOutputEnable)
	Configures the output enable setting for all specified DIOs. More...

static uint32_t	GPIO_getEventDio (uint32_t dioNumber)
	Gets the event status of a specific DIO. More...

static uint32_t	GPIO_getEventMultiDio (uint32_t dioMask)
	Gets the event status of the specified DIOs. More...

static void	GPIO_clearEventDio (uint32_t dioNumber)
	Clears the IO event status of a specific DIO. More...

static void	GPIO_clearEventMultiDio (uint32_t dioMask)
	Clears the IO event status on the specified DIOs. More...

Detailed Description

Introduction

The GPIO module allows software to control the pins of the device directly if the IOC module has been configured to route the GPIO signal to a physical pin (called DIO). Alternatively, pins can be hardware controlled by other peripheral modules. For more information about the IOC module, how to configure physical pins, and how to select between software controlled and hardware controlled, see the IOC API.

The System CPU can access the GPIO module to read the value of any DIO of the device and if the IOC module has been configured such that one or more DIOs are GPIO controlled (software controlled) the System CPU can write these DIOs through the GPIO module.

The IOC module can also be configured to generate events on edge detection and these events can be read and cleared in the GPIO module by the System CPU.

API

The API functions can be grouped like this:

Set and get direction of DIO (output enable):

Write DIO (requires IOC to be configured for GPIO usage):

Set, clear, or toggle DIO (requires IOC to be configured for GPIO usage):

Read DIO (even if IOC is NOT configured for GPIO usage; however, the DIO must be configured for input enable in IOC):

Read or clear events (even if IOC is NOT configured for GPIO usage; however, the DIO must be configured for input enable in IOC):

The IOC API provides two functions for easy configuration of DIOs as GPIO enabled using typical settings. They also serve as examples on how to configure the IOC and GPIO modules for GPIO usage:

Function Documentation

§ GPIO_clearDio()

static void GPIO_clearDio ( uint32_t dioNumber )

inlinestatic

Clears a specific DIO to 0 (low).

Parameters

dioNumber specifies the DIO to clear (0-31).

Returns: None

See also: GPIO_clearMultiDio(), GPIO_setDio(), GPIO_setMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Clear the specified DIO.
     HWREG( GPIO_BASE + GPIO_O_DOUTCLR31_0 ) = ( 1 << dioNumber );
 }

§ GPIO_clearEventDio()

static void GPIO_clearEventDio ( uint32_t dioNumber )

inlinestatic

Clears the IO event status of a specific DIO.

Parameters

dioNumber specifies the DIO on which to clear the event status (0-31).

Returns: None

See also: GPIO_clearEventMultiDio(), GPIO_getEventDio(), GPIO_getEventMultiDio()

Referenced by IOCIntClear().

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Clear the event status for the specified DIO.
     HWREG( GPIO_BASE + GPIO_O_EVFLAGS31_0 ) = ( 1 << dioNumber );
 }

§ GPIO_clearEventMultiDio()

static void GPIO_clearEventMultiDio ( uint32_t dioMask )

inlinestatic

Clears the IO event status on the specified DIOs.

Parameters

dioMask

is the bit-mask representation of the DIOs on which to clear the events status. The parameter must be a bitwise OR'ed combination of the following:

Returns: None

See also: GPIO_clearEventDio(), GPIO_getEventDio(), GPIO_getEventMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Clear the event status for the specified DIOs.
     HWREG( GPIO_BASE + GPIO_O_EVFLAGS31_0 ) = dioMask;
 }

§ GPIO_clearMultiDio()

static void GPIO_clearMultiDio ( uint32_t dioMask )

inlinestatic

Clears the specified DIOs to 0 (low).

Parameters

dioMask

is the bit-mask representation of the DIOs to clear. The parameter must be a bitwise OR'ed combination of the following:

Returns: None

See also: GPIO_clearDio(), GPIO_setDio(), GPIO_setMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Clear the DIOs.
     HWREG( GPIO_BASE + GPIO_O_DOUTCLR31_0 ) = dioMask;
 }

§ GPIO_getEventDio()

static uint32_t GPIO_getEventDio ( uint32_t dioNumber )

inlinestatic

Gets the event status of a specific DIO.

Parameters

dioNumber specifies the DIO to get the event status from (0-31).

Returns

Returns the current event status on the specified DIO.

0 : Non-triggered event.
1 : Triggered event.

See also: GPIO_getEventMultiDio(), GPIO_clearEventDio(), GPIO_clearEventMultiDio()

Referenced by IOCIntStatus().

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Return the event status for the specified DIO.
     return (( HWREG( GPIO_BASE + GPIO_O_EVFLAGS31_0 ) >> dioNumber ) & 1 );
 }

§ GPIO_getEventMultiDio()

static uint32_t GPIO_getEventMultiDio ( uint32_t dioMask )

inlinestatic

Gets the event status of the specified DIOs.

This function returns the event status for multiple DIOs. The value returned is not shifted and hence matches the corresponding dioMask bits.

Parameters

dioMask

is the bit-mask representation of the DIOs to get the event status from (0-31). The parameter must be a bitwise OR'ed combination of the following:

Returns

Returns a bit vector with the current event status corresponding to the specified DIOs.

0 : Corresponding DIO has no triggered event.
1 : Corresponding DIO has a triggered event.

See also: GPIO_getEventDio(), GPIO_clearEventDio(), GPIO_clearEventMultiDio()

Referenced by SysCtrlShutdownWithAbort().

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Return the event status for the specified DIO.
     return ( HWREG( GPIO_BASE + GPIO_O_EVFLAGS31_0 ) & dioMask );
 }

§ GPIO_getOutputEnableDio()

static uint32_t GPIO_getOutputEnableDio ( uint32_t dioNumber )

inlinestatic

Gets the output enable status of a specific DIO.

This function returns the output enable status for the specified DIO. The DIO can be configured as either input or output under software control.

Parameters

dioNumber specifies the DIO to get the output enable setting from (0-31).

Returns

Returns one of the enumerated data types (0 or 1):

GPIO_OUTPUT_DISABLE : DIO output is disabled.
GPIO_OUTPUT_ENABLE : DIO output is enabled.

See also: GPIO_getOutputEnableMultiDio(), GPIO_setOutputEnableDio(), GPIO_setOutputEnableMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Return the output enable status for the specified DIO.
     return (( HWREG( GPIO_BASE + GPIO_O_DOE31_0 ) >> dioNumber ) & 1 );
 }

§ GPIO_getOutputEnableMultiDio()

static uint32_t GPIO_getOutputEnableMultiDio ( uint32_t dioMask )

inlinestatic

Gets the output enable setting of the specified DIOs.

This function returns the output enable setting for multiple DIOs. The value returned is not shifted and hence matches the corresponding dioMask bits.

Parameters

dioMask

is the bit-mask representation of the DIOs to return the output enable settings from. The parameter must be a bitwise OR'ed combination of the following:

Returns

Returns the output enable setting for multiple DIOs as a bit vector corresponding to the dioMask bits.

0 : Corresponding DIO is configured with output disabled.
1 : Corresponding DIO is configured with output enabled.

See also: GPIO_getOutputEnableDio(), GPIO_setOutputEnableDio(), GPIO_setOutputEnableMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Return the output enable value for the specified DIOs.
     return ( HWREG( GPIO_BASE + GPIO_O_DOE31_0 ) & dioMask );
 }

§ GPIO_readDio()

static uint32_t GPIO_readDio ( uint32_t dioNumber )

inlinestatic

Reads a specific DIO.

Parameters

dioNumber specifies the DIO to read (0-31).

Returns: Returns 0 or 1 reflecting the input value of the specified DIO.

See also: GPIO_readMultiDio(), GPIO_writeDio(), GPIO_writeMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Return the input value from the specified DIO.
     return (( HWREG( GPIO_BASE + GPIO_O_DIN31_0 ) >> dioNumber ) & 1 );
 }

§ GPIO_readMultiDio()

static uint32_t GPIO_readMultiDio ( uint32_t dioMask )

inlinestatic

Reads the input value for the specified DIOs.

This function returns the input value for multiple DIOs. The value returned is not shifted and hence matches the corresponding dioMask bits.

Parameters

dioMask

is the bit-mask representation of the DIOs to read. The parameter must be a bitwise OR'ed combination of the following:

Returns

Returns a bit vector reflecting the input value of the corresponding DIOs.

0 : Corresponding DIO is low.
1 : Corresponding DIO is high.

See also: GPIO_readDio(), GPIO_writeDio(), GPIO_writeMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Return the input value from the specified DIOs.
     return ( HWREG( GPIO_BASE + GPIO_O_DIN31_0 ) & dioMask );
 }

§ GPIO_setDio()

static void GPIO_setDio ( uint32_t dioNumber )

inlinestatic

Sets a specific DIO to 1 (high).

Parameters

dioNumber specifies the DIO to set (0-31).

Returns: None

See also: GPIO_setMultiDio(), GPIO_clearDio(), GPIO_clearMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Set the specified DIO.
     HWREG( GPIO_BASE + GPIO_O_DOUTSET31_0 ) = ( 1 << dioNumber );
 }

§ GPIO_setMultiDio()

static void GPIO_setMultiDio ( uint32_t dioMask )

inlinestatic

Sets the specified DIOs to 1 (high).

Parameters

dioMask

is the bit-mask representation of the DIOs to set. The parameter must be a bitwise OR'ed combination of the following:

Returns: None

See also: GPIO_setDio(), GPIO_clearDio(), GPIO_clearMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Set the DIOs.
     HWREG( GPIO_BASE + GPIO_O_DOUTSET31_0 ) = dioMask;
 }

§ GPIO_setOutputEnableDio()

static void GPIO_setOutputEnableDio	(	uint32_t	dioNumber,
		uint32_t	outputEnableValue
	)

inlinestatic

Sets output enable of a specific DIO.

This function sets the GPIO output enable bit for the specified DIO. The DIO can be configured as either input or output under software control.

Parameters

dioNumber	specifies the DIO to configure (0-31).
outputEnableValue	specifies the output enable setting of the specified DIO: GPIO_OUTPUT_DISABLE : DIO output is disabled. GPIO_OUTPUT_ENABLE : DIO output is enabled.

Returns: None

See also: GPIO_setOutputEnableMultiDio(), GPIO_getOutputEnableDio(), GPIO_getOutputEnableMultiDio()

Referenced by IOCPinTypeGpioInput(), and IOCPinTypeGpioOutput().

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
     ASSERT(( outputEnableValue == GPIO_OUTPUT_DISABLE ) ||
            ( outputEnableValue == GPIO_OUTPUT_ENABLE  )    );
 
     // Update the output enable bit for the specified DIO.
     HWREGBITW( GPIO_BASE + GPIO_O_DOE31_0, dioNumber ) = outputEnableValue;
 }

§ GPIO_setOutputEnableMultiDio()

static void GPIO_setOutputEnableMultiDio	(	uint32_t	dioMask,
		uint32_t	bitVectoredOutputEnable
	)

inlinestatic

Configures the output enable setting for all specified DIOs.

This function configures the output enable setting for the specified DIOs. The output enable setting must be shifted so it matches the corresponding dioMask bits. The DIOs can be configured as either an input or output under software control.

Note: Note that this is a read-modify-write operation and hence not atomic.

Parameters

dioMask	is the bit-mask representation of the DIOs on which to configure the output enable setting. The parameter must be a bitwise OR'ed combination of the following: GPIO_DIO_0_MASK ... GPIO_DIO_31_MASK
bitVectoredOutputEnable	holds the output enable setting the corresponding DIO-bits: 0 : Corresponding DIO is configured with output disabled. 1 : Corresponding DIO is configured with output enabled.

Returns: None

See also: GPIO_setOutputEnableDio(), GPIO_getOutputEnableDio(), GPIO_getOutputEnableMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     HWREG( GPIO_BASE + GPIO_O_DOE31_0 ) =
         ( HWREG( GPIO_BASE + GPIO_O_DOE31_0 ) & ~dioMask ) |
         ( bitVectoredOutputEnable & dioMask );
 }

§ GPIO_toggleDio()

static void GPIO_toggleDio ( uint32_t dioNumber )

inlinestatic

Toggles a specific DIO.

Parameters

dioNumber specifies the DIO to toggle (0-31).

Returns: None

See also: GPIO_toggleMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
 
     // Toggle the specified DIO.
     HWREG( GPIO_BASE + GPIO_O_DOUTTGL31_0 ) = ( 1 << dioNumber );
 }

§ GPIO_toggleMultiDio()

static void GPIO_toggleMultiDio ( uint32_t dioMask )

inlinestatic

Toggles the specified DIOs.

Parameters

dioMask

is the bit-mask representation of the DIOs to toggle. The parameter must be a bitwise OR'ed combination of the following:

Returns: None

See also: GPIO_toggleDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     // Toggle the DIOs.
     HWREG( GPIO_BASE + GPIO_O_DOUTTGL31_0 ) = dioMask;
 }

§ GPIO_writeDio()

static void GPIO_writeDio	(	uint32_t	dioNumber,
		uint32_t	value
	)

inlinestatic

Writes a value to a specific DIO.

Parameters

dioNumber	specifies the DIO to update (0-31).
value	specifies the value to write 0 : Logic zero (low) 1 : Logic one (high)

Returns: None

See also: GPIO_writeMultiDio(), GPIO_readDio(), GPIO_readMultiDio()

 {
     // Check the arguments.
     ASSERT( dioNumberLegal( dioNumber ));
     ASSERT(( value == 0 ) || ( value == 1 ));
 
     // Write 0 or 1 to the byte indexed DOUT map
     HWREGB( GPIO_BASE + dioNumber ) = value;
 }

§ GPIO_writeMultiDio()

static void GPIO_writeMultiDio	(	uint32_t	dioMask,
		uint32_t	bitVectoredValue
	)

inlinestatic

Writes masked data to the specified DIOs.

Enables for writing multiple bits simultaneously. The value to write must be shifted so it matches the corresponding dioMask bits.

Note: Note that this is a read-modify-write operation and hence not atomic.

Parameters

dioMask	is the bit-mask representation of the DIOs to write. The parameter must be a bitwise OR'ed combination of the following: GPIO_DIO_0_MASK ... GPIO_DIO_31_MASK
bitVectoredValue	holds the value to be written to the corresponding DIO-bits.

Returns: None

See also: GPIO_writeDio(), GPIO_readDio(), GPIO_readMultiDio()

 {
     // Check the arguments.
     ASSERT( dioMask & GPIO_DIO_ALL_MASK );
 
     HWREG( GPIO_BASE + GPIO_O_DOUT31_0 ) =
         ( HWREG( GPIO_BASE + GPIO_O_DOUT31_0 ) & ~dioMask ) |
         ( bitVectoredValue & dioMask );
 }

Macro Definition Documentation

§ GPIO_DIO_0_MASK

#define GPIO_DIO_0_MASK 0x00000001

§ GPIO_DIO_10_MASK

#define GPIO_DIO_10_MASK 0x00000400

§ GPIO_DIO_11_MASK

#define GPIO_DIO_11_MASK 0x00000800

§ GPIO_DIO_12_MASK

#define GPIO_DIO_12_MASK 0x00001000

§ GPIO_DIO_13_MASK

#define GPIO_DIO_13_MASK 0x00002000

§ GPIO_DIO_14_MASK

#define GPIO_DIO_14_MASK 0x00004000

§ GPIO_DIO_15_MASK

#define GPIO_DIO_15_MASK 0x00008000

§ GPIO_DIO_16_MASK

#define GPIO_DIO_16_MASK 0x00010000

§ GPIO_DIO_17_MASK

#define GPIO_DIO_17_MASK 0x00020000

§ GPIO_DIO_18_MASK

#define GPIO_DIO_18_MASK 0x00040000

§ GPIO_DIO_19_MASK

#define GPIO_DIO_19_MASK 0x00080000

§ GPIO_DIO_1_MASK

#define GPIO_DIO_1_MASK 0x00000002

§ GPIO_DIO_20_MASK

#define GPIO_DIO_20_MASK 0x00100000

§ GPIO_DIO_21_MASK

#define GPIO_DIO_21_MASK 0x00200000

§ GPIO_DIO_22_MASK

#define GPIO_DIO_22_MASK 0x00400000

§ GPIO_DIO_23_MASK

#define GPIO_DIO_23_MASK 0x00800000

§ GPIO_DIO_24_MASK

#define GPIO_DIO_24_MASK 0x01000000

§ GPIO_DIO_25_MASK

#define GPIO_DIO_25_MASK 0x02000000

§ GPIO_DIO_26_MASK

#define GPIO_DIO_26_MASK 0x04000000

§ GPIO_DIO_27_MASK

#define GPIO_DIO_27_MASK 0x08000000

§ GPIO_DIO_28_MASK

#define GPIO_DIO_28_MASK 0x10000000

§ GPIO_DIO_29_MASK

#define GPIO_DIO_29_MASK 0x20000000

§ GPIO_DIO_2_MASK

#define GPIO_DIO_2_MASK 0x00000004

§ GPIO_DIO_30_MASK

#define GPIO_DIO_30_MASK 0x40000000

§ GPIO_DIO_31_MASK

#define GPIO_DIO_31_MASK 0x80000000

§ GPIO_DIO_3_MASK

#define GPIO_DIO_3_MASK 0x00000008

§ GPIO_DIO_4_MASK

#define GPIO_DIO_4_MASK 0x00000010

§ GPIO_DIO_5_MASK

#define GPIO_DIO_5_MASK 0x00000020

§ GPIO_DIO_6_MASK

#define GPIO_DIO_6_MASK 0x00000040

§ GPIO_DIO_7_MASK

#define GPIO_DIO_7_MASK 0x00000080

§ GPIO_DIO_8_MASK

#define GPIO_DIO_8_MASK 0x00000100

§ GPIO_DIO_9_MASK

#define GPIO_DIO_9_MASK 0x00000200

§ GPIO_DIO_ALL_MASK

#define GPIO_DIO_ALL_MASK 0xFFFFFFFF

Referenced by GPIO_clearEventMultiDio(), GPIO_clearMultiDio(), GPIO_getEventMultiDio(), GPIO_getOutputEnableMultiDio(), GPIO_readMultiDio(), GPIO_setMultiDio(), GPIO_setOutputEnableMultiDio(), GPIO_toggleMultiDio(), and GPIO_writeMultiDio().

§ GPIO_OUTPUT_DISABLE

#define GPIO_OUTPUT_DISABLE 0x00000000

Referenced by GPIO_setOutputEnableDio(), and IOCPinTypeGpioInput().

§ GPIO_OUTPUT_ENABLE

#define GPIO_OUTPUT_ENABLE 0x00000001

Referenced by GPIO_setOutputEnableDio(), and IOCPinTypeGpioOutput().

Functions

Detailed Description

Introduction

API

Function Documentation

§ GPIO_clearDio()

§ GPIO_clearEventDio()

§ GPIO_clearEventMultiDio()

§ GPIO_clearMultiDio()

§ GPIO_getEventDio()

§ GPIO_getEventMultiDio()

§ GPIO_getOutputEnableDio()

§ GPIO_getOutputEnableMultiDio()

§ GPIO_readDio()

§ GPIO_readMultiDio()

§ GPIO_setDio()

§ GPIO_setMultiDio()

§ GPIO_setOutputEnableDio()

§ GPIO_setOutputEnableMultiDio()

§ GPIO_toggleDio()

§ GPIO_toggleMultiDio()

§ GPIO_writeDio()

§ GPIO_writeMultiDio()

Macro Definition Documentation

§ GPIO_DIO_0_MASK

§ GPIO_DIO_10_MASK

§ GPIO_DIO_11_MASK

§ GPIO_DIO_12_MASK

§ GPIO_DIO_13_MASK

§ GPIO_DIO_14_MASK

§ GPIO_DIO_15_MASK

§ GPIO_DIO_16_MASK

§ GPIO_DIO_17_MASK

§ GPIO_DIO_18_MASK

§ GPIO_DIO_19_MASK

§ GPIO_DIO_1_MASK

§ GPIO_DIO_20_MASK

§ GPIO_DIO_21_MASK

§ GPIO_DIO_22_MASK

§ GPIO_DIO_23_MASK

§ GPIO_DIO_24_MASK

§ GPIO_DIO_25_MASK

§ GPIO_DIO_26_MASK

§ GPIO_DIO_27_MASK

§ GPIO_DIO_28_MASK

§ GPIO_DIO_29_MASK

§ GPIO_DIO_2_MASK

§ GPIO_DIO_30_MASK

§ GPIO_DIO_31_MASK

§ GPIO_DIO_3_MASK

§ GPIO_DIO_4_MASK

§ GPIO_DIO_5_MASK

§ GPIO_DIO_6_MASK

§ GPIO_DIO_7_MASK

§ GPIO_DIO_8_MASK

§ GPIO_DIO_9_MASK

§ GPIO_DIO_ALL_MASK

§ GPIO_OUTPUT_DISABLE

§ GPIO_OUTPUT_ENABLE