mbed official / mbed

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

TARGET_NUCLEO_L152RE/stm32l1xx.h@122:f9eeca106725, 2016-07-07 (annotated)

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
90:cb3d968589d8 
Release 122 of the mbed library



Changes:

- new targets - Nucleo L432KC, Beetle, Nucleo F446ZE, Nucleo L011K4

- Thread safety addition - mbed API should contain a statement about thread safety

- critical section API addition

- CAS API (core_util_atomic_incr/decr)

- DEVICE_ are generated from targets.json file, device.h deprecated

- Callback replaces FunctionPointer to provide std like interface

- mbed HAL API docs improvements

- toolchain - prexif attributes with MBED_

            - add new attributes - packed, weak, forcedinline, align

- target.json - contains targets definitions

- ST - L1XX - Cube update to 1.5

     - SPI clock selection fix (clock from APB domain)

     - F7 - Cube update v1.4.0

     - L0 -  baudrate init fix

     - L1 - Cube update v1.5

     - F3 - baudrate init fix, 3 targets CAN support

     - F4 - Cube update v1.12.0, 3 targets CAN support

     - L4XX - Cube update v1.5.1

     - F0 - update Cube to v1.5.0

     - L4 - 2 targets (L476RG/VG) CAN support

- NXP - pwm clock fix for KSDK2 MCU

      - LPC2368 - remove ARM toolchain support - due to regression

      - KSDK2 - fix SPI , I2C address and repeat start

- Silabs - some fixes backported from mbed 3

- Renesas - RZ_A1H - SystemCoreClockUpdate addition

Who changed what in which revision?

