added prescaler for 16 bit pwm in LPC1347 target
Fork of mbed-dev by
targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_letimer.c@0:9b334a45a8ff, 2015-10-01 (annotated)
- Committer:
- bogdanm
- Date:
- Thu Oct 01 15:25:22 2015 +0300
- Revision:
- 0:9b334a45a8ff
- Child:
- 50:a417edff4437
Initial commit on mbed-dev
Replaces mbed-src (now inactive)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
bogdanm | 0:9b334a45a8ff | 1 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 2 | * @file em_letimer.c |
bogdanm | 0:9b334a45a8ff | 3 | * @brief Low Energy Timer (LETIMER) 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 | #include "em_letimer.h" |
bogdanm | 0:9b334a45a8ff | 35 | #if defined(LETIMER_COUNT) && (LETIMER_COUNT > 0) |
bogdanm | 0:9b334a45a8ff | 36 | #include "em_cmu.h" |
bogdanm | 0:9b334a45a8ff | 37 | #include "em_assert.h" |
bogdanm | 0:9b334a45a8ff | 38 | |
bogdanm | 0:9b334a45a8ff | 39 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 40 | * @addtogroup EM_Library |
bogdanm | 0:9b334a45a8ff | 41 | * @{ |
bogdanm | 0:9b334a45a8ff | 42 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 43 | |
bogdanm | 0:9b334a45a8ff | 44 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 45 | * @addtogroup LETIMER |
bogdanm | 0:9b334a45a8ff | 46 | * @brief Low Energy Timer (LETIMER) Peripheral API |
bogdanm | 0:9b334a45a8ff | 47 | * @{ |
bogdanm | 0:9b334a45a8ff | 48 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 49 | |
bogdanm | 0:9b334a45a8ff | 50 | /******************************************************************************* |
bogdanm | 0:9b334a45a8ff | 51 | ******************************* DEFINES *********************************** |
bogdanm | 0:9b334a45a8ff | 52 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 53 | |
bogdanm | 0:9b334a45a8ff | 54 | /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
bogdanm | 0:9b334a45a8ff | 55 | |
bogdanm | 0:9b334a45a8ff | 56 | /** Validation of valid comparator register for assert statements. */ |
bogdanm | 0:9b334a45a8ff | 57 | #define LETIMER_COMP_REG_VALID(reg) (((reg) <= 1)) |
bogdanm | 0:9b334a45a8ff | 58 | |
bogdanm | 0:9b334a45a8ff | 59 | /** Validation of LETIMER register block pointer reference for assert statements. */ |
bogdanm | 0:9b334a45a8ff | 60 | #define LETIMER_REF_VALID(ref) ((ref) == LETIMER0) |
bogdanm | 0:9b334a45a8ff | 61 | |
bogdanm | 0:9b334a45a8ff | 62 | /** Validation of valid repeat counter register for assert statements. */ |
bogdanm | 0:9b334a45a8ff | 63 | #define LETIMER_REP_REG_VALID(reg) (((reg) <= 1)) |
bogdanm | 0:9b334a45a8ff | 64 | |
bogdanm | 0:9b334a45a8ff | 65 | /** @endcond */ |
bogdanm | 0:9b334a45a8ff | 66 | |
bogdanm | 0:9b334a45a8ff | 67 | |
bogdanm | 0:9b334a45a8ff | 68 | /******************************************************************************* |
bogdanm | 0:9b334a45a8ff | 69 | ************************** LOCAL FUNCTIONS ******************************** |
bogdanm | 0:9b334a45a8ff | 70 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 71 | |
bogdanm | 0:9b334a45a8ff | 72 | /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */ |
bogdanm | 0:9b334a45a8ff | 73 | |
bogdanm | 0:9b334a45a8ff | 74 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 75 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 76 | * @brief |
bogdanm | 0:9b334a45a8ff | 77 | * Wait for ongoing sync of register(s) to low frequency domain to complete. |
bogdanm | 0:9b334a45a8ff | 78 | * |
bogdanm | 0:9b334a45a8ff | 79 | * @note |
bogdanm | 0:9b334a45a8ff | 80 | * This only applies to the Gecko Family, see the reference manual |
bogdanm | 0:9b334a45a8ff | 81 | * chapter about Access to Low Energy Peripherals (Asynchronos Registers) |
bogdanm | 0:9b334a45a8ff | 82 | * for details. |
bogdanm | 0:9b334a45a8ff | 83 | * |
bogdanm | 0:9b334a45a8ff | 84 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 85 | * Pointer to LETIMER peripheral register block |
bogdanm | 0:9b334a45a8ff | 86 | * |
bogdanm | 0:9b334a45a8ff | 87 | * @param[in] mask |
bogdanm | 0:9b334a45a8ff | 88 | * Bitmask corresponding to SYNCBUSY register defined bits, indicating |
bogdanm | 0:9b334a45a8ff | 89 | * registers that must complete any ongoing synchronization. |
bogdanm | 0:9b334a45a8ff | 90 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 91 | __STATIC_INLINE void LETIMER_Sync(LETIMER_TypeDef *letimer, uint32_t mask) |
bogdanm | 0:9b334a45a8ff | 92 | { |
bogdanm | 0:9b334a45a8ff | 93 | /* Avoid deadlock if modifying the same register twice when freeze mode is */ |
bogdanm | 0:9b334a45a8ff | 94 | /* activated. */ |
bogdanm | 0:9b334a45a8ff | 95 | if (letimer->FREEZE & LETIMER_FREEZE_REGFREEZE) |
bogdanm | 0:9b334a45a8ff | 96 | return; |
bogdanm | 0:9b334a45a8ff | 97 | |
bogdanm | 0:9b334a45a8ff | 98 | /* Wait for any pending previous write operation to have been completed */ |
bogdanm | 0:9b334a45a8ff | 99 | /* in low frequency domain, only required for Gecko Family of devices */ |
bogdanm | 0:9b334a45a8ff | 100 | while (letimer->SYNCBUSY & mask) |
bogdanm | 0:9b334a45a8ff | 101 | ; |
bogdanm | 0:9b334a45a8ff | 102 | } |
bogdanm | 0:9b334a45a8ff | 103 | #endif |
bogdanm | 0:9b334a45a8ff | 104 | |
bogdanm | 0:9b334a45a8ff | 105 | /** @endcond */ |
bogdanm | 0:9b334a45a8ff | 106 | |
bogdanm | 0:9b334a45a8ff | 107 | /******************************************************************************* |
bogdanm | 0:9b334a45a8ff | 108 | ************************** GLOBAL FUNCTIONS ******************************* |
bogdanm | 0:9b334a45a8ff | 109 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 110 | |
bogdanm | 0:9b334a45a8ff | 111 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 112 | * @brief |
bogdanm | 0:9b334a45a8ff | 113 | * Get LETIMER compare register value. |
bogdanm | 0:9b334a45a8ff | 114 | * |
bogdanm | 0:9b334a45a8ff | 115 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 116 | * Pointer to LETIMER peripheral register block |
bogdanm | 0:9b334a45a8ff | 117 | * |
bogdanm | 0:9b334a45a8ff | 118 | * @param[in] comp |
bogdanm | 0:9b334a45a8ff | 119 | * Compare register to get, either 0 or 1 |
bogdanm | 0:9b334a45a8ff | 120 | * |
bogdanm | 0:9b334a45a8ff | 121 | * @return |
bogdanm | 0:9b334a45a8ff | 122 | * Compare register value, 0 if invalid register selected. |
bogdanm | 0:9b334a45a8ff | 123 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 124 | uint32_t LETIMER_CompareGet(LETIMER_TypeDef *letimer, unsigned int comp) |
bogdanm | 0:9b334a45a8ff | 125 | { |
bogdanm | 0:9b334a45a8ff | 126 | uint32_t ret; |
bogdanm | 0:9b334a45a8ff | 127 | |
bogdanm | 0:9b334a45a8ff | 128 | EFM_ASSERT(LETIMER_REF_VALID(letimer) && LETIMER_COMP_REG_VALID(comp)); |
bogdanm | 0:9b334a45a8ff | 129 | |
bogdanm | 0:9b334a45a8ff | 130 | /* Initialize selected compare value */ |
bogdanm | 0:9b334a45a8ff | 131 | switch (comp) |
bogdanm | 0:9b334a45a8ff | 132 | { |
bogdanm | 0:9b334a45a8ff | 133 | case 0: |
bogdanm | 0:9b334a45a8ff | 134 | ret = letimer->COMP0; |
bogdanm | 0:9b334a45a8ff | 135 | break; |
bogdanm | 0:9b334a45a8ff | 136 | |
bogdanm | 0:9b334a45a8ff | 137 | case 1: |
bogdanm | 0:9b334a45a8ff | 138 | ret = letimer->COMP1; |
bogdanm | 0:9b334a45a8ff | 139 | break; |
bogdanm | 0:9b334a45a8ff | 140 | |
bogdanm | 0:9b334a45a8ff | 141 | default: |
bogdanm | 0:9b334a45a8ff | 142 | /* Unknown compare register selected */ |
bogdanm | 0:9b334a45a8ff | 143 | ret = 0; |
bogdanm | 0:9b334a45a8ff | 144 | break; |
bogdanm | 0:9b334a45a8ff | 145 | } |
bogdanm | 0:9b334a45a8ff | 146 | |
bogdanm | 0:9b334a45a8ff | 147 | return(ret); |
bogdanm | 0:9b334a45a8ff | 148 | } |
bogdanm | 0:9b334a45a8ff | 149 | |
bogdanm | 0:9b334a45a8ff | 150 | |
bogdanm | 0:9b334a45a8ff | 151 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 152 | * @brief |
bogdanm | 0:9b334a45a8ff | 153 | * Set LETIMER compare register value. |
bogdanm | 0:9b334a45a8ff | 154 | * |
bogdanm | 0:9b334a45a8ff | 155 | * @note |
bogdanm | 0:9b334a45a8ff | 156 | * The setting of a compare register requires synchronization into the |
bogdanm | 0:9b334a45a8ff | 157 | * low frequency domain. If the same register is modified before a previous |
bogdanm | 0:9b334a45a8ff | 158 | * update has completed, this function will stall until the previous |
bogdanm | 0:9b334a45a8ff | 159 | * synchronization has completed. This only applies to the Gecko Family, see |
bogdanm | 0:9b334a45a8ff | 160 | * comment in the LETIMER_Sync() internal function call. |
bogdanm | 0:9b334a45a8ff | 161 | * |
bogdanm | 0:9b334a45a8ff | 162 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 163 | * Pointer to LETIMER peripheral register block |
bogdanm | 0:9b334a45a8ff | 164 | * |
bogdanm | 0:9b334a45a8ff | 165 | * @param[in] comp |
bogdanm | 0:9b334a45a8ff | 166 | * Compare register to set, either 0 or 1 |
bogdanm | 0:9b334a45a8ff | 167 | * |
bogdanm | 0:9b334a45a8ff | 168 | * @param[in] value |
bogdanm | 0:9b334a45a8ff | 169 | * Initialization value (<= 0x0000ffff) |
bogdanm | 0:9b334a45a8ff | 170 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 171 | void LETIMER_CompareSet(LETIMER_TypeDef *letimer, |
bogdanm | 0:9b334a45a8ff | 172 | unsigned int comp, |
bogdanm | 0:9b334a45a8ff | 173 | uint32_t value) |
bogdanm | 0:9b334a45a8ff | 174 | { |
bogdanm | 0:9b334a45a8ff | 175 | volatile uint32_t *compReg; |
bogdanm | 0:9b334a45a8ff | 176 | |
bogdanm | 0:9b334a45a8ff | 177 | EFM_ASSERT(LETIMER_REF_VALID(letimer) && |
bogdanm | 0:9b334a45a8ff | 178 | LETIMER_COMP_REG_VALID(comp) && |
bogdanm | 0:9b334a45a8ff | 179 | ((value & ~(_LETIMER_COMP0_COMP0_MASK >> _LETIMER_COMP0_COMP0_SHIFT)) == 0)); |
bogdanm | 0:9b334a45a8ff | 180 | |
bogdanm | 0:9b334a45a8ff | 181 | /* Initialize selected compare value */ |
bogdanm | 0:9b334a45a8ff | 182 | switch (comp) |
bogdanm | 0:9b334a45a8ff | 183 | { |
bogdanm | 0:9b334a45a8ff | 184 | case 0: |
bogdanm | 0:9b334a45a8ff | 185 | compReg = &(letimer->COMP0); |
bogdanm | 0:9b334a45a8ff | 186 | break; |
bogdanm | 0:9b334a45a8ff | 187 | |
bogdanm | 0:9b334a45a8ff | 188 | case 1: |
bogdanm | 0:9b334a45a8ff | 189 | compReg = &(letimer->COMP1); |
bogdanm | 0:9b334a45a8ff | 190 | break; |
bogdanm | 0:9b334a45a8ff | 191 | |
bogdanm | 0:9b334a45a8ff | 192 | default: |
bogdanm | 0:9b334a45a8ff | 193 | /* Unknown compare register selected, abort */ |
bogdanm | 0:9b334a45a8ff | 194 | return; |
bogdanm | 0:9b334a45a8ff | 195 | } |
bogdanm | 0:9b334a45a8ff | 196 | |
bogdanm | 0:9b334a45a8ff | 197 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 198 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 199 | LETIMER_Sync(letimer, comp ? LETIMER_SYNCBUSY_COMP1 : LETIMER_SYNCBUSY_COMP0); |
bogdanm | 0:9b334a45a8ff | 200 | #endif |
bogdanm | 0:9b334a45a8ff | 201 | |
bogdanm | 0:9b334a45a8ff | 202 | *compReg = value; |
bogdanm | 0:9b334a45a8ff | 203 | } |
bogdanm | 0:9b334a45a8ff | 204 | |
bogdanm | 0:9b334a45a8ff | 205 | |
bogdanm | 0:9b334a45a8ff | 206 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 207 | * @brief |
bogdanm | 0:9b334a45a8ff | 208 | * Start/stop LETIMER. |
bogdanm | 0:9b334a45a8ff | 209 | * |
bogdanm | 0:9b334a45a8ff | 210 | * @note |
bogdanm | 0:9b334a45a8ff | 211 | * The enabling/disabling of the LETIMER modifies the LETIMER CMD register |
bogdanm | 0:9b334a45a8ff | 212 | * which requires synchronization into the low frequency domain. If this |
bogdanm | 0:9b334a45a8ff | 213 | * register is modified before a previous update to the same register has |
bogdanm | 0:9b334a45a8ff | 214 | * completed, this function will stall until the previous synchronization has |
bogdanm | 0:9b334a45a8ff | 215 | * completed. This only applies to the Gecko Family, see comment in the |
bogdanm | 0:9b334a45a8ff | 216 | * LETIMER_Sync() internal function call. |
bogdanm | 0:9b334a45a8ff | 217 | * |
bogdanm | 0:9b334a45a8ff | 218 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 219 | * Pointer to LETIMER peripheral register block. |
bogdanm | 0:9b334a45a8ff | 220 | * |
bogdanm | 0:9b334a45a8ff | 221 | * @param[in] enable |
bogdanm | 0:9b334a45a8ff | 222 | * true to enable counting, false to disable. |
bogdanm | 0:9b334a45a8ff | 223 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 224 | void LETIMER_Enable(LETIMER_TypeDef *letimer, bool enable) |
bogdanm | 0:9b334a45a8ff | 225 | { |
bogdanm | 0:9b334a45a8ff | 226 | EFM_ASSERT(LETIMER_REF_VALID(letimer)); |
bogdanm | 0:9b334a45a8ff | 227 | |
bogdanm | 0:9b334a45a8ff | 228 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 229 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 230 | LETIMER_Sync(letimer, LETIMER_SYNCBUSY_CMD); |
bogdanm | 0:9b334a45a8ff | 231 | #endif |
bogdanm | 0:9b334a45a8ff | 232 | |
bogdanm | 0:9b334a45a8ff | 233 | if (enable) |
bogdanm | 0:9b334a45a8ff | 234 | { |
bogdanm | 0:9b334a45a8ff | 235 | letimer->CMD = LETIMER_CMD_START; |
bogdanm | 0:9b334a45a8ff | 236 | } |
bogdanm | 0:9b334a45a8ff | 237 | else |
bogdanm | 0:9b334a45a8ff | 238 | { |
bogdanm | 0:9b334a45a8ff | 239 | letimer->CMD = LETIMER_CMD_STOP; |
bogdanm | 0:9b334a45a8ff | 240 | } |
bogdanm | 0:9b334a45a8ff | 241 | } |
bogdanm | 0:9b334a45a8ff | 242 | |
bogdanm | 0:9b334a45a8ff | 243 | |
bogdanm | 0:9b334a45a8ff | 244 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 245 | * @brief |
bogdanm | 0:9b334a45a8ff | 246 | * LETIMER register synchronization freeze control. |
bogdanm | 0:9b334a45a8ff | 247 | * |
bogdanm | 0:9b334a45a8ff | 248 | * @details |
bogdanm | 0:9b334a45a8ff | 249 | * Some LETIMER registers require synchronization into the low frequency (LF) |
bogdanm | 0:9b334a45a8ff | 250 | * domain. The freeze feature allows for several such registers to be |
bogdanm | 0:9b334a45a8ff | 251 | * modified before passing them to the LF domain simultaneously (which |
bogdanm | 0:9b334a45a8ff | 252 | * takes place when the freeze mode is disabled). |
bogdanm | 0:9b334a45a8ff | 253 | * |
bogdanm | 0:9b334a45a8ff | 254 | * @note |
bogdanm | 0:9b334a45a8ff | 255 | * When enabling freeze mode, this function will wait for all current |
bogdanm | 0:9b334a45a8ff | 256 | * ongoing LETIMER synchronization to LF domain to complete (Normally |
bogdanm | 0:9b334a45a8ff | 257 | * synchronization will not be in progress.) However for this reason, when |
bogdanm | 0:9b334a45a8ff | 258 | * using freeze mode, modifications of registers requiring LF synchronization |
bogdanm | 0:9b334a45a8ff | 259 | * should be done within one freeze enable/disable block to avoid unecessary |
bogdanm | 0:9b334a45a8ff | 260 | * stalling. |
bogdanm | 0:9b334a45a8ff | 261 | * |
bogdanm | 0:9b334a45a8ff | 262 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 263 | * Pointer to LETIMER peripheral register block. |
bogdanm | 0:9b334a45a8ff | 264 | * |
bogdanm | 0:9b334a45a8ff | 265 | * @param[in] enable |
bogdanm | 0:9b334a45a8ff | 266 | * @li true - enable freeze, modified registers are not propagated to the |
bogdanm | 0:9b334a45a8ff | 267 | * LF domain |
bogdanm | 0:9b334a45a8ff | 268 | * @li false - disables freeze, modified registers are propagated to LF |
bogdanm | 0:9b334a45a8ff | 269 | * domain |
bogdanm | 0:9b334a45a8ff | 270 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 271 | void LETIMER_FreezeEnable(LETIMER_TypeDef *letimer, bool enable) |
bogdanm | 0:9b334a45a8ff | 272 | { |
bogdanm | 0:9b334a45a8ff | 273 | if (enable) |
bogdanm | 0:9b334a45a8ff | 274 | { |
bogdanm | 0:9b334a45a8ff | 275 | /* |
bogdanm | 0:9b334a45a8ff | 276 | * Wait for any ongoing LF synchronization to complete. This is just to |
bogdanm | 0:9b334a45a8ff | 277 | * protect against the rare case when a user |
bogdanm | 0:9b334a45a8ff | 278 | * - modifies a register requiring LF sync |
bogdanm | 0:9b334a45a8ff | 279 | * - then enables freeze before LF sync completed |
bogdanm | 0:9b334a45a8ff | 280 | * - then modifies the same register again |
bogdanm | 0:9b334a45a8ff | 281 | * since modifying a register while it is in sync progress should be |
bogdanm | 0:9b334a45a8ff | 282 | * avoided. |
bogdanm | 0:9b334a45a8ff | 283 | */ |
bogdanm | 0:9b334a45a8ff | 284 | while (letimer->SYNCBUSY) |
bogdanm | 0:9b334a45a8ff | 285 | ; |
bogdanm | 0:9b334a45a8ff | 286 | |
bogdanm | 0:9b334a45a8ff | 287 | letimer->FREEZE = LETIMER_FREEZE_REGFREEZE; |
bogdanm | 0:9b334a45a8ff | 288 | } |
bogdanm | 0:9b334a45a8ff | 289 | else |
bogdanm | 0:9b334a45a8ff | 290 | { |
bogdanm | 0:9b334a45a8ff | 291 | letimer->FREEZE = 0; |
bogdanm | 0:9b334a45a8ff | 292 | } |
bogdanm | 0:9b334a45a8ff | 293 | } |
bogdanm | 0:9b334a45a8ff | 294 | |
bogdanm | 0:9b334a45a8ff | 295 | |
bogdanm | 0:9b334a45a8ff | 296 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 297 | * @brief |
bogdanm | 0:9b334a45a8ff | 298 | * Initialize LETIMER. |
bogdanm | 0:9b334a45a8ff | 299 | * |
bogdanm | 0:9b334a45a8ff | 300 | * @details |
bogdanm | 0:9b334a45a8ff | 301 | * Note that the compare/repeat values must be set separately with |
bogdanm | 0:9b334a45a8ff | 302 | * LETIMER_CompareSet() and LETIMER_RepeatSet(). That should probably be done |
bogdanm | 0:9b334a45a8ff | 303 | * prior to the use of this function if configuring the LETIMER to start when |
bogdanm | 0:9b334a45a8ff | 304 | * initialization is completed. |
bogdanm | 0:9b334a45a8ff | 305 | * |
bogdanm | 0:9b334a45a8ff | 306 | * @note |
bogdanm | 0:9b334a45a8ff | 307 | * The initialization of the LETIMER modifies the LETIMER CTRL/CMD registers |
bogdanm | 0:9b334a45a8ff | 308 | * which require synchronization into the low frequency domain. If any of those |
bogdanm | 0:9b334a45a8ff | 309 | * registers are modified before a previous update to the same register has |
bogdanm | 0:9b334a45a8ff | 310 | * completed, this function will stall until the previous synchronization has |
bogdanm | 0:9b334a45a8ff | 311 | * completed. This only applies to the Gecko Family, see comment in the |
bogdanm | 0:9b334a45a8ff | 312 | * LETIMER_Sync() internal function call. |
bogdanm | 0:9b334a45a8ff | 313 | * |
bogdanm | 0:9b334a45a8ff | 314 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 315 | * Pointer to LETIMER peripheral register block. |
bogdanm | 0:9b334a45a8ff | 316 | * |
bogdanm | 0:9b334a45a8ff | 317 | * @param[in] init |
bogdanm | 0:9b334a45a8ff | 318 | * Pointer to LETIMER initialization structure. |
bogdanm | 0:9b334a45a8ff | 319 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 320 | void LETIMER_Init(LETIMER_TypeDef *letimer, const LETIMER_Init_TypeDef *init) |
bogdanm | 0:9b334a45a8ff | 321 | { |
bogdanm | 0:9b334a45a8ff | 322 | uint32_t tmp = 0; |
bogdanm | 0:9b334a45a8ff | 323 | |
bogdanm | 0:9b334a45a8ff | 324 | EFM_ASSERT(LETIMER_REF_VALID(letimer)); |
bogdanm | 0:9b334a45a8ff | 325 | |
bogdanm | 0:9b334a45a8ff | 326 | /* Stop timer if specified to be disabled and running */ |
bogdanm | 0:9b334a45a8ff | 327 | if (!(init->enable) && (letimer->STATUS & LETIMER_STATUS_RUNNING)) |
bogdanm | 0:9b334a45a8ff | 328 | { |
bogdanm | 0:9b334a45a8ff | 329 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 330 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 331 | LETIMER_Sync(letimer, LETIMER_SYNCBUSY_CMD); |
bogdanm | 0:9b334a45a8ff | 332 | #endif |
bogdanm | 0:9b334a45a8ff | 333 | letimer->CMD = LETIMER_CMD_STOP; |
bogdanm | 0:9b334a45a8ff | 334 | } |
bogdanm | 0:9b334a45a8ff | 335 | |
bogdanm | 0:9b334a45a8ff | 336 | /* Configure DEBUGRUN flag, sets whether or not counter should be |
bogdanm | 0:9b334a45a8ff | 337 | * updated when debugger is active */ |
bogdanm | 0:9b334a45a8ff | 338 | if (init->debugRun) |
bogdanm | 0:9b334a45a8ff | 339 | { |
bogdanm | 0:9b334a45a8ff | 340 | tmp |= LETIMER_CTRL_DEBUGRUN; |
bogdanm | 0:9b334a45a8ff | 341 | } |
bogdanm | 0:9b334a45a8ff | 342 | |
bogdanm | 0:9b334a45a8ff | 343 | if (init->rtcComp0Enable) |
bogdanm | 0:9b334a45a8ff | 344 | { |
bogdanm | 0:9b334a45a8ff | 345 | tmp |= LETIMER_CTRL_RTCC0TEN; |
bogdanm | 0:9b334a45a8ff | 346 | } |
bogdanm | 0:9b334a45a8ff | 347 | |
bogdanm | 0:9b334a45a8ff | 348 | if (init->rtcComp1Enable) |
bogdanm | 0:9b334a45a8ff | 349 | { |
bogdanm | 0:9b334a45a8ff | 350 | tmp |= LETIMER_CTRL_RTCC1TEN; |
bogdanm | 0:9b334a45a8ff | 351 | } |
bogdanm | 0:9b334a45a8ff | 352 | |
bogdanm | 0:9b334a45a8ff | 353 | if (init->comp0Top) |
bogdanm | 0:9b334a45a8ff | 354 | { |
bogdanm | 0:9b334a45a8ff | 355 | tmp |= LETIMER_CTRL_COMP0TOP; |
bogdanm | 0:9b334a45a8ff | 356 | } |
bogdanm | 0:9b334a45a8ff | 357 | |
bogdanm | 0:9b334a45a8ff | 358 | if (init->bufTop) |
bogdanm | 0:9b334a45a8ff | 359 | { |
bogdanm | 0:9b334a45a8ff | 360 | tmp |= LETIMER_CTRL_BUFTOP; |
bogdanm | 0:9b334a45a8ff | 361 | } |
bogdanm | 0:9b334a45a8ff | 362 | |
bogdanm | 0:9b334a45a8ff | 363 | if (init->out0Pol) |
bogdanm | 0:9b334a45a8ff | 364 | { |
bogdanm | 0:9b334a45a8ff | 365 | tmp |= LETIMER_CTRL_OPOL0; |
bogdanm | 0:9b334a45a8ff | 366 | } |
bogdanm | 0:9b334a45a8ff | 367 | |
bogdanm | 0:9b334a45a8ff | 368 | if (init->out1Pol) |
bogdanm | 0:9b334a45a8ff | 369 | { |
bogdanm | 0:9b334a45a8ff | 370 | tmp |= LETIMER_CTRL_OPOL1; |
bogdanm | 0:9b334a45a8ff | 371 | } |
bogdanm | 0:9b334a45a8ff | 372 | |
bogdanm | 0:9b334a45a8ff | 373 | tmp |= init->ufoa0 << _LETIMER_CTRL_UFOA0_SHIFT; |
bogdanm | 0:9b334a45a8ff | 374 | tmp |= init->ufoa1 << _LETIMER_CTRL_UFOA1_SHIFT; |
bogdanm | 0:9b334a45a8ff | 375 | tmp |= init->repMode << _LETIMER_CTRL_REPMODE_SHIFT; |
bogdanm | 0:9b334a45a8ff | 376 | |
bogdanm | 0:9b334a45a8ff | 377 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 378 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 379 | LETIMER_Sync(letimer, LETIMER_SYNCBUSY_CTRL); |
bogdanm | 0:9b334a45a8ff | 380 | #endif |
bogdanm | 0:9b334a45a8ff | 381 | letimer->CTRL = tmp; |
bogdanm | 0:9b334a45a8ff | 382 | |
bogdanm | 0:9b334a45a8ff | 383 | /* Start timer if specified to be enabled and not already running */ |
bogdanm | 0:9b334a45a8ff | 384 | if (init->enable && !(letimer->STATUS & LETIMER_STATUS_RUNNING)) |
bogdanm | 0:9b334a45a8ff | 385 | { |
bogdanm | 0:9b334a45a8ff | 386 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 387 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 388 | LETIMER_Sync(letimer, LETIMER_SYNCBUSY_CMD); |
bogdanm | 0:9b334a45a8ff | 389 | #endif |
bogdanm | 0:9b334a45a8ff | 390 | letimer->CMD = LETIMER_CMD_START; |
bogdanm | 0:9b334a45a8ff | 391 | } |
bogdanm | 0:9b334a45a8ff | 392 | } |
bogdanm | 0:9b334a45a8ff | 393 | |
bogdanm | 0:9b334a45a8ff | 394 | |
bogdanm | 0:9b334a45a8ff | 395 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 396 | * @brief |
bogdanm | 0:9b334a45a8ff | 397 | * Get LETIMER repeat register value. |
bogdanm | 0:9b334a45a8ff | 398 | * |
bogdanm | 0:9b334a45a8ff | 399 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 400 | * Pointer to LETIMER peripheral register block |
bogdanm | 0:9b334a45a8ff | 401 | * |
bogdanm | 0:9b334a45a8ff | 402 | * @param[in] rep |
bogdanm | 0:9b334a45a8ff | 403 | * Repeat register to get, either 0 or 1 |
bogdanm | 0:9b334a45a8ff | 404 | * |
bogdanm | 0:9b334a45a8ff | 405 | * @return |
bogdanm | 0:9b334a45a8ff | 406 | * Repeat register value, 0 if invalid register selected. |
bogdanm | 0:9b334a45a8ff | 407 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 408 | uint32_t LETIMER_RepeatGet(LETIMER_TypeDef *letimer, unsigned int rep) |
bogdanm | 0:9b334a45a8ff | 409 | { |
bogdanm | 0:9b334a45a8ff | 410 | uint32_t ret; |
bogdanm | 0:9b334a45a8ff | 411 | |
bogdanm | 0:9b334a45a8ff | 412 | EFM_ASSERT(LETIMER_REF_VALID(letimer) && LETIMER_REP_REG_VALID(rep)); |
bogdanm | 0:9b334a45a8ff | 413 | |
bogdanm | 0:9b334a45a8ff | 414 | /* Initialize selected compare value */ |
bogdanm | 0:9b334a45a8ff | 415 | switch (rep) |
bogdanm | 0:9b334a45a8ff | 416 | { |
bogdanm | 0:9b334a45a8ff | 417 | case 0: |
bogdanm | 0:9b334a45a8ff | 418 | ret = letimer->REP0; |
bogdanm | 0:9b334a45a8ff | 419 | break; |
bogdanm | 0:9b334a45a8ff | 420 | |
bogdanm | 0:9b334a45a8ff | 421 | case 1: |
bogdanm | 0:9b334a45a8ff | 422 | ret = letimer->REP1; |
bogdanm | 0:9b334a45a8ff | 423 | break; |
bogdanm | 0:9b334a45a8ff | 424 | |
bogdanm | 0:9b334a45a8ff | 425 | default: |
bogdanm | 0:9b334a45a8ff | 426 | /* Unknown compare register selected */ |
bogdanm | 0:9b334a45a8ff | 427 | ret = 0; |
bogdanm | 0:9b334a45a8ff | 428 | break; |
bogdanm | 0:9b334a45a8ff | 429 | } |
bogdanm | 0:9b334a45a8ff | 430 | |
bogdanm | 0:9b334a45a8ff | 431 | return(ret); |
bogdanm | 0:9b334a45a8ff | 432 | } |
bogdanm | 0:9b334a45a8ff | 433 | |
bogdanm | 0:9b334a45a8ff | 434 | |
bogdanm | 0:9b334a45a8ff | 435 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 436 | * @brief |
bogdanm | 0:9b334a45a8ff | 437 | * Set LETIMER repeat counter register value. |
bogdanm | 0:9b334a45a8ff | 438 | * |
bogdanm | 0:9b334a45a8ff | 439 | * @note |
bogdanm | 0:9b334a45a8ff | 440 | * The setting of a repeat counter register requires synchronization into the |
bogdanm | 0:9b334a45a8ff | 441 | * low frequency domain. If the same register is modified before a previous |
bogdanm | 0:9b334a45a8ff | 442 | * update has completed, this function will stall until the previous |
bogdanm | 0:9b334a45a8ff | 443 | * synchronization has completed. This only applies to the Gecko Family, see |
bogdanm | 0:9b334a45a8ff | 444 | * comment in the LETIMER_Sync() internal function call. |
bogdanm | 0:9b334a45a8ff | 445 | * |
bogdanm | 0:9b334a45a8ff | 446 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 447 | * Pointer to LETIMER peripheral register block |
bogdanm | 0:9b334a45a8ff | 448 | * |
bogdanm | 0:9b334a45a8ff | 449 | * @param[in] rep |
bogdanm | 0:9b334a45a8ff | 450 | * Repeat counter register to set, either 0 or 1 |
bogdanm | 0:9b334a45a8ff | 451 | * |
bogdanm | 0:9b334a45a8ff | 452 | * @param[in] value |
bogdanm | 0:9b334a45a8ff | 453 | * Initialization value (<= 0x0000ffff) |
bogdanm | 0:9b334a45a8ff | 454 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 455 | void LETIMER_RepeatSet(LETIMER_TypeDef *letimer, |
bogdanm | 0:9b334a45a8ff | 456 | unsigned int rep, |
bogdanm | 0:9b334a45a8ff | 457 | uint32_t value) |
bogdanm | 0:9b334a45a8ff | 458 | { |
bogdanm | 0:9b334a45a8ff | 459 | volatile uint32_t *repReg; |
bogdanm | 0:9b334a45a8ff | 460 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 461 | uint32_t syncbusy; |
bogdanm | 0:9b334a45a8ff | 462 | #endif |
bogdanm | 0:9b334a45a8ff | 463 | EFM_ASSERT(LETIMER_REF_VALID(letimer) && |
bogdanm | 0:9b334a45a8ff | 464 | LETIMER_REP_REG_VALID(rep) && |
bogdanm | 0:9b334a45a8ff | 465 | ((value & ~(_LETIMER_REP0_REP0_MASK >> _LETIMER_REP0_REP0_SHIFT)) == 0)); |
bogdanm | 0:9b334a45a8ff | 466 | |
bogdanm | 0:9b334a45a8ff | 467 | /* Initialize selected compare value */ |
bogdanm | 0:9b334a45a8ff | 468 | switch (rep) |
bogdanm | 0:9b334a45a8ff | 469 | { |
bogdanm | 0:9b334a45a8ff | 470 | case 0: |
bogdanm | 0:9b334a45a8ff | 471 | repReg = &(letimer->REP0); |
bogdanm | 0:9b334a45a8ff | 472 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 473 | syncbusy = LETIMER_SYNCBUSY_REP0; |
bogdanm | 0:9b334a45a8ff | 474 | #endif |
bogdanm | 0:9b334a45a8ff | 475 | break; |
bogdanm | 0:9b334a45a8ff | 476 | |
bogdanm | 0:9b334a45a8ff | 477 | case 1: |
bogdanm | 0:9b334a45a8ff | 478 | repReg = &(letimer->REP1); |
bogdanm | 0:9b334a45a8ff | 479 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 480 | syncbusy = LETIMER_SYNCBUSY_REP1; |
bogdanm | 0:9b334a45a8ff | 481 | #endif |
bogdanm | 0:9b334a45a8ff | 482 | break; |
bogdanm | 0:9b334a45a8ff | 483 | |
bogdanm | 0:9b334a45a8ff | 484 | default: |
bogdanm | 0:9b334a45a8ff | 485 | /* Unknown compare register selected, abort */ |
bogdanm | 0:9b334a45a8ff | 486 | return; |
bogdanm | 0:9b334a45a8ff | 487 | } |
bogdanm | 0:9b334a45a8ff | 488 | |
bogdanm | 0:9b334a45a8ff | 489 | #if defined(_EFM32_GECKO_FAMILY) |
bogdanm | 0:9b334a45a8ff | 490 | /* LF register about to be modified require sync. busy check */ |
bogdanm | 0:9b334a45a8ff | 491 | LETIMER_Sync(letimer, syncbusy); |
bogdanm | 0:9b334a45a8ff | 492 | #endif |
bogdanm | 0:9b334a45a8ff | 493 | |
bogdanm | 0:9b334a45a8ff | 494 | *repReg = value; |
bogdanm | 0:9b334a45a8ff | 495 | } |
bogdanm | 0:9b334a45a8ff | 496 | |
bogdanm | 0:9b334a45a8ff | 497 | |
bogdanm | 0:9b334a45a8ff | 498 | /***************************************************************************//** |
bogdanm | 0:9b334a45a8ff | 499 | * @brief |
bogdanm | 0:9b334a45a8ff | 500 | * Reset LETIMER to same state as after a HW reset. |
bogdanm | 0:9b334a45a8ff | 501 | * |
bogdanm | 0:9b334a45a8ff | 502 | * @note |
bogdanm | 0:9b334a45a8ff | 503 | * The ROUTE register is NOT reset by this function, in order to allow for |
bogdanm | 0:9b334a45a8ff | 504 | * centralized setup of this feature. |
bogdanm | 0:9b334a45a8ff | 505 | * |
bogdanm | 0:9b334a45a8ff | 506 | * @param[in] letimer |
bogdanm | 0:9b334a45a8ff | 507 | * Pointer to LETIMER peripheral register block. |
bogdanm | 0:9b334a45a8ff | 508 | ******************************************************************************/ |
bogdanm | 0:9b334a45a8ff | 509 | void LETIMER_Reset(LETIMER_TypeDef *letimer) |
bogdanm | 0:9b334a45a8ff | 510 | { |
bogdanm | 0:9b334a45a8ff | 511 | /* Freeze registers to avoid stalling for LF synchronization */ |
bogdanm | 0:9b334a45a8ff | 512 | LETIMER_FreezeEnable(letimer, true); |
bogdanm | 0:9b334a45a8ff | 513 | |
bogdanm | 0:9b334a45a8ff | 514 | /* Make sure disabled first, before resetting other registers */ |
bogdanm | 0:9b334a45a8ff | 515 | letimer->CMD = LETIMER_CMD_STOP | LETIMER_CMD_CLEAR | |
bogdanm | 0:9b334a45a8ff | 516 | LETIMER_CMD_CTO0 | LETIMER_CMD_CTO1; |
bogdanm | 0:9b334a45a8ff | 517 | letimer->CTRL = _LETIMER_CTRL_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 518 | letimer->COMP0 = _LETIMER_COMP0_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 519 | letimer->COMP1 = _LETIMER_COMP1_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 520 | letimer->REP0 = _LETIMER_REP0_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 521 | letimer->REP1 = _LETIMER_REP1_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 522 | letimer->IEN = _LETIMER_IEN_RESETVALUE; |
bogdanm | 0:9b334a45a8ff | 523 | letimer->IFC = _LETIMER_IFC_MASK; |
bogdanm | 0:9b334a45a8ff | 524 | /* Do not reset route register, setting should be done independently */ |
bogdanm | 0:9b334a45a8ff | 525 | |
bogdanm | 0:9b334a45a8ff | 526 | /* Unfreeze registers, pass new settings on to LETIMER */ |
bogdanm | 0:9b334a45a8ff | 527 | LETIMER_FreezeEnable(letimer, false); |
bogdanm | 0:9b334a45a8ff | 528 | } |
bogdanm | 0:9b334a45a8ff | 529 | |
bogdanm | 0:9b334a45a8ff | 530 | |
bogdanm | 0:9b334a45a8ff | 531 | /** @} (end addtogroup LETIMER) */ |
bogdanm | 0:9b334a45a8ff | 532 | /** @} (end addtogroup EM_Library) */ |
bogdanm | 0:9b334a45a8ff | 533 | #endif /* defined(LETIMER_COUNT) && (LETIMER_COUNT > 0) */ |