![]() |
![]() |
Power manager interface for CC27XX.
============================================================================
The Power header file should be included in an application by including the top level header file as follows:
Refer to Power.h for a complete description of APIs.
This header file defines the power resources, constraints, events, sleep states and transition latencies for CC27XX.
#include <ti/drivers/dpl/HwiP.h>
#include <ti/drivers/dpl/ClockP.h>
#include <ti/drivers/Power.h>
#include <ti/devices/DeviceFamily.h>
#include <DeviceFamily_constructPath(inc/hw_pmctl.h)>
#include <DeviceFamily_constructPath(inc/hw_clkctl.h)>
#include <DeviceFamily_constructPath(inc/hw_lrfddbell.h)>
#include <DeviceFamily_constructPath(inc/hw_memmap.h)>
#include <DeviceFamily_constructPath(inc/hw_types.h)>
#include <DeviceFamily_constructPath(driverlib/pmctl.h)>
Go to the source code of this file.
Data Structures | |
struct | PowerCC27XX_Config |
Global configuration structure. More... | |
Macros | |
#define | PowerCC27XX_RESUMETIMESTANDBY 400 |
#define | PowerCC27XX_TOTALTIMESTANDBY 500 |
#define | PowerCC27XX_WAKEDELAYSTANDBY 100 |
#define | PowerLPF3_PERIPH_GPIO (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_GPIO_S) |
#define | PowerLPF3_PERIPH_UART0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_UART0_S) |
#define | PowerLPF3_PERIPH_UART1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_UART1_S) |
#define | PowerLPF3_PERIPH_I2C0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_I2C0_S) |
#define | PowerLPF3_PERIPH_SPI0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_SPI0_S) |
#define | PowerLPF3_PERIPH_SPI1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_SPI1_S) |
#define | PowerLPF3_PERIPH_ADC0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_ADC0_S) |
#define | PowerLPF3_PERIPH_AES (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LAES_S) |
#define | PowerLPF3_PERIPH_DMA (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_DMA_S) |
#define | PowerLPF3_PERIPH_I2S (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_I2S_S) |
#define | PowerLPF3_PERIPH_LGPT0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT0_S) |
#define | PowerLPF3_PERIPH_LGPT1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT1_S) |
#define | PowerLPF3_PERIPH_LGPT2 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT2_S) |
#define | PowerLPF3_PERIPH_LGPT3 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT3_S) |
#define | PowerLPF3_PERIPH_HSM (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_HSM_S) |
#define | PowerLPF3_PERIPH_VCE (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_VCE_S) |
#define | PowerLPF3_PERIPH_MCAN (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_MCAN_S) |
#define | PowerLPF3_PERIPH_LFRD_TRC (PowerCC27XX_PERIPH_GROUP_LRFD | LRFDDBELL_CLKCTL_TRC_S) |
#define | PowerLPF3_PERIPH_LFRD_S2RRAM (PowerCC27XX_PERIPH_GROUP_LRFD | LRFDDBELL_CLKCTL_S2RRAM_S) |
#define | PowerLPF3_STANDBY 0x1 |
#define | PowerLPF3_DISALLOW_SHUTDOWN 0 |
#define | PowerLPF3_DISALLOW_STANDBY 1 |
#define | PowerLPF3_DISALLOW_IDLE 2 |
#define | PowerLPF3_NEED_FLASH_IN_IDLE 3 |
#define | PowerLPF3_ENTERING_STANDBY (1 << 0) |
#define | PowerLPF3_ENTERING_SHUTDOWN (1 << 1) |
#define | PowerLPF3_AWAKE_STANDBY (1 << 2) |
#define | PowerLPF3_HFXT_AVAILABLE (1 << 3) |
#define | PowerLPF3_LFCLK_SWITCHED (1 << 4) |
Enumerations | |
enum | PowerLPF3_ResetReason { PowerLPF3_RESET_SHUTDOWN_IO = PMCTL_RESET_SHUTDOWN_IO, PowerLPF3_RESET_SHUTDOWN_SWD = PMCTL_RESET_SHUTDOWN_SWD, PowerLPF3_RESET_WATCHDOG = PMCTL_RESET_WATCHDOG, PowerLPF3_RESET_SYSTEM = PMCTL_RESET_SYSTEM, PowerLPF3_RESET_CPU = PMCTL_RESET_CPU, PowerLPF3_RESET_LOCKUP = PMCTL_RESET_LOCKUP, PowerLPF3_RESET_TSD = PMCTL_RESET_TSD, PowerLPF3_RESET_SWD = PMCTL_RESET_SWD, PowerLPF3_RESET_LFXT = PMCTL_RESET_LFXT, PowerLPF3_RESET_VDDR = PMCTL_RESET_VDDR, PowerLPF3_RESET_VDDS = PMCTL_RESET_VDDS, PowerLPF3_RESET_PIN = PMCTL_RESET_PIN, PowerLPF3_RESET_POR = PMCTL_RESET_POR, PowerLPF3_RESET_SHUTDOWN_IO = PMCTL_RESET_SHUTDOWN_IO, PowerLPF3_RESET_SHUTDOWN_SWD = PMCTL_RESET_SHUTDOWN_SWD, PowerLPF3_RESET_WATCHDOG = PMCTL_RESET_WATCHDOG, PowerLPF3_RESET_SYSTEM = PMCTL_RESET_SYSTEM, PowerLPF3_RESET_CPU = PMCTL_RESET_CPU, PowerLPF3_RESET_LOCKUP = PMCTL_RESET_LOCKUP, PowerLPF3_RESET_TSD = PMCTL_RESET_TSD, PowerLPF3_RESET_SWD = PMCTL_RESET_SWD, PowerLPF3_RESET_LFXT = PMCTL_RESET_LFXT, PowerLPF3_RESET_VDDR = PMCTL_RESET_VDDR, PowerLPF3_RESET_VDDS = PMCTL_RESET_VDDS, PowerLPF3_RESET_PIN = PMCTL_RESET_PIN, PowerLPF3_RESET_POR = PMCTL_RESET_POR } |
Reasons the device has booted or rebooted. More... | |
enum | PowerLPF3_AfoscFreq { PowerLPF3_AFOSC_FREQ_80MHZ = 80000000, PowerLPF3_AFOSC_FREQ_90P3168MHZ = 90316800, PowerLPF3_AFOSC_FREQ_98P304MHZ = 98304000 } |
The possible frequencies to configure the AFOSC to. More... | |
Functions | |
void | PowerCC27XX_doWFI (void) |
The wait for interrupt (WFI) policy. More... | |
static PowerLPF3_ResetReason | PowerLPF3_getResetReason (void) |
Returns the reason for the most recent reset or wakeup. More... | |
static void | PowerLPF3_releaseLatches (void) |
Unlatch all IOs. More... | |
void | PowerCC27XX_standbyPolicy (void) |
The STANDBY Power Policy. More... | |
void | PowerLPF3_selectLFOSC (void) |
Select LFOSC as LFCLK source. More... | |
void | PowerLPF3_selectLFXT (void) |
Select LFXT as LFCLK source. More... | |
int_fast16_t | PowerLPF3_startAFOSC (PowerLPF3_AfoscFreq frequency) |
Start the AFOSC. More... | |
void | PowerLPF3_stopAFOSC (void) |
Stop the AFOSC. More... | |
void | PowerCC27XX_schedulerDisable (void) |
void | PowerCC27XX_schedulerRestore (void) |
#define PowerCC27XX_RESUMETIMESTANDBY 400 |
The latency to reserve for resume from STANDBY (usec).
#define PowerCC27XX_TOTALTIMESTANDBY 500 |
The total latency to reserve for entry to and exit from STANDBY (usec).
#define PowerCC27XX_WAKEDELAYSTANDBY 100 |
The initial delay when waking from STANDBY (usec).
#define PowerLPF3_PERIPH_GPIO (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_GPIO_S) |
Resource ID: General Purpose I/O
#define PowerLPF3_PERIPH_UART0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_UART0_S) |
Resource ID: UART 0
#define PowerLPF3_PERIPH_UART1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_UART1_S) |
Resource ID: UART 1
#define PowerLPF3_PERIPH_I2C0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_I2C0_S) |
Resource ID: I2C 0
#define PowerLPF3_PERIPH_SPI0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_SPI0_S) |
Resource ID: SPI 0
#define PowerLPF3_PERIPH_SPI1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_SPI1_S) |
Resource ID: SPI 1
#define PowerLPF3_PERIPH_ADC0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_ADC0_S) |
Resource ID: ADC
#define PowerLPF3_PERIPH_AES (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LAES_S) |
Resource ID: AES Security Module
#define PowerLPF3_PERIPH_DMA (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_DMA_S) |
Resource ID: uDMA Controller
#define PowerLPF3_PERIPH_I2S (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_I2S_S) |
Resource ID: I2S
#define PowerLPF3_PERIPH_LGPT0 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT0_S) |
Resource ID: General Purpose Timer 0
#define PowerLPF3_PERIPH_LGPT1 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT1_S) |
Resource ID: General Purpose Timer 1
#define PowerLPF3_PERIPH_LGPT2 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT2_S) |
Resource ID: General Purpose Timer 2
#define PowerLPF3_PERIPH_LGPT3 (PowerCC27XX_PERIPH_GROUP_CLKCTL0 | CLKCTL_DESCEX0_LGPT3_S) |
Resource ID: General Purpose Timer 3
#define PowerLPF3_PERIPH_HSM (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_HSM_S) |
Resource ID: Hardware Security Module
#define PowerLPF3_PERIPH_VCE (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_VCE_S) |
Resource ID: Vector Computational Engine
#define PowerLPF3_PERIPH_MCAN (PowerCC27XX_PERIPH_GROUP_CLKCTL1 | CLKCTL_DESCEX1_MCAN_S) |
Resource ID: MCAN
#define PowerLPF3_PERIPH_LFRD_TRC (PowerCC27XX_PERIPH_GROUP_LRFD | LRFDDBELL_CLKCTL_TRC_S) |
Resource ID: LRFD Tracer
#define PowerLPF3_PERIPH_LFRD_S2RRAM (PowerCC27XX_PERIPH_GROUP_LRFD | LRFDDBELL_CLKCTL_S2RRAM_S) |
Resource ID: LRFD S2R RAM
#define PowerLPF3_STANDBY 0x1 |
The STANDBY sleep state
#define PowerLPF3_DISALLOW_SHUTDOWN 0 |
Constraint: Disallow a transition to the SHUTDOWN state
#define PowerLPF3_DISALLOW_STANDBY 1 |
Constraint: Disallow a transition to the STANDBY sleep state
#define PowerLPF3_DISALLOW_IDLE 2 |
Constraint: Disallow a transition to the IDLE sleep state
#define PowerLPF3_NEED_FLASH_IN_IDLE 3 |
Constraint: Flash memory needs to enabled during IDLE
#define PowerLPF3_ENTERING_STANDBY (1 << 0) |
Power event: The device is entering the STANDBY sleep state
#define PowerLPF3_ENTERING_SHUTDOWN (1 << 1) |
Power event: The device is entering the SHUTDOWN state
#define PowerLPF3_AWAKE_STANDBY (1 << 2) |
Power event: The device is waking up from the STANDBY sleep state
#define PowerLPF3_HFXT_AVAILABLE (1 << 3) |
Power event: The high frequency (HF) crystal oscillator is now available for use (HFXT) by the digital domain
#define PowerLPF3_LFCLK_SWITCHED (1 << 4) |
Power event: The system has switched to the low frequency clock source configured in CCFG
Reasons the device has booted or rebooted.
enum PowerLPF3_AfoscFreq |
void PowerCC27XX_doWFI | ( | void | ) |
The wait for interrupt (WFI) policy.
This is a lightweight Power Policy which simply invokes CPU wait for interrupt.
This policy can be selected statically via the policyFxn pointer in the PowerCC27XX_Config structure, or dynamically at runtime, via Power_setPolicy().
|
inlinestatic |
Returns the reason for the most recent reset or wakeup.
|
inlinestatic |
Unlatch all IOs.
This function releases the latches on all frozen IOs. This function should be called after waking up from shutdown and reconfiguring the IO state so as not to cause glitches.
References PowerCC27XX_schedulerDisable(), PowerCC27XX_schedulerRestore(), PowerCC27XX_standbyPolicy(), PowerLPF3_selectLFOSC(), PowerLPF3_selectLFXT(), PowerLPF3_startAFOSC(), and PowerLPF3_stopAFOSC().
void PowerCC27XX_standbyPolicy | ( | void | ) |
The STANDBY Power Policy.
This is an agressive Power Policy, which considers active constraints, sleep state transition latencies, and time until the next scheduled work, and automatically transitions the device into the deepest sleep state possible.
The first goal is to enter STANDBY; if that is not appropriate given current conditions (e.g., the sleep transition latency is greater greater than the time until the next scheduled Clock event), then the secondary goal is the IDLE state; if that is disallowed (e.g., if the PowerLPF3_DISALLOW_IDLE constraint is declared), then the policy will fallback and simply invoke WFI, to clock gate the CPU until the next interrupt.
In order for this policy to run, it must be selected as the Power Policy (either by being specified as the 'policyFxn' in the PowerCC27XX_Config structure, or specified at runtime with Power_setPolicy()), and the Power Policy must be enabled (either via 'enablePolicy' in the PowerCC27XX_Config structure, or via a call to Power_enablePolicy() at runtime).
Referenced by PowerLPF3_releaseLatches().
void PowerLPF3_selectLFOSC | ( | void | ) |
Select LFOSC as LFCLK source.
Turn on the LFOSC and choose it as LFCLK source. Once LFCLK has switched, the PowerLPF3_LFCLK_SWITCHED notification will be issued and all subscribers to this event will be notified.
Referenced by PowerLPF3_releaseLatches().
void PowerLPF3_selectLFXT | ( | void | ) |
Select LFXT as LFCLK source.
Turn on the LFXT and choose it as LFCLK source. Once LFCLK has switched, the PowerLPF3_LFCLK_SWITCHED notification will be issued and all subscribers to this event will be notified.
Referenced by PowerLPF3_releaseLatches().
int_fast16_t PowerLPF3_startAFOSC | ( | PowerLPF3_AfoscFreq | frequency | ) |
Start the AFOSC.
This function will start the AFOSC if it is not already running. The AFOSC will be configured to the specified frequency and it will be configured to automatically be disabled when entering STANDBY, meaning this function will need to be called again after waking up from STANDBY.
If the AFOSC is already running, no change will be done, and an error code will be returned. This indicates that another SW component is "owning" the AFOSC.
[in] | frequency | The desired frequency of the AFOSC. |
Referenced by PowerLPF3_releaseLatches().
void PowerLPF3_stopAFOSC | ( | void | ) |
Stop the AFOSC.
This function will stop the AFOSC.
Referenced by PowerLPF3_releaseLatches().
void PowerCC27XX_schedulerDisable | ( | void | ) |
Referenced by PowerLPF3_releaseLatches().
void PowerCC27XX_schedulerRestore | ( | void | ) |
Referenced by PowerLPF3_releaseLatches().