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_def.h@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_def.h
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 This file contains HAL common defines, enumeration, macros and
mbed_official 235:685d5f11838f 8 * structures definitions.
mbed_official 235:685d5f11838f 9 ******************************************************************************
mbed_official 235:685d5f11838f 10 * @attention
mbed_official 235:685d5f11838f 11 *
mbed_official 532:fe11edbda85c 12 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 235:685d5f11838f 13 *
mbed_official 235:685d5f11838f 14 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 235:685d5f11838f 15 * are permitted provided that the following conditions are met:
mbed_official 235:685d5f11838f 16 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 235:685d5f11838f 17 * this list of conditions and the following disclaimer.
mbed_official 235:685d5f11838f 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 235:685d5f11838f 19 * this list of conditions and the following disclaimer in the documentation
mbed_official 235:685d5f11838f 20 * and/or other materials provided with the distribution.
mbed_official 235:685d5f11838f 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 235:685d5f11838f 22 * may be used to endorse or promote products derived from this software
mbed_official 235:685d5f11838f 23 * without specific prior written permission.
mbed_official 235:685d5f11838f 24 *
mbed_official 235:685d5f11838f 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 235:685d5f11838f 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 235:685d5f11838f 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 235:685d5f11838f 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 235:685d5f11838f 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 235:685d5f11838f 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 235:685d5f11838f 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 235:685d5f11838f 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 235:685d5f11838f 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 235:685d5f11838f 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 235:685d5f11838f 35 *
mbed_official 235:685d5f11838f 36 ******************************************************************************
mbed_official 235:685d5f11838f 37 */
mbed_official 235:685d5f11838f 38
mbed_official 235:685d5f11838f 39 /* Define to prevent recursive inclusion -------------------------------------*/
mbed_official 235:685d5f11838f 40 #ifndef __STM32F4xx_HAL_DEF
mbed_official 235:685d5f11838f 41 #define __STM32F4xx_HAL_DEF
mbed_official 235:685d5f11838f 42
mbed_official 235:685d5f11838f 43 #ifdef __cplusplus
mbed_official 235:685d5f11838f 44 extern "C" {
mbed_official 235:685d5f11838f 45 #endif
mbed_official 235:685d5f11838f 46
mbed_official 235:685d5f11838f 47 /* Includes ------------------------------------------------------------------*/
mbed_official 235:685d5f11838f 48 #include "stm32f4xx.h"
mbed_official 532:fe11edbda85c 49 #include "stm32_hal_legacy.h"
mbed_official 532:fe11edbda85c 50 #include <stdio.h>
mbed_official 235:685d5f11838f 51
mbed_official 235:685d5f11838f 52 /* Exported types ------------------------------------------------------------*/
mbed_official 235:685d5f11838f 53
mbed_official 235:685d5f11838f 54 /**
mbed_official 235:685d5f11838f 55 * @brief HAL Status structures definition
mbed_official 235:685d5f11838f 56 */
mbed_official 235:685d5f11838f 57 typedef enum
mbed_official 235:685d5f11838f 58 {
mbed_official 235:685d5f11838f 59 HAL_OK = 0x00,
mbed_official 235:685d5f11838f 60 HAL_ERROR = 0x01,
mbed_official 235:685d5f11838f 61 HAL_BUSY = 0x02,
mbed_official 235:685d5f11838f 62 HAL_TIMEOUT = 0x03
mbed_official 235:685d5f11838f 63 } HAL_StatusTypeDef;
mbed_official 235:685d5f11838f 64
mbed_official 235:685d5f11838f 65 /**
mbed_official 235:685d5f11838f 66 * @brief HAL Lock structures definition
mbed_official 235:685d5f11838f 67 */
mbed_official 235:685d5f11838f 68 typedef enum
mbed_official 235:685d5f11838f 69 {
mbed_official 235:685d5f11838f 70 HAL_UNLOCKED = 0x00,
mbed_official 235:685d5f11838f 71 HAL_LOCKED = 0x01
mbed_official 235:685d5f11838f 72 } HAL_LockTypeDef;
mbed_official 235:685d5f11838f 73
mbed_official 235:685d5f11838f 74 /* Exported macro ------------------------------------------------------------*/
mbed_official 532:fe11edbda85c 75 //#ifndef NULL
mbed_official 352:95e80f5e68f6 76 #define HAL_NULL (void *) 0
mbed_official 532:fe11edbda85c 77 //#endif
mbed_official 235:685d5f11838f 78 #define HAL_MAX_DELAY 0xFFFFFFFF
mbed_official 235:685d5f11838f 79
mbed_official 235:685d5f11838f 80 #define HAL_IS_BIT_SET(REG, BIT) (((REG) & (BIT)) != RESET)
mbed_official 235:685d5f11838f 81 #define HAL_IS_BIT_CLR(REG, BIT) (((REG) & (BIT)) == RESET)
mbed_official 235:685d5f11838f 82
mbed_official 235:685d5f11838f 83 #define __HAL_LINKDMA(__HANDLE__, __PPP_DMA_FIELD__, __DMA_HANDLE__) \
mbed_official 235:685d5f11838f 84 do{ \
mbed_official 235:685d5f11838f 85 (__HANDLE__)->__PPP_DMA_FIELD__ = &(__DMA_HANDLE__); \
mbed_official 235:685d5f11838f 86 (__DMA_HANDLE__).Parent = (__HANDLE__); \
mbed_official 235:685d5f11838f 87 } while(0)
mbed_official 235:685d5f11838f 88
mbed_official 532:fe11edbda85c 89 #define UNUSED(x) ((void)(x))
mbed_official 532:fe11edbda85c 90
mbed_official 235:685d5f11838f 91 /** @brief Reset the Handle's State field.
mbed_official 235:685d5f11838f 92 * @param __HANDLE__: specifies the Peripheral Handle.
mbed_official 235:685d5f11838f 93 * @note This macro can be used for the following purpose:
mbed_official 235:685d5f11838f 94 * - When the Handle is declared as local variable; before passing it as parameter
mbed_official 235:685d5f11838f 95 * to HAL_PPP_Init() for the first time, it is mandatory to use this macro
mbed_official 235:685d5f11838f 96 * to set to 0 the Handle's "State" field.
mbed_official 235:685d5f11838f 97 * Otherwise, "State" field may have any random value and the first time the function
mbed_official 235:685d5f11838f 98 * HAL_PPP_Init() is called, the low level hardware initialization will be missed
mbed_official 235:685d5f11838f 99 * (i.e. HAL_PPP_MspInit() will not be executed).
mbed_official 235:685d5f11838f 100 * - When there is a need to reconfigure the low level hardware: instead of calling
mbed_official 235:685d5f11838f 101 * HAL_PPP_DeInit() then HAL_PPP_Init(), user can make a call to this macro then HAL_PPP_Init().
mbed_official 235:685d5f11838f 102 * In this later function, when the Handle's "State" field is set to 0, it will execute the function
mbed_official 235:685d5f11838f 103 * HAL_PPP_MspInit() which will reconfigure the low level hardware.
mbed_official 235:685d5f11838f 104 * @retval None
mbed_official 235:685d5f11838f 105 */
mbed_official 235:685d5f11838f 106 #define __HAL_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = 0)
mbed_official 235:685d5f11838f 107
mbed_official 235:685d5f11838f 108 #if (USE_RTOS == 1)
mbed_official 235:685d5f11838f 109 /* Reserved for future use */
mbed_official 235:685d5f11838f 110 #error “USE_RTOS should be 0 in the current HAL release”
mbed_official 235:685d5f11838f 111 #else
mbed_official 235:685d5f11838f 112 #define __HAL_LOCK(__HANDLE__) \
mbed_official 235:685d5f11838f 113 do{ \
mbed_official 235:685d5f11838f 114 if((__HANDLE__)->Lock == HAL_LOCKED) \
mbed_official 235:685d5f11838f 115 { \
mbed_official 235:685d5f11838f 116 return HAL_BUSY; \
mbed_official 235:685d5f11838f 117 } \
mbed_official 235:685d5f11838f 118 else \
mbed_official 235:685d5f11838f 119 { \
mbed_official 235:685d5f11838f 120 (__HANDLE__)->Lock = HAL_LOCKED; \
mbed_official 235:685d5f11838f 121 } \
mbed_official 235:685d5f11838f 122 }while (0)
mbed_official 235:685d5f11838f 123
mbed_official 235:685d5f11838f 124 #define __HAL_UNLOCK(__HANDLE__) \
mbed_official 235:685d5f11838f 125 do{ \
mbed_official 235:685d5f11838f 126 (__HANDLE__)->Lock = HAL_UNLOCKED; \
mbed_official 235:685d5f11838f 127 }while (0)
mbed_official 235:685d5f11838f 128 #endif /* USE_RTOS */
mbed_official 235:685d5f11838f 129
mbed_official 235:685d5f11838f 130 #if defined ( __GNUC__ )
mbed_official 235:685d5f11838f 131 #ifndef __weak
mbed_official 235:685d5f11838f 132 #define __weak __attribute__((weak))
mbed_official 235:685d5f11838f 133 #endif /* __weak */
mbed_official 235:685d5f11838f 134 #ifndef __packed
mbed_official 235:685d5f11838f 135 #define __packed __attribute__((__packed__))
mbed_official 235:685d5f11838f 136 #endif /* __packed */
mbed_official 235:685d5f11838f 137 #endif /* __GNUC__ */
mbed_official 235:685d5f11838f 138
mbed_official 235:685d5f11838f 139
mbed_official 235:685d5f11838f 140 /* Macro to get variable aligned on 4-bytes, for __ICCARM__ the directive "#pragma data_alignment=4" must be used instead */
mbed_official 235:685d5f11838f 141 #if defined (__GNUC__) /* GNU Compiler */
mbed_official 235:685d5f11838f 142 #ifndef __ALIGN_END
mbed_official 235:685d5f11838f 143 #define __ALIGN_END __attribute__ ((aligned (4)))
mbed_official 235:685d5f11838f 144 #endif /* __ALIGN_END */
mbed_official 235:685d5f11838f 145 #ifndef __ALIGN_BEGIN
mbed_official 235:685d5f11838f 146 #define __ALIGN_BEGIN
mbed_official 235:685d5f11838f 147 #endif /* __ALIGN_BEGIN */
mbed_official 235:685d5f11838f 148 #else
mbed_official 235:685d5f11838f 149 #ifndef __ALIGN_END
mbed_official 235:685d5f11838f 150 #define __ALIGN_END
mbed_official 235:685d5f11838f 151 #endif /* __ALIGN_END */
mbed_official 235:685d5f11838f 152 #ifndef __ALIGN_BEGIN
mbed_official 235:685d5f11838f 153 #if defined (__CC_ARM) /* ARM Compiler */
mbed_official 235:685d5f11838f 154 #define __ALIGN_BEGIN __align(4)
mbed_official 235:685d5f11838f 155 #elif defined (__ICCARM__) /* IAR Compiler */
mbed_official 235:685d5f11838f 156 #define __ALIGN_BEGIN
mbed_official 235:685d5f11838f 157 #endif /* __CC_ARM */
mbed_official 235:685d5f11838f 158 #endif /* __ALIGN_BEGIN */
mbed_official 235:685d5f11838f 159 #endif /* __GNUC__ */
mbed_official 235:685d5f11838f 160
mbed_official 235:685d5f11838f 161
mbed_official 235:685d5f11838f 162 /**
mbed_official 235:685d5f11838f 163 * @brief __RAM_FUNC definition
mbed_official 235:685d5f11838f 164 */
mbed_official 235:685d5f11838f 165 #if defined ( __CC_ARM )
mbed_official 235:685d5f11838f 166 /* ARM Compiler
mbed_official 235:685d5f11838f 167 ------------
mbed_official 235:685d5f11838f 168 RAM functions are defined using the toolchain options.
mbed_official 235:685d5f11838f 169 Functions that are executed in RAM should reside in a separate source module.
mbed_official 235:685d5f11838f 170 Using the 'Options for File' dialog you can simply change the 'Code / Const'
mbed_official 235:685d5f11838f 171 area of a module to a memory space in physical RAM.
mbed_official 235:685d5f11838f 172 Available memory areas are declared in the 'Target' tab of the 'Options for Target'
mbed_official 235:685d5f11838f 173 dialog.
mbed_official 235:685d5f11838f 174 */
mbed_official 235:685d5f11838f 175 #define __RAM_FUNC HAL_StatusTypeDef
mbed_official 235:685d5f11838f 176
mbed_official 235:685d5f11838f 177 #elif defined ( __ICCARM__ )
mbed_official 235:685d5f11838f 178 /* ICCARM Compiler
mbed_official 235:685d5f11838f 179 ---------------
mbed_official 235:685d5f11838f 180 RAM functions are defined using a specific toolchain keyword "__ramfunc".
mbed_official 235:685d5f11838f 181 */
mbed_official 235:685d5f11838f 182 #define __RAM_FUNC __ramfunc HAL_StatusTypeDef
mbed_official 235:685d5f11838f 183
mbed_official 235:685d5f11838f 184 #elif defined ( __GNUC__ )
mbed_official 235:685d5f11838f 185 /* GNU Compiler
mbed_official 235:685d5f11838f 186 ------------
mbed_official 235:685d5f11838f 187 RAM functions are defined using a specific toolchain attribute
mbed_official 235:685d5f11838f 188 "__attribute__((section(".RamFunc")))".
mbed_official 235:685d5f11838f 189 */
mbed_official 235:685d5f11838f 190 #define __RAM_FUNC HAL_StatusTypeDef __attribute__((section(".RamFunc")))
mbed_official 235:685d5f11838f 191
mbed_official 235:685d5f11838f 192 #endif
mbed_official 235:685d5f11838f 193
mbed_official 532:fe11edbda85c 194 /**
mbed_official 532:fe11edbda85c 195 * @brief __NOINLINE definition
mbed_official 532:fe11edbda85c 196 */
mbed_official 532:fe11edbda85c 197 #if defined ( __CC_ARM ) || defined ( __GNUC__ )
mbed_official 532:fe11edbda85c 198 /* ARM & GNUCompiler
mbed_official 532:fe11edbda85c 199 ----------------
mbed_official 532:fe11edbda85c 200 */
mbed_official 532:fe11edbda85c 201 #define __NOINLINE __attribute__ ( (noinline) )
mbed_official 532:fe11edbda85c 202
mbed_official 532:fe11edbda85c 203 #elif defined ( __ICCARM__ )
mbed_official 532:fe11edbda85c 204 /* ICCARM Compiler
mbed_official 532:fe11edbda85c 205 ---------------
mbed_official 532:fe11edbda85c 206 */
mbed_official 532:fe11edbda85c 207 #define __NOINLINE _Pragma("optimize = no_inline")
mbed_official 532:fe11edbda85c 208
mbed_official 532:fe11edbda85c 209 #endif
mbed_official 235:685d5f11838f 210
mbed_official 235:685d5f11838f 211 #ifdef __cplusplus
mbed_official 235:685d5f11838f 212 }
mbed_official 235:685d5f11838f 213 #endif
mbed_official 235:685d5f11838f 214
mbed_official 235:685d5f11838f 215 #endif /* ___STM32F4xx_HAL_DEF */
mbed_official 235:685d5f11838f 216
mbed_official 235:685d5f11838f 217 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/