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_L432KC/TOOLCHAIN_GCC_ARM/stm32l4xx.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
Parent:
171:3a7713b1edbc 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 171:3a7713b1edbc 1 /**
AnnaBridge 171:3a7713b1edbc 2 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 3 * @file stm32l4xx.h
AnnaBridge 171:3a7713b1edbc 4 * @author MCD Application Team
AnnaBridge 171:3a7713b1edbc 5 * @brief CMSIS STM32L4xx Device Peripheral Access Layer Header File.
AnnaBridge 171:3a7713b1edbc 6 *
AnnaBridge 171:3a7713b1edbc 7 * The file is the unique include file that the application programmer
AnnaBridge 171:3a7713b1edbc 8 * is using in the C source code, usually in main.c. This file contains:
AnnaBridge 171:3a7713b1edbc 9 * - Configuration section that allows to select:
AnnaBridge 171:3a7713b1edbc 10 * - The STM32L4xx device used in the target application
AnnaBridge 171:3a7713b1edbc 11 * - To use or not the peripheral’s drivers in application code(i.e.
AnnaBridge 171:3a7713b1edbc 12 * code will be based on direct access to peripheral’s registers
AnnaBridge 171:3a7713b1edbc 13 * rather than drivers API), this option is controlled by
AnnaBridge 171:3a7713b1edbc 14 * "#define USE_HAL_DRIVER"
AnnaBridge 171:3a7713b1edbc 15 *
AnnaBridge 171:3a7713b1edbc 16 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 17 * @attention
AnnaBridge 171:3a7713b1edbc 18 *
AnnaBridge 171:3a7713b1edbc 19 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
AnnaBridge 171:3a7713b1edbc 20 *
AnnaBridge 171:3a7713b1edbc 21 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 171:3a7713b1edbc 22 * are permitted provided that the following conditions are met:
AnnaBridge 171:3a7713b1edbc 23 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 171:3a7713b1edbc 24 * this list of conditions and the following disclaimer.
AnnaBridge 171:3a7713b1edbc 25 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 171:3a7713b1edbc 26 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 171:3a7713b1edbc 27 * and/or other materials provided with the distribution.
AnnaBridge 171:3a7713b1edbc 28 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 171:3a7713b1edbc 29 * may be used to endorse or promote products derived from this software
AnnaBridge 171:3a7713b1edbc 30 * without specific prior written permission.
AnnaBridge 171:3a7713b1edbc 31 *
AnnaBridge 171:3a7713b1edbc 32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 171:3a7713b1edbc 33 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 171:3a7713b1edbc 34 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 171:3a7713b1edbc 35 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 171:3a7713b1edbc 36 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 171:3a7713b1edbc 37 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 171:3a7713b1edbc 38 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 171:3a7713b1edbc 39 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 171:3a7713b1edbc 40 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 171:3a7713b1edbc 41 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 171:3a7713b1edbc 42 *
AnnaBridge 171:3a7713b1edbc 43 ******************************************************************************
AnnaBridge 171:3a7713b1edbc 44 */
AnnaBridge 171:3a7713b1edbc 45
AnnaBridge 171:3a7713b1edbc 46 /** @addtogroup CMSIS
AnnaBridge 171:3a7713b1edbc 47 * @{
AnnaBridge 171:3a7713b1edbc 48 */
AnnaBridge 171:3a7713b1edbc 49
AnnaBridge 171:3a7713b1edbc 50 /** @addtogroup stm32l4xx
AnnaBridge 171:3a7713b1edbc 51 * @{
AnnaBridge 171:3a7713b1edbc 52 */
AnnaBridge 171:3a7713b1edbc 53
AnnaBridge 171:3a7713b1edbc 54 #ifndef __STM32L4xx_H
AnnaBridge 171:3a7713b1edbc 55 #define __STM32L4xx_H
AnnaBridge 171:3a7713b1edbc 56
AnnaBridge 171:3a7713b1edbc 57 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 58 extern "C" {
AnnaBridge 171:3a7713b1edbc 59 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 60
AnnaBridge 171:3a7713b1edbc 61 /** @addtogroup Library_configuration_section
AnnaBridge 171:3a7713b1edbc 62 * @{
AnnaBridge 171:3a7713b1edbc 63 */
AnnaBridge 171:3a7713b1edbc 64
AnnaBridge 171:3a7713b1edbc 65 /**
AnnaBridge 171:3a7713b1edbc 66 * @brief STM32 Family
AnnaBridge 171:3a7713b1edbc 67 */
AnnaBridge 171:3a7713b1edbc 68 #if !defined (STM32L4)
AnnaBridge 171:3a7713b1edbc 69 #define STM32L4
AnnaBridge 171:3a7713b1edbc 70 #endif /* STM32L4 */
AnnaBridge 171:3a7713b1edbc 71
AnnaBridge 171:3a7713b1edbc 72 /* Uncomment the line below according to the target STM32L4 device used in your
AnnaBridge 171:3a7713b1edbc 73 application
AnnaBridge 171:3a7713b1edbc 74 */
AnnaBridge 171:3a7713b1edbc 75
AnnaBridge 171:3a7713b1edbc 76 #if !defined (STM32L431xx) && !defined (STM32L432xx) && !defined (STM32L433xx) && !defined (STM32L442xx) && !defined (STM32L443xx) && \
AnnaBridge 171:3a7713b1edbc 77 !defined (STM32L451xx) && !defined (STM32L452xx) && !defined (STM32L462xx) && \
AnnaBridge 171:3a7713b1edbc 78 !defined (STM32L471xx) && !defined (STM32L475xx) && !defined (STM32L476xx) && !defined (STM32L485xx) && !defined (STM32L486xx) && \
AnnaBridge 171:3a7713b1edbc 79 !defined (STM32L496xx) && !defined (STM32L4A6xx) && \
AnnaBridge 171:3a7713b1edbc 80 !defined (STM32L4R5xx) && !defined (STM32L4R7xx) && !defined (STM32L4R9xx) && !defined (STM32L4S5xx) && !defined (STM32L4S7xx) && !defined (STM32L4S9xx)
AnnaBridge 171:3a7713b1edbc 81 /* #define STM32L431xx */ /*!< STM32L431xx Devices */
AnnaBridge 171:3a7713b1edbc 82 #define STM32L432xx /*!< STM32L432xx Devices */
AnnaBridge 171:3a7713b1edbc 83 /* #define STM32L433xx */ /*!< STM32L433xx Devices */
AnnaBridge 171:3a7713b1edbc 84 /* #define STM32L442xx */ /*!< STM32L442xx Devices */
AnnaBridge 171:3a7713b1edbc 85 /* #define STM32L443xx */ /*!< STM32L443xx Devices */
AnnaBridge 171:3a7713b1edbc 86 /* #define STM32L451xx */ /*!< STM32L451xx Devices */
AnnaBridge 171:3a7713b1edbc 87 /* #define STM32L452xx */ /*!< STM32L452xx Devices */
AnnaBridge 171:3a7713b1edbc 88 /* #define STM32L462xx */ /*!< STM32L462xx Devices */
AnnaBridge 171:3a7713b1edbc 89 /* #define STM32L471xx */ /*!< STM32L471xx Devices */
AnnaBridge 171:3a7713b1edbc 90 /* #define STM32L475xx */ /*!< STM32L475xx Devices */
AnnaBridge 171:3a7713b1edbc 91 /* #define STM32L476xx */ /*!< STM32L476xx Devices */
AnnaBridge 171:3a7713b1edbc 92 /* #define STM32L485xx */ /*!< STM32L485xx Devices */
AnnaBridge 171:3a7713b1edbc 93 /* #define STM32L486xx */ /*!< STM32L486xx Devices */
AnnaBridge 171:3a7713b1edbc 94 /* #define STM32L496xx */ /*!< STM32L496xx Devices */
AnnaBridge 171:3a7713b1edbc 95 /* #define STM32L4A6xx */ /*!< STM32L4A6xx Devices */
AnnaBridge 171:3a7713b1edbc 96 /* #define STM32L4R5xx */ /*!< STM32L4R5xx Devices */
AnnaBridge 171:3a7713b1edbc 97 /* #define STM32L4R7xx */ /*!< STM32L4R7xx Devices */
AnnaBridge 171:3a7713b1edbc 98 /* #define STM32L4R9xx */ /*!< STM32L4R9xx Devices */
AnnaBridge 171:3a7713b1edbc 99 /* #define STM32L4S5xx */ /*!< STM32L4S5xx Devices */
AnnaBridge 171:3a7713b1edbc 100 /* #define STM32L4S7xx */ /*!< STM32L4S7xx Devices */
AnnaBridge 171:3a7713b1edbc 101 /* #define STM32L4S9xx */ /*!< STM32L4S9xx Devices */
AnnaBridge 171:3a7713b1edbc 102 #endif
AnnaBridge 171:3a7713b1edbc 103
AnnaBridge 171:3a7713b1edbc 104 /* Tip: To avoid modifying this file each time you need to switch between these
AnnaBridge 171:3a7713b1edbc 105 devices, you can define the device in your toolchain compiler preprocessor.
AnnaBridge 171:3a7713b1edbc 106 */
AnnaBridge 171:3a7713b1edbc 107 #if !defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 108 /**
AnnaBridge 171:3a7713b1edbc 109 * @brief Comment the line below if you will not use the peripherals drivers.
AnnaBridge 171:3a7713b1edbc 110 In this case, these drivers will not be included and the application code will
AnnaBridge 171:3a7713b1edbc 111 be based on direct access to peripherals registers
AnnaBridge 171:3a7713b1edbc 112 */
AnnaBridge 171:3a7713b1edbc 113 #define USE_HAL_DRIVER
AnnaBridge 171:3a7713b1edbc 114 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 115
AnnaBridge 171:3a7713b1edbc 116 /**
AnnaBridge 171:3a7713b1edbc 117 * @brief CMSIS Device version number
AnnaBridge 171:3a7713b1edbc 118 */
AnnaBridge 171:3a7713b1edbc 119 #define __STM32L4_CMSIS_VERSION_MAIN (0x01) /*!< [31:24] main version */
AnnaBridge 171:3a7713b1edbc 120 #define __STM32L4_CMSIS_VERSION_SUB1 (0x04) /*!< [23:16] sub1 version */
AnnaBridge 171:3a7713b1edbc 121 #define __STM32L4_CMSIS_VERSION_SUB2 (0x02) /*!< [15:8] sub2 version */
AnnaBridge 171:3a7713b1edbc 122 #define __STM32L4_CMSIS_VERSION_RC (0x00) /*!< [7:0] release candidate */
AnnaBridge 171:3a7713b1edbc 123 #define __STM32L4_CMSIS_VERSION ((__STM32L4_CMSIS_VERSION_MAIN << 24)\
AnnaBridge 171:3a7713b1edbc 124 |(__STM32L4_CMSIS_VERSION_SUB1 << 16)\
AnnaBridge 171:3a7713b1edbc 125 |(__STM32L4_CMSIS_VERSION_SUB2 << 8 )\
AnnaBridge 171:3a7713b1edbc 126 |(__STM32L4_CMSIS_VERSION_RC))
AnnaBridge 171:3a7713b1edbc 127
AnnaBridge 171:3a7713b1edbc 128 /**
AnnaBridge 171:3a7713b1edbc 129 * @}
AnnaBridge 171:3a7713b1edbc 130 */
AnnaBridge 171:3a7713b1edbc 131
AnnaBridge 171:3a7713b1edbc 132 /** @addtogroup Device_Included
AnnaBridge 171:3a7713b1edbc 133 * @{
AnnaBridge 171:3a7713b1edbc 134 */
AnnaBridge 171:3a7713b1edbc 135
AnnaBridge 171:3a7713b1edbc 136 #if defined(STM32L431xx)
AnnaBridge 171:3a7713b1edbc 137 #include "stm32l431xx.h"
AnnaBridge 171:3a7713b1edbc 138 #elif defined(STM32L432xx)
AnnaBridge 171:3a7713b1edbc 139 #include "stm32l432xx.h"
AnnaBridge 171:3a7713b1edbc 140 #elif defined(STM32L433xx)
AnnaBridge 171:3a7713b1edbc 141 #include "stm32l433xx.h"
AnnaBridge 171:3a7713b1edbc 142 #elif defined(STM32L442xx)
AnnaBridge 171:3a7713b1edbc 143 #include "stm32l442xx.h"
AnnaBridge 171:3a7713b1edbc 144 #elif defined(STM32L443xx)
AnnaBridge 171:3a7713b1edbc 145 #include "stm32l443xx.h"
AnnaBridge 171:3a7713b1edbc 146 #elif defined(STM32L451xx)
AnnaBridge 171:3a7713b1edbc 147 #include "stm32l451xx.h"
AnnaBridge 171:3a7713b1edbc 148 #elif defined(STM32L452xx)
AnnaBridge 171:3a7713b1edbc 149 #include "stm32l452xx.h"
AnnaBridge 171:3a7713b1edbc 150 #elif defined(STM32L462xx)
AnnaBridge 171:3a7713b1edbc 151 #include "stm32l462xx.h"
AnnaBridge 171:3a7713b1edbc 152 #elif defined(STM32L471xx)
AnnaBridge 171:3a7713b1edbc 153 #include "stm32l471xx.h"
AnnaBridge 171:3a7713b1edbc 154 #elif defined(STM32L475xx)
AnnaBridge 171:3a7713b1edbc 155 #include "stm32l475xx.h"
AnnaBridge 171:3a7713b1edbc 156 #elif defined(STM32L476xx)
AnnaBridge 171:3a7713b1edbc 157 #include "stm32l476xx.h"
AnnaBridge 171:3a7713b1edbc 158 #elif defined(STM32L485xx)
AnnaBridge 171:3a7713b1edbc 159 #include "stm32l485xx.h"
AnnaBridge 171:3a7713b1edbc 160 #elif defined(STM32L486xx)
AnnaBridge 171:3a7713b1edbc 161 #include "stm32l486xx.h"
AnnaBridge 171:3a7713b1edbc 162 #elif defined(STM32L496xx)
AnnaBridge 171:3a7713b1edbc 163 #include "stm32l496xx.h"
AnnaBridge 171:3a7713b1edbc 164 #elif defined(STM32L4A6xx)
AnnaBridge 171:3a7713b1edbc 165 #include "stm32l4a6xx.h"
AnnaBridge 171:3a7713b1edbc 166 #elif defined(STM32L4R5xx)
AnnaBridge 171:3a7713b1edbc 167 #include "stm32l4r5xx.h"
AnnaBridge 171:3a7713b1edbc 168 #elif defined(STM32L4R7xx)
AnnaBridge 171:3a7713b1edbc 169 #include "stm32l4r7xx.h"
AnnaBridge 171:3a7713b1edbc 170 #elif defined(STM32L4R9xx)
AnnaBridge 171:3a7713b1edbc 171 #include "stm32l4r9xx.h"
AnnaBridge 171:3a7713b1edbc 172 #elif defined(STM32L4S5xx)
AnnaBridge 171:3a7713b1edbc 173 #include "stm32l4s5xx.h"
AnnaBridge 171:3a7713b1edbc 174 #elif defined(STM32L4S7xx)
AnnaBridge 171:3a7713b1edbc 175 #include "stm32l4s7xx.h"
AnnaBridge 171:3a7713b1edbc 176 #elif defined(STM32L4S9xx)
AnnaBridge 171:3a7713b1edbc 177 #include "stm32l4s9xx.h"
AnnaBridge 171:3a7713b1edbc 178 #else
AnnaBridge 171:3a7713b1edbc 179 #error "Please select first the target STM32L4xx device used in your application (in stm32l4xx.h file)"
AnnaBridge 171:3a7713b1edbc 180 #endif
AnnaBridge 171:3a7713b1edbc 181
AnnaBridge 171:3a7713b1edbc 182 /**
AnnaBridge 171:3a7713b1edbc 183 * @}
AnnaBridge 171:3a7713b1edbc 184 */
AnnaBridge 171:3a7713b1edbc 185
AnnaBridge 171:3a7713b1edbc 186 /** @addtogroup Exported_types
AnnaBridge 171:3a7713b1edbc 187 * @{
AnnaBridge 171:3a7713b1edbc 188 */
AnnaBridge 171:3a7713b1edbc 189 typedef enum
AnnaBridge 171:3a7713b1edbc 190 {
AnnaBridge 171:3a7713b1edbc 191 RESET = 0,
AnnaBridge 171:3a7713b1edbc 192 SET = !RESET
AnnaBridge 171:3a7713b1edbc 193 } FlagStatus, ITStatus;
AnnaBridge 171:3a7713b1edbc 194
AnnaBridge 171:3a7713b1edbc 195 typedef enum
AnnaBridge 171:3a7713b1edbc 196 {
AnnaBridge 171:3a7713b1edbc 197 DISABLE = 0,
AnnaBridge 171:3a7713b1edbc 198 ENABLE = !DISABLE
AnnaBridge 171:3a7713b1edbc 199 } FunctionalState;
AnnaBridge 171:3a7713b1edbc 200 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
AnnaBridge 171:3a7713b1edbc 201
AnnaBridge 171:3a7713b1edbc 202 typedef enum
AnnaBridge 171:3a7713b1edbc 203 {
AnnaBridge 171:3a7713b1edbc 204 ERROR = 0,
AnnaBridge 171:3a7713b1edbc 205 SUCCESS = !ERROR
AnnaBridge 171:3a7713b1edbc 206 } ErrorStatus;
AnnaBridge 171:3a7713b1edbc 207
AnnaBridge 171:3a7713b1edbc 208 /**
AnnaBridge 171:3a7713b1edbc 209 * @}
AnnaBridge 171:3a7713b1edbc 210 */
AnnaBridge 171:3a7713b1edbc 211
AnnaBridge 171:3a7713b1edbc 212
AnnaBridge 171:3a7713b1edbc 213 /** @addtogroup Exported_macros
AnnaBridge 171:3a7713b1edbc 214 * @{
AnnaBridge 171:3a7713b1edbc 215 */
AnnaBridge 171:3a7713b1edbc 216 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
AnnaBridge 171:3a7713b1edbc 217
AnnaBridge 171:3a7713b1edbc 218 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
AnnaBridge 171:3a7713b1edbc 219
AnnaBridge 171:3a7713b1edbc 220 #define READ_BIT(REG, BIT) ((REG) & (BIT))
AnnaBridge 171:3a7713b1edbc 221
AnnaBridge 171:3a7713b1edbc 222 #define CLEAR_REG(REG) ((REG) = (0x0))
AnnaBridge 171:3a7713b1edbc 223
AnnaBridge 171:3a7713b1edbc 224 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
AnnaBridge 171:3a7713b1edbc 225
AnnaBridge 171:3a7713b1edbc 226 #define READ_REG(REG) ((REG))
AnnaBridge 171:3a7713b1edbc 227
AnnaBridge 171:3a7713b1edbc 228 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
AnnaBridge 171:3a7713b1edbc 229
AnnaBridge 171:3a7713b1edbc 230 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
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 #if defined (USE_HAL_DRIVER)
AnnaBridge 171:3a7713b1edbc 238 #include "stm32l4xx_hal.h"
AnnaBridge 171:3a7713b1edbc 239 #endif /* USE_HAL_DRIVER */
AnnaBridge 171:3a7713b1edbc 240
AnnaBridge 171:3a7713b1edbc 241 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 242 }
AnnaBridge 171:3a7713b1edbc 243 #endif /* __cplusplus */
AnnaBridge 171:3a7713b1edbc 244
AnnaBridge 171:3a7713b1edbc 245 #endif /* __STM32L4xx_H */
AnnaBridge 171:3a7713b1edbc 246 /**
AnnaBridge 171:3a7713b1edbc 247 * @}
AnnaBridge 171:3a7713b1edbc 248 */
AnnaBridge 171:3a7713b1edbc 249
AnnaBridge 171:3a7713b1edbc 250 /**
AnnaBridge 171:3a7713b1edbc 251 * @}
AnnaBridge 171:3a7713b1edbc 252 */
AnnaBridge 171:3a7713b1edbc 253
AnnaBridge 171:3a7713b1edbc 254
AnnaBridge 171:3a7713b1edbc 255
AnnaBridge 171:3a7713b1edbc 256
AnnaBridge 171:3a7713b1edbc 257 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/