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_F103RB/TOOLCHAIN_IAR/stm32f1xx.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 stm32f1xx.h
AnnaBridge 171:3a7713b1edbc 4 * @author MCD Application Team
AnnaBridge 171:3a7713b1edbc 5 * @version V4.2.0
AnnaBridge 171:3a7713b1edbc 6 * @date 31-March-2017
AnnaBridge 171:3a7713b1edbc 7 * @brief CMSIS STM32F1xx Device Peripheral Access Layer Header File.
AnnaBridge 171:3a7713b1edbc 8 *
AnnaBridge 171:3a7713b1edbc 9 * The file is the unique include file that the application programmer
AnnaBridge 171:3a7713b1edbc 10 * is using in the C source code, usually in main.c. This file contains:
AnnaBridge 171:3a7713b1edbc 11 * - Configuration section that allows to select:
AnnaBridge 171:3a7713b1edbc 12 * - The STM32F1xx device used in the target application
AnnaBridge 171:3a7713b1edbc 13 * - To use or not the peripheral’s drivers in application code(i.e.
AnnaBridge 171:3a7713b1edbc 14 * code will be based on direct access to peripheral’s registers
AnnaBridge 171:3a7713b1edbc 15 * rather than drivers API), this option is controlled by
AnnaBridge 171:3a7713b1edbc 16 * "#define USE_HAL_DRIVER"
AnnaBridge 171:3a7713b1edbc 17 *
AnnaBridge 171:3a7713b1edbc 18 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 19 * @attention
AnnaBridge 171:3a7713b1edbc 20 *
AnnaBridge 171:3a7713b1edbc 21 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
AnnaBridge 171:3a7713b1edbc 22 *
AnnaBridge 171:3a7713b1edbc 23 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 171:3a7713b1edbc 24 * are permitted provided that the following conditions are met:
AnnaBridge 171:3a7713b1edbc 25 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 171:3a7713b1edbc 26 * this list of conditions and the following disclaimer.
AnnaBridge 171:3a7713b1edbc 27 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 171:3a7713b1edbc 28 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 171:3a7713b1edbc 29 * and/or other materials provided with the distribution.
AnnaBridge 171:3a7713b1edbc 30 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 171:3a7713b1edbc 31 * may be used to endorse or promote products derived from this software
AnnaBridge 171:3a7713b1edbc 32 * without specific prior written permission.
AnnaBridge 171:3a7713b1edbc 33 *
AnnaBridge 171:3a7713b1edbc 34 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 171:3a7713b1edbc 35 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 171:3a7713b1edbc 36 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 171:3a7713b1edbc 37 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 171:3a7713b1edbc 38 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 171:3a7713b1edbc 39 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 171:3a7713b1edbc 40 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 171:3a7713b1edbc 41 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 171:3a7713b1edbc 42 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 171:3a7713b1edbc 43 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 171:3a7713b1edbc 44 *
AnnaBridge 171:3a7713b1edbc 45 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 46 */
AnnaBridge 171:3a7713b1edbc 47
AnnaBridge 171:3a7713b1edbc 48 /** @addtogroup CMSIS
AnnaBridge 171:3a7713b1edbc 49 * @{
AnnaBridge 171:3a7713b1edbc 50 */
AnnaBridge 171:3a7713b1edbc 51
AnnaBridge 171:3a7713b1edbc 52 /** @addtogroup stm32f1xx
AnnaBridge 171:3a7713b1edbc 53 * @{
AnnaBridge 171:3a7713b1edbc 54 */
AnnaBridge 171:3a7713b1edbc 55
AnnaBridge 171:3a7713b1edbc 56 #ifndef __STM32F1XX_H
AnnaBridge 171:3a7713b1edbc 57 #define __STM32F1XX_H
AnnaBridge 171:3a7713b1edbc 58
AnnaBridge 171:3a7713b1edbc 59 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 60 extern "C" {
AnnaBridge 171:3a7713b1edbc 61 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 62
AnnaBridge 171:3a7713b1edbc 63 /** @addtogroup Library_configuration_section
AnnaBridge 171:3a7713b1edbc 64 * @{
AnnaBridge 171:3a7713b1edbc 65 */
AnnaBridge 171:3a7713b1edbc 66
AnnaBridge 171:3a7713b1edbc 67 /**
AnnaBridge 171:3a7713b1edbc 68 * @brief STM32 Family
AnnaBridge 171:3a7713b1edbc 69 */
AnnaBridge 171:3a7713b1edbc 70 #if !defined (STM32F1)
AnnaBridge 171:3a7713b1edbc 71 #define STM32F1
AnnaBridge 171:3a7713b1edbc 72 #endif /* STM32F1 */
AnnaBridge 171:3a7713b1edbc 73
AnnaBridge 171:3a7713b1edbc 74 /* Uncomment the line below according to the target STM32L device used in your
AnnaBridge 171:3a7713b1edbc 75 application
AnnaBridge 171:3a7713b1edbc 76 */
AnnaBridge 171:3a7713b1edbc 77
AnnaBridge 171:3a7713b1edbc 78 #if !defined (STM32F100xB) && !defined (STM32F100xE) && !defined (STM32F101x6) && \
AnnaBridge 171:3a7713b1edbc 79 !defined (STM32F101xB) && !defined (STM32F101xE) && !defined (STM32F101xG) && !defined (STM32F102x6) && !defined (STM32F102xB) && !defined (STM32F103x6) && \
AnnaBridge 171:3a7713b1edbc 80 !defined (STM32F103xB) && !defined (STM32F103xE) && !defined (STM32F103xG) && !defined (STM32F105xC) && !defined (STM32F107xC)
AnnaBridge 171:3a7713b1edbc 81 /* #define STM32F100xB */ /*!< STM32F100C4, STM32F100R4, STM32F100C6, STM32F100R6, STM32F100C8, STM32F100R8, STM32F100V8, STM32F100CB, STM32F100RB and STM32F100VB */
AnnaBridge 171:3a7713b1edbc 82 /* #define STM32F100xE */ /*!< STM32F100RC, STM32F100VC, STM32F100ZC, STM32F100RD, STM32F100VD, STM32F100ZD, STM32F100RE, STM32F100VE and STM32F100ZE */
AnnaBridge 171:3a7713b1edbc 83 /* #define STM32F101x6 */ /*!< STM32F101C4, STM32F101R4, STM32F101T4, STM32F101C6, STM32F101R6 and STM32F101T6 Devices */
AnnaBridge 171:3a7713b1edbc 84 /* #define STM32F101xB */ /*!< STM32F101C8, STM32F101R8, STM32F101T8, STM32F101V8, STM32F101CB, STM32F101RB, STM32F101TB and STM32F101VB */
AnnaBridge 171:3a7713b1edbc 85 /* #define STM32F101xE */ /*!< STM32F101RC, STM32F101VC, STM32F101ZC, STM32F101RD, STM32F101VD, STM32F101ZD, STM32F101RE, STM32F101VE and STM32F101ZE */
AnnaBridge 171:3a7713b1edbc 86 /* #define STM32F101xG */ /*!< STM32F101RF, STM32F101VF, STM32F101ZF, STM32F101RG, STM32F101VG and STM32F101ZG */
AnnaBridge 171:3a7713b1edbc 87 /* #define STM32F102x6 */ /*!< STM32F102C4, STM32F102R4, STM32F102C6 and STM32F102R6 */
AnnaBridge 171:3a7713b1edbc 88 /* #define STM32F102xB */ /*!< STM32F102C8, STM32F102R8, STM32F102CB and STM32F102RB */
AnnaBridge 171:3a7713b1edbc 89 /* #define STM32F103x6 */ /*!< STM32F103C4, STM32F103R4, STM32F103T4, STM32F103C6, STM32F103R6 and STM32F103T6 */
AnnaBridge 171:3a7713b1edbc 90 #define STM32F103xB /*!< STM32F103C8, STM32F103R8, STM32F103T8, STM32F103V8, STM32F103CB, STM32F103RB, STM32F103TB and STM32F103VB */
AnnaBridge 171:3a7713b1edbc 91 /* #define STM32F103xE */ /*!< STM32F103RC, STM32F103VC, STM32F103ZC, STM32F103RD, STM32F103VD, STM32F103ZD, STM32F103RE, STM32F103VE and STM32F103ZE */
AnnaBridge 171:3a7713b1edbc 92 /* #define STM32F103xG */ /*!< STM32F103RF, STM32F103VF, STM32F103ZF, STM32F103RG, STM32F103VG and STM32F103ZG */
AnnaBridge 171:3a7713b1edbc 93 /* #define STM32F105xC */ /*!< STM32F105R8, STM32F105V8, STM32F105RB, STM32F105VB, STM32F105RC and STM32F105VC */
AnnaBridge 171:3a7713b1edbc 94 /* #define STM32F107xC */ /*!< STM32F107RB, STM32F107VB, STM32F107RC and STM32F107VC */
AnnaBridge 171:3a7713b1edbc 95 #endif
AnnaBridge 171:3a7713b1edbc 96
AnnaBridge 171:3a7713b1edbc 97 /* Tip: To avoid modifying this file each time you need to switch between these
AnnaBridge 171:3a7713b1edbc 98 devices, you can define the device in your toolchain compiler preprocessor.
AnnaBridge 171:3a7713b1edbc 99 */
AnnaBridge 171:3a7713b1edbc 100
AnnaBridge 171:3a7713b1edbc 101 #if !defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 102 /**
AnnaBridge 171:3a7713b1edbc 103 * @brief Comment the line below if you will not use the peripherals drivers.
AnnaBridge 171:3a7713b1edbc 104 In this case, these drivers will not be included and the application code will
AnnaBridge 171:3a7713b1edbc 105 be based on direct access to peripherals registers
AnnaBridge 171:3a7713b1edbc 106 */
AnnaBridge 171:3a7713b1edbc 107 #define USE_HAL_DRIVER
AnnaBridge 171:3a7713b1edbc 108 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 109
AnnaBridge 171:3a7713b1edbc 110 /**
AnnaBridge 171:3a7713b1edbc 111 * @brief CMSIS Device version number V4.2.0
AnnaBridge 171:3a7713b1edbc 112 */
AnnaBridge 171:3a7713b1edbc 113 #define __STM32F1_CMSIS_VERSION_MAIN (0x04) /*!< [31:24] main version */
AnnaBridge 171:3a7713b1edbc 114 #define __STM32F1_CMSIS_VERSION_SUB1 (0x02) /*!< [23:16] sub1 version */
AnnaBridge 171:3a7713b1edbc 115 #define __STM32F1_CMSIS_VERSION_SUB2 (0x00) /*!< [15:8] sub2 version */
AnnaBridge 171:3a7713b1edbc 116 #define __STM32F1_CMSIS_VERSION_RC (0x00) /*!< [7:0] release candidate */
AnnaBridge 171:3a7713b1edbc 117 #define __STM32F1_CMSIS_VERSION ((__STM32F1_CMSIS_VERSION_MAIN << 24)\
AnnaBridge 171:3a7713b1edbc 118 |(__STM32F1_CMSIS_VERSION_SUB1 << 16)\
AnnaBridge 171:3a7713b1edbc 119 |(__STM32F1_CMSIS_VERSION_SUB2 << 8 )\
AnnaBridge 171:3a7713b1edbc 120 |(__STM32F1_CMSIS_VERSION_RC))
AnnaBridge 171:3a7713b1edbc 121
AnnaBridge 171:3a7713b1edbc 122 /**
AnnaBridge 171:3a7713b1edbc 123 * @}
AnnaBridge 171:3a7713b1edbc 124 */
AnnaBridge 171:3a7713b1edbc 125
AnnaBridge 171:3a7713b1edbc 126 /** @addtogroup Device_Included
AnnaBridge 171:3a7713b1edbc 127 * @{
AnnaBridge 171:3a7713b1edbc 128 */
AnnaBridge 171:3a7713b1edbc 129
AnnaBridge 171:3a7713b1edbc 130 #if defined(STM32F100xB)
AnnaBridge 171:3a7713b1edbc 131 #include "stm32f100xb.h"
AnnaBridge 171:3a7713b1edbc 132 #elif defined(STM32F100xE)
AnnaBridge 171:3a7713b1edbc 133 #include "stm32f100xe.h"
AnnaBridge 171:3a7713b1edbc 134 #elif defined(STM32F101x6)
AnnaBridge 171:3a7713b1edbc 135 #include "stm32f101x6.h"
AnnaBridge 171:3a7713b1edbc 136 #elif defined(STM32F101xB)
AnnaBridge 171:3a7713b1edbc 137 #include "stm32f101xb.h"
AnnaBridge 171:3a7713b1edbc 138 #elif defined(STM32F101xE)
AnnaBridge 171:3a7713b1edbc 139 #include "stm32f101xe.h"
AnnaBridge 171:3a7713b1edbc 140 #elif defined(STM32F101xG)
AnnaBridge 171:3a7713b1edbc 141 #include "stm32f101xg.h"
AnnaBridge 171:3a7713b1edbc 142 #elif defined(STM32F102x6)
AnnaBridge 171:3a7713b1edbc 143 #include "stm32f102x6.h"
AnnaBridge 171:3a7713b1edbc 144 #elif defined(STM32F102xB)
AnnaBridge 171:3a7713b1edbc 145 #include "stm32f102xb.h"
AnnaBridge 171:3a7713b1edbc 146 #elif defined(STM32F103x6)
AnnaBridge 171:3a7713b1edbc 147 #include "stm32f103x6.h"
AnnaBridge 171:3a7713b1edbc 148 #elif defined(STM32F103xB)
AnnaBridge 171:3a7713b1edbc 149 #include "stm32f103xb.h"
AnnaBridge 171:3a7713b1edbc 150 #elif defined(STM32F103xE)
AnnaBridge 171:3a7713b1edbc 151 #include "stm32f103xe.h"
AnnaBridge 171:3a7713b1edbc 152 #elif defined(STM32F103xG)
AnnaBridge 171:3a7713b1edbc 153 #include "stm32f103xg.h"
AnnaBridge 171:3a7713b1edbc 154 #elif defined(STM32F105xC)
AnnaBridge 171:3a7713b1edbc 155 #include "stm32f105xc.h"
AnnaBridge 171:3a7713b1edbc 156 #elif defined(STM32F107xC)
AnnaBridge 171:3a7713b1edbc 157 #include "stm32f107xc.h"
AnnaBridge 171:3a7713b1edbc 158 #else
AnnaBridge 171:3a7713b1edbc 159 #error "Please select first the target STM32F1xx device used in your application (in stm32f1xx.h file)"
AnnaBridge 171:3a7713b1edbc 160 #endif
AnnaBridge 171:3a7713b1edbc 161
AnnaBridge 171:3a7713b1edbc 162 /**
AnnaBridge 171:3a7713b1edbc 163 * @}
AnnaBridge 171:3a7713b1edbc 164 */
AnnaBridge 171:3a7713b1edbc 165
AnnaBridge 171:3a7713b1edbc 166 /** @addtogroup Exported_types
AnnaBridge 171:3a7713b1edbc 167 * @{
AnnaBridge 171:3a7713b1edbc 168 */
AnnaBridge 171:3a7713b1edbc 169 typedef enum
AnnaBridge 171:3a7713b1edbc 170 {
AnnaBridge 171:3a7713b1edbc 171 RESET = 0,
AnnaBridge 171:3a7713b1edbc 172 SET = !RESET
AnnaBridge 171:3a7713b1edbc 173 } FlagStatus, ITStatus;
AnnaBridge 171:3a7713b1edbc 174
AnnaBridge 171:3a7713b1edbc 175 typedef enum
AnnaBridge 171:3a7713b1edbc 176 {
AnnaBridge 171:3a7713b1edbc 177 DISABLE = 0,
AnnaBridge 171:3a7713b1edbc 178 ENABLE = !DISABLE
AnnaBridge 171:3a7713b1edbc 179 } FunctionalState;
AnnaBridge 171:3a7713b1edbc 180 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
AnnaBridge 171:3a7713b1edbc 181
AnnaBridge 171:3a7713b1edbc 182 typedef enum
AnnaBridge 171:3a7713b1edbc 183 {
AnnaBridge 171:3a7713b1edbc 184 ERROR = 0,
AnnaBridge 171:3a7713b1edbc 185 SUCCESS = !ERROR
AnnaBridge 171:3a7713b1edbc 186 } ErrorStatus;
AnnaBridge 171:3a7713b1edbc 187
AnnaBridge 171:3a7713b1edbc 188 /**
AnnaBridge 171:3a7713b1edbc 189 * @}
AnnaBridge 171:3a7713b1edbc 190 */
AnnaBridge 171:3a7713b1edbc 191
AnnaBridge 171:3a7713b1edbc 192
AnnaBridge 171:3a7713b1edbc 193 /** @addtogroup Exported_macros
AnnaBridge 171:3a7713b1edbc 194 * @{
AnnaBridge 171:3a7713b1edbc 195 */
AnnaBridge 171:3a7713b1edbc 196 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
AnnaBridge 171:3a7713b1edbc 197
AnnaBridge 171:3a7713b1edbc 198 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
AnnaBridge 171:3a7713b1edbc 199
AnnaBridge 171:3a7713b1edbc 200 #define READ_BIT(REG, BIT) ((REG) & (BIT))
AnnaBridge 171:3a7713b1edbc 201
AnnaBridge 171:3a7713b1edbc 202 #define CLEAR_REG(REG) ((REG) = (0x0))
AnnaBridge 171:3a7713b1edbc 203
AnnaBridge 171:3a7713b1edbc 204 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
AnnaBridge 171:3a7713b1edbc 205
AnnaBridge 171:3a7713b1edbc 206 #define READ_REG(REG) ((REG))
AnnaBridge 171:3a7713b1edbc 207
AnnaBridge 171:3a7713b1edbc 208 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
AnnaBridge 171:3a7713b1edbc 209
AnnaBridge 171:3a7713b1edbc 210 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
AnnaBridge 171:3a7713b1edbc 211
AnnaBridge 171:3a7713b1edbc 212
AnnaBridge 171:3a7713b1edbc 213 /**
AnnaBridge 171:3a7713b1edbc 214 * @}
AnnaBridge 171:3a7713b1edbc 215 */
AnnaBridge 171:3a7713b1edbc 216
AnnaBridge 171:3a7713b1edbc 217 #if defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 218 #include "stm32f1xx_hal.h"
AnnaBridge 171:3a7713b1edbc 219 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 220
AnnaBridge 171:3a7713b1edbc 221
AnnaBridge 171:3a7713b1edbc 222 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 223 }
AnnaBridge 171:3a7713b1edbc 224 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 225
AnnaBridge 171:3a7713b1edbc 226 #endif /* __STM32F1xx_H */
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
AnnaBridge 171:3a7713b1edbc 235
AnnaBridge 171:3a7713b1edbc 236
AnnaBridge 171:3a7713b1edbc 237
AnnaBridge 171:3a7713b1edbc 238 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/