tool/mbed/mbed-sdk/libraries/mbed/targets/cmsis/TARGET_STM/TARGET_STM32F3/TARGET_NUCLEO_F303RE/stm32f3xx.h

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