mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
385:be64abf45658
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081

Full URL: https://github.com/mbedmicro/mbed/commit/d5b4d2ab9c47edb4dc5776e7177b0c2263459081/

Initial version of drivers for SAMR21

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****/