shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_L152RE/misc.c@323:9e901b0a5aa1, 2014-09-13 (annotated)

Committer:
shaoziyang
Date:
Sat Sep 13 14:25:46 2014 +0000
Revision:
323:9e901b0a5aa1
Parent:
106:ced8cbb51063 
test with CLOCK_SETUP = 0

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /**
mbed_official 76:aeb1df146756 2 ******************************************************************************
mbed_official 76:aeb1df146756 3 * @file misc.c
mbed_official 76:aeb1df146756 4 * @author MCD Application Team
mbed_official 80:66393a7b209d 5 * @version V1.3.0
mbed_official 80:66393a7b209d 6 * @date 31-January-2014
mbed_official 76:aeb1df146756 7 * @brief This file provides all the miscellaneous firmware functions (add-on
mbed_official 76:aeb1df146756 8 * to CMSIS functions).
mbed_official 76:aeb1df146756 9 ******************************************************************************
mbed_official 76:aeb1df146756 10 * @attention
mbed_official 76:aeb1df146756 11 *
mbed_official 106:ced8cbb51063 12 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 76:aeb1df146756 13 *
mbed_official 106:ced8cbb51063 14 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 106:ced8cbb51063 15 * are permitted provided that the following conditions are met:
mbed_official 106:ced8cbb51063 16 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 106:ced8cbb51063 17 * this list of conditions and the following disclaimer.
mbed_official 106:ced8cbb51063 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 106:ced8cbb51063 19 * this list of conditions and the following disclaimer in the documentation
mbed_official 106:ced8cbb51063 20 * and/or other materials provided with the distribution.
mbed_official 106:ced8cbb51063 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 106:ced8cbb51063 22 * may be used to endorse or promote products derived from this software
mbed_official 106:ced8cbb51063 23 * without specific prior written permission.
mbed_official 76:aeb1df146756 24 *
mbed_official 106:ced8cbb51063 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 106:ced8cbb51063 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 106:ced8cbb51063 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 106:ced8cbb51063 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 106:ced8cbb51063 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 106:ced8cbb51063 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 106:ced8cbb51063 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 106:ced8cbb51063 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 106:ced8cbb51063 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 106:ced8cbb51063 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 76:aeb1df146756 35 *
mbed_official 76:aeb1df146756 36 ******************************************************************************
mbed_official 76:aeb1df146756 37 */
mbed_official 76:aeb1df146756 38
mbed_official 76:aeb1df146756 39 /* Includes ------------------------------------------------------------------*/
mbed_official 76:aeb1df146756 40 #include "misc.h"
mbed_official 76:aeb1df146756 41
mbed_official 76:aeb1df146756 42 /** @addtogroup STM32L1xx_StdPeriph_Driver
mbed_official 76:aeb1df146756 43 * @{
mbed_official 76:aeb1df146756 44 */
mbed_official 76:aeb1df146756 45
mbed_official 76:aeb1df146756 46 /** @defgroup MISC
mbed_official 76:aeb1df146756 47 * @brief MISC driver modules
mbed_official 76:aeb1df146756 48 * @{
mbed_official 76:aeb1df146756 49 */
mbed_official 76:aeb1df146756 50
mbed_official 76:aeb1df146756 51 /* Private typedef -----------------------------------------------------------*/
mbed_official 76:aeb1df146756 52 /* Private define ------------------------------------------------------------*/
mbed_official 76:aeb1df146756 53 #define AIRCR_VECTKEY_MASK ((uint32_t)0x05FA0000)
mbed_official 76:aeb1df146756 54
mbed_official 76:aeb1df146756 55 /* Private macro -------------------------------------------------------------*/
mbed_official 76:aeb1df146756 56 /* Private variables ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 57 /* Private function prototypes -----------------------------------------------*/
mbed_official 76:aeb1df146756 58 /* Private functions ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 59
mbed_official 76:aeb1df146756 60 /** @defgroup MISC_Private_Functions
mbed_official 76:aeb1df146756 61 * @{
mbed_official 76:aeb1df146756 62 */
mbed_official 76:aeb1df146756 63 /**
mbed_official 76:aeb1df146756 64 *
mbed_official 76:aeb1df146756 65 @verbatim
mbed_official 76:aeb1df146756 66 *******************************************************************************
mbed_official 76:aeb1df146756 67 ##### Interrupts configuration functions #####
mbed_official 76:aeb1df146756 68 *******************************************************************************
mbed_official 76:aeb1df146756 69 [..] This section provide functions allowing to configure the NVIC interrupts
mbed_official 76:aeb1df146756 70 (IRQ).The Cortex-M3 exceptions are managed by CMSIS functions.
mbed_official 76:aeb1df146756 71 (#) Configure the NVIC Priority Grouping using NVIC_PriorityGroupConfig()
mbed_official 76:aeb1df146756 72 function according to the following table.
mbed_official 76:aeb1df146756 73 The table below gives the allowed values of the preemption priority
mbed_official 76:aeb1df146756 74 and subpriority according to the Priority Grouping configuration
mbed_official 76:aeb1df146756 75 performed by NVIC_PriorityGroupConfig function.
mbed_official 76:aeb1df146756 76 ============================================================================================================================
mbed_official 76:aeb1df146756 77 NVIC_PriorityGroup | NVIC_IRQChannelPreemptionPriority | NVIC_IRQChannelSubPriority | Description
mbed_official 76:aeb1df146756 78 ============================================================================================================================
mbed_official 76:aeb1df146756 79 NVIC_PriorityGroup_0 | 0 | 0-15 | 0 bits for preemption priority
mbed_official 76:aeb1df146756 80 | | | 4 bits for subpriority
mbed_official 76:aeb1df146756 81 ----------------------------------------------------------------------------------------------------------------------------
mbed_official 76:aeb1df146756 82 NVIC_PriorityGroup_1 | 0-1 | 0-7 | 1 bits for preemption priority
mbed_official 76:aeb1df146756 83 | | | 3 bits for subpriority
mbed_official 76:aeb1df146756 84 ----------------------------------------------------------------------------------------------------------------------------
mbed_official 76:aeb1df146756 85 NVIC_PriorityGroup_2 | 0-3 | 0-3 | 2 bits for preemption priority
mbed_official 76:aeb1df146756 86 | | | 2 bits for subpriority
mbed_official 76:aeb1df146756 87 ----------------------------------------------------------------------------------------------------------------------------
mbed_official 76:aeb1df146756 88 NVIC_PriorityGroup_3 | 0-7 | 0-1 | 3 bits for preemption priority
mbed_official 76:aeb1df146756 89 | | | 1 bits for subpriority
mbed_official 76:aeb1df146756 90 ----------------------------------------------------------------------------------------------------------------------------
mbed_official 76:aeb1df146756 91 NVIC_PriorityGroup_4 | 0-15 | 0 | 4 bits for preemption priority
mbed_official 76:aeb1df146756 92 | | | 0 bits for subpriority
mbed_official 76:aeb1df146756 93 ============================================================================================================================
mbed_official 76:aeb1df146756 94
mbed_official 76:aeb1df146756 95
mbed_official 76:aeb1df146756 96 (#) Enable and Configure the priority of the selected IRQ Channels.
mbed_official 76:aeb1df146756 97
mbed_official 76:aeb1df146756 98 -@- When the NVIC_PriorityGroup_0 is selected, it will no any nested interrupt,
mbed_official 76:aeb1df146756 99 the IRQ priority will be managed only by subpriority.
mbed_official 76:aeb1df146756 100 The sub-priority is only used to sort pending exception priorities,
mbed_official 76:aeb1df146756 101 and does not affect active exceptions.
mbed_official 76:aeb1df146756 102 -@- Lower priority values gives higher priority.
mbed_official 76:aeb1df146756 103 -@- Priority Order:
mbed_official 76:aeb1df146756 104 (#@) Lowest Preemption priority.
mbed_official 76:aeb1df146756 105 (#@) Lowest Subpriority.
mbed_official 76:aeb1df146756 106 (#@) Lowest hardware priority (IRQn position).
mbed_official 76:aeb1df146756 107
mbed_official 76:aeb1df146756 108 @endverbatim
mbed_official 76:aeb1df146756 109 */
mbed_official 76:aeb1df146756 110
mbed_official 76:aeb1df146756 111 /**
mbed_official 76:aeb1df146756 112 * @brief Configures the priority grouping: preemption priority and subpriority.
mbed_official 76:aeb1df146756 113 * @param NVIC_PriorityGroup: specifies the priority grouping bits length.
mbed_official 76:aeb1df146756 114 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 115 * @arg NVIC_PriorityGroup_0: 0 bits for preemption priority
mbed_official 76:aeb1df146756 116 * 4 bits for subpriority.
mbed_official 76:aeb1df146756 117 * @note When NVIC_PriorityGroup_0 is selected, it will no be any nested
mbed_official 76:aeb1df146756 118 * interrupt. This interrupts priority is managed only with subpriority.
mbed_official 76:aeb1df146756 119 * @arg NVIC_PriorityGroup_1: 1 bits for preemption priority.
mbed_official 76:aeb1df146756 120 * 3 bits for subpriority.
mbed_official 76:aeb1df146756 121 * @arg NVIC_PriorityGroup_2: 2 bits for preemption priority.
mbed_official 76:aeb1df146756 122 * 2 bits for subpriority.
mbed_official 76:aeb1df146756 123 * @arg NVIC_PriorityGroup_3: 3 bits for preemption priority.
mbed_official 76:aeb1df146756 124 * 1 bits for subpriority.
mbed_official 76:aeb1df146756 125 * @arg NVIC_PriorityGroup_4: 4 bits for preemption priority.
mbed_official 76:aeb1df146756 126 * 0 bits for subpriority.
mbed_official 76:aeb1df146756 127 * @retval None
mbed_official 76:aeb1df146756 128 */
mbed_official 76:aeb1df146756 129 void NVIC_PriorityGroupConfig(uint32_t NVIC_PriorityGroup)
mbed_official 76:aeb1df146756 130 {
mbed_official 76:aeb1df146756 131 /* Check the parameters */
mbed_official 76:aeb1df146756 132 assert_param(IS_NVIC_PRIORITY_GROUP(NVIC_PriorityGroup));
mbed_official 76:aeb1df146756 133
mbed_official 76:aeb1df146756 134 /* Set the PRIGROUP[10:8] bits according to NVIC_PriorityGroup value */
mbed_official 76:aeb1df146756 135 SCB->AIRCR = AIRCR_VECTKEY_MASK | NVIC_PriorityGroup;
mbed_official 76:aeb1df146756 136 }
mbed_official 76:aeb1df146756 137
mbed_official 76:aeb1df146756 138 /**
mbed_official 76:aeb1df146756 139 * @brief Initializes the NVIC peripheral according to the specified
mbed_official 76:aeb1df146756 140 * parameters in the NVIC_InitStruct.
mbed_official 76:aeb1df146756 141 * @note To configure interrupts priority correctly, the NVIC_PriorityGroupConfig()
mbed_official 76:aeb1df146756 142 * function should be called before.
mbed_official 76:aeb1df146756 143 * @param NVIC_InitStruct: pointer to a NVIC_InitTypeDef structure that contains
mbed_official 76:aeb1df146756 144 * the configuration information for the specified NVIC peripheral.
mbed_official 76:aeb1df146756 145 * @retval None
mbed_official 76:aeb1df146756 146 */
mbed_official 76:aeb1df146756 147 void NVIC_Init(NVIC_InitTypeDef* NVIC_InitStruct)
mbed_official 76:aeb1df146756 148 {
mbed_official 76:aeb1df146756 149 uint8_t tmppriority = 0x00, tmppre = 0x00, tmpsub = 0x0F;
mbed_official 76:aeb1df146756 150
mbed_official 76:aeb1df146756 151 /* Check the parameters */
mbed_official 76:aeb1df146756 152 assert_param(IS_FUNCTIONAL_STATE(NVIC_InitStruct->NVIC_IRQChannelCmd));
mbed_official 76:aeb1df146756 153 assert_param(IS_NVIC_PREEMPTION_PRIORITY(NVIC_InitStruct->NVIC_IRQChannelPreemptionPriority));
mbed_official 76:aeb1df146756 154 assert_param(IS_NVIC_SUB_PRIORITY(NVIC_InitStruct->NVIC_IRQChannelSubPriority));
mbed_official 76:aeb1df146756 155
mbed_official 76:aeb1df146756 156 if (NVIC_InitStruct->NVIC_IRQChannelCmd != DISABLE)
mbed_official 76:aeb1df146756 157 {
mbed_official 76:aeb1df146756 158 /* Compute the Corresponding IRQ Priority --------------------------------*/
mbed_official 76:aeb1df146756 159 tmppriority = (0x700 - ((SCB->AIRCR) & (uint32_t)0x700))>> 0x08;
mbed_official 76:aeb1df146756 160 tmppre = (0x4 - tmppriority);
mbed_official 76:aeb1df146756 161 tmpsub = tmpsub >> tmppriority;
mbed_official 76:aeb1df146756 162
mbed_official 76:aeb1df146756 163 tmppriority = (uint32_t)NVIC_InitStruct->NVIC_IRQChannelPreemptionPriority << tmppre;
mbed_official 76:aeb1df146756 164 tmppriority |= (uint8_t)(NVIC_InitStruct->NVIC_IRQChannelSubPriority & tmpsub);
mbed_official 76:aeb1df146756 165 tmppriority = tmppriority << 0x04;
mbed_official 76:aeb1df146756 166
mbed_official 76:aeb1df146756 167 NVIC->IP[NVIC_InitStruct->NVIC_IRQChannel] = tmppriority;
mbed_official 76:aeb1df146756 168
mbed_official 76:aeb1df146756 169 /* Enable the Selected IRQ Channels --------------------------------------*/
mbed_official 76:aeb1df146756 170 NVIC->ISER[NVIC_InitStruct->NVIC_IRQChannel >> 0x05] =
mbed_official 76:aeb1df146756 171 (uint32_t)0x01 << (NVIC_InitStruct->NVIC_IRQChannel & (uint8_t)0x1F);
mbed_official 76:aeb1df146756 172 }
mbed_official 76:aeb1df146756 173 else
mbed_official 76:aeb1df146756 174 {
mbed_official 76:aeb1df146756 175 /* Disable the Selected IRQ Channels -------------------------------------*/
mbed_official 76:aeb1df146756 176 NVIC->ICER[NVIC_InitStruct->NVIC_IRQChannel >> 0x05] =
mbed_official 76:aeb1df146756 177 (uint32_t)0x01 << (NVIC_InitStruct->NVIC_IRQChannel & (uint8_t)0x1F);
mbed_official 76:aeb1df146756 178 }
mbed_official 76:aeb1df146756 179 }
mbed_official 76:aeb1df146756 180
mbed_official 76:aeb1df146756 181 /**
mbed_official 76:aeb1df146756 182 * @brief Sets the vector table location and Offset.
mbed_official 76:aeb1df146756 183 * @param NVIC_VectTab: specifies if the vector table is in RAM or FLASH memory.
mbed_official 76:aeb1df146756 184 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 185 * @arg NVIC_VectTab_RAM: Vector Table in internal SRAM.
mbed_official 76:aeb1df146756 186 * @arg NVIC_VectTab_FLASH: Vector Table in internal FLASH.
mbed_official 76:aeb1df146756 187 * @param Offset: Vector Table base offset field. This value must be a multiple of 0x200.
mbed_official 76:aeb1df146756 188 * @retval None
mbed_official 76:aeb1df146756 189 */
mbed_official 76:aeb1df146756 190 void NVIC_SetVectorTable(uint32_t NVIC_VectTab, uint32_t Offset)
mbed_official 76:aeb1df146756 191 {
mbed_official 76:aeb1df146756 192 /* Check the parameters */
mbed_official 76:aeb1df146756 193 assert_param(IS_NVIC_VECTTAB(NVIC_VectTab));
mbed_official 76:aeb1df146756 194 assert_param(IS_NVIC_OFFSET(Offset));
mbed_official 76:aeb1df146756 195
mbed_official 76:aeb1df146756 196 SCB->VTOR = NVIC_VectTab | (Offset & (uint32_t)0x1FFFFF80);
mbed_official 76:aeb1df146756 197 }
mbed_official 76:aeb1df146756 198
mbed_official 76:aeb1df146756 199 /**
mbed_official 76:aeb1df146756 200 * @brief Selects the condition for the system to enter low power mode.
mbed_official 76:aeb1df146756 201 * @param LowPowerMode: Specifies the new mode for the system to enter low power mode.
mbed_official 76:aeb1df146756 202 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 203 * @arg NVIC_LP_SEVONPEND: Low Power SEV on Pend.
mbed_official 76:aeb1df146756 204 * @arg NVIC_LP_SLEEPDEEP: Low Power DEEPSLEEP request.
mbed_official 76:aeb1df146756 205 * @arg NVIC_LP_SLEEPONEXIT: Low Power Sleep on Exit.
mbed_official 76:aeb1df146756 206 * @param NewState: new state of LP condition.
mbed_official 76:aeb1df146756 207 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 208 * @retval None
mbed_official 76:aeb1df146756 209 */
mbed_official 76:aeb1df146756 210 void NVIC_SystemLPConfig(uint8_t LowPowerMode, FunctionalState NewState)
mbed_official 76:aeb1df146756 211 {
mbed_official 76:aeb1df146756 212 /* Check the parameters */
mbed_official 76:aeb1df146756 213 assert_param(IS_NVIC_LP(LowPowerMode));
mbed_official 76:aeb1df146756 214 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 215
mbed_official 76:aeb1df146756 216 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 217 {
mbed_official 76:aeb1df146756 218 SCB->SCR |= LowPowerMode;
mbed_official 76:aeb1df146756 219 }
mbed_official 76:aeb1df146756 220 else
mbed_official 76:aeb1df146756 221 {
mbed_official 76:aeb1df146756 222 SCB->SCR &= (uint32_t)(~(uint32_t)LowPowerMode);
mbed_official 76:aeb1df146756 223 }
mbed_official 76:aeb1df146756 224 }
mbed_official 76:aeb1df146756 225
mbed_official 76:aeb1df146756 226 /**
mbed_official 76:aeb1df146756 227 * @brief Configures the SysTick clock source.
mbed_official 76:aeb1df146756 228 * @param SysTick_CLKSource: specifies the SysTick clock source.
mbed_official 76:aeb1df146756 229 * This parameter can be one of the following values:
mbed_official 76:aeb1df146756 230 * @arg SysTick_CLKSource_HCLK_Div8: AHB clock divided by 8 selected as SysTick clock source.
mbed_official 76:aeb1df146756 231 * @arg SysTick_CLKSource_HCLK: AHB clock selected as SysTick clock source.
mbed_official 76:aeb1df146756 232 * @retval None
mbed_official 76:aeb1df146756 233 */
mbed_official 76:aeb1df146756 234 void SysTick_CLKSourceConfig(uint32_t SysTick_CLKSource)
mbed_official 76:aeb1df146756 235 {
mbed_official 76:aeb1df146756 236 /* Check the parameters */
mbed_official 76:aeb1df146756 237 assert_param(IS_SYSTICK_CLK_SOURCE(SysTick_CLKSource));
mbed_official 76:aeb1df146756 238
mbed_official 76:aeb1df146756 239 if (SysTick_CLKSource == SysTick_CLKSource_HCLK)
mbed_official 76:aeb1df146756 240 {
mbed_official 76:aeb1df146756 241 SysTick->CTRL |= SysTick_CLKSource_HCLK;
mbed_official 76:aeb1df146756 242 }
mbed_official 76:aeb1df146756 243 else
mbed_official 76:aeb1df146756 244 {
mbed_official 76:aeb1df146756 245 SysTick->CTRL &= SysTick_CLKSource_HCLK_Div8;
mbed_official 76:aeb1df146756 246 }
mbed_official 76:aeb1df146756 247 }
mbed_official 76:aeb1df146756 248
mbed_official 76:aeb1df146756 249 /**
mbed_official 76:aeb1df146756 250 * @}
mbed_official 76:aeb1df146756 251 */
mbed_official 76:aeb1df146756 252
mbed_official 76:aeb1df146756 253 /**
mbed_official 76:aeb1df146756 254 * @}
mbed_official 76:aeb1df146756 255 */
mbed_official 76:aeb1df146756 256
mbed_official 76:aeb1df146756 257 /**
mbed_official 76:aeb1df146756 258 * @}
mbed_official 76:aeb1df146756 259 */
mbed_official 76:aeb1df146756 260
mbed_official 76:aeb1df146756 261 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/