mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F4/stm32f4xx_hal_cortex.c@581:39197bcd20f2, 2015-07-02 (annotated)

Committer:
mbed_official
Date:
Thu Jul 02 16:30:08 2015 +0100
Revision:
581:39197bcd20f2
Parent:
532:fe11edbda85c
Child:
613:bc40b8d2aec4
Synchronized with git revision ae2d3cdffe70184eb8736d94f76c45c93f4b7724



Full URL: https://github.com/mbedmicro/mbed/commit/ae2d3cdffe70184eb8736d94f76c45c93f4b7724/



Make it possible to build the core mbed library with yotta

Who changed what in which revision?

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