Functions
static void	AONIOCDriveStrengthSet (uint32_t ui32DriveLevel, uint32_t ui32DriveStrength)
	Configure drive strength values for the manual drive strength options. More...

static uint32_t	AONIOCDriveStrengthGet (uint32_t ui32DriveLevel)
	Get a specific drive level setting for all IOs. More...

static void	AONIOCFreezeEnable (void)
	Freeze the IOs. More...

static void	AONIOCFreezeDisable (void)
	Un-freeze the IOs. More...

static void	AONIOC32kHzOutputDisable (void)
	Disable the 32kHz clock output. More...

static void	AONIOC32kHzOutputEnable (void)
	Enable the 32kHz clock output. More...

Detailed Description

Introduction

The Input/Output Controller (IOC) controls the functionality of the pins (called DIO). The IOC consists of two APIs:

MCU IOC API selects which peripheral module is connected to the individual DIO and thus allowed to control it. It also controls individual drive strength, slew rate, pull-up/pull-down, edge detection, etc.
AON IOC API controls the general drive strength definitions, IO latches, and if the LF clock is routed to a DIO for external use.

For more information on the MCU IOC see the IOC API.

API

The API functions can be grouped like this:

Freeze IOs while MCU domain is powered down:

Output LF clock to a DIO:

Configure the value of drive strength for the three manual MCU IOC settings (MIN, MED, MAX):

Function Documentation

static void AONIOC32kHzOutputDisable ( void )

inlinestatic

Disable the 32kHz clock output.

When outputting a 32 kHz clock on an IO, the output enable/disable functionality in the IOC is bypassed. Therefore, the programmer needs to call this function to disable the clock output.

Returns: None

See also: AONIOC32kHzOutputEnable()

 {
     // Disable the LF clock output.
     HWREG(AON_IOC_BASE + AON_IOC_O_CLK32KCTL) = AON_IOC_CLK32KCTL_OE_N;
 }

static void AONIOC32kHzOutputEnable ( void )

inlinestatic

Enable the 32kHz clock output.

When outputting a 32 kHz clock on an IO, the output enable/disable functionality in the IOC is bypassed. Therefore, the programmer needs to call this function to enable the clock output.

Returns: None

See also: AONIOC32kHzOutputDisable()

 {
     // Enable the LF clock output.
     HWREG(AON_IOC_BASE + AON_IOC_O_CLK32KCTL) = 0x0;
 }

static uint32_t AONIOCDriveStrengthGet ( uint32_t ui32DriveLevel )

inlinestatic

Get a specific drive level setting for all IOs.

Use this function to read the drive strength setting for a specific IO drive level.

Note: Values are Gray encoded.

Parameters

ui32DriveLevel

is the specific drive level to get the setting for.

AONIOC_DRV_LVL_MIN : Minimum drive strength option.
AONIOC_DRV_LVL_MED : Medium drive strength option.
AONIOC_DRV_LVL_MAX : Maximum drive strength option.

Returns

Returns the requested drive strength level setting for all IOs. Possible values are:

AONIOC_DRV_STR_1 : Lowest drive strength
AONIOC_DRV_STR_2
AONIOC_DRV_STR_3
AONIOC_DRV_STR_4
AONIOC_DRV_STR_5
AONIOC_DRV_STR_6
AONIOC_DRV_STR_7
AONIOC_DRV_STR_8 : Highest drive strength

See also: AONIOCDriveStrengthSet()

 {
     // Check the arguments.
     ASSERT((ui32DriveLevel == AONIOC_DRV_LVL_MIN) ||
            (ui32DriveLevel == AONIOC_DRV_LVL_MED) ||
            (ui32DriveLevel == AONIOC_DRV_LVL_MAX));
 
     // Return the drive strength value.
     return( HWREG(AON_IOC_BASE + ui32DriveLevel) );
 }

static void AONIOCDriveStrengthSet	(	uint32_t	ui32DriveLevel,
		uint32_t	ui32DriveStrength
	)

inlinestatic

Configure drive strength values for the manual drive strength options.

This function defines the general drive strength settings for the non-AUTO drive strength options in the MCU IOC. Consequently, if all IOs are using the automatic drive strength option this function has no effect.

Changing the drive strength values affects all current modes (Low-Current, High-Current, and Extended-Current). Current mode for individual IOs is set in MCU IOC by IOCIODrvStrengthSet().

