Jeroen van Zoeren / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Ophaalbrug-dev

Fork of mbed-dev by mbed official

targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/inc/em_emu.h@46:b2af06471858, 2016-01-14 (annotated)

Committer:
jeroenvz
Date:
Thu Jan 14 18:52:28 2016 +0000
Revision:
46:b2af06471858
Parent:
0:9b334a45a8ff 
- LPCXpresso Interrupt fix

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 2 * @file em_emu.h
bogdanm 0:9b334a45a8ff 3 * @brief Energy management unit (EMU) peripheral API
bogdanm 0:9b334a45a8ff 4 * @version 3.20.12
bogdanm 0:9b334a45a8ff 5 *******************************************************************************
bogdanm 0:9b334a45a8ff 6 * @section License
bogdanm 0:9b334a45a8ff 7 * <b>(C) Copyright 2014 Silicon Labs, http://www.silabs.com</b>
bogdanm 0:9b334a45a8ff 8 *******************************************************************************
bogdanm 0:9b334a45a8ff 9 *
bogdanm 0:9b334a45a8ff 10 * Permission is granted to anyone to use this software for any purpose,
bogdanm 0:9b334a45a8ff 11 * including commercial applications, and to alter it and redistribute it
bogdanm 0:9b334a45a8ff 12 * freely, subject to the following restrictions:
bogdanm 0:9b334a45a8ff 13 *
bogdanm 0:9b334a45a8ff 14 * 1. The origin of this software must not be misrepresented; you must not
bogdanm 0:9b334a45a8ff 15 * claim that you wrote the original software.
bogdanm 0:9b334a45a8ff 16 * 2. Altered source versions must be plainly marked as such, and must not be
bogdanm 0:9b334a45a8ff 17 * misrepresented as being the original software.
bogdanm 0:9b334a45a8ff 18 * 3. This notice may not be removed or altered from any source distribution.
bogdanm 0:9b334a45a8ff 19 *
bogdanm 0:9b334a45a8ff 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
bogdanm 0:9b334a45a8ff 21 * obligation to support this Software. Silicon Labs is providing the
bogdanm 0:9b334a45a8ff 22 * Software "AS IS", with no express or implied warranties of any kind,
bogdanm 0:9b334a45a8ff 23 * including, but not limited to, any implied warranties of merchantability
bogdanm 0:9b334a45a8ff 24 * or fitness for any particular purpose or warranties against infringement
bogdanm 0:9b334a45a8ff 25 * of any proprietary rights of a third party.
bogdanm 0:9b334a45a8ff 26 *
bogdanm 0:9b334a45a8ff 27 * Silicon Labs will not be liable for any consequential, incidental, or
bogdanm 0:9b334a45a8ff 28 * special damages, or any other relief, or for any claim by any third party,
bogdanm 0:9b334a45a8ff 29 * arising from your use of this Software.
bogdanm 0:9b334a45a8ff 30 *
bogdanm 0:9b334a45a8ff 31 ******************************************************************************/
bogdanm 0:9b334a45a8ff 32
bogdanm 0:9b334a45a8ff 33
bogdanm 0:9b334a45a8ff 34 #ifndef __SILICON_LABS_EM_EMU_H__
bogdanm 0:9b334a45a8ff 35 #define __SILICON_LABS_EM_EMU_H__
bogdanm 0:9b334a45a8ff 36
bogdanm 0:9b334a45a8ff 37 #include "em_device.h"
bogdanm 0:9b334a45a8ff 38 #if defined( EMU_PRESENT )
bogdanm 0:9b334a45a8ff 39
bogdanm 0:9b334a45a8ff 40 #include <stdbool.h>
bogdanm 0:9b334a45a8ff 41 #include "em_bitband.h"
bogdanm 0:9b334a45a8ff 42
bogdanm 0:9b334a45a8ff 43 #ifdef __cplusplus
bogdanm 0:9b334a45a8ff 44 extern "C" {
bogdanm 0:9b334a45a8ff 45 #endif
bogdanm 0:9b334a45a8ff 46
bogdanm 0:9b334a45a8ff 47 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 48 * @addtogroup EM_Library
bogdanm 0:9b334a45a8ff 49 * @{
bogdanm 0:9b334a45a8ff 50 ******************************************************************************/
bogdanm 0:9b334a45a8ff 51
bogdanm 0:9b334a45a8ff 52 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 53 * @addtogroup EMU
bogdanm 0:9b334a45a8ff 54 * @{
bogdanm 0:9b334a45a8ff 55 ******************************************************************************/
bogdanm 0:9b334a45a8ff 56
bogdanm 0:9b334a45a8ff 57 /*******************************************************************************
bogdanm 0:9b334a45a8ff 58 ******************************** ENUMS ************************************
bogdanm 0:9b334a45a8ff 59 ******************************************************************************/
bogdanm 0:9b334a45a8ff 60
bogdanm 0:9b334a45a8ff 61 typedef enum
bogdanm 0:9b334a45a8ff 62 {
bogdanm 0:9b334a45a8ff 63 /** Enable EM2 and 3 voltage regulator reduced drive strength (reduced leakage current) */
bogdanm 0:9b334a45a8ff 64 #if defined( _EMU_CTRL_EM23VREG_MASK )
bogdanm 0:9b334a45a8ff 65 emuEM23Vreg_REDUCED = EMU_CTRL_EM23VREG_REDUCED,
bogdanm 0:9b334a45a8ff 66 #elif defined( _EMU_CTRL_EMVREG_MASK )
bogdanm 0:9b334a45a8ff 67 emuEM23Vreg_REDUCED = EMU_CTRL_EMVREG_REDUCED,
bogdanm 0:9b334a45a8ff 68 #endif
bogdanm 0:9b334a45a8ff 69 /** Enable EM2 and 3 voltage regulator full drive strength (faster startup) */
bogdanm 0:9b334a45a8ff 70 #if defined( _EMU_CTRL_EM23VREG_MASK )
bogdanm 0:9b334a45a8ff 71 emuEM23Vreg_FULL = EMU_CTRL_EM23VREG_FULL,
bogdanm 0:9b334a45a8ff 72 #elif defined( _EMU_CTRL_EMVREG_MASK )
bogdanm 0:9b334a45a8ff 73 emuEM23Vreg_FULL = EMU_CTRL_EMVREG_FULL,
bogdanm 0:9b334a45a8ff 74 #endif
bogdanm 0:9b334a45a8ff 75 } EMU_EM23VregMode;
bogdanm 0:9b334a45a8ff 76
bogdanm 0:9b334a45a8ff 77 #if defined( _EMU_EM4CONF_OSC_MASK )
bogdanm 0:9b334a45a8ff 78 /** EM4 duty oscillator */
bogdanm 0:9b334a45a8ff 79 typedef enum
bogdanm 0:9b334a45a8ff 80 {
bogdanm 0:9b334a45a8ff 81 /** Select ULFRCO as duty oscillator in EM4 */
bogdanm 0:9b334a45a8ff 82 emuEM4Osc_ULFRCO = EMU_EM4CONF_OSC_ULFRCO,
bogdanm 0:9b334a45a8ff 83 /** Select LFXO as duty oscillator in EM4 */
bogdanm 0:9b334a45a8ff 84 emuEM4Osc_LFXO = EMU_EM4CONF_OSC_LFXO,
bogdanm 0:9b334a45a8ff 85 /** Select LFRCO as duty oscillator in EM4 */
bogdanm 0:9b334a45a8ff 86 emuEM4Osc_LFRCO = EMU_EM4CONF_OSC_LFRCO
bogdanm 0:9b334a45a8ff 87 } EMU_EM4Osc_TypeDef;
bogdanm 0:9b334a45a8ff 88 #endif
bogdanm 0:9b334a45a8ff 89
bogdanm 0:9b334a45a8ff 90 #if defined( _EMU_BUCTRL_PROBE_MASK )
bogdanm 0:9b334a45a8ff 91 /** Backup Power Voltage Probe types */
bogdanm 0:9b334a45a8ff 92 typedef enum
bogdanm 0:9b334a45a8ff 93 {
bogdanm 0:9b334a45a8ff 94 /** Disable voltage probe */
bogdanm 0:9b334a45a8ff 95 emuProbe_Disable = EMU_BUCTRL_PROBE_DISABLE,
bogdanm 0:9b334a45a8ff 96 /** Connect probe to VDD_DREG */
bogdanm 0:9b334a45a8ff 97 emuProbe_VDDDReg = EMU_BUCTRL_PROBE_VDDDREG,
bogdanm 0:9b334a45a8ff 98 /** Connect probe to BU_IN */
bogdanm 0:9b334a45a8ff 99 emuProbe_BUIN = EMU_BUCTRL_PROBE_BUIN,
bogdanm 0:9b334a45a8ff 100 /** Connect probe to BU_OUT */
bogdanm 0:9b334a45a8ff 101 emuProbe_BUOUT = EMU_BUCTRL_PROBE_BUOUT
bogdanm 0:9b334a45a8ff 102 } EMU_Probe_TypeDef;
bogdanm 0:9b334a45a8ff 103 #endif
bogdanm 0:9b334a45a8ff 104
bogdanm 0:9b334a45a8ff 105 #if defined( _EMU_PWRCONF_PWRRES_MASK )
bogdanm 0:9b334a45a8ff 106 /** Backup Power Domain resistor selection */
bogdanm 0:9b334a45a8ff 107 typedef enum
bogdanm 0:9b334a45a8ff 108 {
bogdanm 0:9b334a45a8ff 109 /** Main power and backup power connected with RES0 series resistance */
bogdanm 0:9b334a45a8ff 110 emuRes_Res0 = EMU_PWRCONF_PWRRES_RES0,
bogdanm 0:9b334a45a8ff 111 /** Main power and backup power connected with RES1 series resistance */
bogdanm 0:9b334a45a8ff 112 emuRes_Res1 = EMU_PWRCONF_PWRRES_RES1,
bogdanm 0:9b334a45a8ff 113 /** Main power and backup power connected with RES2 series resistance */
bogdanm 0:9b334a45a8ff 114 emuRes_Res2 = EMU_PWRCONF_PWRRES_RES2,
bogdanm 0:9b334a45a8ff 115 /** Main power and backup power connected with RES3 series resistance */
bogdanm 0:9b334a45a8ff 116 emuRes_Res3 = EMU_PWRCONF_PWRRES_RES3,
bogdanm 0:9b334a45a8ff 117 } EMU_Resistor_TypeDef;
bogdanm 0:9b334a45a8ff 118 #endif
bogdanm 0:9b334a45a8ff 119
bogdanm 0:9b334a45a8ff 120 #if defined( BU_PRESENT )
bogdanm 0:9b334a45a8ff 121 /** Backup Power Domain power connection */
bogdanm 0:9b334a45a8ff 122 typedef enum
bogdanm 0:9b334a45a8ff 123 {
bogdanm 0:9b334a45a8ff 124 /** No connection between main and backup power */
bogdanm 0:9b334a45a8ff 125 emuPower_None = EMU_BUINACT_PWRCON_NONE,
bogdanm 0:9b334a45a8ff 126 /** Main power and backup power connected through diode,
bogdanm 0:9b334a45a8ff 127 allowing current from backup to main only */
bogdanm 0:9b334a45a8ff 128 emuPower_BUMain = EMU_BUINACT_PWRCON_BUMAIN,
bogdanm 0:9b334a45a8ff 129 /** Main power and backup power connected through diode,
bogdanm 0:9b334a45a8ff 130 allowing current from main to backup only */
bogdanm 0:9b334a45a8ff 131 emuPower_MainBU = EMU_BUINACT_PWRCON_MAINBU,
bogdanm 0:9b334a45a8ff 132 /** Main power and backup power connected without diode */
bogdanm 0:9b334a45a8ff 133 emuPower_NoDiode = EMU_BUINACT_PWRCON_NODIODE,
bogdanm 0:9b334a45a8ff 134 } EMU_Power_TypeDef;
bogdanm 0:9b334a45a8ff 135 #endif
bogdanm 0:9b334a45a8ff 136
bogdanm 0:9b334a45a8ff 137 /** BOD threshold setting selector, active or inactive mode */
bogdanm 0:9b334a45a8ff 138 typedef enum
bogdanm 0:9b334a45a8ff 139 {
bogdanm 0:9b334a45a8ff 140 /** Configure BOD threshold for active mode */
bogdanm 0:9b334a45a8ff 141 emuBODMode_Active,
bogdanm 0:9b334a45a8ff 142 /** Configure BOD threshold for inactive mode */
bogdanm 0:9b334a45a8ff 143 emuBODMode_Inactive,
bogdanm 0:9b334a45a8ff 144 } EMU_BODMode_TypeDef;
bogdanm 0:9b334a45a8ff 145
bogdanm 0:9b334a45a8ff 146
bogdanm 0:9b334a45a8ff 147
bogdanm 0:9b334a45a8ff 148 /*******************************************************************************
bogdanm 0:9b334a45a8ff 149 ******************************* STRUCTS ***********************************
bogdanm 0:9b334a45a8ff 150 ******************************************************************************/
bogdanm 0:9b334a45a8ff 151
bogdanm 0:9b334a45a8ff 152 /** Energy Mode 2 and 3 initialization structure */
bogdanm 0:9b334a45a8ff 153 typedef struct
bogdanm 0:9b334a45a8ff 154 {
bogdanm 0:9b334a45a8ff 155 bool em23Vreg;
bogdanm 0:9b334a45a8ff 156 } EMU_EM23Init_TypeDef;
bogdanm 0:9b334a45a8ff 157
bogdanm 0:9b334a45a8ff 158 /** Default initialization of EM2 and 3 configuration */
bogdanm 0:9b334a45a8ff 159 #define EMU_EM23INIT_DEFAULT \
bogdanm 0:9b334a45a8ff 160 { false } /* Reduced voltage regulator drive strength in EM2 and EM3 */
bogdanm 0:9b334a45a8ff 161
bogdanm 0:9b334a45a8ff 162
bogdanm 0:9b334a45a8ff 163 /** Energy Mode 4 initialization structure */
bogdanm 0:9b334a45a8ff 164 typedef struct
bogdanm 0:9b334a45a8ff 165 {
bogdanm 0:9b334a45a8ff 166 /* Init parameters for platforms with EMU->EM4CONF register */
bogdanm 0:9b334a45a8ff 167 #if defined( _EMU_EM4CONF_MASK )
bogdanm 0:9b334a45a8ff 168 bool lockConfig; /** Lock configuration of regulator, BOD and oscillator */
bogdanm 0:9b334a45a8ff 169 bool buBodRstDis; /** When set, no reset will be asserted due to Brownout when in EM4 */
bogdanm 0:9b334a45a8ff 170 EMU_EM4Osc_TypeDef osc; /** EM4 duty oscillator */
bogdanm 0:9b334a45a8ff 171 bool buRtcWakeup; /** Wake up on EM4 BURTC interrupt */
bogdanm 0:9b334a45a8ff 172 bool vreg; /** Enable EM4 voltage regulator */
bogdanm 0:9b334a45a8ff 173 #else
bogdanm 0:9b334a45a8ff 174 bool reserved; /** Placeholder for empty structs */
bogdanm 0:9b334a45a8ff 175 #endif
bogdanm 0:9b334a45a8ff 176 } EMU_EM4Init_TypeDef;
bogdanm 0:9b334a45a8ff 177
bogdanm 0:9b334a45a8ff 178 /** Default initialization of EM4 configuration */
bogdanm 0:9b334a45a8ff 179 #if defined( _EMU_EM4CONF_MASK )
bogdanm 0:9b334a45a8ff 180 #define EMU_EM4INIT_DEFAULT \
bogdanm 0:9b334a45a8ff 181 { false, /* Dont't lock configuration after it's been set */ \
bogdanm 0:9b334a45a8ff 182 false, /* No reset will be asserted due to Brownout when in EM4 */ \
bogdanm 0:9b334a45a8ff 183 emuEM4Osc_ULFRCO, /* Use default ULFRCO oscillator */ \
bogdanm 0:9b334a45a8ff 184 true, /* Wake up on EM4 BURTC interrupt */ \
bogdanm 0:9b334a45a8ff 185 true, /* Enable VREG */ \
bogdanm 0:9b334a45a8ff 186 }
bogdanm 0:9b334a45a8ff 187 #else
bogdanm 0:9b334a45a8ff 188 #define EMU_EM4INIT_DEFAULT \
bogdanm 0:9b334a45a8ff 189 { false, /* Placeholder default value */ \
bogdanm 0:9b334a45a8ff 190 }
bogdanm 0:9b334a45a8ff 191 #endif
bogdanm 0:9b334a45a8ff 192
bogdanm 0:9b334a45a8ff 193
bogdanm 0:9b334a45a8ff 194 #if defined( BU_PRESENT )
bogdanm 0:9b334a45a8ff 195 /** Backup Power Domain Initialization structure */
bogdanm 0:9b334a45a8ff 196 typedef struct
bogdanm 0:9b334a45a8ff 197 {
bogdanm 0:9b334a45a8ff 198 /* Backup Power Domain power configuration */
bogdanm 0:9b334a45a8ff 199
bogdanm 0:9b334a45a8ff 200 /** Voltage probe select, selects ADC voltage */
bogdanm 0:9b334a45a8ff 201 EMU_Probe_TypeDef probe;
bogdanm 0:9b334a45a8ff 202 /** Enable BOD calibration mode */
bogdanm 0:9b334a45a8ff 203 bool bodCal;
bogdanm 0:9b334a45a8ff 204 /** Enable BU_STAT status pin for active BU mode */
bogdanm 0:9b334a45a8ff 205 bool statusPinEnable;
bogdanm 0:9b334a45a8ff 206
bogdanm 0:9b334a45a8ff 207 /* Backup Power Domain connection configuration */
bogdanm 0:9b334a45a8ff 208 /** Power domain resistor */
bogdanm 0:9b334a45a8ff 209 EMU_Resistor_TypeDef resistor;
bogdanm 0:9b334a45a8ff 210 /** BU_VOUT strong enable */
bogdanm 0:9b334a45a8ff 211 bool voutStrong;
bogdanm 0:9b334a45a8ff 212 /** BU_VOUT medium enable */
bogdanm 0:9b334a45a8ff 213 bool voutMed;
bogdanm 0:9b334a45a8ff 214 /** BU_VOUT weak enable */
bogdanm 0:9b334a45a8ff 215 bool voutWeak;
bogdanm 0:9b334a45a8ff 216 /** Power connection, when not in Backup Mode */
bogdanm 0:9b334a45a8ff 217 EMU_Power_TypeDef inactivePower;
bogdanm 0:9b334a45a8ff 218 /** Power connection, when in Backup Mode */
bogdanm 0:9b334a45a8ff 219 EMU_Power_TypeDef activePower;
bogdanm 0:9b334a45a8ff 220 /** Enable backup power domain, and release reset, enable BU_VIN pin */
bogdanm 0:9b334a45a8ff 221 bool enable;
bogdanm 0:9b334a45a8ff 222 } EMU_BUPDInit_TypeDef;
bogdanm 0:9b334a45a8ff 223
bogdanm 0:9b334a45a8ff 224 /** Default */
bogdanm 0:9b334a45a8ff 225 #define EMU_BUPDINIT_DEFAULT \
bogdanm 0:9b334a45a8ff 226 { emuProbe_Disable, /* Do not enable voltage probe */ \
bogdanm 0:9b334a45a8ff 227 false, /* Disable BOD calibration mode */ \
bogdanm 0:9b334a45a8ff 228 false, /* Disable BU_STAT pin for backup mode indication */ \
bogdanm 0:9b334a45a8ff 229 \
bogdanm 0:9b334a45a8ff 230 emuRes_Res0, /* RES0 series resistance between main and backup power */ \
bogdanm 0:9b334a45a8ff 231 false, /* Don't enable strong switch */ \
bogdanm 0:9b334a45a8ff 232 false, /* Don't enable medium switch */ \
bogdanm 0:9b334a45a8ff 233 false, /* Don't enable weak switch */ \
bogdanm 0:9b334a45a8ff 234 \
bogdanm 0:9b334a45a8ff 235 emuPower_None, /* No connection between main and backup power (inactive mode) */ \
bogdanm 0:9b334a45a8ff 236 emuPower_None, /* No connection between main and backup power (active mode) */ \
bogdanm 0:9b334a45a8ff 237 true /* Enable BUPD enter on BOD, enable BU_VIN pin, release BU reset */ \
bogdanm 0:9b334a45a8ff 238 }
bogdanm 0:9b334a45a8ff 239 #endif
bogdanm 0:9b334a45a8ff 240
bogdanm 0:9b334a45a8ff 241
bogdanm 0:9b334a45a8ff 242 /*******************************************************************************
bogdanm 0:9b334a45a8ff 243 ***************************** PROTOTYPES **********************************
bogdanm 0:9b334a45a8ff 244 ******************************************************************************/
bogdanm 0:9b334a45a8ff 245
bogdanm 0:9b334a45a8ff 246 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 247 * @brief
bogdanm 0:9b334a45a8ff 248 * Enter energy mode 1 (EM1).
bogdanm 0:9b334a45a8ff 249 ******************************************************************************/
bogdanm 0:9b334a45a8ff 250 __STATIC_INLINE void EMU_EnterEM1(void)
bogdanm 0:9b334a45a8ff 251 {
bogdanm 0:9b334a45a8ff 252 /* Just enter Cortex-M3 sleep mode */
bogdanm 0:9b334a45a8ff 253 SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk;
bogdanm 0:9b334a45a8ff 254 __WFI();
bogdanm 0:9b334a45a8ff 255 }
bogdanm 0:9b334a45a8ff 256
bogdanm 0:9b334a45a8ff 257 void EMU_EM23Init(EMU_EM23Init_TypeDef *em23Init);
bogdanm 0:9b334a45a8ff 258 #if defined( _EMU_EM4CONF_MASK )
bogdanm 0:9b334a45a8ff 259 void EMU_EM4Init(EMU_EM4Init_TypeDef *em4Init);
bogdanm 0:9b334a45a8ff 260 #endif
bogdanm 0:9b334a45a8ff 261 void EMU_EnterEM2(bool restore);
bogdanm 0:9b334a45a8ff 262 void EMU_EnterEM3(bool restore);
bogdanm 0:9b334a45a8ff 263 void EMU_EnterEM4(void);
bogdanm 0:9b334a45a8ff 264 void EMU_MemPwrDown(uint32_t blocks);
bogdanm 0:9b334a45a8ff 265 void EMU_UpdateOscConfig(void);
bogdanm 0:9b334a45a8ff 266 #if defined( BU_PRESENT )
bogdanm 0:9b334a45a8ff 267 void EMU_BUPDInit(EMU_BUPDInit_TypeDef *bupdInit);
bogdanm 0:9b334a45a8ff 268 void EMU_BUThresholdSet(EMU_BODMode_TypeDef mode, uint32_t value);
bogdanm 0:9b334a45a8ff 269 void EMU_BUThresRangeSet(EMU_BODMode_TypeDef mode, uint32_t value);
bogdanm 0:9b334a45a8ff 270 #endif
bogdanm 0:9b334a45a8ff 271
bogdanm 0:9b334a45a8ff 272
bogdanm 0:9b334a45a8ff 273 #if defined( _EMU_IF_MASK )
bogdanm 0:9b334a45a8ff 274 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 275 * @brief
bogdanm 0:9b334a45a8ff 276 * Clear one or more pending EMU interrupts.
bogdanm 0:9b334a45a8ff 277 *
bogdanm 0:9b334a45a8ff 278 * @param[in] flags
bogdanm 0:9b334a45a8ff 279 * Pending EMU interrupt sources to clear. Use one or more valid
bogdanm 0:9b334a45a8ff 280 * interrupt flags for the EMU module (EMU_IFC_nnn).
bogdanm 0:9b334a45a8ff 281 ******************************************************************************/
bogdanm 0:9b334a45a8ff 282 __STATIC_INLINE void EMU_IntClear(uint32_t flags)
bogdanm 0:9b334a45a8ff 283 {
bogdanm 0:9b334a45a8ff 284 EMU->IFC = flags;
bogdanm 0:9b334a45a8ff 285 }
bogdanm 0:9b334a45a8ff 286
bogdanm 0:9b334a45a8ff 287
bogdanm 0:9b334a45a8ff 288 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 289 * @brief
bogdanm 0:9b334a45a8ff 290 * Disable one or more EMU interrupts.
bogdanm 0:9b334a45a8ff 291 *
bogdanm 0:9b334a45a8ff 292 * @param[in] flags
bogdanm 0:9b334a45a8ff 293 * EMU interrupt sources to disable. Use one or more valid
bogdanm 0:9b334a45a8ff 294 * interrupt flags for the EMU module (EMU_IEN_nnn).
bogdanm 0:9b334a45a8ff 295 ******************************************************************************/
bogdanm 0:9b334a45a8ff 296 __STATIC_INLINE void EMU_IntDisable(uint32_t flags)
bogdanm 0:9b334a45a8ff 297 {
bogdanm 0:9b334a45a8ff 298 EMU->IEN &= ~(flags);
bogdanm 0:9b334a45a8ff 299 }
bogdanm 0:9b334a45a8ff 300
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 303 * @brief
bogdanm 0:9b334a45a8ff 304 * Enable one or more EMU interrupts.
bogdanm 0:9b334a45a8ff 305 *
bogdanm 0:9b334a45a8ff 306 * @note
bogdanm 0:9b334a45a8ff 307 * Depending on the use, a pending interrupt may already be set prior to
bogdanm 0:9b334a45a8ff 308 * enabling the interrupt. Consider using EMU_IntClear() prior to enabling
bogdanm 0:9b334a45a8ff 309 * if such a pending interrupt should be ignored.
bogdanm 0:9b334a45a8ff 310 *
bogdanm 0:9b334a45a8ff 311 * @param[in] flags
bogdanm 0:9b334a45a8ff 312 * EMU interrupt sources to enable. Use one or more valid
bogdanm 0:9b334a45a8ff 313 * interrupt flags for the EMU module (EMU_IEN_nnn).
bogdanm 0:9b334a45a8ff 314 ******************************************************************************/
bogdanm 0:9b334a45a8ff 315 __STATIC_INLINE void EMU_IntEnable(uint32_t flags)
bogdanm 0:9b334a45a8ff 316 {
bogdanm 0:9b334a45a8ff 317 EMU->IEN |= flags;
bogdanm 0:9b334a45a8ff 318 }
bogdanm 0:9b334a45a8ff 319
bogdanm 0:9b334a45a8ff 320
bogdanm 0:9b334a45a8ff 321 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 322 * @brief
bogdanm 0:9b334a45a8ff 323 * Get pending EMU interrupt flags.
bogdanm 0:9b334a45a8ff 324 *
bogdanm 0:9b334a45a8ff 325 * @note
bogdanm 0:9b334a45a8ff 326 * The event bits are not cleared by the use of this function.
bogdanm 0:9b334a45a8ff 327 *
bogdanm 0:9b334a45a8ff 328 * @return
bogdanm 0:9b334a45a8ff 329 * EMU interrupt sources pending. Returns one or more valid
bogdanm 0:9b334a45a8ff 330 * interrupt flags for the EMU module (EMU_IF_nnn).
bogdanm 0:9b334a45a8ff 331 ******************************************************************************/
bogdanm 0:9b334a45a8ff 332 __STATIC_INLINE uint32_t EMU_IntGet(void)
bogdanm 0:9b334a45a8ff 333 {
bogdanm 0:9b334a45a8ff 334 return EMU->IF;
bogdanm 0:9b334a45a8ff 335 }
bogdanm 0:9b334a45a8ff 336
bogdanm 0:9b334a45a8ff 337
bogdanm 0:9b334a45a8ff 338 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 339 * @brief
bogdanm 0:9b334a45a8ff 340 * Get enabled and pending EMU interrupt flags.
bogdanm 0:9b334a45a8ff 341 * Useful for handling more interrupt sources in the same interrupt handler.
bogdanm 0:9b334a45a8ff 342 *
bogdanm 0:9b334a45a8ff 343 * @note
bogdanm 0:9b334a45a8ff 344 * Interrupt flags are not cleared by the use of this function.
bogdanm 0:9b334a45a8ff 345 *
bogdanm 0:9b334a45a8ff 346 * @return
bogdanm 0:9b334a45a8ff 347 * Pending and enabled EMU interrupt sources
bogdanm 0:9b334a45a8ff 348 * The return value is the bitwise AND of
bogdanm 0:9b334a45a8ff 349 * - the enabled interrupt sources in EMU_IEN and
bogdanm 0:9b334a45a8ff 350 * - the pending interrupt flags EMU_IF
bogdanm 0:9b334a45a8ff 351 ******************************************************************************/
bogdanm 0:9b334a45a8ff 352 __STATIC_INLINE uint32_t EMU_IntGetEnabled(void)
bogdanm 0:9b334a45a8ff 353 {
bogdanm 0:9b334a45a8ff 354 uint32_t ien;
bogdanm 0:9b334a45a8ff 355
bogdanm 0:9b334a45a8ff 356 ien = EMU->IEN;
bogdanm 0:9b334a45a8ff 357 return EMU->IF & ien;
bogdanm 0:9b334a45a8ff 358 }
bogdanm 0:9b334a45a8ff 359
bogdanm 0:9b334a45a8ff 360
bogdanm 0:9b334a45a8ff 361 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 362 * @brief
bogdanm 0:9b334a45a8ff 363 * Set one or more pending EMU interrupts
bogdanm 0:9b334a45a8ff 364 *
bogdanm 0:9b334a45a8ff 365 * @param[in] flags
bogdanm 0:9b334a45a8ff 366 * EMU interrupt sources to set to pending. Use one or more valid
bogdanm 0:9b334a45a8ff 367 * interrupt flags for the EMU module (EMU_IFS_nnn).
bogdanm 0:9b334a45a8ff 368 ******************************************************************************/
bogdanm 0:9b334a45a8ff 369 __STATIC_INLINE void EMU_IntSet(uint32_t flags)
bogdanm 0:9b334a45a8ff 370 {
bogdanm 0:9b334a45a8ff 371 EMU->IFS = flags;
bogdanm 0:9b334a45a8ff 372 }
bogdanm 0:9b334a45a8ff 373 #endif /* _EMU_IF_MASK */
bogdanm 0:9b334a45a8ff 374
bogdanm 0:9b334a45a8ff 375
bogdanm 0:9b334a45a8ff 376 #if defined( _EMU_EM4CONF_LOCKCONF_MASK )
bogdanm 0:9b334a45a8ff 377 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 378 * @brief
bogdanm 0:9b334a45a8ff 379 * Enable or disable EM4 lock configuration
bogdanm 0:9b334a45a8ff 380 * @param[in] enable
bogdanm 0:9b334a45a8ff 381 * If true, locks down EM4 configuration
bogdanm 0:9b334a45a8ff 382 ******************************************************************************/
bogdanm 0:9b334a45a8ff 383 __STATIC_INLINE void EMU_EM4Lock(bool enable)
bogdanm 0:9b334a45a8ff 384 {
bogdanm 0:9b334a45a8ff 385 BITBAND_Peripheral(&(EMU->EM4CONF), _EMU_EM4CONF_LOCKCONF_SHIFT, enable);
bogdanm 0:9b334a45a8ff 386 }
bogdanm 0:9b334a45a8ff 387 #endif
bogdanm 0:9b334a45a8ff 388
bogdanm 0:9b334a45a8ff 389
bogdanm 0:9b334a45a8ff 390 #if defined( _EMU_STATUS_BURDY_MASK )
bogdanm 0:9b334a45a8ff 391 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 392 * @brief
bogdanm 0:9b334a45a8ff 393 * Halts until backup power functionality is ready
bogdanm 0:9b334a45a8ff 394 ******************************************************************************/
bogdanm 0:9b334a45a8ff 395 __STATIC_INLINE void EMU_BUReady(void)
bogdanm 0:9b334a45a8ff 396 {
bogdanm 0:9b334a45a8ff 397 while(!(EMU->STATUS & EMU_STATUS_BURDY));
bogdanm 0:9b334a45a8ff 398 }
bogdanm 0:9b334a45a8ff 399 #endif
bogdanm 0:9b334a45a8ff 400
bogdanm 0:9b334a45a8ff 401
bogdanm 0:9b334a45a8ff 402 #if defined( _EMU_ROUTE_BUVINPEN_MASK )
bogdanm 0:9b334a45a8ff 403 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 404 * @brief
bogdanm 0:9b334a45a8ff 405 * Disable BU_VIN support
bogdanm 0:9b334a45a8ff 406 * @param[in] enable
bogdanm 0:9b334a45a8ff 407 * If true, enables BU_VIN input pin support, if false disables it
bogdanm 0:9b334a45a8ff 408 ******************************************************************************/
bogdanm 0:9b334a45a8ff 409 __STATIC_INLINE void EMU_BUPinEnable(bool enable)
bogdanm 0:9b334a45a8ff 410 {
bogdanm 0:9b334a45a8ff 411 BITBAND_Peripheral(&(EMU->ROUTE), _EMU_ROUTE_BUVINPEN_SHIFT, enable);
bogdanm 0:9b334a45a8ff 412 }
bogdanm 0:9b334a45a8ff 413 #endif
bogdanm 0:9b334a45a8ff 414
bogdanm 0:9b334a45a8ff 415
bogdanm 0:9b334a45a8ff 416 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 417 * @brief
bogdanm 0:9b334a45a8ff 418 * Lock the EMU in order to protect all its registers against unintended
bogdanm 0:9b334a45a8ff 419 * modification.
bogdanm 0:9b334a45a8ff 420 *
bogdanm 0:9b334a45a8ff 421 * @note
bogdanm 0:9b334a45a8ff 422 * If locking the EMU registers, they must be unlocked prior to using any
bogdanm 0:9b334a45a8ff 423 * EMU API functions modifying EMU registers. An exception to this is the
bogdanm 0:9b334a45a8ff 424 * energy mode entering API (EMU_EnterEMn()), which can be used when the
bogdanm 0:9b334a45a8ff 425 * EMU registers are locked.
bogdanm 0:9b334a45a8ff 426 ******************************************************************************/
bogdanm 0:9b334a45a8ff 427 __STATIC_INLINE void EMU_Lock(void)
bogdanm 0:9b334a45a8ff 428 {
bogdanm 0:9b334a45a8ff 429 EMU->LOCK = EMU_LOCK_LOCKKEY_LOCK;
bogdanm 0:9b334a45a8ff 430 }
bogdanm 0:9b334a45a8ff 431
bogdanm 0:9b334a45a8ff 432
bogdanm 0:9b334a45a8ff 433 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 434 * @brief
bogdanm 0:9b334a45a8ff 435 * Unlock the EMU so that writing to locked registers again is possible.
bogdanm 0:9b334a45a8ff 436 ******************************************************************************/
bogdanm 0:9b334a45a8ff 437 __STATIC_INLINE void EMU_Unlock(void)
bogdanm 0:9b334a45a8ff 438 {
bogdanm 0:9b334a45a8ff 439 EMU->LOCK = EMU_LOCK_LOCKKEY_UNLOCK;
bogdanm 0:9b334a45a8ff 440 }
bogdanm 0:9b334a45a8ff 441
bogdanm 0:9b334a45a8ff 442 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 443 * @brief
bogdanm 0:9b334a45a8ff 444 * Block entering EM2 or higher number energy modes.
bogdanm 0:9b334a45a8ff 445 ******************************************************************************/
bogdanm 0:9b334a45a8ff 446 __STATIC_INLINE void EMU_EM2Block(void)
bogdanm 0:9b334a45a8ff 447 {
bogdanm 0:9b334a45a8ff 448 BITBAND_Peripheral(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 1U);
bogdanm 0:9b334a45a8ff 449 }
bogdanm 0:9b334a45a8ff 450
bogdanm 0:9b334a45a8ff 451
bogdanm 0:9b334a45a8ff 452 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 453 * @brief
bogdanm 0:9b334a45a8ff 454 * Unblock entering EM2 or higher number energy modes.
bogdanm 0:9b334a45a8ff 455 ******************************************************************************/
bogdanm 0:9b334a45a8ff 456 __STATIC_INLINE void EMU_EM2UnBlock(void)
bogdanm 0:9b334a45a8ff 457 {
bogdanm 0:9b334a45a8ff 458 BITBAND_Peripheral(&(EMU->CTRL), _EMU_CTRL_EM2BLOCK_SHIFT, 0U);
bogdanm 0:9b334a45a8ff 459 }
bogdanm 0:9b334a45a8ff 460
bogdanm 0:9b334a45a8ff 461
bogdanm 0:9b334a45a8ff 462 /** @} (end addtogroup EMU) */
bogdanm 0:9b334a45a8ff 463 /** @} (end addtogroup EM_Library) */
bogdanm 0:9b334a45a8ff 464
bogdanm 0:9b334a45a8ff 465 #ifdef __cplusplus
bogdanm 0:9b334a45a8ff 466 }
bogdanm 0:9b334a45a8ff 467 #endif
bogdanm 0:9b334a45a8ff 468
bogdanm 0:9b334a45a8ff 469 #endif /* defined( EMU_PRESENT ) */
bogdanm 0:9b334a45a8ff 470 #endif /* __EM_EMU_H */