gabriel della-monica / mbed-src

mbed library sources

Fork of mbed-src by mbed official

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

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

Who changed what in which revision?

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