[pwr_ctrl] Power Controller

Functions
void	PowerCtrlSourceSet (uint32_t ui32PowerConfig)
	Set (Request) the main power source. More...
static uint32_t	PowerCtrlSourceGet (void)
	Get the main power source. More...
static uint32_t	PowerCtrlResetSourceGet (void)
	OBSOLETE: Get the last known reset source of the system. More...
static void	PowerCtrlIOFreezeEnable (void)
	Close the latches in the AON IOC interface and in padring. More...
static void	PowerCtrlIOFreezeDisable (void)

Detailed Description

Function Documentation

static void PowerCtrlIOFreezeDisable ( void  )

inlinestatic

Open the latches in the AON IOC interface and in padring.

Use this function to unfreeze the latches that retained on the IOs driven by the device. This function should not be called before the application has reinitialized the IO configuration that will drive the IOs to the desired level.

Returns

None

See also

PowerCtrlIOFreezeEnable()

{
    // Open the IO latches at AON_IOC level and in the padring
    AONIOCFreezeDisable();
    HWREG(AON_SYSCTL_BASE + AON_SYSCTL_O_SLEEPCTL) = 1;
    HWREG(AON_RTC_BASE + AON_RTC_O_SYNC);
}

Here is the call graph for this function:

static void PowerCtrlIOFreezeEnable ( void  )

inlinestatic

Close the latches in the AON IOC interface and in padring.

Use this function to unfreeze the current value retained on the IOs driven by the device. This is required if it is desired to maintain the level of any IO driven when going through a shutdown/powerdown cycle.

Returns

None

See also

PowerCtrlIOFreezeDisable()

{
    // Close the IO latches at AON_IOC level and in the padring.
    AONIOCFreezeEnable();
    HWREG(AON_SYSCTL_BASE + AON_SYSCTL_O_SLEEPCTL) = 0;
    HWREG(AON_RTC_BASE + AON_RTC_O_SYNC);
}

Here is the call graph for this function:

static uint32_t PowerCtrlResetSourceGet ( void  )

inlinestatic

OBSOLETE: Get the last known reset source of the system.

Recommend using function SysCtrlResetSourceGet() instead of this one. This function returns reset source but does not cover if waking up from shutdown. This function can be seen as a subset of function SysCtrlResetSourceGet() and will be removed in a future release.

Returns

Returns one of the known reset values. The possible reset sources are:

• PWRCTRL_RST_POWER_ON
• PWRCTRL_RST_PIN
• PWRCTRL_RST_VDDS_BOD
• PWRCTRL_RST_VDD_BOD
• PWRCTRL_RST_VDDR_BOD
• PWRCTRL_RST_CLK_LOSS
• PWRCTRL_RST_SW_PIN
• PWRCTRL_RST_WARM

See also

SysCtrlResetSourceGet()

{
    //  Get the reset source.
    return (( HWREG( AON_SYSCTL_BASE + AON_SYSCTL_O_RESETCTL ) &
        AON_SYSCTL_RESETCTL_RESET_SRC_M ) >>
        AON_SYSCTL_RESETCTL_RESET_SRC_S ) ;
}

static uint32_t PowerCtrlSourceGet ( void  )

inlinestatic

Get the main power source.

Use this function to retrieve the current active power source.

When the System CPU is active it can never be powered by uLDO as this is too weak a power source.

Note

Using the DCDC power supply requires an external inductor.

Returns

Returns the main power source.

• PWRCTRL_PWRSRC_DCDC
• PWRCTRL_PWRSRC_GLDO

{
    uint32_t ui32PowerConfig;

    // Return the current power source
    ui32PowerConfig = HWREG(AON_SYSCTL_BASE + AON_SYSCTL_O_PWRCTL);
    if(ui32PowerConfig & AON_SYSCTL_PWRCTL_DCDC_ACTIVE)
    {
        return (PWRCTRL_PWRSRC_DCDC);
    }
    else
    {
        return (PWRCTRL_PWRSRC_GLDO);
    }
}

void PowerCtrlSourceSet

(

uint32_t

ui32PowerConfig

)

Set (Request) the main power source.

Note

The system will never allow a switch to the PWRCTRL_PWRSRC_ULDO when in active mode. This is only allowed when the system is in lower power mode where no code is executing and no peripherals are active. Assuming that there is an external capacitor available for the PWRCTRL_PWRSRC_DCDC the system can dynamically switch back and forth between the two when in active mode.

The system will automatically switch to the GLDO / DCDC when waking up from a low power mode.

Parameters

ui32PowerConfig

is a bitmask indicating the target power source. PWRCTRL_PWRSRC_DCDC PWRCTRL_PWRSRC_GLDO PWRCTRL_PWRSRC_ULDO

Returns

None

{
    // Check the arguments.
    ASSERT((ui32PowerConfig == PWRCTRL_PWRSRC_DCDC) ||
           (ui32PowerConfig == PWRCTRL_PWRSRC_GLDO) ||
           (ui32PowerConfig == PWRCTRL_PWRSRC_ULDO));

    // Configure the power.
    if(ui32PowerConfig == PWRCTRL_PWRSRC_DCDC) {
        HWREG(AON_SYSCTL_BASE + AON_SYSCTL_O_PWRCTL) |=
            (AON_SYSCTL_PWRCTL_DCDC_EN | AON_SYSCTL_PWRCTL_DCDC_ACTIVE);
    }
    else if (ui32PowerConfig == PWRCTRL_PWRSRC_GLDO)
    {
        HWREG(AON_SYSCTL_BASE + AON_SYSCTL_O_PWRCTL) &=
            ~(AON_SYSCTL_PWRCTL_DCDC_EN | AON_SYSCTL_PWRCTL_DCDC_ACTIVE);
    }
    else
    {
        PRCMMcuUldoConfigure(true);
    }
}

Here is the call graph for this function:

Macro Definition Documentation

#define PWRCTRL_ACTIVE   0x00000001

#define PWRCTRL_IOSEG2_DISABLE   0x00000100

#define PWRCTRL_IOSEG2_ENABLE   0x00000400

#define PWRCTRL_IOSEG3_DISABLE   0x00000200

#define PWRCTRL_IOSEG3_ENABLE   0x00000800

#define PWRCTRL_POWER_DOWN   0x00000004

#define PWRCTRL_PWRSRC_DCDC   0x00000001

Referenced by PowerCtrlSourceGet(), and PowerCtrlSourceSet().

#define PWRCTRL_PWRSRC_GLDO   0x00000000

Referenced by PowerCtrlSourceGet(), and PowerCtrlSourceSet().

#define PWRCTRL_PWRSRC_ULDO   0x00000002

Referenced by PowerCtrlSourceSet().

#define PWRCTRL_RST_CLK_LOSS   0x00000005

#define PWRCTRL_RST_PIN   0x00000001

#define PWRCTRL_RST_POWER_ON   0x00000000

#define PWRCTRL_RST_SW_PIN   0x00000006

#define PWRCTRL_RST_VDD_BOD   0x00000003

#define PWRCTRL_RST_VDDR_BOD   0x00000004

#define PWRCTRL_RST_VDDS_BOD   0x00000002

#define PWRCTRL_RST_WARM   0x00000007

#define PWRCTRL_SHUTDOWN   0x00000008

#define PWRCTRL_STANDBY   0x00000002