gabriel della-monica / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F3/TARGET_NUCLEO_F303RE/stm32f3xx.h@445:9a3ffe6cfa19, 2015-01-14 (annotated)

Committer:
moirans2
Date:
Wed Jan 14 20:53:08 2015 +0000
Revision:
445:9a3ffe6cfa19
Parent:
423:560d1a9f3083 
internal clock stm32L051

Who changed what in which revision?

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