mbed official / mbed

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
112:6f327212ef96
Release 122 of the mbed library

Changes:
- new targets - Nucleo L432KC, Beetle, Nucleo F446ZE, Nucleo L011K4
- Thread safety addition - mbed API should contain a statement about thread safety
- critical section API addition
- CAS API (core_util_atomic_incr/decr)
- DEVICE_ are generated from targets.json file, device.h deprecated
- Callback replaces FunctionPointer to provide std like interface
- mbed HAL API docs improvements
- toolchain - prexif attributes with MBED_
- add new attributes - packed, weak, forcedinline, align
- target.json - contains targets definitions
- ST - L1XX - Cube update to 1.5
- SPI clock selection fix (clock from APB domain)
- F7 - Cube update v1.4.0
- L0 - baudrate init fix
- L1 - Cube update v1.5
- F3 - baudrate init fix, 3 targets CAN support
- F4 - Cube update v1.12.0, 3 targets CAN support
- L4XX - Cube update v1.5.1
- F0 - update Cube to v1.5.0
- L4 - 2 targets (L476RG/VG) CAN support
- NXP - pwm clock fix for KSDK2 MCU
- LPC2368 - remove ARM toolchain support - due to regression
- KSDK2 - fix SPI , I2C address and repeat start
- Silabs - some fixes backported from mbed 3
- Renesas - RZ_A1H - SystemCoreClockUpdate addition

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 112:6f327212ef96 1 /**
Kojto 112:6f327212ef96 2 ******************************************************************************
Kojto 112:6f327212ef96 3 * @file stm32f4xx.h
Kojto 112:6f327212ef96 4 * @author MCD Application Team
Kojto 122:f9eeca106725 5 * @version V2.5.0
Kojto 122:f9eeca106725 6 * @date 22-April-2016
Kojto 122:f9eeca106725 7 * @brief CMSIS STM32F4xx Device Peripheral Access Layer Header File.
Kojto 112:6f327212ef96 8 *
Kojto 112:6f327212ef96 9 * The file is the unique include file that the application programmer
Kojto 112:6f327212ef96 10 * is using in the C source code, usually in main.c. This file contains:
Kojto 112:6f327212ef96 11 * - Configuration section that allows to select:
Kojto 112:6f327212ef96 12 * - The STM32F4xx device used in the target application
Kojto 122:f9eeca106725 13 * - To use or not the peripheral's drivers in application code(i.e.
Kojto 122:f9eeca106725 14 * code will be based on direct access to peripheral's registers
Kojto 112:6f327212ef96 15 * rather than drivers API), this option is controlled by
Kojto 112:6f327212ef96 16 * "#define USE_HAL_DRIVER"
Kojto 112:6f327212ef96 17 *
Kojto 112:6f327212ef96 18 ******************************************************************************
Kojto 112:6f327212ef96 19 * @attention
Kojto 112:6f327212ef96 20 *
Kojto 122:f9eeca106725 21 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
Kojto 112:6f327212ef96 22 *
Kojto 112:6f327212ef96 23 * Redistribution and use in source and binary forms, with or without modification,
Kojto 112:6f327212ef96 24 * are permitted provided that the following conditions are met:
Kojto 112:6f327212ef96 25 * 1. Redistributions of source code must retain the above copyright notice,
Kojto 112:6f327212ef96 26 * this list of conditions and the following disclaimer.
Kojto 112:6f327212ef96 27 * 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto 112:6f327212ef96 28 * this list of conditions and the following disclaimer in the documentation
Kojto 112:6f327212ef96 29 * and/or other materials provided with the distribution.
Kojto 112:6f327212ef96 30 * 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto 112:6f327212ef96 31 * may be used to endorse or promote products derived from this software
Kojto 112:6f327212ef96 32 * without specific prior written permission.
Kojto 112:6f327212ef96 33 *
Kojto 112:6f327212ef96 34 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto 112:6f327212ef96 35 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto 112:6f327212ef96 36 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto 112:6f327212ef96 37 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto 112:6f327212ef96 38 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto 112:6f327212ef96 39 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto 112:6f327212ef96 40 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto 112:6f327212ef96 41 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto 112:6f327212ef96 42 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto 112:6f327212ef96 43 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto 112:6f327212ef96 44 *
Kojto 112:6f327212ef96 45 ******************************************************************************
Kojto 112:6f327212ef96 46 */
Kojto 112:6f327212ef96 47
Kojto 112:6f327212ef96 48 /** @addtogroup CMSIS
Kojto 112:6f327212ef96 49 * @{
Kojto 112:6f327212ef96 50 */
Kojto 112:6f327212ef96 51
Kojto 112:6f327212ef96 52 /** @addtogroup stm32f4xx
Kojto 112:6f327212ef96 53 * @{
Kojto 112:6f327212ef96 54 */
Kojto 112:6f327212ef96 55
Kojto 112:6f327212ef96 56 #ifndef __STM32F4xx_H
Kojto 112:6f327212ef96 57 #define __STM32F4xx_H
Kojto 112:6f327212ef96 58
Kojto 112:6f327212ef96 59 #ifdef __cplusplus
Kojto 112:6f327212ef96 60 extern "C" {
Kojto 112:6f327212ef96 61 #endif /* __cplusplus */
Kojto 112:6f327212ef96 62
Kojto 112:6f327212ef96 63 /** @addtogroup Library_configuration_section
Kojto 112:6f327212ef96 64 * @{
Kojto 112:6f327212ef96 65 */
Kojto 112:6f327212ef96 66
Kojto 112:6f327212ef96 67 /**
Kojto 112:6f327212ef96 68 * @brief STM32 Family
Kojto 112:6f327212ef96 69 */
Kojto 112:6f327212ef96 70 #if !defined (STM32F4)
Kojto 112:6f327212ef96 71 #define STM32F4
Kojto 112:6f327212ef96 72 #endif /* STM32F4 */
Kojto 112:6f327212ef96 73
Kojto 112:6f327212ef96 74 /* Uncomment the line below according to the target STM32 device used in your
Kojto 112:6f327212ef96 75 application
Kojto 112:6f327212ef96 76 */
Kojto 112:6f327212ef96 77 #if !defined (STM32F405xx) && !defined (STM32F415xx) && !defined (STM32F407xx) && !defined (STM32F417xx) && \
Kojto 112:6f327212ef96 78 !defined (STM32F427xx) && !defined (STM32F437xx) && !defined (STM32F429xx) && !defined (STM32F439xx) && \
Kojto 122:f9eeca106725 79 !defined (STM32F401xC) && !defined (STM32F401xE) && !defined (STM32F410Tx) && !defined (STM32F410Cx) && \
Kojto 122:f9eeca106725 80 !defined (STM32F410Rx) && !defined (STM32F411xE) && !defined (STM32F446xx) && !defined (STM32F469xx) && \
Kojto 122:f9eeca106725 81 !defined (STM32F479xx) && !defined (STM32F412Cx) && !defined (STM32F412Rx) && !defined (STM32F412Vx) && \
Kojto 122:f9eeca106725 82 !defined (STM32F412Zx)
Kojto 112:6f327212ef96 83 /* #define STM32F405xx */ /*!< STM32F405RG, STM32F405VG and STM32F405ZG Devices */
Kojto 112:6f327212ef96 84 /* #define STM32F415xx */ /*!< STM32F415RG, STM32F415VG and STM32F415ZG Devices */
Kojto 112:6f327212ef96 85 /* #define STM32F407xx */ /*!< STM32F407VG, STM32F407VE, STM32F407ZG, STM32F407ZE, STM32F407IG and STM32F407IE Devices */
Kojto 112:6f327212ef96 86 /* #define STM32F417xx */ /*!< STM32F417VG, STM32F417VE, STM32F417ZG, STM32F417ZE, STM32F417IG and STM32F417IE Devices */
Kojto 112:6f327212ef96 87 /* #define STM32F427xx */ /*!< STM32F427VG, STM32F427VI, STM32F427ZG, STM32F427ZI, STM32F427IG and STM32F427II Devices */
Kojto 112:6f327212ef96 88 /* #define STM32F437xx */ /*!< STM32F437VG, STM32F437VI, STM32F437ZG, STM32F437ZI, STM32F437IG and STM32F437II Devices */
Kojto 112:6f327212ef96 89 /* #define STM32F429xx */ /*!< STM32F429VG, STM32F429VI, STM32F429ZG, STM32F429ZI, STM32F429BG, STM32F429BI, STM32F429NG,
Kojto 112:6f327212ef96 90 STM32F439NI, STM32F429IG and STM32F429II Devices */
Kojto 112:6f327212ef96 91 /* #define STM32F439xx */ /*!< STM32F439VG, STM32F439VI, STM32F439ZG, STM32F439ZI, STM32F439BG, STM32F439BI, STM32F439NG,
Kojto 112:6f327212ef96 92 STM32F439NI, STM32F439IG and STM32F439II Devices */
Kojto 112:6f327212ef96 93 /* #define STM32F401xC */ /*!< STM32F401CB, STM32F401CC, STM32F401RB, STM32F401RC, STM32F401VB and STM32F401VC Devices */
Kojto 112:6f327212ef96 94 /* #define STM32F401xE */ /*!< STM32F401CD, STM32F401RD, STM32F401VD, STM32F401CE, STM32F401RE and STM32F401VE Devices */
Kojto 122:f9eeca106725 95 /* #define STM32F410Tx */ /*!< STM32F410T8 and STM32F410TB Devices */
Kojto 122:f9eeca106725 96 /* #define STM32F410Cx */ /*!< STM32F410C8 and STM32F410CB Devices */
Kojto 122:f9eeca106725 97 /* #define STM32F410Rx */ /*!< STM32F410R8 and STM32F410RB Devices */
Kojto 122:f9eeca106725 98 /* #define STM32F411xE */ /*!< STM32F411CC, STM32F411RC, STM32F411VC, STM32F411CE, STM32F411RE and STM32F411VE Devices */
Kojto 122:f9eeca106725 99 #define STM32F446xx /*!< STM32F446MC, STM32F446ME, STM32F446RC, STM32F446RE, STM32F446VC, STM32F446VE, STM32F446ZC,
Kojto 122:f9eeca106725 100 and STM32F446ZE Devices */
Kojto 122:f9eeca106725 101 /* #define STM32F469xx */ /*!< STM32F469AI, STM32F469II, STM32F469BI, STM32F469NI, STM32F469AG, STM32F469IG, STM32F469BG,
Kojto 122:f9eeca106725 102 STM32F469NG, STM32F469AE, STM32F469IE, STM32F469BE and STM32F469NE Devices */
Kojto 122:f9eeca106725 103 /* #define STM32F479xx */ /*!< STM32F479AI, STM32F479II, STM32F479BI, STM32F479NI, STM32F479AG, STM32F479IG, STM32F479BG
Kojto 122:f9eeca106725 104 and STM32F479NG Devices */
Kojto 122:f9eeca106725 105 /* #define STM32F412Cx */ /*!< STM32F412CEU and STM32F412CGU Devices */
Kojto 122:f9eeca106725 106 /* #define STM32F412Zx */ /*!< STM32F412ZET, STM32F412ZGT, STM32F412ZEJ and STM32F412ZGJ Devices */
Kojto 122:f9eeca106725 107 /* #define STM32F412Vx */ /*!< STM32F412VET, STM32F412VGT, STM32F412VEH and STM32F412VGH Devices */
Kojto 122:f9eeca106725 108 /* #define STM32F412Rx */ /*!< STM32F412RET, STM32F412RGT, STM32F412REY and STM32F412RGY Devices */
Kojto 112:6f327212ef96 109 #endif
Kojto 112:6f327212ef96 110
Kojto 112:6f327212ef96 111 /* Tip: To avoid modifying this file each time you need to switch between these
Kojto 112:6f327212ef96 112 devices, you can define the device in your toolchain compiler preprocessor.
Kojto 112:6f327212ef96 113 */
Kojto 112:6f327212ef96 114 #if !defined (USE_HAL_DRIVER)
Kojto 112:6f327212ef96 115 /**
Kojto 112:6f327212ef96 116 * @brief Comment the line below if you will not use the peripherals drivers.
Kojto 112:6f327212ef96 117 In this case, these drivers will not be included and the application code will
Kojto 112:6f327212ef96 118 be based on direct access to peripherals registers
Kojto 112:6f327212ef96 119 */
Kojto 112:6f327212ef96 120 #define USE_HAL_DRIVER
Kojto 112:6f327212ef96 121 #endif /* USE_HAL_DRIVER */
Kojto 112:6f327212ef96 122
Kojto 112:6f327212ef96 123 /**
Kojto 122:f9eeca106725 124 * @brief CMSIS version number V2.5.0
Kojto 112:6f327212ef96 125 */
Kojto 122:f9eeca106725 126 #define __STM32F4xx_CMSIS_VERSION_MAIN (0x02U) /*!< [31:24] main version */
Kojto 122:f9eeca106725 127 #define __STM32F4xx_CMSIS_VERSION_SUB1 (0x05U) /*!< [23:16] sub1 version */
Kojto 122:f9eeca106725 128 #define __STM32F4xx_CMSIS_VERSION_SUB2 (0x00U) /*!< [15:8] sub2 version */
Kojto 122:f9eeca106725 129 #define __STM32F4xx_CMSIS_VERSION_RC (0x00U) /*!< [7:0] release candidate */
Kojto 122:f9eeca106725 130 #define __STM32F4xx_CMSIS_VERSION ((__STM32F4xx_CMSIS_VERSION_MAIN << 24)\
Kojto 122:f9eeca106725 131 |(__STM32F4xx_CMSIS_VERSION_SUB1 << 16)\
Kojto 122:f9eeca106725 132 |(__STM32F4xx_CMSIS_VERSION_SUB2 << 8 )\
Kojto 122:f9eeca106725 133 |(__STM32F4xx_CMSIS_VERSION))
Kojto 122:f9eeca106725 134
Kojto 112:6f327212ef96 135 /**
Kojto 112:6f327212ef96 136 * @}
Kojto 112:6f327212ef96 137 */
Kojto 112:6f327212ef96 138
Kojto 112:6f327212ef96 139 /** @addtogroup Device_Included
Kojto 112:6f327212ef96 140 * @{
Kojto 112:6f327212ef96 141 */
Kojto 112:6f327212ef96 142
Kojto 112:6f327212ef96 143 #if defined(STM32F405xx)
Kojto 112:6f327212ef96 144 #include "stm32f405xx.h"
Kojto 112:6f327212ef96 145 #elif defined(STM32F415xx)
Kojto 112:6f327212ef96 146 #include "stm32f415xx.h"
Kojto 112:6f327212ef96 147 #elif defined(STM32F407xx)
Kojto 112:6f327212ef96 148 #include "stm32f407xx.h"
Kojto 112:6f327212ef96 149 #elif defined(STM32F417xx)
Kojto 112:6f327212ef96 150 #include "stm32f417xx.h"
Kojto 112:6f327212ef96 151 #elif defined(STM32F427xx)
Kojto 112:6f327212ef96 152 #include "stm32f427xx.h"
Kojto 112:6f327212ef96 153 #elif defined(STM32F437xx)
Kojto 112:6f327212ef96 154 #include "stm32f437xx.h"
Kojto 112:6f327212ef96 155 #elif defined(STM32F429xx)
Kojto 112:6f327212ef96 156 #include "stm32f429xx.h"
Kojto 112:6f327212ef96 157 #elif defined(STM32F439xx)
Kojto 112:6f327212ef96 158 #include "stm32f439xx.h"
Kojto 112:6f327212ef96 159 #elif defined(STM32F401xC)
Kojto 112:6f327212ef96 160 #include "stm32f401xc.h"
Kojto 112:6f327212ef96 161 #elif defined(STM32F401xE)
Kojto 112:6f327212ef96 162 #include "stm32f401xe.h"
Kojto 122:f9eeca106725 163 #elif defined(STM32F410Tx)
Kojto 122:f9eeca106725 164 #include "stm32f410tx.h"
Kojto 122:f9eeca106725 165 #elif defined(STM32F410Cx)
Kojto 122:f9eeca106725 166 #include "stm32f410cx.h"
Kojto 122:f9eeca106725 167 #elif defined(STM32F410Rx)
Kojto 122:f9eeca106725 168 #include "stm32f410rx.h"
Kojto 112:6f327212ef96 169 #elif defined(STM32F411xE)
Kojto 112:6f327212ef96 170 #include "stm32f411xe.h"
Kojto 112:6f327212ef96 171 #elif defined(STM32F446xx)
Kojto 112:6f327212ef96 172 #include "stm32f446xx.h"
Kojto 122:f9eeca106725 173 #elif defined(STM32F469xx)
Kojto 122:f9eeca106725 174 #include "stm32f469xx.h"
Kojto 122:f9eeca106725 175 #elif defined(STM32F479xx)
Kojto 122:f9eeca106725 176 #include "stm32f479xx.h"
Kojto 122:f9eeca106725 177 #elif defined(STM32F412Cx)
Kojto 122:f9eeca106725 178 #include "stm32f412cx.h"
Kojto 122:f9eeca106725 179 #elif defined(STM32F412Zx)
Kojto 122:f9eeca106725 180 #include "stm32f412zx.h"
Kojto 122:f9eeca106725 181 #elif defined(STM32F412Rx)
Kojto 122:f9eeca106725 182 #include "stm32f412rx.h"
Kojto 122:f9eeca106725 183 #elif defined(STM32F412Vx)
Kojto 122:f9eeca106725 184 #include "stm32f412vx.h"
Kojto 112:6f327212ef96 185 #else
Kojto 112:6f327212ef96 186 #error "Please select first the target STM32F4xx device used in your application (in stm32f4xx.h file)"
Kojto 112:6f327212ef96 187 #endif
Kojto 112:6f327212ef96 188
Kojto 112:6f327212ef96 189 /**
Kojto 112:6f327212ef96 190 * @}
Kojto 112:6f327212ef96 191 */
Kojto 112:6f327212ef96 192
Kojto 112:6f327212ef96 193 /** @addtogroup Exported_types
Kojto 112:6f327212ef96 194 * @{
Kojto 112:6f327212ef96 195 */
Kojto 112:6f327212ef96 196 typedef enum
Kojto 112:6f327212ef96 197 {
Kojto 122:f9eeca106725 198 RESET = 0U,
Kojto 112:6f327212ef96 199 SET = !RESET
Kojto 112:6f327212ef96 200 } FlagStatus, ITStatus;
Kojto 112:6f327212ef96 201
Kojto 112:6f327212ef96 202 typedef enum
Kojto 112:6f327212ef96 203 {
Kojto 122:f9eeca106725 204 DISABLE = 0U,
Kojto 112:6f327212ef96 205 ENABLE = !DISABLE
Kojto 112:6f327212ef96 206 } FunctionalState;
Kojto 112:6f327212ef96 207 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
Kojto 112:6f327212ef96 208
Kojto 112:6f327212ef96 209 typedef enum
Kojto 112:6f327212ef96 210 {
Kojto 122:f9eeca106725 211 ERROR = 0U,
Kojto 112:6f327212ef96 212 SUCCESS = !ERROR
Kojto 112:6f327212ef96 213 } ErrorStatus;
Kojto 112:6f327212ef96 214
Kojto 112:6f327212ef96 215 /**
Kojto 112:6f327212ef96 216 * @}
Kojto 112:6f327212ef96 217 */
Kojto 112:6f327212ef96 218
Kojto 112:6f327212ef96 219
Kojto 112:6f327212ef96 220 /** @addtogroup Exported_macro
Kojto 112:6f327212ef96 221 * @{
Kojto 112:6f327212ef96 222 */
Kojto 112:6f327212ef96 223 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
Kojto 112:6f327212ef96 224
Kojto 112:6f327212ef96 225 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
Kojto 112:6f327212ef96 226
Kojto 112:6f327212ef96 227 #define READ_BIT(REG, BIT) ((REG) & (BIT))
Kojto 112:6f327212ef96 228
Kojto 112:6f327212ef96 229 #define CLEAR_REG(REG) ((REG) = (0x0))
Kojto 112:6f327212ef96 230
Kojto 112:6f327212ef96 231 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
Kojto 112:6f327212ef96 232
Kojto 112:6f327212ef96 233 #define READ_REG(REG) ((REG))
Kojto 112:6f327212ef96 234
Kojto 112:6f327212ef96 235 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
Kojto 112:6f327212ef96 236
Kojto 112:6f327212ef96 237 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
Kojto 112:6f327212ef96 238
Kojto 112:6f327212ef96 239
Kojto 112:6f327212ef96 240 /**
Kojto 112:6f327212ef96 241 * @}
Kojto 112:6f327212ef96 242 */
Kojto 112:6f327212ef96 243
Kojto 112:6f327212ef96 244 #if defined (USE_HAL_DRIVER)
Kojto 112:6f327212ef96 245 #include "stm32f4xx_hal.h"
Kojto 112:6f327212ef96 246 #endif /* USE_HAL_DRIVER */
Kojto 112:6f327212ef96 247
Kojto 112:6f327212ef96 248 #ifdef __cplusplus
Kojto 112:6f327212ef96 249 }
Kojto 112:6f327212ef96 250 #endif /* __cplusplus */
Kojto 112:6f327212ef96 251
Kojto 112:6f327212ef96 252 #endif /* __STM32F4xx_H */
Kojto 112:6f327212ef96 253 /**
Kojto 112:6f327212ef96 254 * @}
Kojto 112:6f327212ef96 255 */
Kojto 112:6f327212ef96 256
Kojto 112:6f327212ef96 257 /**
Kojto 112:6f327212ef96 258 * @}
Kojto 112:6f327212ef96 259 */
Kojto 112:6f327212ef96 260
Kojto 112:6f327212ef96 261
Kojto 112:6f327212ef96 262
Kojto 112:6f327212ef96 263
Kojto 112:6f327212ef96 264 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/