mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_F303RE/TOOLCHAIN_ARM_MICRO/stm32f3xx.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 171:3a7713b1edbc 1 /**
AnnaBridge 171:3a7713b1edbc 2 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 3 * @file stm32f3xx.h
AnnaBridge 171:3a7713b1edbc 4 * @author MCD Application Team
AnnaBridge 171:3a7713b1edbc 5 * @brief CMSIS STM32F3xx Device Peripheral Access Layer Header File.
AnnaBridge 171:3a7713b1edbc 6 *
AnnaBridge 171:3a7713b1edbc 7 * The file is the unique include file that the application programmer
AnnaBridge 171:3a7713b1edbc 8 * is using in the C source code, usually in main.c. This file contains:
AnnaBridge 171:3a7713b1edbc 9 * - Configuration section that allows to select:
AnnaBridge 171:3a7713b1edbc 10 * - The STM32F3xx device used in the target application
AnnaBridge 171:3a7713b1edbc 11 * - To use or not the peripheral’s drivers in application code(i.e.
AnnaBridge 171:3a7713b1edbc 12 * code will be based on direct access to peripheral’s registers
AnnaBridge 171:3a7713b1edbc 13 * rather than drivers API), this option is controlled by
AnnaBridge 171:3a7713b1edbc 14 * "#define USE_HAL_DRIVER"
AnnaBridge 171:3a7713b1edbc 15 *
AnnaBridge 171:3a7713b1edbc 16 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 17 * @attention
AnnaBridge 171:3a7713b1edbc 18 *
AnnaBridge 171:3a7713b1edbc 19 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 171:3a7713b1edbc 20 *
AnnaBridge 171:3a7713b1edbc 21 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 171:3a7713b1edbc 22 * are permitted provided that the following conditions are met:
AnnaBridge 171:3a7713b1edbc 23 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 171:3a7713b1edbc 24 * this list of conditions and the following disclaimer.
AnnaBridge 171:3a7713b1edbc 25 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 171:3a7713b1edbc 26 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 171:3a7713b1edbc 27 * and/or other materials provided with the distribution.
AnnaBridge 171:3a7713b1edbc 28 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 171:3a7713b1edbc 29 * may be used to endorse or promote products derived from this software
AnnaBridge 171:3a7713b1edbc 30 * without specific prior written permission.
AnnaBridge 171:3a7713b1edbc 31 *
AnnaBridge 171:3a7713b1edbc 32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 171:3a7713b1edbc 33 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 171:3a7713b1edbc 34 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 171:3a7713b1edbc 35 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 171:3a7713b1edbc 36 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 171:3a7713b1edbc 37 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 171:3a7713b1edbc 38 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 171:3a7713b1edbc 39 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 171:3a7713b1edbc 40 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 171:3a7713b1edbc 41 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 171:3a7713b1edbc 42 *
AnnaBridge 171:3a7713b1edbc 43 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 44 */
AnnaBridge 171:3a7713b1edbc 45
AnnaBridge 171:3a7713b1edbc 46 /** @addtogroup CMSIS
AnnaBridge 171:3a7713b1edbc 47 * @{
AnnaBridge 171:3a7713b1edbc 48 */
AnnaBridge 171:3a7713b1edbc 49
AnnaBridge 171:3a7713b1edbc 50 /** @addtogroup stm32f3xx
AnnaBridge 171:3a7713b1edbc 51 * @{
AnnaBridge 171:3a7713b1edbc 52 */
AnnaBridge 171:3a7713b1edbc 53
AnnaBridge 171:3a7713b1edbc 54 #ifndef __STM32F3xx_H
AnnaBridge 171:3a7713b1edbc 55 #define __STM32F3xx_H
AnnaBridge 171:3a7713b1edbc 56
AnnaBridge 171:3a7713b1edbc 57 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 58 extern "C" {
AnnaBridge 171:3a7713b1edbc 59 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 60
AnnaBridge 171:3a7713b1edbc 61 /** @addtogroup Library_configuration_section
AnnaBridge 171:3a7713b1edbc 62 * @{
AnnaBridge 171:3a7713b1edbc 63 */
AnnaBridge 171:3a7713b1edbc 64
AnnaBridge 171:3a7713b1edbc 65 /**
AnnaBridge 171:3a7713b1edbc 66 * @brief STM32 Family
AnnaBridge 171:3a7713b1edbc 67 */
AnnaBridge 171:3a7713b1edbc 68 #if !defined (STM32F3)
AnnaBridge 171:3a7713b1edbc 69 #define STM32F3
AnnaBridge 171:3a7713b1edbc 70 #endif /* STM32F3 */
AnnaBridge 171:3a7713b1edbc 71
AnnaBridge 171:3a7713b1edbc 72 /* Uncomment the line below according to the target STM32 device used in your
AnnaBridge 171:3a7713b1edbc 73 application
AnnaBridge 171:3a7713b1edbc 74 */
AnnaBridge 171:3a7713b1edbc 75
AnnaBridge 171:3a7713b1edbc 76 #if !defined (STM32F301x8) && !defined (STM32F302x8) && !defined (STM32F318xx) && \
AnnaBridge 171:3a7713b1edbc 77 !defined (STM32F302xC) && !defined (STM32F303xC) && !defined (STM32F358xx) && \
AnnaBridge 171:3a7713b1edbc 78 !defined (STM32F303x8) && !defined (STM32F334x8) && !defined (STM32F328xx) && \
AnnaBridge 171:3a7713b1edbc 79 !defined (STM32F302xE) && !defined (STM32F303xE) && !defined (STM32F398xx) && \
AnnaBridge 171:3a7713b1edbc 80 !defined (STM32F373xC) && !defined (STM32F378xx)
AnnaBridge 171:3a7713b1edbc 81
AnnaBridge 171:3a7713b1edbc 82 /* #define STM32F301x8 */ /*!< STM32F301K6, STM32F301K8, STM32F301C6, STM32F301C8,
AnnaBridge 171:3a7713b1edbc 83 STM32F301R6 and STM32F301R8 Devices */
AnnaBridge 171:3a7713b1edbc 84 /* #define STM32F302x8 */ /*!< STM32F302K6, STM32F302K8, STM32F302C6, STM32F302C8,
AnnaBridge 171:3a7713b1edbc 85 STM32F302R6 and STM32F302R8 Devices */
AnnaBridge 171:3a7713b1edbc 86 /* #define STM32F302xC */ /*!< STM32F302CB, STM32F302CC, STM32F302RB, STM32F302RC,
AnnaBridge 171:3a7713b1edbc 87 STM32F302VB and STM32F302VC Devices */
AnnaBridge 171:3a7713b1edbc 88 /* #define STM32F302xE */ /*!< STM32F302RE, STM32F302VE, STM32F302ZE, STM32F302RD,
AnnaBridge 171:3a7713b1edbc 89 STM32F302VD and STM32F302ZD Devices */
AnnaBridge 171:3a7713b1edbc 90 /* #define STM32F303x8 */ /*!< STM32F303K6, STM32F303K8, STM32F303C6, STM32F303C8,
AnnaBridge 171:3a7713b1edbc 91 STM32F303R6 and STM32F303R8 Devices */
AnnaBridge 171:3a7713b1edbc 92 /* #define STM32F303xC */ /*!< STM32F303CB, STM32F303CC, STM32F303RB, STM32F303RC,
AnnaBridge 171:3a7713b1edbc 93 STM32F303VB and STM32F303VC Devices */
AnnaBridge 171:3a7713b1edbc 94 #define STM32F303xE /*!< STM32F303RE, STM32F303VE, STM32F303ZE, STM32F303RD,
AnnaBridge 171:3a7713b1edbc 95 STM32F303VD and STM32F303ZD Devices */
AnnaBridge 171:3a7713b1edbc 96 /* #define STM32F373xC */ /*!< STM32F373C8, STM32F373CB, STM32F373CC,
AnnaBridge 171:3a7713b1edbc 97 STM32F373R8, STM32F373RB, STM32F373RC,
AnnaBridge 171:3a7713b1edbc 98 STM32F373V8, STM32F373VB and STM32F373VC Devices */
AnnaBridge 171:3a7713b1edbc 99 /* #define STM32F334x8 */ /*!< STM32F334K4, STM32F334K6, STM32F334K8,
AnnaBridge 171:3a7713b1edbc 100 STM32F334C4, STM32F334C6, STM32F334C8,
AnnaBridge 171:3a7713b1edbc 101 STM32F334R4, STM32F334R6 and STM32F334R8 Devices */
AnnaBridge 171:3a7713b1edbc 102 /* #define STM32F318xx */ /*!< STM32F318K8, STM32F318C8: STM32F301x8 with regulator off: STM32F318xx Devices */
AnnaBridge 171:3a7713b1edbc 103 /* #define STM32F328xx */ /*!< STM32F328C8, STM32F328R8: STM32F334x8 with regulator off: STM32F328xx Devices */
AnnaBridge 171:3a7713b1edbc 104 /* #define STM32F358xx */ /*!< STM32F358CC, STM32F358RC, STM32F358VC: STM32F303xC with regulator off: STM32F358xx Devices */
AnnaBridge 171:3a7713b1edbc 105 /* #define STM32F378xx */ /*!< STM32F378CC, STM32F378RC, STM32F378VC: STM32F373xC with regulator off: STM32F378xx Devices */
AnnaBridge 171:3a7713b1edbc 106 /* #define STM32F398xx */ /*!< STM32F398VE: STM32F303xE with regulator off: STM32F398xx Devices */
AnnaBridge 171:3a7713b1edbc 107 #endif
AnnaBridge 171:3a7713b1edbc 108
AnnaBridge 171:3a7713b1edbc 109 /* Tip: To avoid modifying this file each time you need to switch between these
AnnaBridge 171:3a7713b1edbc 110 devices, you can define the device in your toolchain compiler preprocessor.
AnnaBridge 171:3a7713b1edbc 111 */
AnnaBridge 171:3a7713b1edbc 112 #if !defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 113 /**
AnnaBridge 171:3a7713b1edbc 114 * @brief Comment the line below if you will not use the peripherals drivers.
AnnaBridge 171:3a7713b1edbc 115 In this case, these drivers will not be included and the application code will
AnnaBridge 171:3a7713b1edbc 116 be based on direct access to peripherals registers
AnnaBridge 171:3a7713b1edbc 117 */
AnnaBridge 171:3a7713b1edbc 118 #define USE_HAL_DRIVER
AnnaBridge 171:3a7713b1edbc 119 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 120
AnnaBridge 171:3a7713b1edbc 121 /**
AnnaBridge 171:3a7713b1edbc 122 * @brief CMSIS Device version number V2.3.2
AnnaBridge 171:3a7713b1edbc 123 */
AnnaBridge 171:3a7713b1edbc 124 #define __STM32F3_CMSIS_VERSION_MAIN (0x02) /*!< [31:24] main version */
AnnaBridge 171:3a7713b1edbc 125 #define __STM32F3_CMSIS_VERSION_SUB1 (0x03) /*!< [23:16] sub1 version */
AnnaBridge 171:3a7713b1edbc 126 #define __STM32F3_CMSIS_VERSION_SUB2 (0x02) /*!< [15:8] sub2 version */
AnnaBridge 171:3a7713b1edbc 127 #define __STM32F3_CMSIS_VERSION_RC (0x00) /*!< [7:0] release candidate */
AnnaBridge 171:3a7713b1edbc 128 #define __STM32F3_CMSIS_VERSION ((__STM32F3_CMSIS_VERSION_MAIN << 24)\
AnnaBridge 171:3a7713b1edbc 129 |(__STM32F3_CMSIS_VERSION_SUB1 << 16)\
AnnaBridge 171:3a7713b1edbc 130 |(__STM32F3_CMSIS_VERSION_SUB2 << 8 )\
AnnaBridge 171:3a7713b1edbc 131 |(__STM32F3_CMSIS_VERSION_RC))
AnnaBridge 171:3a7713b1edbc 132
AnnaBridge 171:3a7713b1edbc 133 /**
AnnaBridge 171:3a7713b1edbc 134 * @}
AnnaBridge 171:3a7713b1edbc 135 */
AnnaBridge 171:3a7713b1edbc 136
AnnaBridge 171:3a7713b1edbc 137 /** @addtogroup Device_Included
AnnaBridge 171:3a7713b1edbc 138 * @{
AnnaBridge 171:3a7713b1edbc 139 */
AnnaBridge 171:3a7713b1edbc 140
AnnaBridge 171:3a7713b1edbc 141 #if defined(STM32F301x8)
AnnaBridge 171:3a7713b1edbc 142 #include "stm32f301x8.h"
AnnaBridge 171:3a7713b1edbc 143 #elif defined(STM32F302x8)
AnnaBridge 171:3a7713b1edbc 144 #include "stm32f302x8.h"
AnnaBridge 171:3a7713b1edbc 145 #elif defined(STM32F302xC)
AnnaBridge 171:3a7713b1edbc 146 #include "stm32f302xc.h"
AnnaBridge 171:3a7713b1edbc 147 #elif defined(STM32F302xE)
AnnaBridge 171:3a7713b1edbc 148 #include "stm32f302xe.h"
AnnaBridge 171:3a7713b1edbc 149 #elif defined(STM32F303x8)
AnnaBridge 171:3a7713b1edbc 150 #include "stm32f303x8.h"
AnnaBridge 171:3a7713b1edbc 151 #elif defined(STM32F303xC)
AnnaBridge 171:3a7713b1edbc 152 #include "stm32f303xc.h"
AnnaBridge 171:3a7713b1edbc 153 #elif defined(STM32F303xE)
AnnaBridge 171:3a7713b1edbc 154 #include "stm32f303xe.h"
AnnaBridge 171:3a7713b1edbc 155 #elif defined(STM32F373xC)
AnnaBridge 171:3a7713b1edbc 156 #include "stm32f373xc.h"
AnnaBridge 171:3a7713b1edbc 157 #elif defined(STM32F334x8)
AnnaBridge 171:3a7713b1edbc 158 #include "stm32f334x8.h"
AnnaBridge 171:3a7713b1edbc 159 #elif defined(STM32F318xx)
AnnaBridge 171:3a7713b1edbc 160 #include "stm32f318xx.h"
AnnaBridge 171:3a7713b1edbc 161 #elif defined(STM32F328xx)
AnnaBridge 171:3a7713b1edbc 162 #include "stm32f328xx.h"
AnnaBridge 171:3a7713b1edbc 163 #elif defined(STM32F358xx)
AnnaBridge 171:3a7713b1edbc 164 #include "stm32f358xx.h"
AnnaBridge 171:3a7713b1edbc 165 #elif defined(STM32F378xx)
AnnaBridge 171:3a7713b1edbc 166 #include "stm32f378xx.h"
AnnaBridge 171:3a7713b1edbc 167 #elif defined(STM32F398xx)
AnnaBridge 171:3a7713b1edbc 168 #include "stm32f398xx.h"
AnnaBridge 171:3a7713b1edbc 169 #else
AnnaBridge 171:3a7713b1edbc 170 #error "Please select first the target STM32F3xx device used in your application (in stm32f3xx.h file)"
AnnaBridge 171:3a7713b1edbc 171 #endif
AnnaBridge 171:3a7713b1edbc 172
AnnaBridge 171:3a7713b1edbc 173 /**
AnnaBridge 171:3a7713b1edbc 174 * @}
AnnaBridge 171:3a7713b1edbc 175 */
AnnaBridge 171:3a7713b1edbc 176
AnnaBridge 171:3a7713b1edbc 177 /** @addtogroup Exported_types
AnnaBridge 171:3a7713b1edbc 178 * @{
AnnaBridge 171:3a7713b1edbc 179 */
AnnaBridge 171:3a7713b1edbc 180 typedef enum
AnnaBridge 171:3a7713b1edbc 181 {
AnnaBridge 171:3a7713b1edbc 182 RESET = 0,
AnnaBridge 171:3a7713b1edbc 183 SET = !RESET
AnnaBridge 171:3a7713b1edbc 184 } FlagStatus, ITStatus;
AnnaBridge 171:3a7713b1edbc 185
AnnaBridge 171:3a7713b1edbc 186 typedef enum
AnnaBridge 171:3a7713b1edbc 187 {
AnnaBridge 171:3a7713b1edbc 188 DISABLE = 0,
AnnaBridge 171:3a7713b1edbc 189 ENABLE = !DISABLE
AnnaBridge 171:3a7713b1edbc 190 } FunctionalState;
AnnaBridge 171:3a7713b1edbc 191 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
AnnaBridge 171:3a7713b1edbc 192
AnnaBridge 171:3a7713b1edbc 193 typedef enum
AnnaBridge 171:3a7713b1edbc 194 {
AnnaBridge 171:3a7713b1edbc 195 ERROR = 0,
AnnaBridge 171:3a7713b1edbc 196 SUCCESS = !ERROR
AnnaBridge 171:3a7713b1edbc 197 } ErrorStatus;
AnnaBridge 171:3a7713b1edbc 198
AnnaBridge 171:3a7713b1edbc 199 /**
AnnaBridge 171:3a7713b1edbc 200 * @}
AnnaBridge 171:3a7713b1edbc 201 */
AnnaBridge 171:3a7713b1edbc 202
AnnaBridge 171:3a7713b1edbc 203
AnnaBridge 171:3a7713b1edbc 204 /** @addtogroup Exported_macros
AnnaBridge 171:3a7713b1edbc 205 * @{
AnnaBridge 171:3a7713b1edbc 206 */
AnnaBridge 171:3a7713b1edbc 207 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
AnnaBridge 171:3a7713b1edbc 208
AnnaBridge 171:3a7713b1edbc 209 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
AnnaBridge 171:3a7713b1edbc 210
AnnaBridge 171:3a7713b1edbc 211 #define READ_BIT(REG, BIT) ((REG) & (BIT))
AnnaBridge 171:3a7713b1edbc 212
AnnaBridge 171:3a7713b1edbc 213 #define CLEAR_REG(REG) ((REG) = (0x0))
AnnaBridge 171:3a7713b1edbc 214
AnnaBridge 171:3a7713b1edbc 215 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
AnnaBridge 171:3a7713b1edbc 216
AnnaBridge 171:3a7713b1edbc 217 #define READ_REG(REG) ((REG))
AnnaBridge 171:3a7713b1edbc 218
AnnaBridge 171:3a7713b1edbc 219 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
AnnaBridge 171:3a7713b1edbc 220
AnnaBridge 171:3a7713b1edbc 221 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
AnnaBridge 171:3a7713b1edbc 222
AnnaBridge 171:3a7713b1edbc 223
AnnaBridge 171:3a7713b1edbc 224 #if defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 225 #include "stm32f3xx_hal.h"
AnnaBridge 171:3a7713b1edbc 226 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 227
AnnaBridge 171:3a7713b1edbc 228
AnnaBridge 171:3a7713b1edbc 229 /**
AnnaBridge 171:3a7713b1edbc 230 * @}
AnnaBridge 171:3a7713b1edbc 231 */
AnnaBridge 171:3a7713b1edbc 232
AnnaBridge 171:3a7713b1edbc 233
AnnaBridge 171:3a7713b1edbc 234 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 235 }
AnnaBridge 171:3a7713b1edbc 236 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 237
AnnaBridge 171:3a7713b1edbc 238 #endif /* __STM32F3xx_H */
AnnaBridge 171:3a7713b1edbc 239 /**
AnnaBridge 171:3a7713b1edbc 240 * @}
AnnaBridge 171:3a7713b1edbc 241 */
AnnaBridge 171:3a7713b1edbc 242
AnnaBridge 171:3a7713b1edbc 243 /**
AnnaBridge 171:3a7713b1edbc 244 * @}
AnnaBridge 171:3a7713b1edbc 245 */
AnnaBridge 171:3a7713b1edbc 246
AnnaBridge 171:3a7713b1edbc 247
AnnaBridge 171:3a7713b1edbc 248
AnnaBridge 171:3a7713b1edbc 249
AnnaBridge 171:3a7713b1edbc 250 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/