mbed official / mbed

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@156:ff21514d8981, 2017-11-08 (annotated)

Committer:
AnnaBridge
Date:
Wed Nov 08 17:18:06 2017 +0000
Revision:
156:ff21514d8981
Child:
159:7130f322cb7e
Reverting back to release 154 of the mbed library

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 156:ff21514d8981 1 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 2 * @file em_emu.h
AnnaBridge 156:ff21514d8981 3 * @brief Energy management unit (EMU) peripheral API
AnnaBridge 156:ff21514d8981 4 * @version 5.1.2
AnnaBridge 156:ff21514d8981 5 *******************************************************************************
AnnaBridge 156:ff21514d8981 6 * @section License
AnnaBridge 156:ff21514d8981 7 * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b>
AnnaBridge 156:ff21514d8981 8 *******************************************************************************
AnnaBridge 156:ff21514d8981 9 *
AnnaBridge 156:ff21514d8981 10 * Permission is granted to anyone to use this software for any purpose,
AnnaBridge 156:ff21514d8981 11 * including commercial applications, and to alter it and redistribute it
AnnaBridge 156:ff21514d8981 12 * freely, subject to the following restrictions:
AnnaBridge 156:ff21514d8981 13 *
AnnaBridge 156:ff21514d8981 14 * 1. The origin of this software must not be misrepresented; you must not
AnnaBridge 156:ff21514d8981 15 * claim that you wrote the original software.
AnnaBridge 156:ff21514d8981 16 * 2. Altered source versions must be plainly marked as such, and must not be
AnnaBridge 156:ff21514d8981 17 * misrepresented as being the original software.
AnnaBridge 156:ff21514d8981 18 * 3. This notice may not be removed or altered from any source distribution.
AnnaBridge 156:ff21514d8981 19 *
AnnaBridge 156:ff21514d8981 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
AnnaBridge 156:ff21514d8981 21 * obligation to support this Software. Silicon Labs is providing the
AnnaBridge 156:ff21514d8981 22 * Software "AS IS", with no express or implied warranties of any kind,
AnnaBridge 156:ff21514d8981 23 * including, but not limited to, any implied warranties of merchantability
AnnaBridge 156:ff21514d8981 24 * or fitness for any particular purpose or warranties against infringement
AnnaBridge 156:ff21514d8981 25 * of any proprietary rights of a third party.
AnnaBridge 156:ff21514d8981 26 *
AnnaBridge 156:ff21514d8981 27 * Silicon Labs will not be liable for any consequential, incidental, or
AnnaBridge 156:ff21514d8981 28 * special damages, or any other relief, or for any claim by any third party,
AnnaBridge 156:ff21514d8981 29 * arising from your use of this Software.
AnnaBridge 156:ff21514d8981 30 *
AnnaBridge 156:ff21514d8981 31 ******************************************************************************/
AnnaBridge 156:ff21514d8981 32
AnnaBridge 156:ff21514d8981 33 #ifndef EM_EMU_H
AnnaBridge 156:ff21514d8981 34 #define EM_EMU_H
AnnaBridge 156:ff21514d8981 35
AnnaBridge 156:ff21514d8981 36 #include "em_device.h"
AnnaBridge 156:ff21514d8981 37 #if defined( EMU_PRESENT )
AnnaBridge 156:ff21514d8981 38
AnnaBridge 156:ff21514d8981 39 #include <stdbool.h>
AnnaBridge 156:ff21514d8981 40 #include "em_bus.h"
AnnaBridge 156:ff21514d8981 41
AnnaBridge 156:ff21514d8981 42 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 43 extern "C" {
AnnaBridge 156:ff21514d8981 44 #endif
AnnaBridge 156:ff21514d8981 45
AnnaBridge 156:ff21514d8981 46 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 47 * @addtogroup emlib
AnnaBridge 156:ff21514d8981 48 * @{
AnnaBridge 156:ff21514d8981 49 ******************************************************************************/
AnnaBridge 156:ff21514d8981 50
AnnaBridge 156:ff21514d8981 51 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 52 * @addtogroup EMU
AnnaBridge 156:ff21514d8981 53 * @{
AnnaBridge 156:ff21514d8981 54 ******************************************************************************/
AnnaBridge 156:ff21514d8981 55
AnnaBridge 156:ff21514d8981 56 /*******************************************************************************
AnnaBridge 156:ff21514d8981 57 ******************************** ENUMS ************************************
AnnaBridge 156:ff21514d8981 58 ******************************************************************************/
AnnaBridge 156:ff21514d8981 59
AnnaBridge 156:ff21514d8981 60 #if defined( _EMU_EM4CONF_OSC_MASK )
AnnaBridge 156:ff21514d8981 61 /** EM4 duty oscillator */
AnnaBridge 156:ff21514d8981 62 typedef enum
AnnaBridge 156:ff21514d8981 63 {
AnnaBridge 156:ff21514d8981 64 /** Select ULFRCO as duty oscillator in EM4 */
AnnaBridge 156:ff21514d8981 65 emuEM4Osc_ULFRCO = EMU_EM4CONF_OSC_ULFRCO,
AnnaBridge 156:ff21514d8981 66 /** Select LFXO as duty oscillator in EM4 */
AnnaBridge 156:ff21514d8981 67 emuEM4Osc_LFXO = EMU_EM4CONF_OSC_LFXO,
AnnaBridge 156:ff21514d8981 68 /** Select LFRCO as duty oscillator in EM4 */
AnnaBridge 156:ff21514d8981 69 emuEM4Osc_LFRCO = EMU_EM4CONF_OSC_LFRCO
AnnaBridge 156:ff21514d8981 70 } EMU_EM4Osc_TypeDef;
AnnaBridge 156:ff21514d8981 71 #endif
AnnaBridge 156:ff21514d8981 72
AnnaBridge 156:ff21514d8981 73 #if defined( _EMU_BUCTRL_PROBE_MASK )
AnnaBridge 156:ff21514d8981 74 /** Backup Power Voltage Probe types */
AnnaBridge 156:ff21514d8981 75 typedef enum
AnnaBridge 156:ff21514d8981 76 {
AnnaBridge 156:ff21514d8981 77 /** Disable voltage probe */
AnnaBridge 156:ff21514d8981 78 emuProbe_Disable = EMU_BUCTRL_PROBE_DISABLE,
AnnaBridge 156:ff21514d8981 79 /** Connect probe to VDD_DREG */
AnnaBridge 156:ff21514d8981 80 emuProbe_VDDDReg = EMU_BUCTRL_PROBE_VDDDREG,
AnnaBridge 156:ff21514d8981 81 /** Connect probe to BU_IN */
AnnaBridge 156:ff21514d8981 82 emuProbe_BUIN = EMU_BUCTRL_PROBE_BUIN,
AnnaBridge 156:ff21514d8981 83 /** Connect probe to BU_OUT */
AnnaBridge 156:ff21514d8981 84 emuProbe_BUOUT = EMU_BUCTRL_PROBE_BUOUT
AnnaBridge 156:ff21514d8981 85 } EMU_Probe_TypeDef;
AnnaBridge 156:ff21514d8981 86 #endif
AnnaBridge 156:ff21514d8981 87
AnnaBridge 156:ff21514d8981 88 #if defined( _EMU_PWRCONF_PWRRES_MASK )
AnnaBridge 156:ff21514d8981 89 /** Backup Power Domain resistor selection */
AnnaBridge 156:ff21514d8981 90 typedef enum
AnnaBridge 156:ff21514d8981 91 {
AnnaBridge 156:ff21514d8981 92 /** Main power and backup power connected with RES0 series resistance */
AnnaBridge 156:ff21514d8981 93 emuRes_Res0 = EMU_PWRCONF_PWRRES_RES0,
AnnaBridge 156:ff21514d8981 94 /** Main power and backup power connected with RES1 series resistance */
AnnaBridge 156:ff21514d8981 95 emuRes_Res1 = EMU_PWRCONF_PWRRES_RES1,
AnnaBridge 156:ff21514d8981 96 /** Main power and backup power connected with RES2 series resistance */
AnnaBridge 156:ff21514d8981 97 emuRes_Res2 = EMU_PWRCONF_PWRRES_RES2,
AnnaBridge 156:ff21514d8981 98 /** Main power and backup power connected with RES3 series resistance */
AnnaBridge 156:ff21514d8981 99 emuRes_Res3 = EMU_PWRCONF_PWRRES_RES3,
AnnaBridge 156:ff21514d8981 100 } EMU_Resistor_TypeDef;
AnnaBridge 156:ff21514d8981 101 #endif
AnnaBridge 156:ff21514d8981 102
AnnaBridge 156:ff21514d8981 103 #if defined( BU_PRESENT )
AnnaBridge 156:ff21514d8981 104 /** Backup Power Domain power connection */
AnnaBridge 156:ff21514d8981 105 typedef enum
AnnaBridge 156:ff21514d8981 106 {
AnnaBridge 156:ff21514d8981 107 /** No connection between main and backup power */
AnnaBridge 156:ff21514d8981 108 emuPower_None = EMU_BUINACT_PWRCON_NONE,
AnnaBridge 156:ff21514d8981 109 /** Main power and backup power connected through diode,
AnnaBridge 156:ff21514d8981 110 allowing current from backup to main only */
AnnaBridge 156:ff21514d8981 111 emuPower_BUMain = EMU_BUINACT_PWRCON_BUMAIN,
AnnaBridge 156:ff21514d8981 112 /** Main power and backup power connected through diode,
AnnaBridge 156:ff21514d8981 113 allowing current from main to backup only */
AnnaBridge 156:ff21514d8981 114 emuPower_MainBU = EMU_BUINACT_PWRCON_MAINBU,
AnnaBridge 156:ff21514d8981 115 /** Main power and backup power connected without diode */
AnnaBridge 156:ff21514d8981 116 emuPower_NoDiode = EMU_BUINACT_PWRCON_NODIODE,
AnnaBridge 156:ff21514d8981 117 } EMU_Power_TypeDef;
AnnaBridge 156:ff21514d8981 118 #endif
AnnaBridge 156:ff21514d8981 119
AnnaBridge 156:ff21514d8981 120 /** BOD threshold setting selector, active or inactive mode */
AnnaBridge 156:ff21514d8981 121 typedef enum
AnnaBridge 156:ff21514d8981 122 {
AnnaBridge 156:ff21514d8981 123 /** Configure BOD threshold for active mode */
AnnaBridge 156:ff21514d8981 124 emuBODMode_Active,
AnnaBridge 156:ff21514d8981 125 /** Configure BOD threshold for inactive mode */
AnnaBridge 156:ff21514d8981 126 emuBODMode_Inactive,
AnnaBridge 156:ff21514d8981 127 } EMU_BODMode_TypeDef;
AnnaBridge 156:ff21514d8981 128
AnnaBridge 156:ff21514d8981 129 #if defined( _EMU_EM4CTRL_EM4STATE_MASK )
AnnaBridge 156:ff21514d8981 130 /** EM4 modes */
AnnaBridge 156:ff21514d8981 131 typedef enum
AnnaBridge 156:ff21514d8981 132 {
AnnaBridge 156:ff21514d8981 133 /** EM4 Hibernate */
AnnaBridge 156:ff21514d8981 134 emuEM4Hibernate = EMU_EM4CTRL_EM4STATE_EM4H,
AnnaBridge 156:ff21514d8981 135 /** EM4 Shutoff */
AnnaBridge 156:ff21514d8981 136 emuEM4Shutoff = EMU_EM4CTRL_EM4STATE_EM4S,
AnnaBridge 156:ff21514d8981 137 } EMU_EM4State_TypeDef;
AnnaBridge 156:ff21514d8981 138 #endif
AnnaBridge 156:ff21514d8981 139
AnnaBridge 156:ff21514d8981 140
AnnaBridge 156:ff21514d8981 141 #if defined( _EMU_EM4CTRL_EM4IORETMODE_MASK )
AnnaBridge 156:ff21514d8981 142 typedef enum
AnnaBridge 156:ff21514d8981 143 {
AnnaBridge 156:ff21514d8981 144 /** No Retention: Pads enter reset state when entering EM4 */
AnnaBridge 156:ff21514d8981 145 emuPinRetentionDisable = EMU_EM4CTRL_EM4IORETMODE_DISABLE,
AnnaBridge 156:ff21514d8981 146 /** Retention through EM4: Pads enter reset state when exiting EM4 */
AnnaBridge 156:ff21514d8981 147 emuPinRetentionEm4Exit = EMU_EM4CTRL_EM4IORETMODE_EM4EXIT,
AnnaBridge 156:ff21514d8981 148 /** Retention through EM4 and wakeup: call EMU_UnlatchPinRetention() to
AnnaBridge 156:ff21514d8981 149 release pins from retention after EM4 wakeup */
AnnaBridge 156:ff21514d8981 150 emuPinRetentionLatch = EMU_EM4CTRL_EM4IORETMODE_SWUNLATCH,
AnnaBridge 156:ff21514d8981 151 } EMU_EM4PinRetention_TypeDef;
AnnaBridge 156:ff21514d8981 152 #endif
AnnaBridge 156:ff21514d8981 153
AnnaBridge 156:ff21514d8981 154 /** Power configurations. DCDC-to-DVDD is currently the only supported mode. */
AnnaBridge 156:ff21514d8981 155 typedef enum
AnnaBridge 156:ff21514d8981 156 {
AnnaBridge 156:ff21514d8981 157 /** DCDC is connected to DVDD */
AnnaBridge 156:ff21514d8981 158 emuPowerConfig_DcdcToDvdd,
AnnaBridge 156:ff21514d8981 159 } EMU_PowerConfig_TypeDef;
AnnaBridge 156:ff21514d8981 160
AnnaBridge 156:ff21514d8981 161
AnnaBridge 156:ff21514d8981 162 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 163 /** DCDC operating modes */
AnnaBridge 156:ff21514d8981 164 typedef enum
AnnaBridge 156:ff21514d8981 165 {
AnnaBridge 156:ff21514d8981 166 /** DCDC regulator bypass */
AnnaBridge 156:ff21514d8981 167 emuDcdcMode_Bypass = EMU_DCDCCTRL_DCDCMODE_BYPASS,
AnnaBridge 156:ff21514d8981 168 /** DCDC low-noise mode */
AnnaBridge 156:ff21514d8981 169 emuDcdcMode_LowNoise = EMU_DCDCCTRL_DCDCMODE_LOWNOISE,
AnnaBridge 156:ff21514d8981 170 #if defined(_EMU_DCDCLPEM01CFG_MASK)
AnnaBridge 156:ff21514d8981 171 /** DCDC low-power mode */
AnnaBridge 156:ff21514d8981 172 emuDcdcMode_LowPower = EMU_DCDCCTRL_DCDCMODE_LOWPOWER,
AnnaBridge 156:ff21514d8981 173 #endif
AnnaBridge 156:ff21514d8981 174 } EMU_DcdcMode_TypeDef;
AnnaBridge 156:ff21514d8981 175 #endif
AnnaBridge 156:ff21514d8981 176
AnnaBridge 156:ff21514d8981 177 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 178 /** DCDC conduction modes */
AnnaBridge 156:ff21514d8981 179 typedef enum
AnnaBridge 156:ff21514d8981 180 {
AnnaBridge 156:ff21514d8981 181 /** DCDC Low-Noise Continuous Conduction Mode (CCM). EFR32 interference minimization
AnnaBridge 156:ff21514d8981 182 features are available in this mode. */
AnnaBridge 156:ff21514d8981 183 emuDcdcConductionMode_ContinuousLN,
AnnaBridge 156:ff21514d8981 184 /** DCDC Low-Noise Discontinuous Conduction Mode (DCM). This mode should be used for EFM32 or
AnnaBridge 156:ff21514d8981 185 when the EFR32 radio is not enabled. */
AnnaBridge 156:ff21514d8981 186 emuDcdcConductionMode_DiscontinuousLN,
AnnaBridge 156:ff21514d8981 187 } EMU_DcdcConductionMode_TypeDef;
AnnaBridge 156:ff21514d8981 188 #endif
AnnaBridge 156:ff21514d8981 189
AnnaBridge 156:ff21514d8981 190 #if defined( _EMU_PWRCTRL_MASK )
AnnaBridge 156:ff21514d8981 191 /** DCDC to DVDD mode analog peripheral power supply select */
AnnaBridge 156:ff21514d8981 192 typedef enum
AnnaBridge 156:ff21514d8981 193 {
AnnaBridge 156:ff21514d8981 194 /** Select AVDD as analog power supply. Typically lower noise, but less energy efficient. */
AnnaBridge 156:ff21514d8981 195 emuDcdcAnaPeripheralPower_AVDD = EMU_PWRCTRL_ANASW_AVDD,
AnnaBridge 156:ff21514d8981 196 /** Select DCDC (DVDD) as analog power supply. Typically more energy efficient, but more noise. */
AnnaBridge 156:ff21514d8981 197 emuDcdcAnaPeripheralPower_DCDC = EMU_PWRCTRL_ANASW_DVDD
AnnaBridge 156:ff21514d8981 198 } EMU_DcdcAnaPeripheralPower_TypeDef;
AnnaBridge 156:ff21514d8981 199 #endif
AnnaBridge 156:ff21514d8981 200
AnnaBridge 156:ff21514d8981 201 #if defined( _EMU_DCDCMISCCTRL_MASK )
AnnaBridge 156:ff21514d8981 202 /** DCDC Forced CCM and reverse current limiter control. Positive values have unit mA. */
AnnaBridge 156:ff21514d8981 203 typedef int16_t EMU_DcdcLnReverseCurrentControl_TypeDef;
AnnaBridge 156:ff21514d8981 204
AnnaBridge 156:ff21514d8981 205 /** High efficiency mode. EMU_DCDCZDETCTRL_ZDETILIMSEL is "don't care". */
AnnaBridge 156:ff21514d8981 206 #define emuDcdcLnHighEfficiency -1
AnnaBridge 156:ff21514d8981 207
AnnaBridge 156:ff21514d8981 208 /** Default reverse current for fast transient response mode (low noise). */
AnnaBridge 156:ff21514d8981 209 #define emuDcdcLnFastTransient 160
AnnaBridge 156:ff21514d8981 210 #endif
AnnaBridge 156:ff21514d8981 211
AnnaBridge 156:ff21514d8981 212
AnnaBridge 156:ff21514d8981 213 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 214 /** DCDC Low-noise RCO band select */
AnnaBridge 156:ff21514d8981 215 typedef enum
AnnaBridge 156:ff21514d8981 216 {
AnnaBridge 156:ff21514d8981 217 /** Set RCO to 3MHz */
AnnaBridge 156:ff21514d8981 218 emuDcdcLnRcoBand_3MHz = 0,
AnnaBridge 156:ff21514d8981 219 /** Set RCO to 4MHz */
AnnaBridge 156:ff21514d8981 220 emuDcdcLnRcoBand_4MHz = 1,
AnnaBridge 156:ff21514d8981 221 /** Set RCO to 5MHz */
AnnaBridge 156:ff21514d8981 222 emuDcdcLnRcoBand_5MHz = 2,
AnnaBridge 156:ff21514d8981 223 /** Set RCO to 6MHz */
AnnaBridge 156:ff21514d8981 224 emuDcdcLnRcoBand_6MHz = 3,
AnnaBridge 156:ff21514d8981 225 /** Set RCO to 7MHz */
AnnaBridge 156:ff21514d8981 226 emuDcdcLnRcoBand_7MHz = 4,
AnnaBridge 156:ff21514d8981 227 /** Set RCO to 8MHz */
AnnaBridge 156:ff21514d8981 228 emuDcdcLnRcoBand_8MHz = 5,
AnnaBridge 156:ff21514d8981 229 /** Set RCO to 9MHz */
AnnaBridge 156:ff21514d8981 230 emuDcdcLnRcoBand_9MHz = 6,
AnnaBridge 156:ff21514d8981 231 /** Set RCO to 10MHz */
AnnaBridge 156:ff21514d8981 232 emuDcdcLnRcoBand_10MHz = 7,
AnnaBridge 156:ff21514d8981 233 } EMU_DcdcLnRcoBand_TypeDef;
AnnaBridge 156:ff21514d8981 234
AnnaBridge 156:ff21514d8981 235 /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
AnnaBridge 156:ff21514d8981 236 /* Deprecated. */
AnnaBridge 156:ff21514d8981 237 #define EMU_DcdcLnRcoBand_3MHz emuDcdcLnRcoBand_3MHz
AnnaBridge 156:ff21514d8981 238 #define EMU_DcdcLnRcoBand_4MHz emuDcdcLnRcoBand_4MHz
AnnaBridge 156:ff21514d8981 239 #define EMU_DcdcLnRcoBand_5MHz emuDcdcLnRcoBand_5MHz
AnnaBridge 156:ff21514d8981 240 #define EMU_DcdcLnRcoBand_6MHz emuDcdcLnRcoBand_6MHz
AnnaBridge 156:ff21514d8981 241 #define EMU_DcdcLnRcoBand_7MHz emuDcdcLnRcoBand_7MHz
AnnaBridge 156:ff21514d8981 242 #define EMU_DcdcLnRcoBand_8MHz emuDcdcLnRcoBand_8MHz
AnnaBridge 156:ff21514d8981 243 #define EMU_DcdcLnRcoBand_9MHz emuDcdcLnRcoBand_9MHz
AnnaBridge 156:ff21514d8981 244 #define EMU_DcdcLnRcoBand_10MHz emuDcdcLnRcoBand_10MHz
AnnaBridge 156:ff21514d8981 245 /** @endcond */
AnnaBridge 156:ff21514d8981 246 #endif
AnnaBridge 156:ff21514d8981 247
AnnaBridge 156:ff21514d8981 248
AnnaBridge 156:ff21514d8981 249 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 250 /** DCDC Low Noise Compensator Control register. */
AnnaBridge 156:ff21514d8981 251 typedef enum
AnnaBridge 156:ff21514d8981 252 {
AnnaBridge 156:ff21514d8981 253 /** DCDC capacitor is 1uF. */
AnnaBridge 156:ff21514d8981 254 emuDcdcLnCompCtrl_1u0F,
AnnaBridge 156:ff21514d8981 255 /** DCDC capacitor is 4.7uF. */
AnnaBridge 156:ff21514d8981 256 emuDcdcLnCompCtrl_4u7F,
AnnaBridge 156:ff21514d8981 257 } EMU_DcdcLnCompCtrl_TypeDef;
AnnaBridge 156:ff21514d8981 258 #endif
AnnaBridge 156:ff21514d8981 259
AnnaBridge 156:ff21514d8981 260
AnnaBridge 156:ff21514d8981 261 #if defined( EMU_STATUS_VMONRDY )
AnnaBridge 156:ff21514d8981 262 /** VMON channels */
AnnaBridge 156:ff21514d8981 263 typedef enum
AnnaBridge 156:ff21514d8981 264 {
AnnaBridge 156:ff21514d8981 265 emuVmonChannel_AVDD,
AnnaBridge 156:ff21514d8981 266 emuVmonChannel_ALTAVDD,
AnnaBridge 156:ff21514d8981 267 emuVmonChannel_DVDD,
AnnaBridge 156:ff21514d8981 268 emuVmonChannel_IOVDD0
AnnaBridge 156:ff21514d8981 269 } EMU_VmonChannel_TypeDef;
AnnaBridge 156:ff21514d8981 270 #endif /* EMU_STATUS_VMONRDY */
AnnaBridge 156:ff21514d8981 271
AnnaBridge 156:ff21514d8981 272 #if defined( _SILICON_LABS_GECKO_INTERNAL_SDID_80 )
AnnaBridge 156:ff21514d8981 273 /** Bias mode configurations */
AnnaBridge 156:ff21514d8981 274 typedef enum
AnnaBridge 156:ff21514d8981 275 {
AnnaBridge 156:ff21514d8981 276 emuBiasMode_1KHz,
AnnaBridge 156:ff21514d8981 277 emuBiasMode_4KHz,
AnnaBridge 156:ff21514d8981 278 emuBiasMode_Continuous
AnnaBridge 156:ff21514d8981 279 } EMU_BiasMode_TypeDef;
AnnaBridge 156:ff21514d8981 280 #endif
AnnaBridge 156:ff21514d8981 281
AnnaBridge 156:ff21514d8981 282 #if defined( _EMU_CMD_EM01VSCALE0_MASK )
AnnaBridge 156:ff21514d8981 283 /** Supported EM0/1 Voltage Scaling Levels */
AnnaBridge 156:ff21514d8981 284 typedef enum
AnnaBridge 156:ff21514d8981 285 {
AnnaBridge 156:ff21514d8981 286 /** High-performance voltage level. HF clock can be set to any frequency. */
AnnaBridge 156:ff21514d8981 287 emuVScaleEM01_HighPerformance = _EMU_STATUS_VSCALE_VSCALE2,
AnnaBridge 156:ff21514d8981 288 /** Low-power optimized voltage level. The HF clock must be limited
AnnaBridge 156:ff21514d8981 289 to @ref CMU_VSCALEEM01_LOWPOWER_VOLTAGE_CLOCK_MAX Hz at this voltage.
AnnaBridge 156:ff21514d8981 290 EM0/1 voltage scaling is applied when the core clock frequency is
AnnaBridge 156:ff21514d8981 291 changed from @ref CMU or when calling @ref EMU_EM01Init() when the HF
AnnaBridge 156:ff21514d8981 292 clock is already below the limit. */
AnnaBridge 156:ff21514d8981 293 emuVScaleEM01_LowPower = _EMU_STATUS_VSCALE_VSCALE0,
AnnaBridge 156:ff21514d8981 294 } EMU_VScaleEM01_TypeDef;
AnnaBridge 156:ff21514d8981 295 #endif
AnnaBridge 156:ff21514d8981 296
AnnaBridge 156:ff21514d8981 297 #if defined( _EMU_CTRL_EM23VSCALE_MASK )
AnnaBridge 156:ff21514d8981 298 /** Supported EM2/3 Voltage Scaling Levels */
AnnaBridge 156:ff21514d8981 299 typedef enum
AnnaBridge 156:ff21514d8981 300 {
AnnaBridge 156:ff21514d8981 301 /** Fast-wakeup voltage level. */
AnnaBridge 156:ff21514d8981 302 emuVScaleEM23_FastWakeup = _EMU_CTRL_EM23VSCALE_VSCALE2,
AnnaBridge 156:ff21514d8981 303 /** Low-power optimized voltage level. Using this voltage level in EM2 and 3
AnnaBridge 156:ff21514d8981 304 adds 20-25us to wakeup time if the EM0 and 1 voltage must be scaled
AnnaBridge 156:ff21514d8981 305 up to @ref emuVScaleEM01_HighPerformance on EM2 or 3 exit. */
AnnaBridge 156:ff21514d8981 306 emuVScaleEM23_LowPower = _EMU_CTRL_EM23VSCALE_VSCALE0,
AnnaBridge 156:ff21514d8981 307 } EMU_VScaleEM23_TypeDef;
AnnaBridge 156:ff21514d8981 308 #endif
AnnaBridge 156:ff21514d8981 309
AnnaBridge 156:ff21514d8981 310 #if defined( _EMU_CTRL_EM4HVSCALE_MASK )
AnnaBridge 156:ff21514d8981 311 /** Supported EM4H Voltage Scaling Levels */
AnnaBridge 156:ff21514d8981 312 typedef enum
AnnaBridge 156:ff21514d8981 313 {
AnnaBridge 156:ff21514d8981 314 /** Fast-wakeup voltage level. */
AnnaBridge 156:ff21514d8981 315 emuVScaleEM4H_FastWakeup = _EMU_CTRL_EM4HVSCALE_VSCALE2,
AnnaBridge 156:ff21514d8981 316 /** Low-power optimized voltage level. Using this voltage level in EM4H
AnnaBridge 156:ff21514d8981 317 adds 20-25us to wakeup time if the EM0 and 1 voltage must be scaled
AnnaBridge 156:ff21514d8981 318 up to @ref emuVScaleEM01_HighPerformance on EM4H exit. */
AnnaBridge 156:ff21514d8981 319 emuVScaleEM4H_LowPower = _EMU_CTRL_EM4HVSCALE_VSCALE0,
AnnaBridge 156:ff21514d8981 320 } EMU_VScaleEM4H_TypeDef;
AnnaBridge 156:ff21514d8981 321 #endif
AnnaBridge 156:ff21514d8981 322
AnnaBridge 156:ff21514d8981 323 #if defined(_EMU_EM23PERNORETAINCTRL_MASK)
AnnaBridge 156:ff21514d8981 324 /** Peripheral EM2 and 3 retention control */
AnnaBridge 156:ff21514d8981 325 typedef enum
AnnaBridge 156:ff21514d8981 326 {
AnnaBridge 156:ff21514d8981 327 emuPeripheralRetention_LEUART0 = _EMU_EM23PERNORETAINCTRL_LEUART0DIS_MASK, /* Select LEUART0 retention control */
AnnaBridge 156:ff21514d8981 328 emuPeripheralRetention_CSEN = _EMU_EM23PERNORETAINCTRL_CSENDIS_MASK, /* Select CSEN retention control */
AnnaBridge 156:ff21514d8981 329 emuPeripheralRetention_LESENSE0 = _EMU_EM23PERNORETAINCTRL_LESENSE0DIS_MASK, /* Select LESENSE0 retention control */
AnnaBridge 156:ff21514d8981 330 emuPeripheralRetention_LETIMER0 = _EMU_EM23PERNORETAINCTRL_LETIMER0DIS_MASK, /* Select LETIMER0 retention control */
AnnaBridge 156:ff21514d8981 331 emuPeripheralRetention_ADC0 = _EMU_EM23PERNORETAINCTRL_ADC0DIS_MASK, /* Select ADC0 retention control */
AnnaBridge 156:ff21514d8981 332 emuPeripheralRetention_IDAC0 = _EMU_EM23PERNORETAINCTRL_IDAC0DIS_MASK, /* Select IDAC0 retention control */
AnnaBridge 156:ff21514d8981 333 emuPeripheralRetention_VDAC0 = _EMU_EM23PERNORETAINCTRL_DAC0DIS_MASK, /* Select DAC0 retention control */
AnnaBridge 156:ff21514d8981 334 emuPeripheralRetention_I2C1 = _EMU_EM23PERNORETAINCTRL_I2C1DIS_MASK, /* Select I2C1 retention control */
AnnaBridge 156:ff21514d8981 335 emuPeripheralRetention_I2C0 = _EMU_EM23PERNORETAINCTRL_I2C0DIS_MASK, /* Select I2C0 retention control */
AnnaBridge 156:ff21514d8981 336 emuPeripheralRetention_ACMP1 = _EMU_EM23PERNORETAINCTRL_ACMP1DIS_MASK, /* Select ACMP1 retention control */
AnnaBridge 156:ff21514d8981 337 emuPeripheralRetention_ACMP0 = _EMU_EM23PERNORETAINCTRL_ACMP0DIS_MASK, /* Select ACMP0 retention control */
AnnaBridge 156:ff21514d8981 338 #if defined( _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK )
AnnaBridge 156:ff21514d8981 339 emuPeripheralRetention_PCNT2 = _EMU_EM23PERNORETAINCTRL_PCNT2DIS_MASK, /* Select PCNT2 retention control */
AnnaBridge 156:ff21514d8981 340 emuPeripheralRetention_PCNT1 = _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK, /* Select PCNT1 retention control */
AnnaBridge 156:ff21514d8981 341 #endif
AnnaBridge 156:ff21514d8981 342 emuPeripheralRetention_PCNT0 = _EMU_EM23PERNORETAINCTRL_PCNT0DIS_MASK, /* Select PCNT0 retention control */
AnnaBridge 156:ff21514d8981 343
AnnaBridge 156:ff21514d8981 344 emuPeripheralRetention_D1 = _EMU_EM23PERNORETAINCTRL_LETIMER0DIS_MASK
AnnaBridge 156:ff21514d8981 345 | _EMU_EM23PERNORETAINCTRL_PCNT0DIS_MASK
AnnaBridge 156:ff21514d8981 346 | _EMU_EM23PERNORETAINCTRL_ADC0DIS_MASK
AnnaBridge 156:ff21514d8981 347 | _EMU_EM23PERNORETAINCTRL_ACMP0DIS_MASK
AnnaBridge 156:ff21514d8981 348 | _EMU_EM23PERNORETAINCTRL_LESENSE0DIS_MASK,/* Select all peripherals in domain 1 */
AnnaBridge 156:ff21514d8981 349 emuPeripheralRetention_D2 = _EMU_EM23PERNORETAINCTRL_ACMP1DIS_MASK
AnnaBridge 156:ff21514d8981 350 | _EMU_EM23PERNORETAINCTRL_IDAC0DIS_MASK
AnnaBridge 156:ff21514d8981 351 | _EMU_EM23PERNORETAINCTRL_DAC0DIS_MASK
AnnaBridge 156:ff21514d8981 352 | _EMU_EM23PERNORETAINCTRL_CSENDIS_MASK
AnnaBridge 156:ff21514d8981 353 | _EMU_EM23PERNORETAINCTRL_LEUART0DIS_MASK
AnnaBridge 156:ff21514d8981 354 #if defined( _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK )
AnnaBridge 156:ff21514d8981 355 | _EMU_EM23PERNORETAINCTRL_PCNT1DIS_MASK
AnnaBridge 156:ff21514d8981 356 | _EMU_EM23PERNORETAINCTRL_PCNT2DIS_MASK
AnnaBridge 156:ff21514d8981 357 #endif
AnnaBridge 156:ff21514d8981 358 | _EMU_EM23PERNORETAINCTRL_I2C0DIS_MASK
AnnaBridge 156:ff21514d8981 359 | _EMU_EM23PERNORETAINCTRL_I2C1DIS_MASK, /* Select all peripherals in domain 2 */
AnnaBridge 156:ff21514d8981 360 emuPeripheralRetention_ALL = emuPeripheralRetention_D1
AnnaBridge 156:ff21514d8981 361 | emuPeripheralRetention_D2, /* Select all peripherals with retention control */
AnnaBridge 156:ff21514d8981 362 } EMU_PeripheralRetention_TypeDef;
AnnaBridge 156:ff21514d8981 363 #endif
AnnaBridge 156:ff21514d8981 364
AnnaBridge 156:ff21514d8981 365 /*******************************************************************************
AnnaBridge 156:ff21514d8981 366 ******************************* STRUCTS ***********************************
AnnaBridge 156:ff21514d8981 367 ******************************************************************************/
AnnaBridge 156:ff21514d8981 368
AnnaBridge 156:ff21514d8981 369 #if defined( _EMU_CMD_EM01VSCALE0_MASK )
AnnaBridge 156:ff21514d8981 370 /** EM0 and 1 initialization structure. Voltage scaling is applied when
AnnaBridge 156:ff21514d8981 371 the core clock frequency is changed from @ref CMU. EM0 an 1 emuVScaleEM01_HighPerformance
AnnaBridge 156:ff21514d8981 372 is always enabled. */
AnnaBridge 156:ff21514d8981 373 typedef struct
AnnaBridge 156:ff21514d8981 374 {
AnnaBridge 156:ff21514d8981 375 bool vScaleEM01LowPowerVoltageEnable; /**< EM0/1 low power voltage status */
AnnaBridge 156:ff21514d8981 376 } EMU_EM01Init_TypeDef;
AnnaBridge 156:ff21514d8981 377 #endif
AnnaBridge 156:ff21514d8981 378
AnnaBridge 156:ff21514d8981 379 #if defined( _EMU_CMD_EM01VSCALE0_MASK )
AnnaBridge 156:ff21514d8981 380 /** Default initialization of EM0 and 1 configuration */
AnnaBridge 156:ff21514d8981 381 #define EMU_EM01INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 382 { \
AnnaBridge 156:ff21514d8981 383 false /** Do not scale down in EM0/1 */ \
AnnaBridge 156:ff21514d8981 384 }
AnnaBridge 156:ff21514d8981 385 #endif
AnnaBridge 156:ff21514d8981 386
AnnaBridge 156:ff21514d8981 387 /** EM2 and 3 initialization structure */
AnnaBridge 156:ff21514d8981 388 typedef struct
AnnaBridge 156:ff21514d8981 389 {
AnnaBridge 156:ff21514d8981 390 bool em23VregFullEn; /**< Enable full VREG drive strength in EM2/3 */
AnnaBridge 156:ff21514d8981 391 #if defined( _EMU_CTRL_EM23VSCALE_MASK )
AnnaBridge 156:ff21514d8981 392 EMU_VScaleEM23_TypeDef vScaleEM23Voltage; /**< EM2/3 voltage scaling level */
AnnaBridge 156:ff21514d8981 393 #endif
AnnaBridge 156:ff21514d8981 394 } EMU_EM23Init_TypeDef;
AnnaBridge 156:ff21514d8981 395
AnnaBridge 156:ff21514d8981 396 /** Default initialization of EM2 and 3 configuration */
AnnaBridge 156:ff21514d8981 397 #if defined( _EMU_CTRL_EM4HVSCALE_MASK )
AnnaBridge 156:ff21514d8981 398 #define EMU_EM23INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 399 { \
AnnaBridge 156:ff21514d8981 400 false, /* Reduced voltage regulator drive strength in EM2/3 */ \
AnnaBridge 156:ff21514d8981 401 emuVScaleEM23_FastWakeup, /* Do not scale down in EM2/3 */ \
AnnaBridge 156:ff21514d8981 402 }
AnnaBridge 156:ff21514d8981 403 #else
AnnaBridge 156:ff21514d8981 404 #define EMU_EM23INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 405 { \
AnnaBridge 156:ff21514d8981 406 false, /* Reduced voltage regulator drive strength in EM2/3 */ \
AnnaBridge 156:ff21514d8981 407 }
AnnaBridge 156:ff21514d8981 408 #endif
AnnaBridge 156:ff21514d8981 409
AnnaBridge 156:ff21514d8981 410 #if defined( _EMU_EM4CONF_MASK ) || defined( _EMU_EM4CTRL_MASK )
AnnaBridge 156:ff21514d8981 411 /** EM4 initialization structure */
AnnaBridge 156:ff21514d8981 412 typedef struct
AnnaBridge 156:ff21514d8981 413 {
AnnaBridge 156:ff21514d8981 414 #if defined( _EMU_EM4CONF_MASK )
AnnaBridge 156:ff21514d8981 415 /* Init parameters for platforms with EMU->EM4CONF register (Series 0) */
AnnaBridge 156:ff21514d8981 416 bool lockConfig; /**< Lock configuration of regulator, BOD and oscillator */
AnnaBridge 156:ff21514d8981 417 bool buBodRstDis; /**< When set, no reset will be asserted due to Brownout when in EM4 */
AnnaBridge 156:ff21514d8981 418 EMU_EM4Osc_TypeDef osc; /**< EM4 duty oscillator */
AnnaBridge 156:ff21514d8981 419 bool buRtcWakeup; /**< Wake up on EM4 BURTC interrupt */
AnnaBridge 156:ff21514d8981 420 bool vreg; /**< Enable EM4 voltage regulator */
AnnaBridge 156:ff21514d8981 421 #elif defined( _EMU_EM4CTRL_MASK )
AnnaBridge 156:ff21514d8981 422 /* Init parameters for platforms with EMU->EM4CTRL register (Series 1) */
AnnaBridge 156:ff21514d8981 423 bool retainLfxo; /**< Disable the LFXO upon EM4 entry */
AnnaBridge 156:ff21514d8981 424 bool retainLfrco; /**< Disable the LFRCO upon EM4 entry */
AnnaBridge 156:ff21514d8981 425 bool retainUlfrco; /**< Disable the ULFRCO upon EM4 entry */
AnnaBridge 156:ff21514d8981 426 EMU_EM4State_TypeDef em4State; /**< Hibernate or shutoff EM4 state */
AnnaBridge 156:ff21514d8981 427 EMU_EM4PinRetention_TypeDef pinRetentionMode; /**< EM4 pin retention mode */
AnnaBridge 156:ff21514d8981 428 #endif
AnnaBridge 156:ff21514d8981 429 #if defined( _EMU_CTRL_EM4HVSCALE_MASK )
AnnaBridge 156:ff21514d8981 430 EMU_VScaleEM4H_TypeDef vScaleEM4HVoltage;/**< EM4H voltage scaling level */
AnnaBridge 156:ff21514d8981 431 #endif
AnnaBridge 156:ff21514d8981 432 } EMU_EM4Init_TypeDef;
AnnaBridge 156:ff21514d8981 433 #endif
AnnaBridge 156:ff21514d8981 434
AnnaBridge 156:ff21514d8981 435 #if defined( _EMU_EM4CONF_MASK )
AnnaBridge 156:ff21514d8981 436 /** Default initialization of EM4 configuration (Series 0) */
AnnaBridge 156:ff21514d8981 437 #define EMU_EM4INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 438 { \
AnnaBridge 156:ff21514d8981 439 false, /* Dont't lock configuration after it's been set */ \
AnnaBridge 156:ff21514d8981 440 false, /* No reset will be asserted due to BOD in EM4 */ \
AnnaBridge 156:ff21514d8981 441 emuEM4Osc_ULFRCO, /* Use default ULFRCO oscillator */ \
AnnaBridge 156:ff21514d8981 442 true, /* Wake up on EM4 BURTC interrupt */ \
AnnaBridge 156:ff21514d8981 443 true, /* Enable VREG */ \
AnnaBridge 156:ff21514d8981 444 }
AnnaBridge 156:ff21514d8981 445
AnnaBridge 156:ff21514d8981 446 #elif defined( _EMU_CTRL_EM4HVSCALE_MASK )
AnnaBridge 156:ff21514d8981 447 /** Default initialization of EM4 configuration (Series 1 with VSCALE) */
AnnaBridge 156:ff21514d8981 448 #define EMU_EM4INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 449 { \
AnnaBridge 156:ff21514d8981 450 false, /* Retain LFXO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 451 false, /* Retain LFRCO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 452 false, /* Retain ULFRCO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 453 emuEM4Shutoff, /* Use EM4 shutoff state */ \
AnnaBridge 156:ff21514d8981 454 emuPinRetentionDisable, /* Do not retain pins in EM4 */ \
AnnaBridge 156:ff21514d8981 455 emuVScaleEM4H_FastWakeup, /* Do not scale down in EM4H */ \
AnnaBridge 156:ff21514d8981 456 }
AnnaBridge 156:ff21514d8981 457
AnnaBridge 156:ff21514d8981 458 #elif defined( _EMU_EM4CTRL_MASK )
AnnaBridge 156:ff21514d8981 459 /** Default initialization of EM4 configuration (Series 1 without VSCALE) */
AnnaBridge 156:ff21514d8981 460 #define EMU_EM4INIT_DEFAULT \
AnnaBridge 156:ff21514d8981 461 { \
AnnaBridge 156:ff21514d8981 462 false, /* Retain LFXO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 463 false, /* Retain LFRCO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 464 false, /* Retain ULFRCO configuration upon EM4 entry */ \
AnnaBridge 156:ff21514d8981 465 emuEM4Shutoff, /* Use EM4 shutoff state */ \
AnnaBridge 156:ff21514d8981 466 emuPinRetentionDisable, /* Do not retain pins in EM4 */ \
AnnaBridge 156:ff21514d8981 467 }
AnnaBridge 156:ff21514d8981 468 #endif
AnnaBridge 156:ff21514d8981 469
AnnaBridge 156:ff21514d8981 470 #if defined( BU_PRESENT )
AnnaBridge 156:ff21514d8981 471 /** Backup Power Domain Initialization structure */
AnnaBridge 156:ff21514d8981 472 typedef struct
AnnaBridge 156:ff21514d8981 473 {
AnnaBridge 156:ff21514d8981 474 /* Backup Power Domain power configuration */
AnnaBridge 156:ff21514d8981 475
AnnaBridge 156:ff21514d8981 476 /** Voltage probe select, selects ADC voltage */
AnnaBridge 156:ff21514d8981 477 EMU_Probe_TypeDef probe;
AnnaBridge 156:ff21514d8981 478 /** Enable BOD calibration mode */
AnnaBridge 156:ff21514d8981 479 bool bodCal;
AnnaBridge 156:ff21514d8981 480 /** Enable BU_STAT status pin for active BU mode */
AnnaBridge 156:ff21514d8981 481 bool statusPinEnable;
AnnaBridge 156:ff21514d8981 482
AnnaBridge 156:ff21514d8981 483 /* Backup Power Domain connection configuration */
AnnaBridge 156:ff21514d8981 484 /** Power domain resistor */
AnnaBridge 156:ff21514d8981 485 EMU_Resistor_TypeDef resistor;
AnnaBridge 156:ff21514d8981 486 /** BU_VOUT strong enable */
AnnaBridge 156:ff21514d8981 487 bool voutStrong;
AnnaBridge 156:ff21514d8981 488 /** BU_VOUT medium enable */
AnnaBridge 156:ff21514d8981 489 bool voutMed;
AnnaBridge 156:ff21514d8981 490 /** BU_VOUT weak enable */
AnnaBridge 156:ff21514d8981 491 bool voutWeak;
AnnaBridge 156:ff21514d8981 492 /** Power connection, when not in Backup Mode */
AnnaBridge 156:ff21514d8981 493 EMU_Power_TypeDef inactivePower;
AnnaBridge 156:ff21514d8981 494 /** Power connection, when in Backup Mode */
AnnaBridge 156:ff21514d8981 495 EMU_Power_TypeDef activePower;
AnnaBridge 156:ff21514d8981 496 /** Enable backup power domain, and release reset, enable BU_VIN pin */
AnnaBridge 156:ff21514d8981 497 bool enable;
AnnaBridge 156:ff21514d8981 498 } EMU_BUPDInit_TypeDef;
AnnaBridge 156:ff21514d8981 499
AnnaBridge 156:ff21514d8981 500 /** Default Backup Power Domain configuration */
AnnaBridge 156:ff21514d8981 501 #define EMU_BUPDINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 502 { \
AnnaBridge 156:ff21514d8981 503 emuProbe_Disable, /* Do not enable voltage probe */ \
AnnaBridge 156:ff21514d8981 504 false, /* Disable BOD calibration mode */ \
AnnaBridge 156:ff21514d8981 505 false, /* Disable BU_STAT pin for backup mode indication */ \
AnnaBridge 156:ff21514d8981 506 \
AnnaBridge 156:ff21514d8981 507 emuRes_Res0, /* RES0 series resistance between main and backup power */ \
AnnaBridge 156:ff21514d8981 508 false, /* Don't enable strong switch */ \
AnnaBridge 156:ff21514d8981 509 false, /* Don't enable medium switch */ \
AnnaBridge 156:ff21514d8981 510 false, /* Don't enable weak switch */ \
AnnaBridge 156:ff21514d8981 511 \
AnnaBridge 156:ff21514d8981 512 emuPower_None, /* No connection between main and backup power (inactive mode) */ \
AnnaBridge 156:ff21514d8981 513 emuPower_None, /* No connection between main and backup power (active mode) */ \
AnnaBridge 156:ff21514d8981 514 true /* Enable BUPD enter on BOD, enable BU_VIN pin, release BU reset */ \
AnnaBridge 156:ff21514d8981 515 }
AnnaBridge 156:ff21514d8981 516 #endif
AnnaBridge 156:ff21514d8981 517
AnnaBridge 156:ff21514d8981 518 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 519 /** DCDC initialization structure */
AnnaBridge 156:ff21514d8981 520 typedef struct
AnnaBridge 156:ff21514d8981 521 {
AnnaBridge 156:ff21514d8981 522 EMU_PowerConfig_TypeDef powerConfig; /**< Device external power configuration.
AnnaBridge 156:ff21514d8981 523 @ref emuPowerConfig_DcdcToDvdd is currently the only supported mode. */
AnnaBridge 156:ff21514d8981 524 EMU_DcdcMode_TypeDef dcdcMode; /**< DCDC regulator operating mode in EM0/1 */
AnnaBridge 156:ff21514d8981 525 uint16_t mVout; /**< Target output voltage (mV) */
AnnaBridge 156:ff21514d8981 526 uint16_t em01LoadCurrent_mA; /**< Estimated average load current in EM0/1 (mA).
AnnaBridge 156:ff21514d8981 527 This estimate is also used for EM1 optimization,
AnnaBridge 156:ff21514d8981 528 so if EM1 current is expected to be higher than EM0,
AnnaBridge 156:ff21514d8981 529 then this parameter should hold the higher EM1 current. */
AnnaBridge 156:ff21514d8981 530 uint16_t em234LoadCurrent_uA; /**< Estimated average load current in EM2 (uA).
AnnaBridge 156:ff21514d8981 531 This estimate is also used for EM3 and 4 optimization,
AnnaBridge 156:ff21514d8981 532 so if EM3 or 4 current is expected to be higher than EM2,
AnnaBridge 156:ff21514d8981 533 then this parameter should hold the higher EM3 or 4 current. */
AnnaBridge 156:ff21514d8981 534 uint16_t maxCurrent_mA; /**< Maximum average DCDC output current (mA).
AnnaBridge 156:ff21514d8981 535 This can be set to the maximum for the power source,
AnnaBridge 156:ff21514d8981 536 for example the maximum for a battery. */
AnnaBridge 156:ff21514d8981 537 EMU_DcdcAnaPeripheralPower_TypeDef
AnnaBridge 156:ff21514d8981 538 anaPeripheralPower; /**< Select analog peripheral power in DCDC-to-DVDD mode */
AnnaBridge 156:ff21514d8981 539 EMU_DcdcLnReverseCurrentControl_TypeDef
AnnaBridge 156:ff21514d8981 540 reverseCurrentControl; /**< Low-noise reverse current control.
AnnaBridge 156:ff21514d8981 541 NOTE: this parameter uses special encoding:
AnnaBridge 156:ff21514d8981 542 >= 0 is forced CCM mode where the parameter is used as the
AnnaBridge 156:ff21514d8981 543 reverse current threshold in mA.
AnnaBridge 156:ff21514d8981 544 -1 is encoded as emuDcdcLnHighEfficiencyMode (EFM32 only) */
AnnaBridge 156:ff21514d8981 545 EMU_DcdcLnCompCtrl_TypeDef dcdcLnCompCtrl; /**< DCDC Low-noise mode compensator control. */
AnnaBridge 156:ff21514d8981 546 } EMU_DCDCInit_TypeDef;
AnnaBridge 156:ff21514d8981 547
AnnaBridge 156:ff21514d8981 548 /** Default DCDC initialization */
AnnaBridge 156:ff21514d8981 549 #if defined( _EFM_DEVICE )
AnnaBridge 156:ff21514d8981 550 #if defined(_SILICON_LABS_GECKO_INTERNAL_SDID_80)
AnnaBridge 156:ff21514d8981 551 #define EMU_DCDCINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 552 { \
AnnaBridge 156:ff21514d8981 553 emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \
AnnaBridge 156:ff21514d8981 554 emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \
AnnaBridge 156:ff21514d8981 555 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \
AnnaBridge 156:ff21514d8981 556 5, /* Nominal EM0/1 load current of less than 5mA */ \
AnnaBridge 156:ff21514d8981 557 10, /* Nominal EM2/3/4 load current less than 10uA */ \
AnnaBridge 156:ff21514d8981 558 200, /* Maximum average current of 200mA
AnnaBridge 156:ff21514d8981 559 (assume strong battery or other power source) */ \
AnnaBridge 156:ff21514d8981 560 emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \
AnnaBridge 156:ff21514d8981 561 emuDcdcLnHighEfficiency, /* Use high-efficiency mode */ \
AnnaBridge 156:ff21514d8981 562 emuDcdcLnCompCtrl_1u0F, /* 1uF DCDC capacitor */ \
AnnaBridge 156:ff21514d8981 563 }
AnnaBridge 156:ff21514d8981 564 #else
AnnaBridge 156:ff21514d8981 565 #define EMU_DCDCINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 566 { \
AnnaBridge 156:ff21514d8981 567 emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \
AnnaBridge 156:ff21514d8981 568 emuDcdcMode_LowPower, /* Low-power mode in EM0 */ \
AnnaBridge 156:ff21514d8981 569 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \
AnnaBridge 156:ff21514d8981 570 5, /* Nominal EM0/1 load current of less than 5mA */ \
AnnaBridge 156:ff21514d8981 571 10, /* Nominal EM2/3/4 load current less than 10uA */ \
AnnaBridge 156:ff21514d8981 572 200, /* Maximum average current of 200mA
AnnaBridge 156:ff21514d8981 573 (assume strong battery or other power source) */ \
AnnaBridge 156:ff21514d8981 574 emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \
AnnaBridge 156:ff21514d8981 575 emuDcdcLnHighEfficiency, /* Use high-efficiency mode */ \
AnnaBridge 156:ff21514d8981 576 emuDcdcLnCompCtrl_4u7F, /* 4.7uF DCDC capacitor */ \
AnnaBridge 156:ff21514d8981 577 }
AnnaBridge 156:ff21514d8981 578 #endif
AnnaBridge 156:ff21514d8981 579
AnnaBridge 156:ff21514d8981 580 #else /* EFR32 device */
AnnaBridge 156:ff21514d8981 581 #if defined(_SILICON_LABS_GECKO_INTERNAL_SDID_80)
AnnaBridge 156:ff21514d8981 582 #define EMU_DCDCINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 583 { \
AnnaBridge 156:ff21514d8981 584 emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \
AnnaBridge 156:ff21514d8981 585 emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \
AnnaBridge 156:ff21514d8981 586 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \
AnnaBridge 156:ff21514d8981 587 15, /* Nominal EM0/1 load current of less than 15mA */ \
AnnaBridge 156:ff21514d8981 588 10, /* Nominal EM2/3/4 load current less than 10uA */ \
AnnaBridge 156:ff21514d8981 589 200, /* Maximum average current of 200mA
AnnaBridge 156:ff21514d8981 590 (assume strong battery or other power source) */ \
AnnaBridge 156:ff21514d8981 591 emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \
AnnaBridge 156:ff21514d8981 592 160, /* Maximum reverse current of 160mA */ \
AnnaBridge 156:ff21514d8981 593 emuDcdcLnCompCtrl_1u0F, /* 1uF DCDC capacitor */ \
AnnaBridge 156:ff21514d8981 594 }
AnnaBridge 156:ff21514d8981 595 #else
AnnaBridge 156:ff21514d8981 596 #define EMU_DCDCINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 597 { \
AnnaBridge 156:ff21514d8981 598 emuPowerConfig_DcdcToDvdd, /* DCDC to DVDD */ \
AnnaBridge 156:ff21514d8981 599 emuDcdcMode_LowNoise, /* Low-niose mode in EM0 */ \
AnnaBridge 156:ff21514d8981 600 1800, /* Nominal output voltage for DVDD mode, 1.8V */ \
AnnaBridge 156:ff21514d8981 601 15, /* Nominal EM0/1 load current of less than 15mA */ \
AnnaBridge 156:ff21514d8981 602 10, /* Nominal EM2/3/4 load current less than 10uA */ \
AnnaBridge 156:ff21514d8981 603 200, /* Maximum average current of 200mA
AnnaBridge 156:ff21514d8981 604 (assume strong battery or other power source) */ \
AnnaBridge 156:ff21514d8981 605 emuDcdcAnaPeripheralPower_DCDC,/* Select DCDC as analog power supply (lower power) */ \
AnnaBridge 156:ff21514d8981 606 160, /* Maximum reverse current of 160mA */ \
AnnaBridge 156:ff21514d8981 607 emuDcdcLnCompCtrl_4u7F, /* 4.7uF DCDC capacitor */ \
AnnaBridge 156:ff21514d8981 608 }
AnnaBridge 156:ff21514d8981 609 #endif
AnnaBridge 156:ff21514d8981 610 #endif
AnnaBridge 156:ff21514d8981 611 #endif
AnnaBridge 156:ff21514d8981 612
AnnaBridge 156:ff21514d8981 613 #if defined( EMU_STATUS_VMONRDY )
AnnaBridge 156:ff21514d8981 614 /** VMON initialization structure */
AnnaBridge 156:ff21514d8981 615 typedef struct
AnnaBridge 156:ff21514d8981 616 {
AnnaBridge 156:ff21514d8981 617 EMU_VmonChannel_TypeDef channel; /**< VMON channel to configure */
AnnaBridge 156:ff21514d8981 618 int threshold; /**< Trigger threshold (mV) */
AnnaBridge 156:ff21514d8981 619 bool riseWakeup; /**< Wake up from EM4H on rising edge */
AnnaBridge 156:ff21514d8981 620 bool fallWakeup; /**< Wake up from EM4H on falling edge */
AnnaBridge 156:ff21514d8981 621 bool enable; /**< Enable VMON channel */
AnnaBridge 156:ff21514d8981 622 bool retDisable; /**< Disable IO0 retention when voltage drops below threshold (IOVDD only) */
AnnaBridge 156:ff21514d8981 623 } EMU_VmonInit_TypeDef;
AnnaBridge 156:ff21514d8981 624
AnnaBridge 156:ff21514d8981 625 /** Default VMON initialization structure */
AnnaBridge 156:ff21514d8981 626 #define EMU_VMONINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 627 { \
AnnaBridge 156:ff21514d8981 628 emuVmonChannel_AVDD, /* AVDD VMON channel */ \
AnnaBridge 156:ff21514d8981 629 3200, /* 3.2 V threshold */ \
AnnaBridge 156:ff21514d8981 630 false, /* Don't wake from EM4H on rising edge */ \
AnnaBridge 156:ff21514d8981 631 false, /* Don't wake from EM4H on falling edge */ \
AnnaBridge 156:ff21514d8981 632 true, /* Enable VMON channel */ \
AnnaBridge 156:ff21514d8981 633 false /* Don't disable IO0 retention */ \
AnnaBridge 156:ff21514d8981 634 }
AnnaBridge 156:ff21514d8981 635
AnnaBridge 156:ff21514d8981 636 /** VMON Hysteresis initialization structure */
AnnaBridge 156:ff21514d8981 637 typedef struct
AnnaBridge 156:ff21514d8981 638 {
AnnaBridge 156:ff21514d8981 639 EMU_VmonChannel_TypeDef channel; /**< VMON channel to configure */
AnnaBridge 156:ff21514d8981 640 int riseThreshold; /**< Rising threshold (mV) */
AnnaBridge 156:ff21514d8981 641 int fallThreshold; /**< Falling threshold (mV) */
AnnaBridge 156:ff21514d8981 642 bool riseWakeup; /**< Wake up from EM4H on rising edge */
AnnaBridge 156:ff21514d8981 643 bool fallWakeup; /**< Wake up from EM4H on falling edge */
AnnaBridge 156:ff21514d8981 644 bool enable; /**< Enable VMON channel */
AnnaBridge 156:ff21514d8981 645 } EMU_VmonHystInit_TypeDef;
AnnaBridge 156:ff21514d8981 646
AnnaBridge 156:ff21514d8981 647 /** Default VMON Hysteresis initialization structure */
AnnaBridge 156:ff21514d8981 648 #define EMU_VMONHYSTINIT_DEFAULT \
AnnaBridge 156:ff21514d8981 649 { \
AnnaBridge 156:ff21514d8981 650 emuVmonChannel_AVDD, /* AVDD VMON channel */ \
AnnaBridge 156:ff21514d8981 651 3200, /* 3.2 V rise threshold */ \
AnnaBridge 156:ff21514d8981 652 3200, /* 3.2 V fall threshold */ \
AnnaBridge 156:ff21514d8981 653 false, /* Don't wake from EM4H on rising edge */ \
AnnaBridge 156:ff21514d8981 654 false, /* Don't wake from EM4H on falling edge */ \
AnnaBridge 156:ff21514d8981 655 true /* Enable VMON channel */ \
AnnaBridge 156:ff21514d8981 656 }
AnnaBridge 156:ff21514d8981 657 #endif /* EMU_STATUS_VMONRDY */
AnnaBridge 156:ff21514d8981 658
AnnaBridge 156:ff21514d8981 659 /*******************************************************************************
AnnaBridge 156:ff21514d8981 660 ***************************** PROTOTYPES **********************************
AnnaBridge 156:ff21514d8981 661 ******************************************************************************/
AnnaBridge 156:ff21514d8981 662
AnnaBridge 156:ff21514d8981 663 #if defined( _EMU_CMD_EM01VSCALE0_MASK )
AnnaBridge 156:ff21514d8981 664 void EMU_EM01Init(const EMU_EM01Init_TypeDef *em01Init);
AnnaBridge 156:ff21514d8981 665 #endif
AnnaBridge 156:ff21514d8981 666 void EMU_EM23Init(const EMU_EM23Init_TypeDef *em23Init);
AnnaBridge 156:ff21514d8981 667 #if defined( _EMU_EM4CONF_MASK ) || defined( _EMU_EM4CTRL_MASK )
AnnaBridge 156:ff21514d8981 668 void EMU_EM4Init(const EMU_EM4Init_TypeDef *em4Init);
AnnaBridge 156:ff21514d8981 669 #endif
AnnaBridge 156:ff21514d8981 670 void EMU_EnterEM2(bool restore);
AnnaBridge 156:ff21514d8981 671 void EMU_EnterEM3(bool restore);
AnnaBridge 156:ff21514d8981 672 void EMU_Restore(void);
AnnaBridge 156:ff21514d8981 673 void EMU_EnterEM4(void);
AnnaBridge 156:ff21514d8981 674 #if defined( _EMU_EM4CTRL_MASK )
AnnaBridge 156:ff21514d8981 675 void EMU_EnterEM4H(void);
AnnaBridge 156:ff21514d8981 676 void EMU_EnterEM4S(void);
AnnaBridge 156:ff21514d8981 677 #endif
AnnaBridge 156:ff21514d8981 678 void EMU_MemPwrDown(uint32_t blocks);
AnnaBridge 156:ff21514d8981 679 void EMU_RamPowerDown(uint32_t start, uint32_t end);
AnnaBridge 156:ff21514d8981 680 #if defined(_EMU_EM23PERNORETAINCTRL_MASK)
AnnaBridge 156:ff21514d8981 681 void EMU_PeripheralRetention(EMU_PeripheralRetention_TypeDef periMask, bool enable);
AnnaBridge 156:ff21514d8981 682 #endif
AnnaBridge 156:ff21514d8981 683 void EMU_UpdateOscConfig(void);
AnnaBridge 156:ff21514d8981 684 #if defined( _EMU_CMD_EM01VSCALE0_MASK )
AnnaBridge 156:ff21514d8981 685 void EMU_VScaleEM01ByClock(uint32_t clockFrequency, bool wait);
AnnaBridge 156:ff21514d8981 686 void EMU_VScaleEM01(EMU_VScaleEM01_TypeDef voltage, bool wait);
AnnaBridge 156:ff21514d8981 687 #endif
AnnaBridge 156:ff21514d8981 688 #if defined( BU_PRESENT )
AnnaBridge 156:ff21514d8981 689 void EMU_BUPDInit(const EMU_BUPDInit_TypeDef *bupdInit);
AnnaBridge 156:ff21514d8981 690 void EMU_BUThresholdSet(EMU_BODMode_TypeDef mode, uint32_t value);
AnnaBridge 156:ff21514d8981 691 void EMU_BUThresRangeSet(EMU_BODMode_TypeDef mode, uint32_t value);
AnnaBridge 156:ff21514d8981 692 #endif
AnnaBridge 156:ff21514d8981 693 #if defined( _EMU_DCDCCTRL_MASK )
AnnaBridge 156:ff21514d8981 694 bool EMU_DCDCInit(const EMU_DCDCInit_TypeDef *dcdcInit);
AnnaBridge 156:ff21514d8981 695 void EMU_DCDCModeSet(EMU_DcdcMode_TypeDef dcdcMode);
AnnaBridge 156:ff21514d8981 696 void EMU_DCDCConductionModeSet(EMU_DcdcConductionMode_TypeDef conductionMode, bool rcoDefaultSet);
AnnaBridge 156:ff21514d8981 697 bool EMU_DCDCOutputVoltageSet(uint32_t mV, bool setLpVoltage, bool setLnVoltage);
AnnaBridge 156:ff21514d8981 698 void EMU_DCDCOptimizeSlice(uint32_t mALoadCurrent);
AnnaBridge 156:ff21514d8981 699 void EMU_DCDCLnRcoBandSet(EMU_DcdcLnRcoBand_TypeDef band);
AnnaBridge 156:ff21514d8981 700 bool EMU_DCDCPowerOff(void);
AnnaBridge 156:ff21514d8981 701 #endif
AnnaBridge 156:ff21514d8981 702 #if defined( EMU_STATUS_VMONRDY )
AnnaBridge 156:ff21514d8981 703 void EMU_VmonInit(const EMU_VmonInit_TypeDef *vmonInit);
AnnaBridge 156:ff21514d8981 704 void EMU_VmonHystInit(const EMU_VmonHystInit_TypeDef *vmonInit);
AnnaBridge 156:ff21514d8981 705 void EMU_VmonEnable(EMU_VmonChannel_TypeDef channel, bool enable);
AnnaBridge 156:ff21514d8981 706 bool EMU_VmonChannelStatusGet(EMU_VmonChannel_TypeDef channel);
AnnaBridge 156:ff21514d8981 707 #endif
AnnaBridge 156:ff21514d8981 708
AnnaBridge 156:ff21514d8981 709 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 710 * @brief
AnnaBridge 156:ff21514d8981 711 * Enter energy mode 1 (EM1).
AnnaBridge 156:ff21514d8981 712 ******************************************************************************/
AnnaBridge 156:ff21514d8981 713 __STATIC_INLINE void EMU_EnterEM1(void)
AnnaBridge 156:ff21514d8981 714 {
AnnaBridge 156:ff21514d8981 715 /* Enter sleep mode */
AnnaBridge 156:ff21514d8981 716 SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk;
AnnaBridge 156:ff21514d8981 717 __WFI();
AnnaBridge 156:ff21514d8981 718 }
AnnaBridge 156:ff21514d8981 719
AnnaBridge 156:ff21514d8981 720
AnnaBridge 156:ff21514d8981 721 #if defined( _EMU_STATUS_VSCALE_MASK )
AnnaBridge 156:ff21514d8981 722 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 723 * @brief
AnnaBridge 156:ff21514d8981 724 * Wait for voltage scaling to complete
AnnaBridge 156:ff21514d8981 725 ******************************************************************************/
AnnaBridge 156:ff21514d8981 726 __STATIC_INLINE void EMU_VScaleWait(void)
AnnaBridge 156:ff21514d8981 727 {
AnnaBridge 156:ff21514d8981 728 while (BUS_RegBitRead(&EMU->STATUS, _EMU_STATUS_VSCALEBUSY_SHIFT));
AnnaBridge 156:ff21514d8981 729 }
AnnaBridge 156:ff21514d8981 730 #endif
AnnaBridge 156:ff21514d8981 731
AnnaBridge 156:ff21514d8981 732 #if defined( _EMU_STATUS_VSCALE_MASK )
AnnaBridge 156:ff21514d8981 733 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 734 * @brief
AnnaBridge 156:ff21514d8981 735 * Get current voltage scaling level
AnnaBridge 156:ff21514d8981 736 *
AnnaBridge 156:ff21514d8981 737 * @return
AnnaBridge 156:ff21514d8981 738 * Current voltage scaling level
AnnaBridge 156:ff21514d8981 739 ******************************************************************************/
AnnaBridge 156:ff21514d8981 740 __STATIC_INLINE EMU_VScaleEM01_TypeDef EMU_VScaleGet(void)
AnnaBridge 156:ff21514d8981 741 {
AnnaBridge 156:ff21514d8981 742 EMU_VScaleWait();
AnnaBridge 156:ff21514d8981 743 return (EMU_VScaleEM01_TypeDef)((EMU->STATUS & _EMU_STATUS_VSCALE_MASK)
AnnaBridge 156:ff21514d8981 744 >> _EMU_STATUS_VSCALE_SHIFT);
AnnaBridge 156:ff21514d8981 745 }
AnnaBridge 156:ff21514d8981 746 #endif
AnnaBridge 156:ff21514d8981 747
AnnaBridge 156:ff21514d8981 748 #if defined( _EMU_STATUS_VMONRDY_MASK )
AnnaBridge 156:ff21514d8981 749 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 750 * @brief
AnnaBridge 156:ff21514d8981 751 * Get the status of the voltage monitor (VMON).
AnnaBridge 156:ff21514d8981 752 *
AnnaBridge 156:ff21514d8981 753 * @return
AnnaBridge 156:ff21514d8981 754 * Status of the VMON. True if all the enabled channels are ready, false if
AnnaBridge 156:ff21514d8981 755 * one or more of the enabled channels are not ready.
AnnaBridge 156:ff21514d8981 756 ******************************************************************************/
AnnaBridge 156:ff21514d8981 757 __STATIC_INLINE bool EMU_VmonStatusGet(void)
AnnaBridge 156:ff21514d8981 758 {
AnnaBridge 156:ff21514d8981 759 return BUS_RegBitRead(&EMU->STATUS, _EMU_STATUS_VMONRDY_SHIFT);
AnnaBridge 156:ff21514d8981 760 }
AnnaBridge 156:ff21514d8981 761 #endif /* _EMU_STATUS_VMONRDY_MASK */
AnnaBridge 156:ff21514d8981 762
AnnaBridge 156:ff21514d8981 763 #if defined( _EMU_IF_MASK )
AnnaBridge 156:ff21514d8981 764 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 765 * @brief
AnnaBridge 156:ff21514d8981 766 * Clear one or more pending EMU interrupts.
AnnaBridge 156:ff21514d8981 767 *
AnnaBridge 156:ff21514d8981 768 * @param[in] flags
AnnaBridge 156:ff21514d8981 769 * Pending EMU interrupt sources to clear. Use one or more valid
AnnaBridge 156:ff21514d8981 770 * interrupt flags for the EMU module (EMU_IFC_nnn).
AnnaBridge 156:ff21514d8981 771 ******************************************************************************/
AnnaBridge 156:ff21514d8981 772 __STATIC_INLINE void EMU_IntClear(uint32_t flags)
AnnaBridge 156:ff21514d8981 773 {
AnnaBridge 156:ff21514d8981 774 EMU->IFC = flags;
AnnaBridge 156:ff21514d8981 775 }
AnnaBridge 156:ff21514d8981 776
AnnaBridge 156:ff21514d8981 777
AnnaBridge 156:ff21514d8981 778 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 779 * @brief
AnnaBridge 156:ff21514d8981 780 * Disable one or more EMU interrupts.
AnnaBridge 156:ff21514d8981 781 *
AnnaBridge 156:ff21514d8981 782 * @param[in] flags
AnnaBridge 156:ff21514d8981 783 * EMU interrupt sources to disable. Use one or more valid
AnnaBridge 156:ff21514d8981 784 * interrupt flags for the EMU module (EMU_IEN_nnn).
AnnaBridge 156:ff21514d8981 785 ******************************************************************************/
AnnaBridge 156:ff21514d8981 786 __STATIC_INLINE void EMU_IntDisable(uint32_t flags)
AnnaBridge 156:ff21514d8981 787 {
AnnaBridge 156:ff21514d8981 788 EMU->IEN &= ~flags;
AnnaBridge 156:ff21514d8981 789 }
AnnaBridge 156:ff21514d8981 790
AnnaBridge 156:ff21514d8981 791
AnnaBridge 156:ff21514d8981 792 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 793 * @brief
AnnaBridge 156:ff21514d8981 794 * Enable one or more EMU interrupts.
AnnaBridge 156:ff21514d8981 795 *
AnnaBridge 156:ff21514d8981 796 * @note
AnnaBridge 156:ff21514d8981 797 * Depending on the use, a pending interrupt may already be set prior to
AnnaBridge 156:ff21514d8981 798 * enabling the interrupt. Consider using EMU_IntClear() prior to enabling
AnnaBridge 156:ff21514d8981 799 * if such a pending interrupt should be ignored.
AnnaBridge 156:ff21514d8981 800 *
AnnaBridge 156:ff21514d8981 801 * @param[in] flags
AnnaBridge 156:ff21514d8981 802 * EMU interrupt sources to enable. Use one or more valid
AnnaBridge 156:ff21514d8981 803 * interrupt flags for the EMU module (EMU_IEN_nnn).
AnnaBridge 156:ff21514d8981 804 ******************************************************************************/
AnnaBridge 156:ff21514d8981 805 __STATIC_INLINE void EMU_IntEnable(uint32_t flags)
AnnaBridge 156:ff21514d8981 806 {
AnnaBridge 156:ff21514d8981 807 EMU->IEN |= flags;
AnnaBridge 156:ff21514d8981 808 }
AnnaBridge 156:ff21514d8981 809
AnnaBridge 156:ff21514d8981 810
AnnaBridge 156:ff21514d8981 811 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 812 * @brief
AnnaBridge 156:ff21514d8981 813 * Get pending EMU interrupt flags.
AnnaBridge 156:ff21514d8981 814 *
AnnaBridge 156:ff21514d8981 815 * @note
AnnaBridge 156:ff21514d8981 816 * The event bits are not cleared by the use of this function.
AnnaBridge 156:ff21514d8981 817 *
AnnaBridge 156:ff21514d8981 818 * @return
AnnaBridge 156:ff21514d8981 819 * EMU interrupt sources pending. Returns one or more valid
AnnaBridge 156:ff21514d8981 820 * interrupt flags for the EMU module (EMU_IF_nnn).
AnnaBridge 156:ff21514d8981 821 ******************************************************************************/
AnnaBridge 156:ff21514d8981 822 __STATIC_INLINE uint32_t EMU_IntGet(void)
AnnaBridge 156:ff21514d8981 823 {
AnnaBridge 156:ff21514d8981 824 return EMU->IF;
AnnaBridge 156:ff21514d8981 825 }
AnnaBridge 156:ff21514d8981 826
AnnaBridge 156:ff21514d8981 827
AnnaBridge 156:ff21514d8981 828 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 829 * @brief
AnnaBridge 156:ff21514d8981 830 * Get enabled and pending EMU interrupt flags.
AnnaBridge 156:ff21514d8981 831 * Useful for handling more interrupt sources in the same interrupt handler.
AnnaBridge 156:ff21514d8981 832 *
AnnaBridge 156:ff21514d8981 833 * @note
AnnaBridge 156:ff21514d8981 834 * Interrupt flags are not cleared by the use of this function.
AnnaBridge 156:ff21514d8981 835 *
AnnaBridge 156:ff21514d8981 836 * @return
AnnaBridge 156:ff21514d8981 837 * Pending and enabled EMU interrupt sources
AnnaBridge 156:ff21514d8981 838 * The return value is the bitwise AND of
AnnaBridge 156:ff21514d8981 839 * - the enabled interrupt sources in EMU_IEN and
AnnaBridge 156:ff21514d8981 840 * - the pending interrupt flags EMU_IF
AnnaBridge 156:ff21514d8981 841 ******************************************************************************/
AnnaBridge 156:ff21514d8981 842 __STATIC_INLINE uint32_t EMU_IntGetEnabled(void)
AnnaBridge 156:ff21514d8981 843 {
AnnaBridge 156:ff21514d8981 844 uint32_t ien;
AnnaBridge 156:ff21514d8981 845
AnnaBridge 156:ff21514d8981 846 ien = EMU->IEN;
AnnaBridge 156:ff21514d8981 847 return EMU->IF & ien;
AnnaBridge 156:ff21514d8981 848 }
AnnaBridge 156:ff21514d8981 849
AnnaBridge 156:ff21514d8981 850
AnnaBridge 156:ff21514d8981 851 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 852 * @brief
AnnaBridge 156:ff21514d8981 853 * Set one or more pending EMU interrupts
AnnaBridge 156:ff21514d8981 854 *
AnnaBridge 156:ff21514d8981 855 * @param[in] flags
AnnaBridge 156:ff21514d8981 856 * EMU interrupt sources to set to pending. Use one or more valid
AnnaBridge 156:ff21514d8981 857 * interrupt flags for the EMU module (EMU_IFS_nnn).
AnnaBridge 156:ff21514d8981 858 ******************************************************************************/
AnnaBridge 156:ff21514d8981 859 __STATIC_INLINE void EMU_IntSet(uint32_t flags)
AnnaBridge 156:ff21514d8981 860 {
AnnaBridge 156:ff21514d8981 861 EMU->IFS = flags;
AnnaBridge 156:ff21514d8981 862 }
AnnaBridge 156:ff21514d8981 863 #endif /* _EMU_IF_MASK */
AnnaBridge 156:ff21514d8981 864
AnnaBridge 156:ff21514d8981 865
AnnaBridge 156:ff21514d8981 866 #if defined( _EMU_EM4CONF_LOCKCONF_MASK )
AnnaBridge 156:ff21514d8981 867 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 868 * @brief
AnnaBridge 156:ff21514d8981 869 * Enable or disable EM4 lock configuration
AnnaBridge 156:ff21514d8981 870 * @param[in] enable
AnnaBridge 156:ff21514d8981 871 * If true, locks down EM4 configuration
AnnaBridge 156:ff21514d8981 872 ******************************************************************************/
AnnaBridge 156:ff21514d8981 873 __STATIC_INLINE void EMU_EM4Lock(bool enable)
AnnaBridge 156:ff21514d8981 874 {
AnnaBridge 156:ff21514d8981 875 BUS_RegBitWrite(&(EMU->EM4CONF), _EMU_EM4CONF_LOCKCONF_SHIFT, enable);
AnnaBridge 156:ff21514d8981 876 }
AnnaBridge 156:ff21514d8981 877 #endif
AnnaBridge 156:ff21514d8981 878
AnnaBridge 156:ff21514d8981 879 #if defined( _EMU_STATUS_BURDY_MASK )
AnnaBridge 156:ff21514d8981 880 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 881 * @brief
AnnaBridge 156:ff21514d8981 882 * Halts until backup power functionality is ready
AnnaBridge 156:ff21514d8981 883 ******************************************************************************/
AnnaBridge 156:ff21514d8981 884 __STATIC_INLINE void EMU_BUReady(void)
AnnaBridge 156:ff21514d8981 885 {
AnnaBridge 156:ff21514d8981 886 while(!(EMU->STATUS & EMU_STATUS_BURDY))
AnnaBridge 156:ff21514d8981 887 ;
AnnaBridge 156:ff21514d8981 888 }
AnnaBridge 156:ff21514d8981 889 #endif
AnnaBridge 156:ff21514d8981 890
AnnaBridge 156:ff21514d8981 891 #if defined( _EMU_ROUTE_BUVINPEN_MASK )
AnnaBridge 156:ff21514d8981 892 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 893 * @brief
AnnaBridge 156:ff21514d8981 894 * Disable BU_VIN support
AnnaBridge 156:ff21514d8981 895 * @param[in] enable
AnnaBridge 156:ff21514d8981 896 * If true, enables BU_VIN input pin support, if false disables it
AnnaBridge 156:ff21514d8981 897 ******************************************************************************/
AnnaBridge 156:ff21514d8981 898 __STATIC_INLINE void EMU_BUPinEnable(bool enable)
AnnaBridge 156:ff21514d8981 899 {
AnnaBridge 156:ff21514d8981 900 BUS_RegBitWrite(&(EMU->ROUTE), _EMU_ROUTE_BUVINPEN_SHIFT, enable);
AnnaBridge 156:ff21514d8981 901 }
AnnaBridge 156:ff21514d8981 902 #endif
AnnaBridge 156:ff21514d8981 903
AnnaBridge 156:ff21514d8981 904 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 905 * @brief
AnnaBridge 156:ff21514d8981 906 * Lock the EMU in order to protect its registers against unintended
AnnaBridge 156:ff21514d8981 907 * modification.
AnnaBridge 156:ff21514d8981 908 *
AnnaBridge 156:ff21514d8981 909 * @note
AnnaBridge 156:ff21514d8981 910 * If locking the EMU registers, they must be unlocked prior to using any
AnnaBridge 156:ff21514d8981 911 * EMU API functions modifying EMU registers, excluding interrupt control
AnnaBridge 156:ff21514d8981 912 * and regulator control if the architecture has a EMU_PWRCTRL register.
AnnaBridge 156:ff21514d8981 913 * An exception to this is the energy mode entering API (EMU_EnterEMn()),
AnnaBridge 156:ff21514d8981 914 * which can be used when the EMU registers are locked.
AnnaBridge 156:ff21514d8981 915 ******************************************************************************/
AnnaBridge 156:ff21514d8981 916 __STATIC_INLINE void EMU_Lock(void)
AnnaBridge 156:ff21514d8981 917 {
AnnaBridge 156:ff21514d8981 918 EMU->LOCK = EMU_LOCK_LOCKKEY_LOCK;
AnnaBridge 156:ff21514d8981 919 }
AnnaBridge 156:ff21514d8981 920
AnnaBridge 156:ff21514d8981 921
AnnaBridge 156:ff21514d8981 922 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 923 * @brief
AnnaBridge 156:ff21514d8981 924 * Unlock the EMU so that writing to locked registers again is possible.
AnnaBridge 156:ff21514d8981 925 ******************************************************************************/
AnnaBridge 156:ff21514d8981 926 __STATIC_INLINE void EMU_Unlock(void)
AnnaBridge 156:ff21514d8981 927 {
AnnaBridge 156:ff21514d8981 928 EMU->LOCK = EMU_LOCK_LOCKKEY_UNLOCK;
AnnaBridge 156:ff21514d8981 929 }
AnnaBridge 156:ff21514d8981 930
AnnaBridge 156:ff21514d8981 931
AnnaBridge 156:ff21514d8981 932 #if defined( _EMU_PWRLOCK_MASK )
AnnaBridge 156:ff21514d8981 933 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 934 * @brief
AnnaBridge 156:ff21514d8981 935 * Lock the EMU regulator control registers in order to protect against
AnnaBridge 156:ff21514d8981 936 * unintended modification.
AnnaBridge 156:ff21514d8981 937 ******************************************************************************/
AnnaBridge 156:ff21514d8981 938 __STATIC_INLINE void EMU_PowerLock(void)
AnnaBridge 156:ff21514d8981 939 {
AnnaBridge 156:ff21514d8981 940 EMU->PWRLOCK = EMU_PWRLOCK_LOCKKEY_LOCK;
AnnaBridge 156:ff21514d8981 941 }
AnnaBridge 156:ff21514d8981 942
AnnaBridge 156:ff21514d8981 943
AnnaBridge 156:ff21514d8981 944 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 945 * @brief
AnnaBridge 156:ff21514d8981 946 * Unlock the EMU power control registers so that writing to
AnnaBridge 156:ff21514d8981 947 * locked registers again is possible.
AnnaBridge 156:ff21514d8981 948 ******************************************************************************/
AnnaBridge 156:ff21514d8981 949 __STATIC_INLINE void EMU_PowerUnlock(void)
AnnaBridge 156:ff21514d8981 950 {
AnnaBridge 156:ff21514d8981 951 EMU->PWRLOCK = EMU_PWRLOCK_LOCKKEY_UNLOCK;
AnnaBridge 156:ff21514d8981 952 }
AnnaBridge 156:ff21514d8981 953 #endif
AnnaBridge 156:ff21514d8981 954
AnnaBridge 156:ff21514d8981 955
AnnaBridge 156:ff21514d8981 956 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 957 * @brief
AnnaBridge 156:ff21514d8981 958 * Block entering EM2 or higher number energy modes.
AnnaBridge 156:ff21514d8981 959 ******************************************************************************/
AnnaBridge 156:ff21514d8981 960 __STATIC_INLINE void EMU_EM2Block(void)
AnnaBridge 156:ff21514d8981 961 {
AnnaBridge 156:ff21514d8981 962 BUS_RegBitWrite(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 1U);
AnnaBridge 156:ff21514d8981 963 }
AnnaBridge 156:ff21514d8981 964
AnnaBridge 156:ff21514d8981 965 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 966 * @brief
AnnaBridge 156:ff21514d8981 967 * Unblock entering EM2 or higher number energy modes.
AnnaBridge 156:ff21514d8981 968 ******************************************************************************/
AnnaBridge 156:ff21514d8981 969 __STATIC_INLINE void EMU_EM2UnBlock(void)
AnnaBridge 156:ff21514d8981 970 {
AnnaBridge 156:ff21514d8981 971 BUS_RegBitWrite(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 0U);
AnnaBridge 156:ff21514d8981 972 }
AnnaBridge 156:ff21514d8981 973
AnnaBridge 156:ff21514d8981 974 #if defined( _EMU_EM4CTRL_EM4IORETMODE_MASK )
AnnaBridge 156:ff21514d8981 975 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 976 * @brief
AnnaBridge 156:ff21514d8981 977 * When EM4 pin retention is set to emuPinRetentionLatch, then pins are retained
AnnaBridge 156:ff21514d8981 978 * through EM4 entry and wakeup. The pin state is released by calling this function.
AnnaBridge 156:ff21514d8981 979 * The feature allows peripherals or GPIO to be re-initialized after EM4 exit (reset),
AnnaBridge 156:ff21514d8981 980 * and when the initialization is done, this function can release pins and return control
AnnaBridge 156:ff21514d8981 981 * to the peripherals or GPIO.
AnnaBridge 156:ff21514d8981 982 ******************************************************************************/
AnnaBridge 156:ff21514d8981 983 __STATIC_INLINE void EMU_UnlatchPinRetention(void)
AnnaBridge 156:ff21514d8981 984 {
AnnaBridge 156:ff21514d8981 985 EMU->CMD = EMU_CMD_EM4UNLATCH;
AnnaBridge 156:ff21514d8981 986 }
AnnaBridge 156:ff21514d8981 987 #endif
AnnaBridge 156:ff21514d8981 988
AnnaBridge 156:ff21514d8981 989 #if defined( _SILICON_LABS_GECKO_INTERNAL_SDID_80 )
AnnaBridge 156:ff21514d8981 990 void EMU_SetBiasMode(EMU_BiasMode_TypeDef mode);
AnnaBridge 156:ff21514d8981 991 #endif
AnnaBridge 156:ff21514d8981 992
AnnaBridge 156:ff21514d8981 993 /** @} (end addtogroup EMU) */
AnnaBridge 156:ff21514d8981 994 /** @} (end addtogroup emlib) */
AnnaBridge 156:ff21514d8981 995
AnnaBridge 156:ff21514d8981 996 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 997 }
AnnaBridge 156:ff21514d8981 998 #endif
AnnaBridge 156:ff21514d8981 999
AnnaBridge 156:ff21514d8981 1000 #endif /* defined( EMU_PRESENT ) */
AnnaBridge 156:ff21514d8981 1001 #endif /* EM_EMU_H */