Filippo Casamassima / mbed

my fork

Dependents:   Nucleo_blueNRG

Fork of mbed by mbed official

TARGET_NUCLEO_F302R8/stm32f3xx.h@90:cb3d968589d8, 2014-10-28 (annotated)

Committer:
Kojto
Date:
Tue Oct 28 16:40:41 2014 +0000
Revision:
90:cb3d968589d8
Release 90 of the mbed library



Changes:



- Freescale KSDK update (v1.0)

- K22 - new target addition

- KL43Z - new target addition

- Nucleo F091RC - new target addition

- Nucleo L152RE - STM32Cube driver

- Nordic - Softdevice v7.1.0

- Nvic files - BSD License

- LPC824 - various HAL fixes

- Nucleo F411RE - CMSIS - IAR files

Who changed what in which revision?

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