The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.
Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more
mbed 2
This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.
TARGET_EFM32WG_STK3800/TARGET_Silicon_Labs/TARGET_EFM32/emlib/inc/em_emu.h
- Committer:
- <>
- Date:
- 2017-03-30
- Revision:
- 139:856d2700e60b
- Parent:
- 128:9bcdf88f62b0
File content as of revision 139:856d2700e60b:
/***************************************************************************//** * @file em_emu.h * @brief Energy management unit (EMU) peripheral API * @version 5.1.2 ******************************************************************************* * @section License * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b> ******************************************************************************* * * Permission is granted to anyone to use this software for any purpose, * including commercial applications, and to alter it and redistribute it * freely, subject to the following restrictions: * * 1. The origin of this software must not be misrepresented; you must not * claim that you wrote the original software. * 2. Altered source versions must be plainly marked as such, and must not be * misrepresented as being the original software. * 3. This notice may not be removed or altered from any source distribution. * * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no * obligation to support this Software. Silicon Labs is providing the * Software "AS IS", with no express or implied warranties of any kind, * including, but not limited to, any implied warranties of merchantability * or fitness for any particular purpose or warranties against infringement * of any proprietary rights of a third party. * * Silicon Labs will not be liable for any consequential, incidental, or * special damages, or any other relief, or for any claim by any third party, * arising from your use of this Software. * ******************************************************************************/ #ifndef EM_EMU_H #define EM_EMU_H #include "em_device.h" #if defined( EMU_PRESENT ) #include <stdbool.h> #include "em_bus.h" #ifdef __cplusplus extern "C" { #endif /***************************************************************************//** * @addtogroup emlib * @{ ******************************************************************************/ /***************************************************************************//** * @addtogroup EMU * @{ ******************************************************************************/ /******************************************************************************* ******************************** ENUMS ************************************ ******************************************************************************/ #if defined( _EMU_EM4CONF_OSC_MASK ) /** EM4 duty oscillator */ typedef enum { /** Select ULFRCO as duty oscillator in EM4 */ emuEM4Osc_ULFRCO = EMU_EM4CONF_OSC_ULFRCO, /** Select LFXO as duty oscillator in EM4 */ emuEM4Osc_LFXO = EMU_EM4CONF_OSC_LFXO, /** Select LFRCO as duty oscillator in EM4 */ emuEM4Osc_LFRCO = EMU_EM4CONF_OSC_LFRCO } EMU_EM4Osc_TypeDef; #endif #if defined( _EMU_BUCTRL_PROBE_MASK ) /** Backup Power Voltage Probe types */ typedef enum { /** Disable voltage probe */ emuProbe_Disable = EMU_BUCTRL_PROBE_DISABLE, /** Connect probe to VDD_DREG */ emuProbe_VDDDReg = EMU_BUCTRL_PROBE_VDDDREG, /** Connect probe to BU_IN */ emuProbe_BUIN = EMU_BUCTRL_PROBE_BUIN, /** Connect probe to BU_OUT */ emuProbe_BUOUT = EMU_BUCTRL_PROBE_BUOUT } EMU_Probe_TypeDef; #endif #if defined( _EMU_PWRCONF_PWRRES_MASK ) /** Backup Power Domain resistor selection */ typedef enum { /** Main power and backup power connected with RES0 series resistance */ emuRes_Res0 = EMU_PWRCONF_PWRRES_RES0, /** Main power and backup power connected with RES1 series resistance */ emuRes_Res1 = EMU_PWRCONF_PWRRES_RES1, /** Main power and backup power connected with RES2 series resistance */ emuRes_Res2 = EMU_PWRCONF_PWRRES_RES2, /** Main power and backup power connected with RES3 series resistance */ emuRes_Res3 = EMU_PWRCONF_PWRRES_RES3, } EMU_Resistor_TypeDef; #endif #if defined( BU_PRESENT ) /** Backup Power Domain power connection */ typedef enum { /** No connection between main and backup power */ emuPower_None = EMU_BUINACT_PWRCON_NONE, /** Main power and backup power connected through diode, allowing current from backup to main only */ emuPower_BUMain = EMU_BUINACT_PWRCON_BUMAIN, /** Main power and backup power connected through diode, allowing current from main to backup only */ emuPower_MainBU = EMU_BUINACT_PWRCON_MAINBU, /** Main power and backup power connected without diode */ emuPower_NoDiode = EMU_BUINACT_PWRCON_NODIODE, } EMU_Power_TypeDef; #endif /** BOD threshold setting selector, active or inactive mode */ typedef enum { /** Configure BOD threshold for active mode */ emuBODMode_Active, /** Configure BOD threshold for inactive mode */ emuBODMode_Inactive, } EMU_BODMode_TypeDef; #if defined( _EMU_EM4CTRL_EM4STATE_MASK ) /** EM4 modes */ typedef enum { /** EM4 Hibernate */ emuEM4Hibernate = EMU_EM4CTRL_EM4STATE_EM4H, /** EM4 Shutoff */ emuEM4Shutoff = EMU_EM4CTRL_EM4STATE_EM4S, } EMU_EM4State_TypeDef; #endif #if defined( _EMU_EM4CTRL_EM4IORETMODE_MASK ) typedef enum { /** No Retention: Pads enter reset state when entering EM4 */ emuPinRetentionDisable = EMU_EM4CTRL_EM4IORETMODE_DISABLE, /** Retention through EM4: Pads enter reset state when exiting EM4 */ emuPinRetentionEm4Exit = EMU_EM4CTRL_EM4IORETMODE_EM4EXIT, /** Retention through EM4 and wakeup: call EMU_UnlatchPinRetention() to release pins from retention after EM4 wakeup */ emuPinRetentionLatch = EMU_EM4CTRL_EM4IORETMODE_SWUNLATCH, } EMU_EM4PinRetention_TypeDef; #endif /** Power configurations. DCDC-to-DVDD is currently the only supported mode. */ typedef enum { /** DCDC is connected to DVDD */ emuPowerConfig_DcdcToDvdd, } EMU_PowerConfig_TypeDef; #if defined( _EMU_DCDCCTRL_MASK ) /** DCDC operating modes */ typedef enum { /** DCDC regulator bypass */ emuDcdcMode_Bypass = EMU_DCDCCTRL_DCDCMODE_BYPASS, /** DCDC low-noise mode */ emuDcdcMode_LowNoise = EMU_DCDCCTRL_DCDCMODE_LOWNOISE, #if defined(_EMU_DCDCLPEM01CFG_MASK) /** DCDC low-power mode */ emuDcdcMode_LowPower = EMU_DCDCCTRL_DCDCMODE_LOWPOWER, #endif } EMU_DcdcMode_TypeDef; #endif #if defined( _EMU_DCDCCTRL_MASK ) /** DCDC conduction modes */ typedef enum { /** DCDC Low-Noise Continuous Conduction Mode (CCM). EFR32 interference minimization features are available in this mode. */ emuDcdcConductionMode_ContinuousLN, /** DCDC Low-Noise Discontinuous Conduction Mode (DCM). This mode should be used for EFM32 or when the EFR32 radio is not enabled. */ emuDcdcConductionMode_DiscontinuousLN, } EMU_DcdcConductionMode_TypeDef; #endif #if defined( _EMU_PWRCTRL_MASK ) /** DCDC to DVDD mode analog peripheral power supply select */ typedef enum { /** Select AVDD as analog power supply. Typically lower noise, but less energy efficient. */ emuDcdcAnaPeripheralPower_AVDD = EMU_PWRCTRL_ANASW_AVDD, /** Select DCDC (DVDD) as analog power supply. Typically more energy efficient, but more noise. */ emuDcdcAnaPeripheralPower_DCDC = EMU_PWRCTRL_ANASW_DVDD } EMU_DcdcAnaPeripheralPower_TypeDef; #endif #if defined( _EMU_DCDCMISCCTRL_MASK ) /** DCDC Forced CCM and reverse current limiter control. Positive values have unit mA. */ typedef int16_t EMU_DcdcLnReverseCurrentControl_TypeDef; /** High efficiency mode. EMU_DCDCZDETCTRL_ZDETILIMSEL is "don't care". */ #define emuDcdcLnHighEfficiency -1 /** Default reverse current for fast transient response mode (low noise). */ #define emuDcdcLnFastTransient 160 #endif #if defined( _EMU_DCDCCTRL_MASK ) /** DCDC Low-noise RCO band select */ typedef enum { /** Set RCO to 3MHz */ emuDcdcLnRcoBand_3MHz = 0, /** Set RCO to 4MHz */ emuDcdcLnRcoBand_4MHz = 1, /** Set RCO to 5MHz */ emuDcdcLnRcoBand_5MHz = 2, /** Set RCO to 6MHz */ emuDcdcLnRcoBand_6MHz = 3, /** Set RCO to 7MHz */ emuDcdcLnRcoBand_7MHz = 4, /** Set RCO to 8MHz */ emuDcdcLnRcoBand_8MHz = 5, /** Set RCO to 9MHz */ emuDcdcLnRcoBand_9MHz = 6, /** Set RCO to 10MHz */ emuDcdcLnRcoBand_10MHz = 7, } EMU_DcdcLnRcoBand_TypeDef; /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ /* Deprecated. */ #define EMU_DcdcLnRcoBand_3MHz emuDcdcLnRcoBand_3MHz #define EMU_DcdcLnRcoBand_4MHz emuDcdcLnRcoBand_4MHz #define EMU_DcdcLnRcoBand_5MHz emuDcdcLnRcoBand_5MHz #define EMU_DcdcLnRcoBand_6MHz emuDcdcLnRcoBand_6MHz #define EMU_DcdcLnRcoBand_7MHz emuDcdcLnRcoBand_7MHz #define EMU_DcdcLnRcoBand_8MHz emuDcdcLnRcoBand_8MHz #define EMU_DcdcLnRcoBand_9MHz emuDcdcLnRcoBand_9MHz #define EMU_DcdcLnRcoBand_10MHz emuDcdcLnRcoBand_10MHz /** @endcond */ #endif #if defined( _EMU_DCDCCTRL_MASK ) /** DCDC Low Noise Compensator Control register. */ typedef enum { /** DCDC capacitor is 1uF. */ emuDcdcLnCompCtrl_1u0F, /** DCDC capacitor is 4.7uF. */ emuDcdcLnCompCtrl_4u7F, } EMU_DcdcLnCompCtrl_TypeDef; #endif #if defined( EMU_STATUS_VMONRDY ) /** VMON channels */ typedef enum { emuVmonChannel_AVDD, emuVmonChannel_ALTAVDD, emuVmonChannel_DVDD, emuVmonChannel_IOVDD0 } EMU_VmonChannel_TypeDef; #endif /* EMU_STATUS_VMONRDY */ #if defined( _SILICON_LABS_GECKO_INTERNAL_SDID_80 ) /** Bias mode configurations */ typedef enum { emuBiasMode_1KHz, emuBiasMode_4KHz, emuBiasMode_Continuous } EMU_BiasMode_TypeDef; #endif #if defined( _EMU_CMD_EM01VSCALE0_MASK ) /** Supported EM0/1 Voltage Scaling Levels */ typedef enum { /** High-performance voltage level. HF clock can be set to any frequency. */ emuVScaleEM01_HighPerformance = _EMU_STATUS_VSCALE_VSCALE2, /** Low-power optimized voltage level. The HF clock must be limited to @ref CMU_VSCALEEM01_LOWPOWER_VOLTAGE_CLOCK_MAX Hz at this voltage. EM0/1 voltage scaling is applied when the core clock frequency is changed from @ref CMU or when calling @ref EMU_EM01Init() when the HF clock is already below the limit. */ emuVScaleEM01_LowPower = _EMU_STATUS_VSCALE_VSCALE0, } EMU_VScaleEM01_TypeDef; #endif #if defined( _EMU_CTRL_EM23VSCALE_MASK ) /** Supported EM2/3 Voltage Scaling Levels */ typedef enum { /** Fast-wakeup voltage level. */ emuVScaleEM23_FastWakeup = _EMU_CTRL_EM23VSCALE_VSCALE2, /** Low-power optimized voltage level. Using this voltage level in EM2 and 3 adds 20-25us to wakeup time if the EM0 and 1 voltage must be scaled up to @ref emuVScaleEM01_HighPerformance on EM2 or 3 exit. */ emuVScaleEM23_LowPower = _EMU_CTRL_EM23VSCALE_VSCALE0, } EMU_VScaleEM23_TypeDef; #endif #if defined( _EMU_CTRL_EM4HVSCALE_MASK ) /** Supported EM4H Voltage Scaling Levels */ typedef enum { /** Fast-wakeup voltage level. */ emuVScaleEM4H_FastWakeup = _EMU_CTRL_EM4HVSCALE_VSCALE2, /** Low-power optimized voltage level. Using this voltage level in EM4H adds 20-25us to wakeup time if the EM0 and 1 voltage must be scaled up to @ref emuVScaleEM01_HighPerformance on EM4H exit. */ emuVScaleEM4H_LowPower = _EMU_CTRL_EM4HVSCALE_VSCALE0, } EMU_VScaleEM4H_TypeDef; #endif #if defined(_EMU_EM23PERNORETAINCTRL_MASK) /** Peripheral EM2 and 3 retention control */ typedef enum { emuPeripheralRetention_LEUART0 = _EMU_EM23PERNORETAINCTRL_LEUART0DIS_MASK, /* Select LEUART0 retention control */ emuPeripheralRetention_CSEN = _EMU_EM23PERNORETAINCTRL_CSENDIS_MASK, /* Select CSEN retention control */ emuPeripheralRetention_LESENSE0 = _EMU_EM23PERNORETAINCTRL_LESENSE0DIS_MASK, /* Select LESENSE0 retention control */ emuPeripheralRetention_LETIMER0 = _EMU_EM23PERNORETAINCTRL_LETIMER0DIS_MASK, /* Select LETIMER0 retention control */ emuPeripheralRetention_ADC0 = _EMU_EM23PERNORETAINCTRL_ADC0DIS_MASK, /* Select ADC0 retention control */ emuPeripheralRetention_IDAC0 = _EMU_EM23PERNORETAINCTRL_IDAC0DIS_MASK, /* Select IDAC0 retention control */ emuPeripheralRetention_VDAC0 = _EMU_EM23PERNORETAINCTRL_DAC0DIS_MASK, /* Select DAC0 retention control */ emuPeripheralRetention_I2C1 = _EMU_EM23PERNORETAINCTRL_I2C1DIS_MASK, /* Select I2C1 retention control */ emuPeripheralRetention_I2C0 = _EMU_EM23PERNORETAINCTRL_I2C0DIS_MASK, /* Select I2C0 retention control */ emuPeripheralRetention_ACMP1 = _EMU_EM23PERNORETAINCTRL_ACMP1DIS_MASK, /* Select ACMP1 retention control */ emuPeripheralRetention_ACMP0 = _EMU_EM23PERNORETAINCTRL_ACMP0DIS_MASK, /* Select ACMP0 retention control */ #if defined( _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK ) emuPeripheralRetention_PCNT2 = _EMU_EM23PERNORETAINCTRL_PCNT2DIS_MASK, /* Select PCNT2 retention control */ emuPeripheralRetention_PCNT1 = _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK, /* Select PCNT1 retention control */ #endif emuPeripheralRetention_PCNT0 = _EMU_EM23PERNORETAINCTRL_PCNT0DIS_MASK, /* Select PCNT0 retention control */ emuPeripheralRetention_D1 = _EMU_EM23PERNORETAINCTRL_LETIMER0DIS_MASK | _EMU_EM23PERNORETAINCTRL_PCNT0DIS_MASK | _EMU_EM23PERNORETAINCTRL_ADC0DIS_MASK | _EMU_EM23PERNORETAINCTRL_ACMP0DIS_MASK | _EMU_EM23PERNORETAINCTRL_LESENSE0DIS_MASK,/* Select all peripherals in domain 1 */ emuPeripheralRetention_D2 = _EMU_EM23PERNORETAINCTRL_ACMP1DIS_MASK | _EMU_EM23PERNORETAINCTRL_IDAC0DIS_MASK | _EMU_EM23PERNORETAINCTRL_DAC0DIS_MASK | _EMU_EM23PERNORETAINCTRL_CSENDIS_MASK | _EMU_EM23PERNORETAINCTRL_LEUART0DIS_MASK #if defined( _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK ) | _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK | _EMU_EM23PERNORETAINCTRL_PCNT2DIS_MASK #endif | _EMU_EM23PERNORETAINCTRL_I2C0DIS_MASK | _EMU_EM23PERNORETAINCTRL_I2C1DIS_MASK, /* Select all peripherals in domain 2 */ emuPeripheralRetention_ALL = emuPeripheralRetention_D1 | emuPeripheralRetention_D2, /* Select all peripherals with retention control */ } EMU_PeripheralRetention_TypeDef; #endif /******************************************************************************* ******************************* STRUCTS *********************************** ******************************************************************************/ #if defined( _EMU_CMD_EM01VSCALE0_MASK ) /** EM0 and 1 initialization structure. Voltage scaling is applied when the core clock frequency is changed from @ref CMU. EM0 an 1 emuVScaleEM01_HighPerformance is always enabled. */ typedef struct { bool vScaleEM01LowPowerVoltageEnable; /**< EM0/1 low power voltage status */ } EMU_EM01Init_TypeDef; #endif #if defined( _EMU_CMD_EM01VSCALE0_MASK ) /** Default initialization of EM0 and 1 configuration */ #define EMU_EM01INIT_DEFAULT \ { \ false /** Do not scale down in EM0/1 */ \ } #endif /** EM2 and 3 initialization structure */ typedef struct { bool em23VregFullEn; /**< Enable full VREG drive strength in EM2/3 */ #if defined( _EMU_CTRL_EM23VSCALE_MASK ) EMU_VScaleEM23_TypeDef vScaleEM23Voltage; /**< EM2/3 voltage scaling level */ #endif } EMU_EM23Init_TypeDef; /** Default initialization of EM2 and 3 configuration */ #if defined( _EMU_CTRL_EM4HVSCALE_MASK ) #define EMU_EM23INIT_DEFAULT \ { \ false, /* Reduced voltage regulator drive strength in EM2/3 */ \ emuVScaleEM23_FastWakeup, /* Do not scale down in EM2/3 */ \ } #else #define EMU_EM23INIT_DEFAULT \ { \ false, /* Reduced voltage regulator drive strength in EM2/3 */ \ } #endif #if defined( _EMU_EM4CONF_MASK ) || defined( _EMU_EM4CTRL_MASK ) /** EM4 initialization structure */ typedef struct { #if defined( _EMU_EM4CONF_MASK ) /* Init parameters for platforms with EMU->EM4CONF register (Series 0) */ bool lockConfig; /**< Lock configuration of regulator, BOD and oscillator */ bool buBodRstDis; /**< When set, no reset will be asserted due to Brownout when in EM4 */ EMU_EM4Osc_TypeDef osc; /**< EM4 duty oscillator */ bool buRtcWakeup; /**< Wake up on EM4 BURTC interrupt */ bool vreg; /**< Enable EM4 voltage regulator */ #elif defined( _EMU_EM4CTRL_MASK ) /* Init parameters for platforms with EMU->EM4CTRL register (Series 1) */ bool retainLfxo; /**< Disable the LFXO upon EM4 entry */ bool retainLfrco; /**< Disable the LFRCO upon EM4 entry */ bool retainUlfrco; /**< Disable the ULFRCO upon EM4 entry */ EMU_EM4State_TypeDef em4State; /**< Hibernate or shutoff EM4 state */ EMU_EM4PinRetention_TypeDef pinRetentionMode; /**< EM4 pin retention mode */ #endif #if defined( _EMU_CTRL_EM4HVSCALE_MASK ) EMU_VScaleEM4H_TypeDef vScaleEM4HVoltage;/**< EM4H voltage scaling level */ #endif } EMU_EM4Init_TypeDef; #endif #if defined( _EMU_EM4CONF_MASK ) /** Default initialization of EM4 configuration (Series 0) */ #define EMU_EM4INIT_DEFAULT \ { \ false, /* Dont't lock configuration after it's been set */ \ false, /* No reset will be asserted due to BOD in EM4 */ \ emuEM4Osc_ULFRCO, /* Use default ULFRCO oscillator */ \ true, /* Wake up on EM4 BURTC interrupt */ \ true, /* Enable VREG */ \ } #elif defined( _EMU_CTRL_EM4HVSCALE_MASK ) /** Default initialization of EM4 configuration (Series 1 with VSCALE) */ #define EMU_EM4INIT_DEFAULT \ { \ false, /* Retain LFXO configuration upon EM4 entry */ \ false, /* Retain LFRCO configuration upon EM4 entry */ \ false, /* Retain ULFRCO configuration upon EM4 entry */ \ emuEM4Shutoff, /* Use EM4 shutoff state */ \ emuPinRetentionDisable, /* Do not retain pins in EM4 */ \ emuVScaleEM4H_FastWakeup, /* Do not scale down in EM4H */ \ } #elif defined( _EMU_EM4CTRL_MASK ) /** Default initialization of EM4 configuration (Series 1 without VSCALE) */ #define EMU_EM4INIT_DEFAULT \ { \ false, /* Retain LFXO configuration upon EM4 entry */ \ false, /* Retain LFRCO configuration upon EM4 entry */ \ false, /* Retain ULFRCO configuration upon EM4 entry */ \ emuEM4Shutoff, /* Use EM4 shutoff state */ \ emuPinRetentionDisable, /* Do not retain pins in EM4 */ \ } #endif #if defined( BU_PRESENT ) /** Backup Power Domain Initialization structure */ typedef struct { /* Backup Power Domain power configuration */ /** Voltage probe select, selects ADC voltage */ EMU_Probe_TypeDef probe; /** Enable BOD calibration mode */ bool bodCal; /** Enable BU_STAT status pin for active BU mode */ bool statusPinEnable; /* Backup Power Domain connection configuration */ /** Power domain resistor */ EMU_Resistor_TypeDef resistor; /** BU_VOUT strong enable */ bool voutStrong; /** BU_VOUT medium enable */ bool voutMed; /** BU_VOUT weak enable */ bool voutWeak; /** Power connection, when not in Backup Mode */ EMU_Power_TypeDef inactivePower; /** Power connection, when in Backup Mode */ EMU_Power_TypeDef activePower; /** Enable backup power domain, and release reset, enable BU_VIN pin */ bool enable; } EMU_BUPDInit_TypeDef; /** Default Backup Power Domain configuration */ #define EMU_BUPDINIT_DEFAULT \ { \ emuProbe_Disable, /* Do not enable voltage probe */ \ false, /* Disable BOD calibration mode */ \ false, /* Disable BU_STAT pin for backup mode indication */ \ \ emuRes_Res0, /* RES0 series resistance between main and backup power */ \ false, /* Don't enable strong switch */ \ false, /* Don't enable medium switch */ \ false, /* Don't enable weak switch */ \ \ emuPower_None, /* No connection between main and backup power (inactive mode) */ \ emuPower_None, /* No connection between main and backup power (active mode) */ \ true /* Enable BUPD enter on BOD, enable BU_VIN pin, release BU reset */ \ } #endif #if defined( _EMU_DCDCCTRL_MASK ) /** DCDC initialization structure */ typedef struct { EMU_PowerConfig_TypeDef powerConfig; /**< Device external power configuration. @ref emuPowerConfig_DcdcToDvdd is currently the only supported mode. */ EMU_DcdcMode_TypeDef dcdcMode; /**< DCDC regulator operating mode in EM0/1 */ uint16_t mVout; /**< Target output voltage (mV) */ uint16_t em01LoadCurrent_mA; /**< Estimated average load current in EM0/1 (mA). This estimate is also used for EM1 optimization, so if EM1 current is expected to be higher than EM0, then this parameter should hold the higher EM1 current. */ uint16_t em234LoadCurrent_uA; /**< Estimated average load current in EM2 (uA). This estimate is also used for EM3 and 4 optimization, so if EM3 or 4 current is expected to be higher than EM2, then this parameter should hold the higher EM3 or 4 current. */ uint16_t maxCurrent_mA; /**< Maximum average DCDC output current (mA). This can be set to the maximum for the power source, for example the maximum for a battery. */ EMU_DcdcAnaPeripheralPower_TypeDef anaPeripheralPower; /**< Select analog peripheral power in DCDC-to-DVDD mode */ EMU_DcdcLnReverseCurrentControl_TypeDef reverseCurrentControl; /**< Low-noise reverse current control. NOTE: this parameter uses special encoding: >= 0 is forced CCM mode where the parameter is used as the reverse current threshold in mA. -1 is encoded as emuDcdcLnHighEfficiencyMode (EFM32 only) */ EMU_DcdcLnCompCtrl_TypeDef dcdcLnCompCtrl; /**< DCDC Low-noise mode compensator control. */ } EMU_DCDCInit_TypeDef; /** Default DCDC initialization */ #if defined( _EFM_DEVICE ) #if defined(_SILICON_LABS_GECKO_INTERNAL_SDID_80) #define EMU_DCDCINIT_DEFAULT \ { \ emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \ emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \ 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \ 5, /* Nominal EM0/1 load current of less than 5mA */ \ 10, /* Nominal EM2/3/4 load current less than 10uA */ \ 200, /* Maximum average current of 200mA (assume strong battery or other power source) */ \ emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \ emuDcdcLnHighEfficiency, /* Use high-efficiency mode */ \ emuDcdcLnCompCtrl_1u0F, /* 1uF DCDC capacitor */ \ } #else #define EMU_DCDCINIT_DEFAULT \ { \ emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \ emuDcdcMode_LowPower, /* Low-power mode in EM0 */ \ 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \ 5, /* Nominal EM0/1 load current of less than 5mA */ \ 10, /* Nominal EM2/3/4 load current less than 10uA */ \ 200, /* Maximum average current of 200mA (assume strong battery or other power source) */ \ emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \ emuDcdcLnHighEfficiency, /* Use high-efficiency mode */ \ emuDcdcLnCompCtrl_4u7F, /* 4.7uF DCDC capacitor */ \ } #endif #else /* EFR32 device */ #if defined(_SILICON_LABS_GECKO_INTERNAL_SDID_80) #define EMU_DCDCINIT_DEFAULT \ { \ emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \ emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \ 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \ 15, /* Nominal EM0/1 load current of less than 15mA */ \ 10, /* Nominal EM2/3/4 load current less than 10uA */ \ 200, /* Maximum average current of 200mA (assume strong battery or other power source) */ \ emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \ 160, /* Maximum reverse current of 160mA */ \ emuDcdcLnCompCtrl_1u0F, /* 1uF DCDC capacitor */ \ } #else #define EMU_DCDCINIT_DEFAULT \ { \ emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \ emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \ 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \ 15, /* Nominal EM0/1 load current of less than 15mA */ \ 10, /* Nominal EM2/3/4 load current less than 10uA */ \ 200, /* Maximum average current of 200mA (assume strong battery or other power source) */ \ emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \ 160, /* Maximum reverse current of 160mA */ \ emuDcdcLnCompCtrl_4u7F, /* 4.7uF DCDC capacitor */ \ } #endif #endif #endif #if defined( EMU_STATUS_VMONRDY ) /** VMON initialization structure */ typedef struct { EMU_VmonChannel_TypeDef channel; /**< VMON channel to configure */ int threshold; /**< Trigger threshold (mV) */ bool riseWakeup; /**< Wake up from EM4H on rising edge */ bool fallWakeup; /**< Wake up from EM4H on falling edge */ bool enable; /**< Enable VMON channel */ bool retDisable; /**< Disable IO0 retention when voltage drops below threshold (IOVDD only) */ } EMU_VmonInit_TypeDef; /** Default VMON initialization structure */ #define EMU_VMONINIT_DEFAULT \ { \ emuVmonChannel_AVDD, /* AVDD VMON channel */ \ 3200, /* 3.2 V threshold */ \ false, /* Don't wake from EM4H on rising edge */ \ false, /* Don't wake from EM4H on falling edge */ \ true, /* Enable VMON channel */ \ false /* Don't disable IO0 retention */ \ } /** VMON Hysteresis initialization structure */ typedef struct { EMU_VmonChannel_TypeDef channel; /**< VMON channel to configure */ int riseThreshold; /**< Rising threshold (mV) */ int fallThreshold; /**< Falling threshold (mV) */ bool riseWakeup; /**< Wake up from EM4H on rising edge */ bool fallWakeup; /**< Wake up from EM4H on falling edge */ bool enable; /**< Enable VMON channel */ } EMU_VmonHystInit_TypeDef; /** Default VMON Hysteresis initialization structure */ #define EMU_VMONHYSTINIT_DEFAULT \ { \ emuVmonChannel_AVDD, /* AVDD VMON channel */ \ 3200, /* 3.2 V rise threshold */ \ 3200, /* 3.2 V fall threshold */ \ false, /* Don't wake from EM4H on rising edge */ \ false, /* Don't wake from EM4H on falling edge */ \ true /* Enable VMON channel */ \ } #endif /* EMU_STATUS_VMONRDY */ /******************************************************************************* ***************************** PROTOTYPES ********************************** ******************************************************************************/ #if defined( _EMU_CMD_EM01VSCALE0_MASK ) void EMU_EM01Init(const EMU_EM01Init_TypeDef *em01Init); #endif void EMU_EM23Init(const EMU_EM23Init_TypeDef *em23Init); #if defined( _EMU_EM4CONF_MASK ) || defined( _EMU_EM4CTRL_MASK ) void EMU_EM4Init(const EMU_EM4Init_TypeDef *em4Init); #endif void EMU_EnterEM2(bool restore); void EMU_EnterEM3(bool restore); void EMU_Restore(void); void EMU_EnterEM4(void); #if defined( _EMU_EM4CTRL_MASK ) void EMU_EnterEM4H(void); void EMU_EnterEM4S(void); #endif void EMU_MemPwrDown(uint32_t blocks); void EMU_RamPowerDown(uint32_t start, uint32_t end); #if defined(_EMU_EM23PERNORETAINCTRL_MASK) void EMU_PeripheralRetention(EMU_PeripheralRetention_TypeDef periMask, bool enable); #endif void EMU_UpdateOscConfig(void); #if defined( _EMU_CMD_EM01VSCALE0_MASK ) void EMU_VScaleEM01ByClock(uint32_t clockFrequency, bool wait); void EMU_VScaleEM01(EMU_VScaleEM01_TypeDef voltage, bool wait); #endif #if defined( BU_PRESENT ) void EMU_BUPDInit(const EMU_BUPDInit_TypeDef *bupdInit); void EMU_BUThresholdSet(EMU_BODMode_TypeDef mode, uint32_t value); void EMU_BUThresRangeSet(EMU_BODMode_TypeDef mode, uint32_t value); #endif #if defined( _EMU_DCDCCTRL_MASK ) bool EMU_DCDCInit(const EMU_DCDCInit_TypeDef *dcdcInit); void EMU_DCDCModeSet(EMU_DcdcMode_TypeDef dcdcMode); void EMU_DCDCConductionModeSet(EMU_DcdcConductionMode_TypeDef conductionMode, bool rcoDefaultSet); bool EMU_DCDCOutputVoltageSet(uint32_t mV, bool setLpVoltage, bool setLnVoltage); void EMU_DCDCOptimizeSlice(uint32_t mALoadCurrent); void EMU_DCDCLnRcoBandSet(EMU_DcdcLnRcoBand_TypeDef band); bool EMU_DCDCPowerOff(void); #endif #if defined( EMU_STATUS_VMONRDY ) void EMU_VmonInit(const EMU_VmonInit_TypeDef *vmonInit); void EMU_VmonHystInit(const EMU_VmonHystInit_TypeDef *vmonInit); void EMU_VmonEnable(EMU_VmonChannel_TypeDef channel, bool enable); bool EMU_VmonChannelStatusGet(EMU_VmonChannel_TypeDef channel); #endif /***************************************************************************//** * @brief * Enter energy mode 1 (EM1). ******************************************************************************/ __STATIC_INLINE void EMU_EnterEM1(void) { /* Enter sleep mode */ SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk; __WFI(); } #if defined( _EMU_STATUS_VSCALE_MASK ) /***************************************************************************//** * @brief * Wait for voltage scaling to complete ******************************************************************************/ __STATIC_INLINE void EMU_VScaleWait(void) { while (BUS_RegBitRead(&EMU->STATUS, _EMU_STATUS_VSCALEBUSY_SHIFT)); } #endif #if defined( _EMU_STATUS_VSCALE_MASK ) /***************************************************************************//** * @brief * Get current voltage scaling level * * @return * Current voltage scaling level ******************************************************************************/ __STATIC_INLINE EMU_VScaleEM01_TypeDef EMU_VScaleGet(void) { EMU_VScaleWait(); return (EMU_VScaleEM01_TypeDef)((EMU->STATUS & _EMU_STATUS_VSCALE_MASK) >> _EMU_STATUS_VSCALE_SHIFT); } #endif #if defined( _EMU_STATUS_VMONRDY_MASK ) /***************************************************************************//** * @brief * Get the status of the voltage monitor (VMON). * * @return * Status of the VMON. True if all the enabled channels are ready, false if * one or more of the enabled channels are not ready. ******************************************************************************/ __STATIC_INLINE bool EMU_VmonStatusGet(void) { return BUS_RegBitRead(&EMU->STATUS, _EMU_STATUS_VMONRDY_SHIFT); } #endif /* _EMU_STATUS_VMONRDY_MASK */ #if defined( _EMU_IF_MASK ) /***************************************************************************//** * @brief * Clear one or more pending EMU interrupts. * * @param[in] flags * Pending EMU interrupt sources to clear. Use one or more valid * interrupt flags for the EMU module (EMU_IFC_nnn). ******************************************************************************/ __STATIC_INLINE void EMU_IntClear(uint32_t flags) { EMU->IFC = flags; } /***************************************************************************//** * @brief * Disable one or more EMU interrupts. * * @param[in] flags * EMU interrupt sources to disable. Use one or more valid * interrupt flags for the EMU module (EMU_IEN_nnn). ******************************************************************************/ __STATIC_INLINE void EMU_IntDisable(uint32_t flags) { EMU->IEN &= ~flags; } /***************************************************************************//** * @brief * Enable one or more EMU interrupts. * * @note * Depending on the use, a pending interrupt may already be set prior to * enabling the interrupt. Consider using EMU_IntClear() prior to enabling * if such a pending interrupt should be ignored. * * @param[in] flags * EMU interrupt sources to enable. Use one or more valid * interrupt flags for the EMU module (EMU_IEN_nnn). ******************************************************************************/ __STATIC_INLINE void EMU_IntEnable(uint32_t flags) { EMU->IEN |= flags; } /***************************************************************************//** * @brief * Get pending EMU interrupt flags. * * @note * The event bits are not cleared by the use of this function. * * @return * EMU interrupt sources pending. Returns one or more valid * interrupt flags for the EMU module (EMU_IF_nnn). ******************************************************************************/ __STATIC_INLINE uint32_t EMU_IntGet(void) { return EMU->IF; } /***************************************************************************//** * @brief * Get enabled and pending EMU interrupt flags. * Useful for handling more interrupt sources in the same interrupt handler. * * @note * Interrupt flags are not cleared by the use of this function. * * @return * Pending and enabled EMU interrupt sources * The return value is the bitwise AND of * - the enabled interrupt sources in EMU_IEN and * - the pending interrupt flags EMU_IF ******************************************************************************/ __STATIC_INLINE uint32_t EMU_IntGetEnabled(void) { uint32_t ien; ien = EMU->IEN; return EMU->IF & ien; } /***************************************************************************//** * @brief * Set one or more pending EMU interrupts * * @param[in] flags * EMU interrupt sources to set to pending. Use one or more valid * interrupt flags for the EMU module (EMU_IFS_nnn). ******************************************************************************/ __STATIC_INLINE void EMU_IntSet(uint32_t flags) { EMU->IFS = flags; } #endif /* _EMU_IF_MASK */ #if defined( _EMU_EM4CONF_LOCKCONF_MASK ) /***************************************************************************//** * @brief * Enable or disable EM4 lock configuration * @param[in] enable * If true, locks down EM4 configuration ******************************************************************************/ __STATIC_INLINE void EMU_EM4Lock(bool enable) { BUS_RegBitWrite(&(EMU->EM4CONF), _EMU_EM4CONF_LOCKCONF_SHIFT, enable); } #endif #if defined( _EMU_STATUS_BURDY_MASK ) /***************************************************************************//** * @brief * Halts until backup power functionality is ready ******************************************************************************/ __STATIC_INLINE void EMU_BUReady(void) { while(!(EMU->STATUS & EMU_STATUS_BURDY)) ; } #endif #if defined( _EMU_ROUTE_BUVINPEN_MASK ) /***************************************************************************//** * @brief * Disable BU_VIN support * @param[in] enable * If true, enables BU_VIN input pin support, if false disables it ******************************************************************************/ __STATIC_INLINE void EMU_BUPinEnable(bool enable) { BUS_RegBitWrite(&(EMU->ROUTE), _EMU_ROUTE_BUVINPEN_SHIFT, enable); } #endif /***************************************************************************//** * @brief * Lock the EMU in order to protect its registers against unintended * modification. * * @note * If locking the EMU registers, they must be unlocked prior to using any * EMU API functions modifying EMU registers, excluding interrupt control * and regulator control if the architecture has a EMU_PWRCTRL register. * An exception to this is the energy mode entering API (EMU_EnterEMn()), * which can be used when the EMU registers are locked. ******************************************************************************/ __STATIC_INLINE void EMU_Lock(void) { EMU->LOCK = EMU_LOCK_LOCKKEY_LOCK; } /***************************************************************************//** * @brief * Unlock the EMU so that writing to locked registers again is possible. ******************************************************************************/ __STATIC_INLINE void EMU_Unlock(void) { EMU->LOCK = EMU_LOCK_LOCKKEY_UNLOCK; } #if defined( _EMU_PWRLOCK_MASK ) /***************************************************************************//** * @brief * Lock the EMU regulator control registers in order to protect against * unintended modification. ******************************************************************************/ __STATIC_INLINE void EMU_PowerLock(void) { EMU->PWRLOCK = EMU_PWRLOCK_LOCKKEY_LOCK; } /***************************************************************************//** * @brief * Unlock the EMU power control registers so that writing to * locked registers again is possible. ******************************************************************************/ __STATIC_INLINE void EMU_PowerUnlock(void) { EMU->PWRLOCK = EMU_PWRLOCK_LOCKKEY_UNLOCK; } #endif /***************************************************************************//** * @brief * Block entering EM2 or higher number energy modes. ******************************************************************************/ __STATIC_INLINE void EMU_EM2Block(void) { BUS_RegBitWrite(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 1U); } /***************************************************************************//** * @brief * Unblock entering EM2 or higher number energy modes. ******************************************************************************/ __STATIC_INLINE void EMU_EM2UnBlock(void) { BUS_RegBitWrite(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 0U); } #if defined( _EMU_EM4CTRL_EM4IORETMODE_MASK ) /***************************************************************************//** * @brief * When EM4 pin retention is set to emuPinRetentionLatch, then pins are retained * through EM4 entry and wakeup. The pin state is released by calling this function. * The feature allows peripherals or GPIO to be re-initialized after EM4 exit (reset), * and when the initialization is done, this function can release pins and return control * to the peripherals or GPIO. ******************************************************************************/ __STATIC_INLINE void EMU_UnlatchPinRetention(void) { EMU->CMD = EMU_CMD_EM4UNLATCH; } #endif #if defined( _SILICON_LABS_GECKO_INTERNAL_SDID_80 ) void EMU_SetBiasMode(EMU_BiasMode_TypeDef mode); #endif /** @} (end addtogroup EMU) */ /** @} (end addtogroup emlib) */ #ifdef __cplusplus } #endif #endif /* defined( EMU_PRESENT ) */ #endif /* EM_EMU_H */