UserRevisionLine numberNew contents of line
emilmont 77:869cf507173a 1 /**
emilmont 77:869cf507173a 2 ******************************************************************************
emilmont 77:869cf507173a 3 * @file stm32l1xx.h
emilmont 77:869cf507173a 4 * @author MCD Application Team
Kojto 122:f9eeca106725 5 * @version V2.1.3
Kojto 122:f9eeca106725 6 * @date 04-March-2016
Kojto 90:cb3d968589d8 7 * @brief CMSIS STM32L1xx Device Peripheral Access Layer Header File.
emilmont 77:869cf507173a 8 *
emilmont 77:869cf507173a 9 * The file is the unique include file that the application programmer
emilmont 77:869cf507173a 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 STM32L1xx device used in the target application
emilmont 77:869cf507173a 13 * - To use or not the peripheral’s drivers in application code(i.e.
emilmont 77:869cf507173a 14 * code will be based on direct access to peripheral’s registers
emilmont 77:869cf507173a 15 * rather than drivers API), this option is controlled by
Kojto 90:cb3d968589d8 16 * "#define USE_HAL_DRIVER"
Kojto 90:cb3d968589d8 17 *
emilmont 77:869cf507173a 18 ******************************************************************************
emilmont 77:869cf507173a 19 * @attention
emilmont 77:869cf507173a 20 *
Kojto 122:f9eeca106725 21 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
emilmont 77:869cf507173a 22 *
bogdanm 81:7d30d6019079 23 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 81:7d30d6019079 24 * are permitted provided that the following conditions are met:
bogdanm 81:7d30d6019079 25 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 81:7d30d6019079 26 * this list of conditions and the following disclaimer.
bogdanm 81:7d30d6019079 27 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 81:7d30d6019079 28 * this list of conditions and the following disclaimer in the documentation
bogdanm 81:7d30d6019079 29 * and/or other materials provided with the distribution.
bogdanm 81:7d30d6019079 30 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 81:7d30d6019079 31 * may be used to endorse or promote products derived from this software
bogdanm 81:7d30d6019079 32 * without specific prior written permission.
emilmont 77:869cf507173a 33 *
bogdanm 81:7d30d6019079 34 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 81:7d30d6019079 35 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 81:7d30d6019079 36 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 81:7d30d6019079 37 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 81:7d30d6019079 38 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 81:7d30d6019079 39 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 81:7d30d6019079 40 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 81:7d30d6019079 41 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 81:7d30d6019079 42 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 81:7d30d6019079 43 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
emilmont 77:869cf507173a 44 *
emilmont 77:869cf507173a 45 ******************************************************************************
emilmont 77:869cf507173a 46 */
emilmont 77:869cf507173a 47
emilmont 77:869cf507173a 48 /** @addtogroup CMSIS
emilmont 77:869cf507173a 49 * @{
emilmont 77:869cf507173a 50 */
emilmont 77:869cf507173a 51
emilmont 77:869cf507173a 52 /** @addtogroup stm32l1xx
emilmont 77:869cf507173a 53 * @{
emilmont 77:869cf507173a 54 */
emilmont 77:869cf507173a 55
emilmont 77:869cf507173a 56 #ifndef __STM32L1XX_H
emilmont 77:869cf507173a 57 #define __STM32L1XX_H
emilmont 77:869cf507173a 58
emilmont 77:869cf507173a 59 #ifdef __cplusplus
emilmont 77:869cf507173a 60 extern "C" {
Kojto 90:cb3d968589d8 61 #endif /* __cplusplus */
emilmont 77:869cf507173a 62
emilmont 77:869cf507173a 63 /** @addtogroup Library_configuration_section
emilmont 77:869cf507173a 64 * @{
emilmont 77:869cf507173a 65 */
Kojto 90:cb3d968589d8 66
Kojto 122:f9eeca106725 67 /**
Kojto 122:f9eeca106725 68 * @brief STM32 Family
Kojto 122:f9eeca106725 69 */
Kojto 122:f9eeca106725 70 #if !defined (STM32L1)
Kojto 122:f9eeca106725 71 #define STM32L1
Kojto 122:f9eeca106725 72 #endif /* STM32L1 */
Kojto 122:f9eeca106725 73
Kojto 122:f9eeca106725 74
emilmont 77:869cf507173a 75 /* Uncomment the line below according to the target STM32L device used in your
emilmont 77:869cf507173a 76 application
emilmont 77:869cf507173a 77 */
emilmont 77:869cf507173a 78
Kojto 90:cb3d968589d8 79 #if !defined (STM32L100xB) && !defined (STM32L100xBA) && !defined (STM32L100xC) && \
Kojto 122:f9eeca106725 80 !defined (STM32L151xB) && !defined (STM32L151xBA) && !defined (STM32L151xC) && !defined (STM32L151xCA) && !defined (STM32L151xD) && !defined (STM32L151xDX) && !defined (STM32L151xE) && \
Kojto 122:f9eeca106725 81 !defined (STM32L152xB) && !defined (STM32L152xBA) && !defined (STM32L152xC) && !defined (STM32L152xCA) && !defined (STM32L152xD) && !defined (STM32L152xDX) && !defined (STM32L152xE) && \
Kojto 122:f9eeca106725 82 !defined (STM32L162xC) && !defined (STM32L162xCA) && !defined (STM32L162xD) && !defined (STM32L162xDX) && !defined (STM32L162xE)
Kojto 90:cb3d968589d8 83 /* #define STM32L100xB */ /*!< STM32L100C6, STM32L100R and STM32L100RB Devices */
Kojto 90:cb3d968589d8 84 /* #define STM32L100xBA */ /*!< STM32L100C6-A, STM32L100R8-A and STM32L100RB-A Devices */
Kojto 90:cb3d968589d8 85 /* #define STM32L100xC */ /*!< STM32L100RC Devices */
Kojto 90:cb3d968589d8 86 /* #define STM32L151xB */ /*!< STM32L151C6, STM32L151R6, STM32L151C8, STM32L151R8, STM32L151V8, STM32L151CB, STM32L151RB and STM32L151VB */
Kojto 90:cb3d968589d8 87 /* #define STM32L151xBA */ /*!< STM32L151C6-A, STM32L151R6-A, STM32L151C8-A, STM32L151R8-A, STM32L151V8-A, STM32L151CB-A, STM32L151RB-A and STM32L151VB-A */
Kojto 90:cb3d968589d8 88 /* #define STM32L151xC */ /*!< STM32L151CC, STM32L151UC, STM32L151RC and STM32L151VC */
Kojto 90:cb3d968589d8 89 /* #define STM32L151xCA */ /*!< STM32L151RC-A, STM32L151VC-A, STM32L151QC and STM32L151ZC */
Kojto 90:cb3d968589d8 90 /* #define STM32L151xD */ /*!< STM32L151QD, STM32L151RD, STM32L151VD & STM32L151ZD */
Kojto 122:f9eeca106725 91 /* #define STM32L151xDX */ /*!< STM32L151VD-X Devices */
Kojto 90:cb3d968589d8 92 /* #define STM32L151xE */ /*!< STM32L151QE, STM32L151RE, STM32L151VE and STM32L151ZE */
Kojto 90:cb3d968589d8 93 /* #define STM32L152xB */ /*!< STM32L152C6, STM32L152R6, STM32L152C8, STM32L152R8, STM32L152V8, STM32L152CB, STM32L152RB and STM32L152VB */
Kojto 90:cb3d968589d8 94 /* #define STM32L152xBA */ /*!< STM32L152C6-A, STM32L152R6-A, STM32L152C8-A, STM32L152R8-A, STM32L152V8-A, STM32L152CB-A, STM32L152RB-A and STM32L152VB-A */
Kojto 90:cb3d968589d8 95 /* #define STM32L152xC */ /*!< STM32L152CC, STM32L152UC, STM32L152RC and STM32L152VC */
Kojto 90:cb3d968589d8 96 /* #define STM32L152xCA */ /*!< STM32L152RC-A, STM32L152VC-A, STM32L152QC and STM32L152ZC */
Kojto 90:cb3d968589d8 97 /* #define STM32L152xD */ /*!< STM32L152QD, STM32L152RD, STM32L152VD and STM32L152ZD */
Kojto 90:cb3d968589d8 98 #define STM32L152xE /*!< STM32L152QE, STM32L152RE, STM32L152VE and STM32L152ZE */
Kojto 90:cb3d968589d8 99 /* #define STM32L162xC */ /*!< STM32L162RC and STM32L162VC */
Kojto 90:cb3d968589d8 100 /* #define STM32L162xCA */ /*!< STM32L162RC-A, STM32L162VC-A, STM32L162QC and STM32L162ZC */
Kojto 90:cb3d968589d8 101 /* #define STM32L162xD */ /*!< STM32L162QD, STM32L162RD, STM32L162VD and STM32L162ZD */
Kojto 122:f9eeca106725 102 /* #define STM32L162xDX */ /*!< STM32L162VD-X Devices */
Kojto 90:cb3d968589d8 103 /* #define STM32L162xE */ /*!< STM32L162RE, STM32L162VE and STM32L162ZE */
Kojto 90:cb3d968589d8 104 #endif
emilmont 77:869cf507173a 105
emilmont 77:869cf507173a 106 /* Tip: To avoid modifying this file each time you need to switch between these
emilmont 77:869cf507173a 107 devices, you can define the device in your toolchain compiler preprocessor.
emilmont 77:869cf507173a 108 */
Kojto 90:cb3d968589d8 109
Kojto 90:cb3d968589d8 110 #if !defined (USE_HAL_DRIVER)
emilmont 77:869cf507173a 111 /**
emilmont 77:869cf507173a 112 * @brief Comment the line below if you will not use the peripherals drivers.
emilmont 77:869cf507173a 113 In this case, these drivers will not be included and the application code will
emilmont 77:869cf507173a 114 be based on direct access to peripherals registers
emilmont 77:869cf507173a 115 */
Kojto 90:cb3d968589d8 116 #define USE_HAL_DRIVER
Kojto 90:cb3d968589d8 117 #endif /* USE_HAL_DRIVER */
emilmont 77:869cf507173a 118
emilmont 77:869cf507173a 119 /**
Kojto 122:f9eeca106725 120 * @brief CMSIS Device version number V2.1.3
Kojto 90:cb3d968589d8 121 */
Kojto 122:f9eeca106725 122 #define __STM32L1xx_CMSIS_VERSION_MAIN (0x02) /*!< [31:24] main version */
Kojto 122:f9eeca106725 123 #define __STM32L1xx_CMSIS_VERSION_SUB1 (0x01) /*!< [23:16] sub1 version */
Kojto 122:f9eeca106725 124 #define __STM32L1xx_CMSIS_VERSION_SUB2 (0x03) /*!< [15:8] sub2 version */
Kojto 122:f9eeca106725 125 #define __STM32L1xx_CMSIS_VERSION_RC (0x00) /*!< [7:0] release candidate */
Kojto 122:f9eeca106725 126 #define __STM32L1xx_CMSIS_VERSION ((__STM32L1xx_CMSIS_VERSION_MAIN << 24)\
Kojto 122:f9eeca106725 127 |(__STM32L1xx_CMSIS_VERSION_SUB1 << 16)\
Kojto 122:f9eeca106725 128 |(__STM32L1xx_CMSIS_VERSION_SUB2 << 8 )\
Kojto 122:f9eeca106725 129 |(__STM32L1xx_CMSIS_VERSION_RC))
emilmont 77:869cf507173a 130
emilmont 77:869cf507173a 131 /**
emilmont 77:869cf507173a 132 * @}
emilmont 77:869cf507173a 133 */
emilmont 77:869cf507173a 134
Kojto 90:cb3d968589d8 135 /** @addtogroup Device_Included
emilmont 77:869cf507173a 136 * @{
emilmont 77:869cf507173a 137 */
emilmont 77:869cf507173a 138
Kojto 90:cb3d968589d8 139 #if defined(STM32L100xB)
Kojto 90:cb3d968589d8 140 #include "stm32l100xb.h"
Kojto 90:cb3d968589d8 141 #elif defined(STM32L100xBA)
Kojto 90:cb3d968589d8 142 #include "stm32l100xba.h"
Kojto 90:cb3d968589d8 143 #elif defined(STM32L100xC)
Kojto 90:cb3d968589d8 144 #include "stm32l100xc.h"
Kojto 90:cb3d968589d8 145 #elif defined(STM32L151xB)
Kojto 90:cb3d968589d8 146 #include "stm32l151xb.h"
Kojto 90:cb3d968589d8 147 #elif defined(STM32L151xBA)
Kojto 90:cb3d968589d8 148 #include "stm32l151xba.h"
Kojto 90:cb3d968589d8 149 #elif defined(STM32L151xC)
Kojto 90:cb3d968589d8 150 #include "stm32l151xc.h"
Kojto 90:cb3d968589d8 151 #elif defined(STM32L151xCA)
Kojto 90:cb3d968589d8 152 #include "stm32l151xca.h"
Kojto 90:cb3d968589d8 153 #elif defined(STM32L151xD)
Kojto 90:cb3d968589d8 154 #include "stm32l151xd.h"
Kojto 122:f9eeca106725 155 #elif defined(STM32L151xDX)
Kojto 122:f9eeca106725 156 #include "stm32l151xdx.h"
Kojto 90:cb3d968589d8 157 #elif defined(STM32L151xE)
Kojto 90:cb3d968589d8 158 #include "stm32l151xe.h"
Kojto 90:cb3d968589d8 159 #elif defined(STM32L152xB)
Kojto 90:cb3d968589d8 160 #include "stm32l152xb.h"
Kojto 90:cb3d968589d8 161 #elif defined(STM32L152xBA)
Kojto 90:cb3d968589d8 162 #include "stm32l152xba.h"
Kojto 90:cb3d968589d8 163 #elif defined(STM32L152xC)
Kojto 90:cb3d968589d8 164 #include "stm32l152xc.h"
Kojto 90:cb3d968589d8 165 #elif defined(STM32L152xCA)
Kojto 90:cb3d968589d8 166 #include "stm32l152xca.h"
Kojto 90:cb3d968589d8 167 #elif defined(STM32L152xD)
Kojto 90:cb3d968589d8 168 #include "stm32l152xd.h"
Kojto 122:f9eeca106725 169 #elif defined(STM32L152xDX)
Kojto 122:f9eeca106725 170 #include "stm32l152xdx.h"
Kojto 90:cb3d968589d8 171 #elif defined(STM32L152xE)
Kojto 90:cb3d968589d8 172 #include "stm32l152xe.h"
Kojto 90:cb3d968589d8 173 #elif defined(STM32L162xC)
Kojto 90:cb3d968589d8 174 #include "stm32l162xc.h"
Kojto 90:cb3d968589d8 175 #elif defined(STM32L162xCA)
Kojto 90:cb3d968589d8 176 #include "stm32l162xca.h"
Kojto 90:cb3d968589d8 177 #elif defined(STM32L162xD)
Kojto 90:cb3d968589d8 178 #include "stm32l162xd.h"
Kojto 122:f9eeca106725 179 #elif defined(STM32L162xDX)
Kojto 122:f9eeca106725 180 #include "stm32l162xdx.h"
Kojto 90:cb3d968589d8 181 #elif defined(STM32L162xE)
Kojto 90:cb3d968589d8 182 #include "stm32l162xe.h"
Kojto 90:cb3d968589d8 183 #else
Kojto 90:cb3d968589d8 184 #error "Please select first the target STM32L1xx device used in your application (in stm32l1xx.h file)"
emilmont 77:869cf507173a 185 #endif
emilmont 77:869cf507173a 186
emilmont 77:869cf507173a 187 /**
emilmont 77:869cf507173a 188 * @}
emilmont 77:869cf507173a 189 */
emilmont 77:869cf507173a 190
Kojto 90:cb3d968589d8 191 /** @addtogroup Exported_types
emilmont 77:869cf507173a 192 * @{
emilmont 77:869cf507173a 193 */
Kojto 90:cb3d968589d8 194 typedef enum
Kojto 90:cb3d968589d8 195 {
Kojto 90:cb3d968589d8 196 RESET = 0,
Kojto 90:cb3d968589d8 197 SET = !RESET
Kojto 90:cb3d968589d8 198 } FlagStatus, ITStatus;
emilmont 77:869cf507173a 199
Kojto 90:cb3d968589d8 200 typedef enum
Kojto 90:cb3d968589d8 201 {
Kojto 90:cb3d968589d8 202 DISABLE = 0,
Kojto 90:cb3d968589d8 203 ENABLE = !DISABLE
Kojto 90:cb3d968589d8 204 } FunctionalState;
Kojto 90:cb3d968589d8 205 #define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
emilmont 77:869cf507173a 206
Kojto 90:cb3d968589d8 207 typedef enum
Kojto 90:cb3d968589d8 208 {
Kojto 90:cb3d968589d8 209 ERROR = 0,
Kojto 90:cb3d968589d8 210 SUCCESS = !ERROR
Kojto 90:cb3d968589d8 211 } ErrorStatus;
emilmont 77:869cf507173a 212
emilmont 77:869cf507173a 213 /**
emilmont 77:869cf507173a 214 * @}
emilmont 77:869cf507173a 215 */
emilmont 77:869cf507173a 216
emilmont 77:869cf507173a 217
Kojto 90:cb3d968589d8 218 /** @addtogroup Exported_macros
emilmont 77:869cf507173a 219 * @{
emilmont 77:869cf507173a 220 */
emilmont 77:869cf507173a 221 #define SET_BIT(REG, BIT) ((REG) |= (BIT))
emilmont 77:869cf507173a 222
emilmont 77:869cf507173a 223 #define CLEAR_BIT(REG, BIT) ((REG) &= ~(BIT))
emilmont 77:869cf507173a 224
emilmont 77:869cf507173a 225 #define READ_BIT(REG, BIT) ((REG) & (BIT))
emilmont 77:869cf507173a 226
emilmont 77:869cf507173a 227 #define CLEAR_REG(REG) ((REG) = (0x0))
emilmont 77:869cf507173a 228
emilmont 77:869cf507173a 229 #define WRITE_REG(REG, VAL) ((REG) = (VAL))
emilmont 77:869cf507173a 230
emilmont 77:869cf507173a 231 #define READ_REG(REG) ((REG))
emilmont 77:869cf507173a 232
emilmont 77:869cf507173a 233 #define MODIFY_REG(REG, CLEARMASK, SETMASK) WRITE_REG((REG), (((READ_REG(REG)) & (~(CLEARMASK))) | (SETMASK)))
emilmont 77:869cf507173a 234
Kojto 90:cb3d968589d8 235 #define POSITION_VAL(VAL) (__CLZ(__RBIT(VAL)))
emilmont 77:869cf507173a 236
emilmont 77:869cf507173a 237
emilmont 77:869cf507173a 238 /**
emilmont 77:869cf507173a 239 * @}
emilmont 77:869cf507173a 240 */
emilmont 77:869cf507173a 241
Kojto 90:cb3d968589d8 242 #if defined (USE_HAL_DRIVER)
Kojto 90:cb3d968589d8 243 #include "stm32l1xx_hal.h"
Kojto 90:cb3d968589d8 244 #endif /* USE_HAL_DRIVER */
Kojto 90:cb3d968589d8 245
Kojto 90:cb3d968589d8 246
Kojto 90:cb3d968589d8 247 #ifdef __cplusplus
Kojto 90:cb3d968589d8 248 }
Kojto 90:cb3d968589d8 249 #endif /* __cplusplus */
Kojto 90:cb3d968589d8 250
Kojto 90:cb3d968589d8 251 #endif /* __STM32L1xx_H */
Kojto 90:cb3d968589d8 252 /**
emilmont 77:869cf507173a 253 * @}
emilmont 77:869cf507173a 254 */
emilmont 77:869cf507173a 255
Kojto 90:cb3d968589d8 256 /**
Kojto 90:cb3d968589d8 257 * @}
Kojto 90:cb3d968589d8 258 */
Kojto 90:cb3d968589d8 259
Kojto 90:cb3d968589d8 260
Kojto 90:cb3d968589d8 261
Kojto 90:cb3d968589d8 262
emilmont 77:869cf507173a 263 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/