Note: Values are Gray encoded. Simply incrementing values to increase drive strength will not work.

Parameters

ui32DriveLevel

AONIOC_DRV_LVL_MIN : Minimum drive strength option. Default value is selected to give minimum 2/4/8 mA @3.3V for Low-Current mode, High-Current mode, and Extended-Current mode respectively.
AONIOC_DRV_LVL_MED : Medium drive strength option. Default value is selected to give minimum 2/4/8 mA @2.5V for Low-Current mode, High-Current mode, and Extended-Current mode respectively.
AONIOC_DRV_LVL_MAX : Maximum drive strength option. Default value is selected to give minimum 2/4/8 mA @1.8V for Low-Current mode, High-Current mode, and Extended-Current mode respectively.

ui32DriveStrength

sets the value used by IOs configured as non-AUTO drive strength in MCU IOC.

AONIOC_DRV_STR_1 : Lowest drive strength
AONIOC_DRV_STR_2
AONIOC_DRV_STR_3
AONIOC_DRV_STR_4
AONIOC_DRV_STR_5
AONIOC_DRV_STR_6
AONIOC_DRV_STR_7
AONIOC_DRV_STR_8 : Highest drive strength

Returns: None

See also: AONIOCDriveStrengthGet(), IOCIODrvStrengthSet()

 {
     ASSERT((ui32DriveLevel == AONIOC_DRV_LVL_MIN) ||
            (ui32DriveLevel == AONIOC_DRV_LVL_MED) ||
            (ui32DriveLevel == AONIOC_DRV_LVL_MAX));
     ASSERT((ui32DriveStrength == AONIOC_DRV_STR_1) ||
            (ui32DriveStrength == AONIOC_DRV_STR_2) ||
            (ui32DriveStrength == AONIOC_DRV_STR_3) ||
            (ui32DriveStrength == AONIOC_DRV_STR_4) ||
            (ui32DriveStrength == AONIOC_DRV_STR_5) ||
            (ui32DriveStrength == AONIOC_DRV_STR_6) ||
            (ui32DriveStrength == AONIOC_DRV_STR_7) ||
            (ui32DriveStrength == AONIOC_DRV_STR_8));
 
     // Set the drive strength.
     HWREG(AON_IOC_BASE + ui32DriveLevel) = ui32DriveStrength;
 }

static void AONIOCFreezeDisable ( void )

inlinestatic

Un-freeze the IOs.

When rebooting the chip after it has entered powerdown/shutdown mode, the software can regain control of the IOs by setting the IO latches as transparent. The IOs should not be unfrozen before software has restored the functionality of the IO.

Returns: None

See also: AONIOCFreezeEnable()

 {
     // Set the AON IOC latches as transparent.
     HWREG(AON_IOC_BASE + AON_IOC_O_IOCLATCH) = AON_IOC_IOCLATCH_EN;
 }

static void AONIOCFreezeEnable ( void )

inlinestatic

Freeze the IOs.

To retain the values of the output IOs during a powerdown/shutdown of the device all IO latches in the AON domain should be frozen in their current state. This ensures that software can regain control of the IOs after a reboot without the IOs first falling back to the default values (i.e. input and no pull).

Returns: None

See also: AONIOCFreezeDisable()

Referenced by SysCtrlStandby().

 {
     // Set the AON IO latches as static.
     HWREG(AON_IOC_BASE + AON_IOC_O_IOCLATCH) = 0x0;
 }

Macro Definition Documentation

#define AONIOC_DRV_LVL_MAX (AON_IOC_O_IOSTRMAX)

Referenced by AONIOCDriveStrengthGet(), and AONIOCDriveStrengthSet().

#define AONIOC_DRV_LVL_MED (AON_IOC_O_IOSTRMED)

Referenced by AONIOCDriveStrengthGet(), and AONIOCDriveStrengthSet().

#define AONIOC_DRV_LVL_MIN (AON_IOC_O_IOSTRMIN)

Referenced by AONIOCDriveStrengthGet(), and AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_1 0x00000000

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_2 0x00000001

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_3 0x00000003

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_4 0x00000002

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_5 0x00000006

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_6 0x00000007

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_7 0x00000005

Referenced by AONIOCDriveStrengthSet().

#define AONIOC_DRV_STR_8 0x00000004

Referenced by AONIOCDriveStrengthSet().

Functions

Detailed Description

Introduction

API

Function Documentation

Macro Definition Documentation