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_DISCO_F407VG/stm32f4xx_hal_cortex.c@133:d4dda5c437f0, 2014-03-24 (annotated)

Committer:
mbed_official
Date:
Mon Mar 24 17:45:07 2014 +0000
Revision:
133:d4dda5c437f0
Child:
242:7074e42da0b2
Synchronized with git revision 47b961246bed973fe4cb8932781ffc8025b78a61



Full URL: https://github.com/mbedmicro/mbed/commit/47b961246bed973fe4cb8932781ffc8025b78a61/



[STM32F4-Discovery (STM32F407VG)] initial port

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 133:d4dda5c437f0 1 /**
mbed_official 133:d4dda5c437f0 2 ******************************************************************************
mbed_official 133:d4dda5c437f0 3 * @file stm32f4xx_hal_cortex.c
mbed_official 133:d4dda5c437f0 4 * @author MCD Application Team
mbed_official 133:d4dda5c437f0 5 * @version V1.0.0
mbed_official 133:d4dda5c437f0 6 * @date 18-February-2014
mbed_official 133:d4dda5c437f0 7 * @brief CORTEX HAL module driver.
mbed_official 133:d4dda5c437f0 8 * This file provides firmware functions to manage the following
mbed_official 133:d4dda5c437f0 9 * functionalities of the CORTEX:
mbed_official 133:d4dda5c437f0 10 * + Initialization and de-initialization functions
mbed_official 133:d4dda5c437f0 11 * + Peripheral Control functions
mbed_official 133:d4dda5c437f0 12 *
mbed_official 133:d4dda5c437f0 13 @verbatim
mbed_official 133:d4dda5c437f0 14 ==============================================================================
mbed_official 133:d4dda5c437f0 15 ##### How to use this driver #####
mbed_official 133:d4dda5c437f0 16 ==============================================================================
mbed_official 133:d4dda5c437f0 17
mbed_official 133:d4dda5c437f0 18 [..]
mbed_official 133:d4dda5c437f0 19 *** How to configure Interrupts using Cortex HAL driver ***
mbed_official 133:d4dda5c437f0 20 ===========================================================
mbed_official 133:d4dda5c437f0 21 [..]
mbed_official 133:d4dda5c437f0 22 This section provide functions allowing to configure the NVIC interrupts (IRQ).
mbed_official 133:d4dda5c437f0 23 The Cortex-M4 exceptions are managed by CMSIS functions.
mbed_official 133:d4dda5c437f0 24
mbed_official 133:d4dda5c437f0 25 (#) Configure the NVIC Priority Grouping using HAL_NVIC_SetPriorityGrouping()
mbed_official 133:d4dda5c437f0 26 function according to the following table.
mbed_official 133:d4dda5c437f0 27
mbed_official 133:d4dda5c437f0 28 The table below gives the allowed values of the pre-emption priority and subpriority according
mbed_official 133:d4dda5c437f0 29 to the Priority Grouping configuration performed by HAL_NVIC_SetPriorityGrouping() function.
mbed_official 133:d4dda5c437f0 30 ==========================================================================================================================
mbed_official 133:d4dda5c437f0 31 NVIC_PriorityGroup | NVIC_IRQChannelPreemptionPriority | NVIC_IRQChannelSubPriority | Description
mbed_official 133:d4dda5c437f0 32 ==========================================================================================================================
mbed_official 133:d4dda5c437f0 33 NVIC_PRIORITYGROUP_0 | 0 | 0-15 | 0 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 34 | | | 4 bits for subpriority
mbed_official 133:d4dda5c437f0 35 --------------------------------------------------------------------------------------------------------------------------
mbed_official 133:d4dda5c437f0 36 NVIC_PRIORITYGROUP_1 | 0-1 | 0-7 | 1 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 37 | | | 3 bits for subpriority
mbed_official 133:d4dda5c437f0 38 --------------------------------------------------------------------------------------------------------------------------
mbed_official 133:d4dda5c437f0 39 NVIC_PRIORITYGROUP_2 | 0-3 | 0-3 | 2 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 40 | | | 2 bits for subpriority
mbed_official 133:d4dda5c437f0 41 --------------------------------------------------------------------------------------------------------------------------
mbed_official 133:d4dda5c437f0 42 NVIC_PRIORITYGROUP_3 | 0-7 | 0-1 | 3 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 43 | | | 1 bits for subpriority
mbed_official 133:d4dda5c437f0 44 --------------------------------------------------------------------------------------------------------------------------
mbed_official 133:d4dda5c437f0 45 NVIC_PRIORITYGROUP_4 | 0-15 | 0 | 4 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 46 | | | 0 bits for subpriority
mbed_official 133:d4dda5c437f0 47 ==========================================================================================================================
mbed_official 133:d4dda5c437f0 48 (#) Configure the priority of the selected IRQ Channels using HAL_NVIC_SetPriority()
mbed_official 133:d4dda5c437f0 49
mbed_official 133:d4dda5c437f0 50 (#) Enable the selected IRQ Channels using HAL_NVIC_EnableIRQ()
mbed_official 133:d4dda5c437f0 51
mbed_official 133:d4dda5c437f0 52
mbed_official 133:d4dda5c437f0 53 -@- When the NVIC_PRIORITYGROUP_0 is selected, IRQ pre-emption is no more possible.
mbed_official 133:d4dda5c437f0 54 The pending IRQ priority will be managed only by the sub priority.
mbed_official 133:d4dda5c437f0 55
mbed_official 133:d4dda5c437f0 56 -@- IRQ priority order (sorted by highest to lowest priority):
mbed_official 133:d4dda5c437f0 57 (+@) Lowest pre-emption priority
mbed_official 133:d4dda5c437f0 58 (+@) Lowest sub priority
mbed_official 133:d4dda5c437f0 59 (+@) Lowest hardware priority (IRQ number)
mbed_official 133:d4dda5c437f0 60
mbed_official 133:d4dda5c437f0 61 [..]
mbed_official 133:d4dda5c437f0 62 *** How to configure Systick using Cortex HAL driver ***
mbed_official 133:d4dda5c437f0 63 ========================================================
mbed_official 133:d4dda5c437f0 64 [..]
mbed_official 133:d4dda5c437f0 65 Setup SysTick Timer for 1 msec interrupts.
mbed_official 133:d4dda5c437f0 66
mbed_official 133:d4dda5c437f0 67 (+) The HAL_SYSTICK_Config()function calls the SysTick_Config() function which
mbed_official 133:d4dda5c437f0 68 is a CMSIS function that:
mbed_official 133:d4dda5c437f0 69 (++) Configures the SysTick Reload register with value passed as function parameter.
mbed_official 133:d4dda5c437f0 70 (++) Configures the SysTick IRQ priority to the lowest value (0x0F).
mbed_official 133:d4dda5c437f0 71 (++) Resets the SysTick Counter register.
mbed_official 133:d4dda5c437f0 72 (++) Configures the SysTick Counter clock source to be Core Clock Source (HCLK).
mbed_official 133:d4dda5c437f0 73 (++) Enables the SysTick Interrupt.
mbed_official 133:d4dda5c437f0 74 (++) Starts the SysTick Counter.
mbed_official 133:d4dda5c437f0 75
mbed_official 133:d4dda5c437f0 76 (+) You can change the SysTick Clock source to be HCLK_Div8 by calling the macro
mbed_official 133:d4dda5c437f0 77 __HAL_CORTEX_SYSTICKCLK_CONFIG(SYSTICK_CLKSOURCE_HCLK_DIV8) just after the
mbed_official 133:d4dda5c437f0 78 HAL_SYSTICK_Config() function call. The __HAL_CORTEX_SYSTICKCLK_CONFIG() macro is defined
mbed_official 133:d4dda5c437f0 79 inside the stm32f4xx_hal_cortex.h file.
mbed_official 133:d4dda5c437f0 80
mbed_official 133:d4dda5c437f0 81 (+) You can change the SysTick IRQ priority by calling the
mbed_official 133:d4dda5c437f0 82 HAL_NVIC_SetPriority(SysTick_IRQn,...) function just after the HAL_SYSTICK_Config() function
mbed_official 133:d4dda5c437f0 83 call. The HAL_NVIC_SetPriority() call the NVIC_SetPriority() function which is a CMSIS function.
mbed_official 133:d4dda5c437f0 84
mbed_official 133:d4dda5c437f0 85 (+) To adjust the SysTick time base, use the following formula:
mbed_official 133:d4dda5c437f0 86
mbed_official 133:d4dda5c437f0 87 Reload Value = SysTick Counter Clock (Hz) x Desired Time base (s)
mbed_official 133:d4dda5c437f0 88 (++) Reload Value is the parameter to be passed for HAL_SYSTICK_Config() function
mbed_official 133:d4dda5c437f0 89 (++) Reload Value should not exceed 0xFFFFFF
mbed_official 133:d4dda5c437f0 90
mbed_official 133:d4dda5c437f0 91 @endverbatim
mbed_official 133:d4dda5c437f0 92 ******************************************************************************
mbed_official 133:d4dda5c437f0 93 * @attention
mbed_official 133:d4dda5c437f0 94 *
mbed_official 133:d4dda5c437f0 95 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 133:d4dda5c437f0 96 *
mbed_official 133:d4dda5c437f0 97 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 133:d4dda5c437f0 98 * are permitted provided that the following conditions are met:
mbed_official 133:d4dda5c437f0 99 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 133:d4dda5c437f0 100 * this list of conditions and the following disclaimer.
mbed_official 133:d4dda5c437f0 101 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 133:d4dda5c437f0 102 * this list of conditions and the following disclaimer in the documentation
mbed_official 133:d4dda5c437f0 103 * and/or other materials provided with the distribution.
mbed_official 133:d4dda5c437f0 104 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 133:d4dda5c437f0 105 * may be used to endorse or promote products derived from this software
mbed_official 133:d4dda5c437f0 106 * without specific prior written permission.
mbed_official 133:d4dda5c437f0 107 *
mbed_official 133:d4dda5c437f0 108 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 133:d4dda5c437f0 109 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 133:d4dda5c437f0 110 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 133:d4dda5c437f0 111 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 133:d4dda5c437f0 112 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 133:d4dda5c437f0 113 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 133:d4dda5c437f0 114 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 133:d4dda5c437f0 115 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 133:d4dda5c437f0 116 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 133:d4dda5c437f0 117 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 133:d4dda5c437f0 118 *
mbed_official 133:d4dda5c437f0 119 ******************************************************************************
mbed_official 133:d4dda5c437f0 120 */
mbed_official 133:d4dda5c437f0 121
mbed_official 133:d4dda5c437f0 122 /* Includes ------------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 123 #include "stm32f4xx_hal.h"
mbed_official 133:d4dda5c437f0 124
mbed_official 133:d4dda5c437f0 125 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 133:d4dda5c437f0 126 * @{
mbed_official 133:d4dda5c437f0 127 */
mbed_official 133:d4dda5c437f0 128
mbed_official 133:d4dda5c437f0 129 /** @defgroup CORTEX
mbed_official 133:d4dda5c437f0 130 * @brief CORTEX HAL module driver
mbed_official 133:d4dda5c437f0 131 * @{
mbed_official 133:d4dda5c437f0 132 */
mbed_official 133:d4dda5c437f0 133
mbed_official 133:d4dda5c437f0 134 #ifdef HAL_CORTEX_MODULE_ENABLED
mbed_official 133:d4dda5c437f0 135
mbed_official 133:d4dda5c437f0 136 /* Private typedef -----------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 137 /* Private define ------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 138 /* Private macro -------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 139 /* Private variables ---------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 140 /* Private function prototypes -----------------------------------------------*/
mbed_official 133:d4dda5c437f0 141 /* Private functions ---------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 142
mbed_official 133:d4dda5c437f0 143 /** @defgroup CORTEX_Private_Functions
mbed_official 133:d4dda5c437f0 144 * @{
mbed_official 133:d4dda5c437f0 145 */
mbed_official 133:d4dda5c437f0 146
mbed_official 133:d4dda5c437f0 147
mbed_official 133:d4dda5c437f0 148 /** @defgroup CORTEX_Group1 Initialization and de-initialization functions
mbed_official 133:d4dda5c437f0 149 * @brief Initialization and Configuration functions
mbed_official 133:d4dda5c437f0 150 *
mbed_official 133:d4dda5c437f0 151 @verbatim
mbed_official 133:d4dda5c437f0 152 ==============================================================================
mbed_official 133:d4dda5c437f0 153 ##### Initialization and de-initialization functions #####
mbed_official 133:d4dda5c437f0 154 ==============================================================================
mbed_official 133:d4dda5c437f0 155 [..]
mbed_official 133:d4dda5c437f0 156 This section provide the Cortex HAL driver functions allowing to configure Interrupts
mbed_official 133:d4dda5c437f0 157 Systick functionalities
mbed_official 133:d4dda5c437f0 158
mbed_official 133:d4dda5c437f0 159 @endverbatim
mbed_official 133:d4dda5c437f0 160 * @{
mbed_official 133:d4dda5c437f0 161 */
mbed_official 133:d4dda5c437f0 162
mbed_official 133:d4dda5c437f0 163
mbed_official 133:d4dda5c437f0 164 /**
mbed_official 133:d4dda5c437f0 165 * @brief Sets the priority grouping field (pre-emption priority and subpriority)
mbed_official 133:d4dda5c437f0 166 * using the required unlock sequence.
mbed_official 133:d4dda5c437f0 167 * @param PriorityGroup: The priority grouping bits length.
mbed_official 133:d4dda5c437f0 168 * This parameter can be one of the following values:
mbed_official 133:d4dda5c437f0 169 * @arg NVIC_PRIORITYGROUP_0: 0 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 170 * 4 bits for subpriority
mbed_official 133:d4dda5c437f0 171 * @arg NVIC_PRIORITYGROUP_1: 1 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 172 * 3 bits for subpriority
mbed_official 133:d4dda5c437f0 173 * @arg NVIC_PRIORITYGROUP_2: 2 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 174 * 2 bits for subpriority
mbed_official 133:d4dda5c437f0 175 * @arg NVIC_PRIORITYGROUP_3: 3 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 176 * 1 bits for subpriority
mbed_official 133:d4dda5c437f0 177 * @arg NVIC_PRIORITYGROUP_4: 4 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 178 * 0 bits for subpriority
mbed_official 133:d4dda5c437f0 179 * @note When the NVIC_PriorityGroup_0 is selected, IRQ pre-emption is no more possible.
mbed_official 133:d4dda5c437f0 180 * The pending IRQ priority will be managed only by the subpriority.
mbed_official 133:d4dda5c437f0 181 * @retval None
mbed_official 133:d4dda5c437f0 182 */
mbed_official 133:d4dda5c437f0 183 void HAL_NVIC_SetPriorityGrouping(uint32_t PriorityGroup)
mbed_official 133:d4dda5c437f0 184 {
mbed_official 133:d4dda5c437f0 185 /* Check the parameters */
mbed_official 133:d4dda5c437f0 186 assert_param(IS_NVIC_PRIORITY_GROUP(PriorityGroup));
mbed_official 133:d4dda5c437f0 187
mbed_official 133:d4dda5c437f0 188 /* Set the PRIGROUP[10:8] bits according to the PriorityGroup parameter value */
mbed_official 133:d4dda5c437f0 189 NVIC_SetPriorityGrouping(PriorityGroup);
mbed_official 133:d4dda5c437f0 190 }
mbed_official 133:d4dda5c437f0 191
mbed_official 133:d4dda5c437f0 192 /**
mbed_official 133:d4dda5c437f0 193 * @brief Sets the priority of an interrupt.
mbed_official 133:d4dda5c437f0 194 * @param IRQn: External interrupt number
mbed_official 133:d4dda5c437f0 195 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 196 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 197 * @param PreemptPriority: The pre-emption priority for the IRQn channel.
mbed_official 133:d4dda5c437f0 198 * This parameter can be a value between 0 and 15
mbed_official 133:d4dda5c437f0 199 * A lower priority value indicates a higher priority
mbed_official 133:d4dda5c437f0 200 * @param SubPriority: the subpriority level for the IRQ channel.
mbed_official 133:d4dda5c437f0 201 * This parameter can be a value between 0 and 15
mbed_official 133:d4dda5c437f0 202 * A lower priority value indicates a higher priority.
mbed_official 133:d4dda5c437f0 203 * @retval None
mbed_official 133:d4dda5c437f0 204 */
mbed_official 133:d4dda5c437f0 205 void HAL_NVIC_SetPriority(IRQn_Type IRQn, uint32_t PreemptPriority, uint32_t SubPriority)
mbed_official 133:d4dda5c437f0 206 {
mbed_official 133:d4dda5c437f0 207 uint32_t prioritygroup = 0x00;
mbed_official 133:d4dda5c437f0 208
mbed_official 133:d4dda5c437f0 209 /* Check the parameters */
mbed_official 133:d4dda5c437f0 210 assert_param(IS_NVIC_SUB_PRIORITY(SubPriority));
mbed_official 133:d4dda5c437f0 211 assert_param(IS_NVIC_PREEMPTION_PRIORITY(PreemptPriority));
mbed_official 133:d4dda5c437f0 212
mbed_official 133:d4dda5c437f0 213 prioritygroup = NVIC_GetPriorityGrouping();
mbed_official 133:d4dda5c437f0 214
mbed_official 133:d4dda5c437f0 215 NVIC_SetPriority(IRQn, NVIC_EncodePriority(prioritygroup, PreemptPriority, SubPriority));
mbed_official 133:d4dda5c437f0 216 }
mbed_official 133:d4dda5c437f0 217
mbed_official 133:d4dda5c437f0 218 /**
mbed_official 133:d4dda5c437f0 219 * @brief Enables a device specific interrupt in the NVIC interrupt controller.
mbed_official 133:d4dda5c437f0 220 * @note To configure interrupts priority correctly, the NVIC_PriorityGroupConfig()
mbed_official 133:d4dda5c437f0 221 * function should be called before.
mbed_official 133:d4dda5c437f0 222 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 223 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 224 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 225 * @retval None
mbed_official 133:d4dda5c437f0 226 */
mbed_official 133:d4dda5c437f0 227 void HAL_NVIC_EnableIRQ(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 228 {
mbed_official 133:d4dda5c437f0 229 /* Enable interrupt */
mbed_official 133:d4dda5c437f0 230 NVIC_EnableIRQ(IRQn);
mbed_official 133:d4dda5c437f0 231 }
mbed_official 133:d4dda5c437f0 232
mbed_official 133:d4dda5c437f0 233 /**
mbed_official 133:d4dda5c437f0 234 * @brief Disables a device specific interrupt in the NVIC interrupt controller.
mbed_official 133:d4dda5c437f0 235 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 236 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 237 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 238 * @retval None
mbed_official 133:d4dda5c437f0 239 */
mbed_official 133:d4dda5c437f0 240 void HAL_NVIC_DisableIRQ(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 241 {
mbed_official 133:d4dda5c437f0 242 /* Disable interrupt */
mbed_official 133:d4dda5c437f0 243 NVIC_DisableIRQ(IRQn);
mbed_official 133:d4dda5c437f0 244 }
mbed_official 133:d4dda5c437f0 245
mbed_official 133:d4dda5c437f0 246 /**
mbed_official 133:d4dda5c437f0 247 * @brief Initiates a system reset request to reset the MCU.
mbed_official 133:d4dda5c437f0 248 * @param None
mbed_official 133:d4dda5c437f0 249 * @retval None
mbed_official 133:d4dda5c437f0 250 */
mbed_official 133:d4dda5c437f0 251 void HAL_NVIC_SystemReset(void)
mbed_official 133:d4dda5c437f0 252 {
mbed_official 133:d4dda5c437f0 253 /* System Reset */
mbed_official 133:d4dda5c437f0 254 NVIC_SystemReset();
mbed_official 133:d4dda5c437f0 255 }
mbed_official 133:d4dda5c437f0 256
mbed_official 133:d4dda5c437f0 257 /**
mbed_official 133:d4dda5c437f0 258 * @brief Initializes the System Timer and its interrupt, and starts the System Tick Timer.
mbed_official 133:d4dda5c437f0 259 * Counter is in free running mode to generate periodic interrupts.
mbed_official 133:d4dda5c437f0 260 * @param TicksNumb: Specifies the ticks Number of ticks between two interrupts.
mbed_official 133:d4dda5c437f0 261 * @retval status: - 0 Function succeeded.
mbed_official 133:d4dda5c437f0 262 * - 1 Function failed.
mbed_official 133:d4dda5c437f0 263 */
mbed_official 133:d4dda5c437f0 264 uint32_t HAL_SYSTICK_Config(uint32_t TicksNumb)
mbed_official 133:d4dda5c437f0 265 {
mbed_official 133:d4dda5c437f0 266 return SysTick_Config(TicksNumb);
mbed_official 133:d4dda5c437f0 267 }
mbed_official 133:d4dda5c437f0 268 /**
mbed_official 133:d4dda5c437f0 269 * @}
mbed_official 133:d4dda5c437f0 270 */
mbed_official 133:d4dda5c437f0 271
mbed_official 133:d4dda5c437f0 272 /** @defgroup CORTEX_Group2 Peripheral Control functions
mbed_official 133:d4dda5c437f0 273 * @brief Cortex control functions
mbed_official 133:d4dda5c437f0 274 *
mbed_official 133:d4dda5c437f0 275 @verbatim
mbed_official 133:d4dda5c437f0 276 ==============================================================================
mbed_official 133:d4dda5c437f0 277 ##### Peripheral Control functions #####
mbed_official 133:d4dda5c437f0 278 ==============================================================================
mbed_official 133:d4dda5c437f0 279 [..]
mbed_official 133:d4dda5c437f0 280 This subsection provides a set of functions allowing to control the CORTEX
mbed_official 133:d4dda5c437f0 281 (NVIC, SYSTICK) functionalities.
mbed_official 133:d4dda5c437f0 282
mbed_official 133:d4dda5c437f0 283
mbed_official 133:d4dda5c437f0 284 @endverbatim
mbed_official 133:d4dda5c437f0 285 * @{
mbed_official 133:d4dda5c437f0 286 */
mbed_official 133:d4dda5c437f0 287
mbed_official 133:d4dda5c437f0 288 /**
mbed_official 133:d4dda5c437f0 289 * @brief Gets the priority grouping field from the NVIC Interrupt Controller.
mbed_official 133:d4dda5c437f0 290 * @param None
mbed_official 133:d4dda5c437f0 291 * @retval Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field)
mbed_official 133:d4dda5c437f0 292 */
mbed_official 133:d4dda5c437f0 293 uint32_t HAL_NVIC_GetPriorityGrouping(void)
mbed_official 133:d4dda5c437f0 294 {
mbed_official 133:d4dda5c437f0 295 /* Get the PRIGROUP[10:8] field value */
mbed_official 133:d4dda5c437f0 296 return NVIC_GetPriorityGrouping();
mbed_official 133:d4dda5c437f0 297 }
mbed_official 133:d4dda5c437f0 298
mbed_official 133:d4dda5c437f0 299 /**
mbed_official 133:d4dda5c437f0 300 * @brief Gets the priority of an interrupt.
mbed_official 133:d4dda5c437f0 301 * @param IRQn: External interrupt number
mbed_official 133:d4dda5c437f0 302 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 303 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 304 * @param PriorityGroup: the priority grouping bits length.
mbed_official 133:d4dda5c437f0 305 * This parameter can be one of the following values:
mbed_official 133:d4dda5c437f0 306 * @arg NVIC_PRIORITYGROUP_0: 0 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 307 * 4 bits for subpriority
mbed_official 133:d4dda5c437f0 308 * @arg NVIC_PRIORITYGROUP_1: 1 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 309 * 3 bits for subpriority
mbed_official 133:d4dda5c437f0 310 * @arg NVIC_PRIORITYGROUP_2: 2 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 311 * 2 bits for subpriority
mbed_official 133:d4dda5c437f0 312 * @arg NVIC_PRIORITYGROUP_3: 3 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 313 * 1 bits for subpriority
mbed_official 133:d4dda5c437f0 314 * @arg NVIC_PRIORITYGROUP_4: 4 bits for pre-emption priority
mbed_official 133:d4dda5c437f0 315 * 0 bits for subpriority
mbed_official 133:d4dda5c437f0 316 * @param pPreemptPriority: Pointer on the Preemptive priority value (starting from 0).
mbed_official 133:d4dda5c437f0 317 * @param pSubPriority: Pointer on the Subpriority value (starting from 0).
mbed_official 133:d4dda5c437f0 318 * @retval None
mbed_official 133:d4dda5c437f0 319 */
mbed_official 133:d4dda5c437f0 320 void HAL_NVIC_GetPriority(IRQn_Type IRQn, uint32_t PriorityGroup, uint32_t *pPreemptPriority, uint32_t *pSubPriority)
mbed_official 133:d4dda5c437f0 321 {
mbed_official 133:d4dda5c437f0 322 /* Check the parameters */
mbed_official 133:d4dda5c437f0 323 assert_param(IS_NVIC_PRIORITY_GROUP(PriorityGroup));
mbed_official 133:d4dda5c437f0 324 /* Get priority for Cortex-M system or device specific interrupts */
mbed_official 133:d4dda5c437f0 325 NVIC_DecodePriority(NVIC_GetPriority(IRQn), PriorityGroup, pPreemptPriority, pSubPriority);
mbed_official 133:d4dda5c437f0 326 }
mbed_official 133:d4dda5c437f0 327
mbed_official 133:d4dda5c437f0 328 /**
mbed_official 133:d4dda5c437f0 329 * @brief Sets Pending bit of an external interrupt.
mbed_official 133:d4dda5c437f0 330 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 331 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 332 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 333 * @retval None
mbed_official 133:d4dda5c437f0 334 */
mbed_official 133:d4dda5c437f0 335 void HAL_NVIC_SetPendingIRQ(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 336 {
mbed_official 133:d4dda5c437f0 337 /* Set interrupt pending */
mbed_official 133:d4dda5c437f0 338 NVIC_SetPendingIRQ(IRQn);
mbed_official 133:d4dda5c437f0 339 }
mbed_official 133:d4dda5c437f0 340
mbed_official 133:d4dda5c437f0 341 /**
mbed_official 133:d4dda5c437f0 342 * @brief Gets Pending Interrupt (reads the pending register in the NVIC
mbed_official 133:d4dda5c437f0 343 * and returns the pending bit for the specified interrupt).
mbed_official 133:d4dda5c437f0 344 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 345 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 346 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 347 * @retval status: - 0 Interrupt status is not pending.
mbed_official 133:d4dda5c437f0 348 * - 1 Interrupt status is pending.
mbed_official 133:d4dda5c437f0 349 */
mbed_official 133:d4dda5c437f0 350 uint32_t HAL_NVIC_GetPendingIRQ(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 351 {
mbed_official 133:d4dda5c437f0 352 /* Return 1 if pending else 0 */
mbed_official 133:d4dda5c437f0 353 return NVIC_GetPendingIRQ(IRQn);
mbed_official 133:d4dda5c437f0 354 }
mbed_official 133:d4dda5c437f0 355
mbed_official 133:d4dda5c437f0 356 /**
mbed_official 133:d4dda5c437f0 357 * @brief Clears the pending bit of an external interrupt.
mbed_official 133:d4dda5c437f0 358 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 359 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 360 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 361 * @retval None
mbed_official 133:d4dda5c437f0 362 */
mbed_official 133:d4dda5c437f0 363 void HAL_NVIC_ClearPendingIRQ(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 364 {
mbed_official 133:d4dda5c437f0 365 /* Clear pending interrupt */
mbed_official 133:d4dda5c437f0 366 NVIC_ClearPendingIRQ(IRQn);
mbed_official 133:d4dda5c437f0 367 }
mbed_official 133:d4dda5c437f0 368
mbed_official 133:d4dda5c437f0 369 /**
mbed_official 133:d4dda5c437f0 370 * @brief Gets active interrupt ( reads the active register in NVIC and returns the active bit).
mbed_official 133:d4dda5c437f0 371 * @param IRQn External interrupt number
mbed_official 133:d4dda5c437f0 372 * This parameter can be an enumerator of @ref IRQn_Type enumeration
mbed_official 133:d4dda5c437f0 373 * (For the complete STM32 Devices IRQ Channels list, please refer to stm32f4xx.h file)
mbed_official 133:d4dda5c437f0 374 * @retval status: - 0 Interrupt status is not pending.
mbed_official 133:d4dda5c437f0 375 * - 1 Interrupt status is pending.
mbed_official 133:d4dda5c437f0 376 */
mbed_official 133:d4dda5c437f0 377 uint32_t HAL_NVIC_GetActive(IRQn_Type IRQn)
mbed_official 133:d4dda5c437f0 378 {
mbed_official 133:d4dda5c437f0 379 /* Return 1 if active else 0 */
mbed_official 133:d4dda5c437f0 380 return NVIC_GetActive(IRQn);
mbed_official 133:d4dda5c437f0 381 }
mbed_official 133:d4dda5c437f0 382
mbed_official 133:d4dda5c437f0 383 /**
mbed_official 133:d4dda5c437f0 384 * @brief Configures the SysTick clock source.
mbed_official 133:d4dda5c437f0 385 * @param CLKSource: specifies the SysTick clock source.
mbed_official 133:d4dda5c437f0 386 * This parameter can be one of the following values:
mbed_official 133:d4dda5c437f0 387 * @arg SYSTICK_CLKSOURCE_HCLK_DIV8: AHB clock divided by 8 selected as SysTick clock source.
mbed_official 133:d4dda5c437f0 388 * @arg SYSTICK_CLKSOURCE_HCLK: AHB clock selected as SysTick clock source.
mbed_official 133:d4dda5c437f0 389 * @retval None
mbed_official 133:d4dda5c437f0 390 */
mbed_official 133:d4dda5c437f0 391 void HAL_SYSTICK_CLKSourceConfig(uint32_t CLKSource)
mbed_official 133:d4dda5c437f0 392 {
mbed_official 133:d4dda5c437f0 393 /* Check the parameters */
mbed_official 133:d4dda5c437f0 394 assert_param(IS_SYSTICK_CLK_SOURCE(CLKSource));
mbed_official 133:d4dda5c437f0 395 if (CLKSource == SYSTICK_CLKSOURCE_HCLK)
mbed_official 133:d4dda5c437f0 396 {
mbed_official 133:d4dda5c437f0 397 SysTick->CTRL |= SYSTICK_CLKSOURCE_HCLK;
mbed_official 133:d4dda5c437f0 398 }
mbed_official 133:d4dda5c437f0 399 else
mbed_official 133:d4dda5c437f0 400 {
mbed_official 133:d4dda5c437f0 401 SysTick->CTRL &= ~SYSTICK_CLKSOURCE_HCLK;
mbed_official 133:d4dda5c437f0 402 }
mbed_official 133:d4dda5c437f0 403 }
mbed_official 133:d4dda5c437f0 404
mbed_official 133:d4dda5c437f0 405 /**
mbed_official 133:d4dda5c437f0 406 * @brief This function handles SYSTICK interrupt request.
mbed_official 133:d4dda5c437f0 407 * @param None
mbed_official 133:d4dda5c437f0 408 * @retval None
mbed_official 133:d4dda5c437f0 409 */
mbed_official 133:d4dda5c437f0 410 void HAL_SYSTICK_IRQHandler(void)
mbed_official 133:d4dda5c437f0 411 {
mbed_official 133:d4dda5c437f0 412 HAL_SYSTICK_Callback();
mbed_official 133:d4dda5c437f0 413 }
mbed_official 133:d4dda5c437f0 414
mbed_official 133:d4dda5c437f0 415 /**
mbed_official 133:d4dda5c437f0 416 * @brief SYSTICK callback.
mbed_official 133:d4dda5c437f0 417 * @param None
mbed_official 133:d4dda5c437f0 418 * @retval None
mbed_official 133:d4dda5c437f0 419 */
mbed_official 133:d4dda5c437f0 420 __weak void HAL_SYSTICK_Callback(void)
mbed_official 133:d4dda5c437f0 421 {
mbed_official 133:d4dda5c437f0 422 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 133:d4dda5c437f0 423 the HAL_SYSTICK_Callback could be implemented in the user file
mbed_official 133:d4dda5c437f0 424 */
mbed_official 133:d4dda5c437f0 425 }
mbed_official 133:d4dda5c437f0 426
mbed_official 133:d4dda5c437f0 427 /**
mbed_official 133:d4dda5c437f0 428 * @}
mbed_official 133:d4dda5c437f0 429 */
mbed_official 133:d4dda5c437f0 430
mbed_official 133:d4dda5c437f0 431 /**
mbed_official 133:d4dda5c437f0 432 * @}
mbed_official 133:d4dda5c437f0 433 */
mbed_official 133:d4dda5c437f0 434
mbed_official 133:d4dda5c437f0 435 #endif /* HAL_CORTEX_MODULE_ENABLED */
mbed_official 133:d4dda5c437f0 436 /**
mbed_official 133:d4dda5c437f0 437 * @}
mbed_official 133:d4dda5c437f0 438 */
mbed_official 133:d4dda5c437f0 439
mbed_official 133:d4dda5c437f0 440 /**
mbed_official 133:d4dda5c437f0 441 * @}
mbed_official 133:d4dda5c437f0 442 */
mbed_official 133:d4dda5c437f0 443
mbed_official 133:d4dda5c437f0 444 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/