/* * Copyright (c) 2017, NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #ifndef _FSL_POWER_H_ #define _FSL_POWER_H_ #include "fsl_common.h" /*! * @addtogroup power * @{ */ /******************************************************************************* * Definitions ******************************************************************************/ /*! @name Driver version */ /*@{*/ /*! @brief power driver version 1.0.0. */ #define FSL_POWER_DRIVER_VERSION (MAKE_VERSION(1, 0, 0)) /*@}*/ /** @brief Low Power main structure */ typedef enum { VD_AON = 0x0, /*!< Digital Always On power domain */ VD_MEM = 0x1, /*!< Memories (SRAM) power domain */ VD_DCDC = 0x2, /*!< Core logic power domain */ VD_DEEPSLEEP = 0x3 /*!< Core logic power domain */ } LPC_POWER_DOMAIN_T; /** @brief Low Power main structure */ typedef struct { /* */ __IO uint32_t CFG; /*!< Low Power Mode Configuration, and miscallenous options */ __IO uint32_t PDCTRL0; /*!< Power Down control : controls power of various modules in the different Low power modes, including ROM */ __IO uint32_t SRAMRETCTRL; /*!< Power Down control : controls power SRAM instances in the different Low power modes */ __IO uint32_t CPURETCTRL; /*!< CPU0 retention control : controls CPU retention parameters in POWER DOWN modes */ __IO uint64_t VOLTAGE; /*!< Voltage control in Low Power Modes */ __IO uint64_t WAKEUPSRC; /*!< Wake up sources control for sleepcon */ __IO uint64_t WAKEUPINT; /*!< Wake up sources control for ARM */ __IO uint32_t HWWAKE; /*!< Interrupt that can postpone power down modes in case an interrupt is pending when the processor request deepsleep */ __IO uint32_t WAKEUPIOSRC; /*!< Wake up I/O sources in DEEP POWER DOWN mode */ __IO uint32_t TIMERCFG; /*!< Wake up timers configuration */ __IO uint32_t TIMERCOUNT; /*!< Wake up Timer count*/ __IO uint32_t POWERCYCLE; /*!< Cancels entry in Low Power mode if set with 0xDEADABBA (might be used by some interrupt handlers)*/ } LPC_LOWPOWER_T; /* */ #define LOWPOWER_POWERCYCLE_CANCELLED 0xDEADABBA /*!< */ /* Low Power modes */ #define LOWPOWER_CFG_LPMODE_INDEX 0 #define LOWPOWER_CFG_LPMODE_MASK (0x3UL << LOWPOWER_CFG_LPMODE_INDEX) #define LOWPOWER_CFG_SELCLOCK_INDEX 2 #define LOWPOWER_CFG_SELCLOCK_MASK (0x1UL << LOWPOWER_CFG_SELCLOCK_INDEX) #define LOWPOWER_CFG_SELMEMSUPPLY_INDEX 3 #define LOWPOWER_CFG_SELMEMSUPPLY_MASK (0x1UL << LOWPOWER_CFG_SELMEMSUPPLY_INDEX) #define LOWPOWER_CFG_MEMLOWPOWERMODE_INDEX 4 #define LOWPOWER_CFG_MEMLOWPOWERMODE_MASK (0x1UL << LOWPOWER_CFG_MEMLOWPOWERMODE_INDEX) #define LOWPOWER_CFG_LDODEEPSLEEPREF_INDEX 5 #define LOWPOWER_CFG_LDODEEPSLEEPREF_MASK (0x1UL << LOWPOWER_CFG_LDODEEPSLEEPREF_INDEX) #define LOWPOWER_CFG_LPMODE_ACTIVE 0 /*!< ACTIVE mode */ #define LOWPOWER_CFG_LPMODE_DEEPSLEEP 1 /*!< DEEP SLEEP mode */ #define LOWPOWER_CFG_LPMODE_POWERDOWN 2 /*!< POWER DOWN mode */ #define LOWPOWER_CFG_LPMODE_DEEPPOWERDOWN 3 /*!< DEEP POWER DOWN mode */ #define LOWPOWER_CFG_LPMODE_SLEEP 4 /*!< SLEEP mode */ #define LOWPOWER_CFG_SELCLOCK_1MHZ 0 /*!< The 1 MHz clock is used during the configuration of the PMC */ #define LOWPOWER_CFG_SELCLOCK_12MHZ 1 /*!< The 12 MHz clock is used during the configuration of the PMC (to speed up PMC configuration process)*/ #define LOWPOWER_CFG_SELMEMSUPPLY_LDOMEM 0 /*!< In DEEP SLEEP power mode, the Memories are supplied by the LDO_MEM */ #define LOWPOWER_CFG_SELMEMSUPPLY_LDODEEPSLEEP 1 /*!< In DEEP SLEEP power mode, the Memories are supplied by the LDO_DEEP_SLEEP (or DCDC) */ #define LOWPOWER_CFG_MEMLOWPOWERMODE_SOURCEBIASING 0 /*!< All SRAM instances use "Source Biasing" as low power mode technic (it is recommended to set LDO_MEM as high as possible -- 1.1V typical -- during low power mode) */ #define LOWPOWER_CFG_MEMLOWPOWERMODE_VOLTAGESCALING 1 /*!< All SRAM instances use "Voltage Scaling" as low power mode technic (it is recommended to set LDO_MEM as low as possible -- down to 0.7V -- during low power mode) */ #define LOWPOWER_CFG_LDODEEPSLEEPREF_FLASHBUFFER 0 /*!< LDO DEEP SLEEP uses Flash Buffer as reference */ #define LOWPOWER_CFG_LDODEEPSLEEPREF_BANDGAG0P8V 1 /*!< LDO DEEP SLEEP uses Band Gap 0.8V as reference */ /* CPU Retention Control*/ #define LOWPOWER_CPURETCTRL_ENA_INDEX 0 #define LOWPOWER_CPURETCTRL_ENA_MASK (0x1UL << LOWPOWER_CPURETCTRL_ENA_INDEX) #define LOWPOWER_CPURETCTRL_MEMBASE_INDEX 1 #define LOWPOWER_CPURETCTRL_MEMBASE_MASK (0x1FFF << LOWPOWER_CPURETCTRL_MEMBASE_INDEX) #define LOWPOWER_CPURETCTRL_RETDATALENGTH_INDEX 14 #define LOWPOWER_CPURETCTRL_RETDATALENGTH_MASK (0x3FFUL << LOWPOWER_CPURETCTRL_RETDATALENGTH_INDEX) #define LOWPOWER_CPURETCTRL_ENA_DISABLE 0 /*!< In POWER DOWN mode, CPU Retention is disabled */ #define LOWPOWER_CPURETCTRL_ENA_ENABLE 1 /*!< In POWER DOWN mode, CPU Retention is enabled */ /** * @brief Analog components power modes control during low power modes */ typedef enum pd_bits { kPDRUNCFG_PD_DCDC = (1UL << 0), kPDRUNCFG_PD_BIAS = (1UL << 1), kPDRUNCFG_PD_BODCORE = (1UL << 2), kPDRUNCFG_PD_BODVBAT = (1UL << 3), kPDRUNCFG_PD_FRO1M = (1UL << 4), kPDRUNCFG_PD_FRO192M = (1UL << 5), kPDRUNCFG_PD_FRO32K = (1UL << 6), kPDRUNCFG_PD_XTAL32K = (1UL << 7), kPDRUNCFG_PD_XTAL32M = (1UL << 8), kPDRUNCFG_PD_PLL0 = (1UL << 9), kPDRUNCFG_PD_PLL1 = (1UL << 10), kPDRUNCFG_PD_USB0_PHY = (1UL << 11), kPDRUNCFG_PD_USB1_PHY = (1UL << 12), kPDRUNCFG_PD_COMP = (1UL << 13), kPDRUNCFG_PD_TEMPSENS = (1UL << 14), kPDRUNCFG_PD_GPADC = (1UL << 15), kPDRUNCFG_PD_LDOMEM = (1UL << 16), kPDRUNCFG_PD_LDODEEPSLEEP = (1UL << 17), kPDRUNCFG_PD_LDOUSBHS = (1UL << 18), kPDRUNCFG_PD_LDOGPADC = (1UL << 19), kPDRUNCFG_PD_LDOXO32M = (1UL << 20), kPDRUNCFG_PD_LDOFLASHNV = (1UL << 21), kPDRUNCFG_PD_RNG = (1UL << 22), kPDRUNCFG_PD_PLL0_SSCG = (1UL << 23), kPDRUNCFG_PD_ROM = (1UL << 24), /* This enum member has no practical meaning,it is used to avoid MISRA issue, user should not trying to use it. */ kPDRUNCFG_ForceUnsigned = 0x80000000U, } pd_bit_t; /** * @brief SRAM instances retention control during low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAMX0 (1UL << 0) /*!< Enable SRAMX_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAMX1 (1UL << 1) /*!< Enable SRAMX_1 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAMX2 (1UL << 2) /*!< Enable SRAMX_2 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAMX3 (1UL << 3) /*!< Enable SRAMX_3 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM00 (1UL << 4) /*!< Enable SRAM0_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM01 (1UL << 5) /*!< Enable SRAM0_1 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM10 (1UL << 6) /*!< Enable SRAM1_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM20 (1UL << 7) /*!< Enable SRAM2_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM30 (1UL << 8) /*!< Enable SRAM3_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM31 (1UL << 9) /*!< Enable SRAM3_1 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM40 (1UL << 10) /*!< Enable SRAM4_0 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM41 (1UL << 11) /*!< Enable SRAM4_1 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM42 (1UL << 12) /*!< Enable SRAM4_2 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM43 (1UL << 13) /*!< Enable SRAM4_3 retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM_USB_HS (1UL << 14) /*!< Enable SRAM USB HS retention when entering in Low power modes */ #define LOWPOWER_SRAMRETCTRL_RETEN_RAM_PUF (1UL << 15) /*!< Enable SRAM PUFF retention when entering in Low power modes */ /** * @brief SRAM Low Power Modes */ #define LOWPOWER_SRAM_LPMODE_MASK (0xFUL) #define LOWPOWER_SRAM_LPMODE_ACTIVE (0x6UL) /*!< SRAM functional mode */ #define LOWPOWER_SRAM_LPMODE_SLEEP (0xFUL) /*!< SRAM Sleep mode (Data retention, fast wake up) */ #define LOWPOWER_SRAM_LPMODE_DEEPSLEEP (0x8UL) /*!< SRAM Deep Sleep mode (Data retention, slow wake up) */ #define LOWPOWER_SRAM_LPMODE_SHUTDOWN (0x9UL) /*!< SRAM Shut Down mode (no data retention) */ #define LOWPOWER_SRAM_LPMODE_POWERUP (0xAUL) /*!< SRAM is powering up */ /*@brief BOD VBAT level */ typedef enum _power_bod_vbat_level { kPOWER_BodVbatLevel1000mv = 0, /*!< Brown out detector VBAT level 1V */ kPOWER_BodVbatLevel1100mv = 1, /*!< Brown out detector VBAT level 1.1V */ kPOWER_BodVbatLevel1200mv = 2, /*!< Brown out detector VBAT level 1.2V */ kPOWER_BodVbatLevel1300mv = 3, /*!< Brown out detector VBAT level 1.3V */ kPOWER_BodVbatLevel1400mv = 4, /*!< Brown out detector VBAT level 1.4V */ kPOWER_BodVbatLevel1500mv = 5, /*!< Brown out detector VBAT level 1.5V */ kPOWER_BodVbatLevel1600mv = 6, /*!< Brown out detector VBAT level 1.6V */ kPOWER_BodVbatLevel1650mv = 7, /*!< Brown out detector VBAT level 1.65V */ kPOWER_BodVbatLevel1700mv = 8, /*!< Brown out detector VBAT level 1.7V */ kPOWER_BodVbatLevel1750mv = 9, /*!< Brown out detector VBAT level 1.75V */ kPOWER_BodVbatLevel1800mv = 10, /*!< Brown out detector VBAT level 1.8V */ kPOWER_BodVbatLevel1900mv = 11, /*!< Brown out detector VBAT level 1.9V */ kPOWER_BodVbatLevel2000mv = 12, /*!< Brown out detector VBAT level 2V */ kPOWER_BodVbatLevel2100mv = 13, /*!< Brown out detector VBAT level 2.1V */ kPOWER_BodVbatLevel2200mv = 14, /*!< Brown out detector VBAT level 2.2V */ kPOWER_BodVbatLevel2300mv = 15, /*!< Brown out detector VBAT level 2.3V */ kPOWER_BodVbatLevel2400mv = 16, /*!< Brown out detector VBAT level 2.4V */ kPOWER_BodVbatLevel2500mv = 17, /*!< Brown out detector VBAT level 2.5V */ kPOWER_BodVbatLevel2600mv = 18, /*!< Brown out detector VBAT level 2.6V */ kPOWER_BodVbatLevel2700mv = 19, /*!< Brown out detector VBAT level 2.7V */ kPOWER_BodVbatLevel2806mv = 20, /*!< Brown out detector VBAT level 2.806V */ kPOWER_BodVbatLevel2900mv = 21, /*!< Brown out detector VBAT level 2.9V */ kPOWER_BodVbatLevel3000mv = 22, /*!< Brown out detector VBAT level 3.0V */ kPOWER_BodVbatLevel3100mv = 23, /*!< Brown out detector VBAT level 3.1V */ kPOWER_BodVbatLevel3200mv = 24, /*!< Brown out detector VBAT level 3.2V */ kPOWER_BodVbatLevel3300mv = 25, /*!< Brown out detector VBAT level 3.3V */ } power_bod_vbat_level_t; /*@brief BOD core level */ typedef enum _power_bod_core_level { kPOWER_BodCoreLevel600mv = 0, /*!< Brown out detector core level 600mV */ kPOWER_BodCoreLevel650mv = 1, /*!< Brown out detector core level 650mV */ kPOWER_BodCoreLevel700mv = 2, /*!< Brown out detector core level 700mV */ kPOWER_BodCoreLevel750mv = 3, /*!< Brown out detector core level 750mV */ kPOWER_BodCoreLevel800mv = 4, /*!< Brown out detector core level 800mV */ kPOWER_BodCoreLevel850mv = 5, /*!< Brown out detector core level 850mV */ kPOWER_BodCoreLevel900mv = 6, /*!< Brown out detector core level 900mV */ kPOWER_BodCoreLevel950mv = 7, /*!< Brown out detector core level 950mV */ } power_bod_core_level_t; /*@brief BOD Hysteresis control */ typedef enum _power_bod_hyst { kPOWER_BodHystLevel25mv = 0U, /*!< BOD Hysteresis control level 25mv */ kPOWER_BodHystLevel50mv = 1U, /*!< BOD Hysteresis control level 50mv */ kPOWER_BodHystLevel75mv = 2U, /*!< BOD Hysteresis control level 75mv */ kPOWER_BodHystLevel100mv = 3U, /*!< BOD Hysteresis control level 100mv */ } power_bod_hyst_t; /** * @brief LDO Voltage control in Low Power Modes */ #define LOWPOWER_VOLTAGE_LDO_PMU_INDEX 0 #define LOWPOWER_VOLTAGE_LDO_PMU_MASK (0x1FULL << LOWPOWER_VOLTAGE_LDO_PMU_INDEX) #define LOWPOWER_VOLTAGE_LDO_MEM_INDEX 5 #define LOWPOWER_VOLTAGE_LDO_MEM_MASK (0x1FULL << LOWPOWER_VOLTAGE_LDO_MEM_INDEX) #define LOWPOWER_VOLTAGE_LDO_DEEP_SLEEP_INDEX 10 #define LOWPOWER_VOLTAGE_LDO_DEEP_SLEEP_MASK (0x7ULL << LOWPOWER_VOLTAGE_LDO_DEEP_SLEEP_INDEX) #define LOWPOWER_VOLTAGE_LDO_PMU_BOOST_INDEX 19 #define LOWPOWER_VOLTAGE_LDO_PMU_BOOST_MASK (0x1FULL << LOWPOWER_VOLTAGE_LDO_PMU_BOOST_INDEX) #define LOWPOWER_VOLTAGE_LDO_MEM_BOOST_INDEX 24 #define LOWPOWER_VOLTAGE_LDO_MEM_BOOST_MASK (0x1FULL << LOWPOWER_VOLTAGE_LDO_MEM_BOOST_INDEX) #define LOWPOWER_VOLTAGE_DCDC_INDEX 29 #define LOWPOWER_VOLTAGE_DCDC_MASK (0xFULL << LOWPOWER_VOLTAGE_DCDC_INDEX) /** * @brief Always On and Memories LDO voltage settings */ typedef enum _v_ao { // V_AO_1P220 1.22 = 0, /*!< 1.22 V */ V_AO_0P700 = 1, /*!< 0.7 V */ V_AO_0P725 = 2, /*!< 0.725 V */ V_AO_0P750 = 3, /*!< 0.75 V */ V_AO_0P775 = 4, /*!< 0.775 V */ V_AO_0P800 = 5, /*!< 0.8 V */ V_AO_0P825 = 6, /*!< 0.825 V */ V_AO_0P850 = 7, /*!< 0.85 V */ V_AO_0P875 = 8, /*!< 0.875 V */ V_AO_0P900 = 9, /*!< 0.9 V */ V_AO_0P960 = 10, /*!< 0.96 V */ V_AO_0P970 = 11, /*!< 0.97 V */ V_AO_0P980 = 12, /*!< 0.98 V */ V_AO_0P990 = 13, /*!< 0.99 V */ V_AO_1P000 = 14, /*!< 1 V */ V_AO_1P010 = 15, /*!< 1.01 V */ V_AO_1P020 = 16, /*!< 1.02 V */ V_AO_1P030 = 17, /*!< 1.03 V */ V_AO_1P040 = 18, /*!< 1.04 V */ V_AO_1P050 = 19, /*!< 1.05 V */ V_AO_1P060 = 20, /*!< 1.06 V */ V_AO_1P070 = 21, /*!< 1.07 V */ V_AO_1P080 = 22, /*!< 1.08 V */ V_AO_1P090 = 23, /*!< 1.09 V */ V_AO_1P100 = 24, /*!< 1.1 V */ V_AO_1P110 = 25, /*!< 1.11 V */ V_AO_1P120 = 26, /*!< 1.12 V */ V_AO_1P130 = 27, /*!< 1.13 V */ V_AO_1P140 = 28, /*!< 1.14 V */ V_AO_1P150 = 29, /*!< 1.15 V */ V_AO_1P160 = 30, /*!< 1.16 V */ V_AO_1P220 = 31 /*!< 1.22 V */ } v_ao_t; /** * @brief Deep Sleep LDO voltage settings */ typedef enum _v_deepsleep { V_DEEPSLEEP_0P900 = 0, /*!< 0.9 V */ V_DEEPSLEEP_0P925 = 1, /*!< 0.925 V */ V_DEEPSLEEP_0P950 = 2, /*!< 0.95 V */ V_DEEPSLEEP_0P975 = 3, /*!< 0.975 V */ V_DEEPSLEEP_1P000 = 4, /*!< 1.000 V */ V_DEEPSLEEP_1P025 = 5, /*!< 1.025 V */ V_DEEPSLEEP_1P050 = 6, /*!< 1.050 V */ V_DEEPSLEEP_1P075 = 7 /*!< 1.075 V */ } v_deepsleep_t; /** * @brief DCDC voltage settings */ typedef enum _v_dcdc { V_DCDC_0P950 = 0, /*!< 0.95 V */ V_DCDC_0P975 = 1, /*!< 0.975 V */ V_DCDC_1P000 = 2, /*!< 1 V */ V_DCDC_1P025 = 3, /*!< 1.025 V */ V_DCDC_1P050 = 4, /*!< 1.050 V */ V_DCDC_1P075 = 5, /*!< 1.075 V */ V_DCDC_1P100 = 6, /*!< 1.1 V */ V_DCDC_1P125 = 7, /*!< 1.125 V */ V_DCDC_1P150 = 8, /*!< 1.150 V */ V_DCDC_1P175 = 9, /*!< 1.175 V */ V_DCDC_1P200 = 10 /*!< 1.2 V */ } v_dcdc_t; /** * @brief LDO_FLASH_NV & LDO_USB voltage settings */ typedef enum _v_flashnv { V_LDOFLASHNV_1P650 = 0, /*!< 0.95 V */ V_LDOFLASHNV_1P700 = 1, /*!< 0.975 V */ V_LDOFLASHNV_1P750 = 2, /*!< 1 V */ V_LDOFLASHNV_0P800 = 3, /*!< 1.025 V */ V_LDOFLASHNV_1P850 = 4, /*!< 1.050 V */ V_LDOFLASHNV_1P900 = 5, /*!< 1.075 V */ V_LDOFLASHNV_1P950 = 6, /*!< 1.1 V */ V_LDOFLASHNV_2P000 = 7 /*!< 1.125 V */ } v_flashnv_t; /** * @brief Low Power Modes Wake up sources */ #define WAKEUP_SYS (1ULL << 0) /*!< [SLEEP, DEEP SLEEP ] */ /* WWDT0_IRQ and BOD_IRQ*/ #define WAKEUP_SDMA0 (1ULL << 1) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_GLOBALINT0 (1ULL << 2) /*!< [SLEEP, DEEP SLEEP, POWER DOWN ] */ #define WAKEUP_GPIO_GLOBALINT1 (1ULL << 3) /*!< [SLEEP, DEEP SLEEP, POWER DOWN ] */ #define WAKEUP_GPIO_INT0_0 (1ULL << 4) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_1 (1ULL << 5) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_2 (1ULL << 6) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_3 (1ULL << 7) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_UTICK (1ULL << 8) /*!< [SLEEP, ] */ #define WAKEUP_MRT (1ULL << 9) /*!< [SLEEP, ] */ #define WAKEUP_CTIMER0 (1ULL << 10) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_CTIMER1 (1ULL << 11) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_SCT (1ULL << 12) /*!< [SLEEP, ] */ #define WAKEUP_CTIMER3 (1ULL << 13) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM0 (1ULL << 14) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM1 (1ULL << 15) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM2 (1ULL << 16) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM3 (1ULL << 17) /*!< [SLEEP, DEEP SLEEP, POWER DOWN ] */ #define WAKEUP_FLEXCOMM4 (1ULL << 18) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM5 (1ULL << 19) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM6 (1ULL << 20) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_FLEXCOMM7 (1ULL << 21) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_ADC (1ULL << 22) /*!< [SLEEP, ] */ // reserved (1ULL << 23) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_ACMP_CAPT (1ULL << 24) /*!< [SLEEP, DEEP SLEEP, POWER DOWN ] */ // reserved (1ULL << 25) // reserved (1ULL << 26) #define WAKEUP_USB0_NEEDCLK (1ULL << 27) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_USB0 (1ULL << 28) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_RTC_LITE_ALARM_WAKEUP (1ULL << 29) /*!< [SLEEP, DEEP SLEEP, POWER DOWN, DEEP POWER DOWN] */ #define WAKEUP_EZH_ARCH_B (1ULL << 30) /*!< [SLEEP, ] */ #define WAKEUP_WAKEUP_MAILBOX (1ULL << 31) /*!< [SLEEP, DEEP SLEEP, POWER DOWN ] */ #define WAKEUP_GPIO_INT0_4 (1ULL << 32) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_5 (1ULL << 33) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_6 (1ULL << 34) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_GPIO_INT0_7 (1ULL << 35) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_CTIMER2 (1ULL << 36) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_CTIMER4 (1ULL << 37) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_OS_EVENT_TIMER (1ULL << 38) /*!< [SLEEP, DEEP SLEEP, POWER DOWN, DEEP POWER DOWN] */ // reserved (1ULL << 39) // reserved (1ULL << 40) // reserved (1ULL << 41) #define WAKEUP_SDIO (1ULL << 42) /*!< [SLEEP, ] */ // reserved (1ULL << 43) // reserved (1ULL << 44) // reserved (1ULL << 45) // reserved (1ULL << 46) #define WAKEUP_USB1 (1ULL << 47) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_USB1_NEEDCLK (1ULL << 48) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_SEC_HYPERVISOR_CALL (1ULL << 49) /*!< [SLEEP, ] */ #define WAKEUP_SEC_GPIO_INT0_0 (1ULL << 50) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_SEC_GPIO_INT0_1 (1ULL << 51) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_PLU (1ULL << 52) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_SEC_VIO (1ULL << 53) #define WAKEUP_SHA (1ULL << 54) /*!< [SLEEP, ] */ #define WAKEUP_CASPER (1ULL << 55) /*!< [SLEEP, ] */ #define WAKEUP_PUFF (1ULL << 56) /*!< [SLEEP, ] */ #define WAKEUP_PQ (1ULL << 57) /*!< [SLEEP, ] */ #define WAKEUP_SDMA1 (1ULL << 58) /*!< [SLEEP, DEEP SLEEP ] */ #define WAKEUP_LSPI_HS (1ULL << 59) /*!< [SLEEP, DEEP SLEEP ] */ // reserved WAKEUP_PVTVF0_AMBER (1ULL << 60) // reserved WAKEUP_PVTVF0_RED (1ULL << 61) // reserved WAKEUP_PVTVF1_AMBER (1ULL << 62) #define WAKEUP_ALLWAKEUPIOS (1ULL << 63) /*!< [ , DEEP POWER DOWN] */ /** * @brief Sleep Postpone */ #define LOWPOWER_HWWAKE_FORCED (1UL << 0) /*!< Force peripheral clocking to stay on during deep-sleep mode. */ #define LOWPOWER_HWWAKE_PERIPHERALS (1UL << 1) /*!< Wake for Flexcomms. Any Flexcomm FIFO reaching the level specified by its own TXLVL will cause peripheral clocking to wake up temporarily while the related status is asserted */ #define LOWPOWER_HWWAKE_SDMA0 (1UL << 3) /*!< Wake for DMA0. DMA0 being busy will cause peripheral clocking to remain running until DMA completes. Used in conjonction with LOWPOWER_HWWAKE_PERIPHERALS */ #define LOWPOWER_HWWAKE_SDMA1 (1UL << 5) /*!< Wake for DMA1. DMA0 being busy will cause peripheral clocking to remain running until DMA completes. Used in conjonction with LOWPOWER_HWWAKE_PERIPHERALS */ #define LOWPOWER_HWWAKE_ENABLE_FRO192M (1UL << 31) /*!< Need to be set if FRO192M is disable - via PDCTRL0 - in Deep Sleep mode and any of LOWPOWER_HWWAKE_PERIPHERALS, LOWPOWER_HWWAKE_SDMA0 or LOWPOWER_HWWAKE_SDMA1 is set */ /** * @brief Wake up I/O sources */ #define LOWPOWER_WAKEUPIOSRC_PIO0_INDEX 0 /*!< Pin P1( 1) */ #define LOWPOWER_WAKEUPIOSRC_PIO1_INDEX 2 /*!< Pin P0(28) */ #define LOWPOWER_WAKEUPIOSRC_PIO2_INDEX 4 /*!< Pin P1(18) */ #define LOWPOWER_WAKEUPIOSRC_PIO3_INDEX 6 /*!< Pin P1(30) */ #define LOWPOWER_WAKEUPIOSRC_DISABLE 0 /*!< Wake up is disable */ #define LOWPOWER_WAKEUPIOSRC_RISING 1 /*!< Wake up on rising edge */ #define LOWPOWER_WAKEUPIOSRC_FALLING 2 /*!< Wake up on falling edge */ #define LOWPOWER_WAKEUPIOSRC_RISING_FALLING 3 /*!< Wake up on both rising or falling edges */ /** * @brief Wake up timers configuration in Low Power Modes */ #define LOWPOWER_TIMERCFG_CTRL_INDEX 0 #define LOWPOWER_TIMERCFG_CTRL_MASK (0x1UL << LOWPOWER_TIMERCFG_CTRL_INDEX) #define LOWPOWER_TIMERCFG_TIMER_INDEX 1 #define LOWPOWER_TIMERCFG_TIMER_MASK (0x7UL << LOWPOWER_TIMERCFG_TIMER_INDEX) #define LOWPOWER_TIMERCFG_OSC32K_INDEX 4 #define LOWPOWER_TIMERCFG_OSC32K_MASK (0x1UL << LOWPOWER_TIMERCFG_OSC32K_INDEX) #define LOWPOWER_TIMERCFG_CTRL_DISABLE 0 /*!< Wake Timer Disable */ #define LOWPOWER_TIMERCFG_CTRL_ENABLE 1 /*!< Wake Timer Enable */ /** * @brief Primary Wake up timers configuration in Low Power Modes */ #define LOWPOWER_TIMERCFG_TIMER_RTC1KHZ 0 /*!< 1 KHz Real Time Counter (RTC) used as wake up source */ #define LOWPOWER_TIMERCFG_TIMER_RTC1HZ 1 /*!< 1 Hz Real Time Counter (RTC) used as wake up source */ #define LOWPOWER_TIMERCFG_TIMER_OSTIMER 2 /*!< OS Event Timer used as wake up source */ #define LOWPOWER_TIMERCFG_OSC32K_FRO32KHZ 0 /*!< Wake up Timers uses FRO 32 KHz as clock source */ #define LOWPOWER_TIMERCFG_OSC32K_XTAL32KHZ 1 /*!< Wake up Timers uses Chrystal 32 KHz as clock source */ //! @brief Interface for lowpower functions typedef struct LowpowerDriverInterface { void (*power_cycle_cpu_and_flash)(void); void (*set_lowpower_mode)(LPC_LOWPOWER_T *p_lowpower_cfg); } lowpower_driver_interface_t; /* Power mode configuration API parameter */ typedef enum _power_mode_config { kPmu_Sleep = 0U, kPmu_Deep_Sleep = 1U, kPmu_PowerDown = 2U, kPmu_Deep_PowerDown = 3U, } power_mode_cfg_t; /******************************************************************************* * API ******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /*! * @brief API to enable PDRUNCFG bit in the Syscon. Note that enabling the bit powers down the peripheral * * @param en peripheral for which to enable the PDRUNCFG bit * @return none */ static inline void POWER_EnablePD(pd_bit_t en) { /* PDRUNCFGSET */ PMC->PDRUNCFGSET0 = en; } /*! * @brief API to disable PDRUNCFG bit in the Syscon. Note that disabling the bit powers up the peripheral * * @param en peripheral for which to disable the PDRUNCFG bit * @return none */ static inline void POWER_DisablePD(pd_bit_t en) { /* PDRUNCFGCLR */ PMC->PDRUNCFGCLR0 = en; } /*! * @brief set BOD VBAT level. * * @param level BOD detect level * @param hyst BoD Hysteresis control * @param enBodVbatReset VBAT brown out detect reset */ static inline void POWER_SetBodVbatLevel(power_bod_vbat_level_t level, power_bod_hyst_t hyst, bool enBodVbatReset) { PMC->BODVBAT = (PMC->BODVBAT & (~(PMC_BODVBAT_TRIGLVL_MASK | PMC_BODVBAT_HYST_MASK))) | PMC_BODVBAT_TRIGLVL(level) | PMC_BODVBAT_HYST(hyst); PMC->RESETCTRL = (PMC->RESETCTRL & (~PMC_RESETCTRL_BODVBATRESETENABLE_MASK)) | PMC_RESETCTRL_BODVBATRESETENABLE(enBodVbatReset); } /*! * @brief set BOD core level. * * @param level BOD detect level * @param hyst BoD Hysteresis control * @param enBodCoreReset core brown out detect reset */ static inline void POWER_SetBodCoreLevel(power_bod_core_level_t level, power_bod_hyst_t hyst, bool enBodCoreReset) { PMC->BODCORE = (PMC->BODCORE & (~(PMC_BODCORE_TRIGLVL_MASK | PMC_BODCORE_HYST_MASK))) | PMC_BODCORE_TRIGLVL(level) | PMC_BODCORE_HYST(hyst); PMC->RESETCTRL = (PMC->RESETCTRL & (~PMC_RESETCTRL_BODCORERESETENABLE_MASK)) | PMC_RESETCTRL_BODCORERESETENABLE(enBodCoreReset); } /*! * @brief API to enable deep sleep bit in the ARM Core. * * @param none * @return none */ static inline void POWER_EnableDeepSleep(void) { SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk; } /*! * @brief API to disable deep sleep bit in the ARM Core. * * @param none * @return none */ static inline void POWER_DisableDeepSleep(void) { SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk; } /*! * @brief API to power down flash controller. * * @param none * @return none */ static inline void POWER_PowerDownFlash(void) { #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* TURN OFF clock ip_2113 (only needed for FLASH programming, will be turned on by ROM API) */ CLOCK_DisableClock(kCLOCK_Flash); /* TURN OFF clock ip_2113 (only needed for FLASH programming, will be turned on by ROM API) */ CLOCK_DisableClock(kCLOCK_Fmc); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ } /*! * @brief API to power up flash controller. * * @param none * @return none */ static inline void POWER_PowerUpFlash(void) { #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* TURN OFF clock ip_2113 (only needed for FLASH programming, will be turned on by ROM API) */ CLOCK_EnableClock(kCLOCK_Fmc); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ } /** * @brief Configures and enters in low power mode * @param p_lowpower_cfg: pointer to a structure that contains all low power mode parameters * @return Nothing * * !!! IMPORTANT NOTES : * 1 - CPU Interrupt Enable registers are updated with p_lowpower_cfg->WAKEUPINT. They are NOT restored by the * API. * 2 - The Non Maskable Interrupt (NMI) should be disable before calling this API (otherwise, there is a risk * of Dead Lock). * 3 - The HARD FAULT handler should execute from SRAM. (The Hard fault handler should initiate a full chip * reset) */ void Power_EnterLowPower(LPC_LOWPOWER_T *p_lowpower_cfg); /** * @brief Shut off the Flash and execute the _WFI(), then power up the Flash after wake-up event * This MUST BE EXECUTED outside the Flash: * either from ROM or from SRAM. The rest could stay in Flash. But, for consistency, it is * preferable to have all functions defined in this file implemented in ROM. * @param None * @return Nothing */ void POWER_CycleCpuAndFlash(void); /** * @brief Configures and enters in DEEP-SLEEP low power mode * @param exclude_from_pd: * @param sram_retention_ctrl: * @param wakeup_interrupts: * @param hardware_wake_ctrl: * @return Nothing * * !!! IMPORTANT NOTES : 0 - CPU0 & System CLock frequency is switched to FRO12MHz and is NOT restored back by the API. * 1 - CPU0 Interrupt Enable registers (NVIC->ISER) are modified by this function. They are restored back in case of CPU retention or if POWERDOWN is not taken (for instance because an interrupt is pending). * 2 - The Non Maskable Interrupt (NMI) is disabled and its configuration before calling this function will be restored back if POWERDOWN is not taken (for instance because an RTC or OSTIMER interrupt is pending). * 3 - The HARD FAULT handler should execute from SRAM. (The Hard fault handler should initiate a full chip reset) reset) */ void POWER_EnterDeepSleepEx(uint32_t exclude_from_pd, uint32_t sram_retention_ctrl, uint64_t wakeup_interrupts,uint32_t hardware_wake_ctrl); /** * @brief Configures and enters in POWERDOWN low power mode * @param exclude_from_pd: * @param sram_retention_ctrl: * @param wakeup_interrupts: * @param cpu_retention_ctrl: 0 = CPU retention is disable / 1 = CPU retention is enabled, all other values are RESERVED. * @return Nothing * * !!! IMPORTANT NOTES : 0 - CPU0 & System CLock frequency is switched to FRO12MHz and is NOT restored back by the API. * 1 - CPU0 Interrupt Enable registers (NVIC->ISER) are modified by this function. They are restored back in case of CPU retention or if POWERDOWN is not taken (for instance because an interrupt is pending). * 2 - The Non Maskable Interrupt (NMI) is disabled and its configuration before calling this function will be restored back if POWERDOWN is not taken (for instance because an RTC or OSTIMER interrupt is pending). * 3 - In case of CPU retention, it is the responsability of the user to make sure that SRAM instance containing the stack used to call this function WILL BE preserved during low power (via parameter "sram_retention_ctrl") * 4 - The HARD FAULT handler should execute from SRAM. (The Hard fault handler should initiate a full chip reset) reset) */ void POWER_EnterPowerDownEx(uint32_t exclude_from_pd, uint32_t sram_retention_ctrl, uint64_t wakeup_interrupts, uint32_t cpu_retention_ctrl); /** * @brief Configures and enters in DEEPPOWERDOWN low power mode * @param exclude_from_pd: * @param sram_retention_ctrl: * @param wakeup_interrupts: * @param wakeup_io_ctrl: * @return Nothing * * !!! IMPORTANT NOTES : 0 - CPU0 & System CLock frequency is switched to FRO12MHz and is NOT restored back by the API. * 1 - CPU0 Interrupt Enable registers (NVIC->ISER) are modified by this function. They are restored back if DEEPPOWERDOWN is not taken (for instance because an RTC or OSTIMER interrupt is pending). * 2 - The Non Maskable Interrupt (NMI) is disabled and its configuration before calling this function will be restored back if DEEPPOWERDOWN is not taken (for instance because an RTC or OSTIMER interrupt is pending). * 3 - The HARD FAULT handler should execute from SRAM. (The Hard fault handler should initiate a full chip reset) */ void POWER_EnterDeepPowerDownEx(uint32_t exclude_from_pd, uint32_t sram_retention_ctrl, uint64_t wakeup_interrupts, uint32_t wakeup_io_ctrl); /** * @brief Configures and enters in SLEEP low power mode * @param : * @return Nothing */ void POWER_EnterSleep(void); /** * @brief PMC Deep Sleep function call * @return nothing */ void POWER_EnterDeepSleep(uint32_t exclude_from_pd); /** * @brief PMC power Down function call * @return nothing */ void POWER_EnterPowerDown(uint32_t exclude_from_pd); /** * @brief PMC Deep Power Down function call * @return nothing */ void POWER_EnterDeepPowerDown(uint32_t exclude_from_pd); /*! * @brief Power Library API to enter different power mode. * * @param exclude_from_pd Bit mask of the PDRUNCFG0(low 32bits) and PDRUNCFG1(high 32bits) that needs to be powered on * during power mode selected. * @return none */ void POWER_EnterPowerMode(power_mode_cfg_t mode, uint32_t exclude_from_pd); /*! * @brief Power Library API to choose normal regulation and set the voltage for the desired operating frequency. * * @param freq - The desired frequency at which the part would like to operate, * note that the voltage and flash wait states should be set before changing frequency * @return none */ void POWER_SetVoltageForFreq(uint32_t freq); /*! * @brief Power Library API to return the library version. * * @param none * @return version number of the power library */ uint32_t POWER_GetLibVersion(void); /** * @} */ #ifdef __cplusplus } #endif #endif /* _FSL_POWER_H_ */