mbed official / mbed

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
106:ba1f97679dad
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 106:ba1f97679dad 1 /**
Kojto 106:ba1f97679dad 2 ******************************************************************************
Kojto 106:ba1f97679dad 3 * @file stm32f4xx.h
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 8 *
Kojto 106:ba1f97679dad 9 * The file is the unique include file that the application programmer
Kojto 106:ba1f97679dad 10 * is using in the C source code, usually in main.c. This file contains:
Kojto 106:ba1f97679dad 11 * - Configuration section that allows to select:
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 15 * rather than drivers API), this option is controlled by
Kojto 106:ba1f97679dad 16 * "#define USE_HAL_DRIVER"
Kojto 106:ba1f97679dad 17 *
Kojto 106:ba1f97679dad 18 ******************************************************************************
Kojto 106:ba1f97679dad 19 * @attention
Kojto 106:ba1f97679dad 20 *
Kojto 122:f9eeca106725 21 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
Kojto 106:ba1f97679dad 22 *
Kojto 106:ba1f97679dad 23 * Redistribution and use in source and binary forms, with or without modification,
Kojto 106:ba1f97679dad 24 * are permitted provided that the following conditions are met:
Kojto 106:ba1f97679dad 25 * 1. Redistributions of source code must retain the above copyright notice,
Kojto 106:ba1f97679dad 26 * this list of conditions and the following disclaimer.
Kojto 106:ba1f97679dad 27 * 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto 106:ba1f97679dad 28 * this list of conditions and the following disclaimer in the documentation
Kojto 106:ba1f97679dad 29 * and/or other materials provided with the distribution.
Kojto 106:ba1f97679dad 30 * 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto 106:ba1f97679dad 31 * may be used to endorse or promote products derived from this software
Kojto 106:ba1f97679dad 32 * without specific prior written permission.
Kojto 106:ba1f97679dad 33 *
Kojto 106:ba1f97679dad 34 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto 106:ba1f97679dad 35 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto 106:ba1f97679dad 36 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto 106:ba1f97679dad 37 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto 106:ba1f97679dad 38 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto 106:ba1f97679dad 39 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto 106:ba1f97679dad 40 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto 106:ba1f97679dad 41 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto 106:ba1f97679dad 42 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto 106:ba1f97679dad 43 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto 106:ba1f97679dad 44 *
Kojto 106:ba1f97679dad 45 ******************************************************************************
Kojto 106:ba1f97679dad 46 */
Kojto 106:ba1f97679dad 47
Kojto 106:ba1f97679dad 48 /** @addtogroup CMSIS
Kojto 106:ba1f97679dad 49 * @{
Kojto 106:ba1f97679dad 50 */
Kojto 106:ba1f97679dad 51
Kojto 106:ba1f97679dad 52 /** @addtogroup stm32f4xx
Kojto 106:ba1f97679dad 53 * @{
Kojto 106:ba1f97679dad 54 */
Kojto 106:ba1f97679dad 55
Kojto 106:ba1f97679dad 56 #ifndef __STM32F4xx_H
Kojto 106:ba1f97679dad 57 #define __STM32F4xx_H
Kojto 106:ba1f97679dad 58
Kojto 106:ba1f97679dad 59 #ifdef __cplusplus
Kojto 106:ba1f97679dad 60 extern "C" {
Kojto 106:ba1f97679dad 61 #endif /* __cplusplus */
Kojto 106:ba1f97679dad 62
Kojto 106:ba1f97679dad 63 /** @addtogroup Library_configuration_section
Kojto 106:ba1f97679dad 64 * @{
Kojto 106:ba1f97679dad 65 */
Kojto 106:ba1f97679dad 66
Kojto 106:ba1f97679dad 67 /**
Kojto 106:ba1f97679dad 68 * @brief STM32 Family
Kojto 106:ba1f97679dad 69 */
Kojto 106:ba1f97679dad 70 #if !defined (STM32F4)
Kojto 106:ba1f97679dad 71 #define STM32F4
Kojto 106:ba1f97679dad 72 #endif /* STM32F4 */
Kojto 106:ba1f97679dad 73
Kojto 106:ba1f97679dad 74 /* Uncomment the line below according to the target STM32 device used in your
Kojto 106:ba1f97679dad 75 application
Kojto 106:ba1f97679dad 76 */
Kojto 106:ba1f97679dad 77 #if !defined (STM32F405xx) && !defined (STM32F415xx) && !defined (STM32F407xx) && !defined (STM32F417xx) && \
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 83 /* #define STM32F405xx */ /*!< STM32F405RG, STM32F405VG and STM32F405ZG Devices */
Kojto 106:ba1f97679dad 84 /* #define STM32F415xx */ /*!< STM32F415RG, STM32F415VG and STM32F415ZG Devices */
Kojto 106:ba1f97679dad 85 /* #define STM32F407xx */ /*!< STM32F407VG, STM32F407VE, STM32F407ZG, STM32F407ZE, STM32F407IG and STM32F407IE Devices */
Kojto 106:ba1f97679dad 86 /* #define STM32F417xx */ /*!< STM32F417VG, STM32F417VE, STM32F417ZG, STM32F417ZE, STM32F417IG and STM32F417IE Devices */
Kojto 106:ba1f97679dad 87 /* #define STM32F427xx */ /*!< STM32F427VG, STM32F427VI, STM32F427ZG, STM32F427ZI, STM32F427IG and STM32F427II Devices */
Kojto 106:ba1f97679dad 88 /* #define STM32F437xx */ /*!< STM32F437VG, STM32F437VI, STM32F437ZG, STM32F437ZI, STM32F437IG and STM32F437II Devices */
Kojto 106:ba1f97679dad 89 /* #define STM32F429xx */ /*!< STM32F429VG, STM32F429VI, STM32F429ZG, STM32F429ZI, STM32F429BG, STM32F429BI, STM32F429NG,
Kojto 106:ba1f97679dad 90 STM32F439NI, STM32F429IG and STM32F429II Devices */
Kojto 106:ba1f97679dad 91 /* #define STM32F439xx */ /*!< STM32F439VG, STM32F439VI, STM32F439ZG, STM32F439ZI, STM32F439BG, STM32F439BI, STM32F439NG,
Kojto 106:ba1f97679dad 92 STM32F439NI, STM32F439IG and STM32F439II Devices */
Kojto 106:ba1f97679dad 93 /* #define STM32F401xC */ /*!< STM32F401CB, STM32F401CC, STM32F401RB, STM32F401RC, STM32F401VB and STM32F401VC Devices */
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 109 #endif
Kojto 106:ba1f97679dad 110
Kojto 106:ba1f97679dad 111 /* Tip: To avoid modifying this file each time you need to switch between these
Kojto 106:ba1f97679dad 112 devices, you can define the device in your toolchain compiler preprocessor.
Kojto 106:ba1f97679dad 113 */
Kojto 106:ba1f97679dad 114 #if !defined (USE_HAL_DRIVER)
Kojto 106:ba1f97679dad 115 /**
Kojto 106:ba1f97679dad 116 * @brief Comment the line below if you will not use the peripherals drivers.
Kojto 106:ba1f97679dad 117 In this case, these drivers will not be included and the application code will
Kojto 106:ba1f97679dad 118 be based on direct access to peripherals registers
Kojto 106:ba1f97679dad 119 */
Kojto 106:ba1f97679dad 120 #define USE_HAL_DRIVER
Kojto 106:ba1f97679dad 121 #endif /* USE_HAL_DRIVER */
Kojto 106:ba1f97679dad 122
Kojto 106:ba1f97679dad 123 /**
Kojto 122:f9eeca106725 124 * @brief CMSIS version number V2.5.0
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 135 /**
Kojto 106:ba1f97679dad 136 * @}
Kojto 106:ba1f97679dad 137 */
Kojto 106:ba1f97679dad 138
Kojto 106:ba1f97679dad 139 /** @addtogroup Device_Included
Kojto 106:ba1f97679dad 140 * @{
Kojto 106:ba1f97679dad 141 */
Kojto 106:ba1f97679dad 142
Kojto 106:ba1f97679dad 143 #if defined(STM32F405xx)
Kojto 106:ba1f97679dad 144 #include "stm32f405xx.h"
Kojto 106:ba1f97679dad 145 #elif defined(STM32F415xx)
Kojto 106:ba1f97679dad 146 #include "stm32f415xx.h"
Kojto 106:ba1f97679dad 147 #elif defined(STM32F407xx)
Kojto 106:ba1f97679dad 148 #include "stm32f407xx.h"
Kojto 106:ba1f97679dad 149 #elif defined(STM32F417xx)
Kojto 106:ba1f97679dad 150 #include "stm32f417xx.h"
Kojto 106:ba1f97679dad 151 #elif defined(STM32F427xx)
Kojto 106:ba1f97679dad 152 #include "stm32f427xx.h"
Kojto 106:ba1f97679dad 153 #elif defined(STM32F437xx)
Kojto 106:ba1f97679dad 154 #include "stm32f437xx.h"
Kojto 106:ba1f97679dad 155 #elif defined(STM32F429xx)
Kojto 106:ba1f97679dad 156 #include "stm32f429xx.h"
Kojto 106:ba1f97679dad 157 #elif defined(STM32F439xx)
Kojto 106:ba1f97679dad 158 #include "stm32f439xx.h"
Kojto 106:ba1f97679dad 159 #elif defined(STM32F401xC)
Kojto 106:ba1f97679dad 160 #include "stm32f401xc.h"
Kojto 106:ba1f97679dad 161 #elif defined(STM32F401xE)
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 169 #elif defined(STM32F411xE)
Kojto 106:ba1f97679dad 170 #include "stm32f411xe.h"
Kojto 106:ba1f97679dad 171 #elif defined(STM32F446xx)
Kojto 106:ba1f97679dad 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 106:ba1f97679dad 185 #else
Kojto 106:ba1f97679dad 186 #error "Please select first the target STM32F4xx device used in your application (in stm32f4xx.h file)"
Kojto 106:ba1f97679dad 187 #endif
Kojto 106:ba1f97679dad 188
Kojto 106:ba1f97679dad 189 /**
Kojto 106:ba1f97679dad 190 * @}
Kojto 106:ba1f97679dad 191 */
Kojto 106:ba1f97679dad 192
Kojto 106:ba1f97679dad 193 /** @addtogroup Exported_types
Kojto 106:ba1f97679dad 194 * @{
Kojto 106:ba1f97679dad 195 */
Kojto 106:ba1f97679dad 196 typedef enum
Kojto 106:ba1f97679dad 197 {
Kojto 122:f9eeca106725 198 RESET = 0U,
Kojto 106:ba1f97679dad 199 SET = !RESET
Kojto 106:ba1f97679dad 200 } FlagStatus, ITStatus;
Kojto 106:ba1f97679dad 201
Kojto 106:ba1f97679dad 202 typedef enum
Kojto 106:ba1f97679dad 203 {
Kojto 122:f9eeca106725 204 DISABLE = 0U,
Kojto 106:ba1f97679dad 205 ENABLE = !DISABLE
Kojto 106:ba1f97679dad 206 } FunctionalState;
Kojto 106:ba1f97679dad 207 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
Kojto 106:ba1f97679dad 208
Kojto 106:ba1f97679dad 209 typedef enum
Kojto 106:ba1f97679dad 210 {
Kojto 122:f9eeca106725 211 ERROR = 0U,
Kojto 106:ba1f97679dad 212 SUCCESS = !ERROR
Kojto 106:ba1f97679dad 213 } ErrorStatus;
Kojto 106:ba1f97679dad 214
Kojto 106:ba1f97679dad 215 /**
Kojto 106:ba1f97679dad 216 * @}
Kojto 106:ba1f97679dad 217 */
Kojto 106:ba1f97679dad 218
Kojto 106:ba1f97679dad 219
Kojto 106:ba1f97679dad 220 /** @addtogroup Exported_macro
Kojto 106:ba1f97679dad 221 * @{
Kojto 106:ba1f97679dad 222 */
Kojto 106:ba1f97679dad 223 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
Kojto 106:ba1f97679dad 224
Kojto 106:ba1f97679dad 225 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
Kojto 106:ba1f97679dad 226
Kojto 106:ba1f97679dad 227 #define READ_BIT(REG, BIT) ((REG) & (BIT))
Kojto 106:ba1f97679dad 228
Kojto 106:ba1f97679dad 229 #define CLEAR_REG(REG) ((REG) = (0x0))
Kojto 106:ba1f97679dad 230
Kojto 106:ba1f97679dad 231 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
Kojto 106:ba1f97679dad 232
Kojto 106:ba1f97679dad 233 #define READ_REG(REG) ((REG))
Kojto 106:ba1f97679dad 234
Kojto 106:ba1f97679dad 235 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
Kojto 106:ba1f97679dad 236
Kojto 106:ba1f97679dad 237 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
Kojto 106:ba1f97679dad 238
Kojto 106:ba1f97679dad 239
Kojto 106:ba1f97679dad 240 /**
Kojto 106:ba1f97679dad 241 * @}
Kojto 106:ba1f97679dad 242 */
Kojto 106:ba1f97679dad 243
Kojto 106:ba1f97679dad 244 #if defined (USE_HAL_DRIVER)
Kojto 106:ba1f97679dad 245 #include "stm32f4xx_hal.h"
Kojto 106:ba1f97679dad 246 #endif /* USE_HAL_DRIVER */
Kojto 106:ba1f97679dad 247
Kojto 106:ba1f97679dad 248 #ifdef __cplusplus
Kojto 106:ba1f97679dad 249 }
Kojto 106:ba1f97679dad 250 #endif /* __cplusplus */
Kojto 106:ba1f97679dad 251
Kojto 106:ba1f97679dad 252 #endif /* __STM32F4xx_H */
Kojto 106:ba1f97679dad 253 /**
Kojto 106:ba1f97679dad 254 * @}
Kojto 106:ba1f97679dad 255 */
Kojto 106:ba1f97679dad 256
Kojto 106:ba1f97679dad 257 /**
Kojto 106:ba1f97679dad 258 * @}
Kojto 106:ba1f97679dad 259 */
Kojto 106:ba1f97679dad 260
Kojto 106:ba1f97679dad 261
Kojto 106:ba1f97679dad 262
Kojto 106:ba1f97679dad 263
Kojto 106:ba1f97679dad 264 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/