mbed official / mbed-src

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.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_def.h@387:643a59b3dbac, 2014-11-05 (annotated)

Committer:
mbed_official
Date:
Wed Nov 05 14:30:08 2014 +0000
Revision:
387:643a59b3dbac
Parent:
382:ee426a420dbb
Child:
489:119543c9f674
Synchronized with git revision cfeccf154f8f92c3ea9c0c881c577c154537aecc



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



Exporters: STM32L053R8 - IAR exporter

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 376:cb4d9db17537 1 /**
mbed_official 376:cb4d9db17537 2 ******************************************************************************
mbed_official 376:cb4d9db17537 3 * @file stm32l0xx_hal_def.h
mbed_official 376:cb4d9db17537 4 * @author MCD Application Team
mbed_official 376:cb4d9db17537 5 * @version V1.1.0
mbed_official 376:cb4d9db17537 6 * @date 18-June-2014
mbed_official 376:cb4d9db17537 7 * @brief This file contains HAL common defines, enumeration, macros and
mbed_official 376:cb4d9db17537 8 * structures definitions.
mbed_official 376:cb4d9db17537 9 ******************************************************************************
mbed_official 376:cb4d9db17537 10 * @attention
mbed_official 376:cb4d9db17537 11 *
mbed_official 376:cb4d9db17537 12 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 376:cb4d9db17537 13 *
mbed_official 376:cb4d9db17537 14 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 376:cb4d9db17537 15 * are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 16 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 17 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 19 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 20 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 22 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 23 * without specific prior written permission.
mbed_official 376:cb4d9db17537 24 *
mbed_official 376:cb4d9db17537 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 35 *
mbed_official 376:cb4d9db17537 36 ******************************************************************************
mbed_official 376:cb4d9db17537 37 */
mbed_official 376:cb4d9db17537 38
mbed_official 376:cb4d9db17537 39 /* Define to prevent recursive inclusion -------------------------------------*/
mbed_official 376:cb4d9db17537 40 #ifndef __STM32L0xx_HAL_DEF
mbed_official 376:cb4d9db17537 41 #define __STM32L0xx_HAL_DEF
mbed_official 376:cb4d9db17537 42
mbed_official 376:cb4d9db17537 43 #ifdef __cplusplus
mbed_official 376:cb4d9db17537 44 extern "C" {
mbed_official 376:cb4d9db17537 45 #endif
mbed_official 376:cb4d9db17537 46
mbed_official 376:cb4d9db17537 47 /* Includes ------------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 48 #include "stm32l0xx.h"
mbed_official 376:cb4d9db17537 49
mbed_official 376:cb4d9db17537 50 /* Exported types ------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 51
mbed_official 376:cb4d9db17537 52 /**
mbed_official 376:cb4d9db17537 53 * @brief HAL Status structures definition
mbed_official 376:cb4d9db17537 54 */
mbed_official 376:cb4d9db17537 55 typedef enum
mbed_official 376:cb4d9db17537 56 {
mbed_official 376:cb4d9db17537 57 HAL_OK = 0x00,
mbed_official 376:cb4d9db17537 58 HAL_ERROR = 0x01,
mbed_official 376:cb4d9db17537 59 HAL_BUSY = 0x02,
mbed_official 376:cb4d9db17537 60 HAL_TIMEOUT = 0x03
mbed_official 376:cb4d9db17537 61 } HAL_StatusTypeDef;
mbed_official 376:cb4d9db17537 62
mbed_official 376:cb4d9db17537 63 /**
mbed_official 376:cb4d9db17537 64 * @brief HAL Lock structures definition
mbed_official 376:cb4d9db17537 65 */
mbed_official 376:cb4d9db17537 66 typedef enum
mbed_official 376:cb4d9db17537 67 {
mbed_official 376:cb4d9db17537 68 HAL_UNLOCKED = 0x00,
mbed_official 376:cb4d9db17537 69 HAL_LOCKED = 0x01
mbed_official 376:cb4d9db17537 70 } HAL_LockTypeDef;
mbed_official 376:cb4d9db17537 71
mbed_official 376:cb4d9db17537 72 /* Exported macro ------------------------------------------------------------*/
mbed_official 387:643a59b3dbac 73 #ifndef HAL_NULL
mbed_official 387:643a59b3dbac 74 #define HAL_NULL (void *) 0
mbed_official 376:cb4d9db17537 75 #endif
mbed_official 376:cb4d9db17537 76
mbed_official 376:cb4d9db17537 77 #define HAL_MAX_DELAY 0xFFFFFFFF
mbed_official 376:cb4d9db17537 78
mbed_official 376:cb4d9db17537 79 #define HAL_IS_BIT_SET(REG, BIT) (((REG) & (BIT)) != RESET)
mbed_official 376:cb4d9db17537 80 #define HAL_IS_BIT_CLR(REG, BIT) (((REG) & (BIT)) == RESET)
mbed_official 376:cb4d9db17537 81
mbed_official 376:cb4d9db17537 82 #define __HAL_LINKDMA(__HANDLE__, __PPP_DMA_FIELD__, __DMA_HANDLE__) \
mbed_official 376:cb4d9db17537 83 do{ \
mbed_official 376:cb4d9db17537 84 (__HANDLE__)->__PPP_DMA_FIELD__ = &(__DMA_HANDLE__); \
mbed_official 376:cb4d9db17537 85 (__DMA_HANDLE__).Parent = (__HANDLE__); \
mbed_official 376:cb4d9db17537 86 } while(0)
mbed_official 376:cb4d9db17537 87
mbed_official 376:cb4d9db17537 88 /** @brief Reset the Handle's State field.
mbed_official 376:cb4d9db17537 89 * @param __HANDLE__: specifies the Peripheral Handle.
mbed_official 376:cb4d9db17537 90 * @note This macro can be used for the following purpose:
mbed_official 376:cb4d9db17537 91 * - When the Handle is declared as local variable; before passing it as parameter
mbed_official 376:cb4d9db17537 92 * to HAL_PPP_Init() for the first time, it is mandatory to use this macro
mbed_official 376:cb4d9db17537 93 * to set to 0 the Handle's "State" field.
mbed_official 376:cb4d9db17537 94 * Otherwise, "State" field may have any random value and the first time the function
mbed_official 376:cb4d9db17537 95 * HAL_PPP_Init() is called, the low level hardware initialization will be missed
mbed_official 376:cb4d9db17537 96 * (i.e. HAL_PPP_MspInit() will not be executed).
mbed_official 376:cb4d9db17537 97 * - When there is a need to reconfigure the low level hardware: instead of calling
mbed_official 376:cb4d9db17537 98 * HAL_PPP_DeInit() then HAL_PPP_Init(), user can make a call to this macro then HAL_PPP_Init().
mbed_official 376:cb4d9db17537 99 * In this later function, when the Handle's "State" field is set to 0, it will execute the function
mbed_official 376:cb4d9db17537 100 * HAL_PPP_MspInit() which will reconfigure the low level hardware.
mbed_official 376:cb4d9db17537 101 * @retval None
mbed_official 376:cb4d9db17537 102 */
mbed_official 376:cb4d9db17537 103 #define __HAL_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = 0)
mbed_official 376:cb4d9db17537 104
mbed_official 376:cb4d9db17537 105 #if (USE_RTOS == 1)
mbed_official 376:cb4d9db17537 106
mbed_official 376:cb4d9db17537 107 /* Reserved for future use */
mbed_official 376:cb4d9db17537 108 #error “USE_RTOS should be 0 in the current HAL release”
mbed_official 376:cb4d9db17537 109
mbed_official 376:cb4d9db17537 110 #else
mbed_official 376:cb4d9db17537 111 #define __HAL_LOCK(__HANDLE__) \
mbed_official 376:cb4d9db17537 112 do{ \
mbed_official 376:cb4d9db17537 113 if((__HANDLE__)->Lock == HAL_LOCKED) \
mbed_official 376:cb4d9db17537 114 { \
mbed_official 376:cb4d9db17537 115 return HAL_BUSY; \
mbed_official 376:cb4d9db17537 116 } \
mbed_official 376:cb4d9db17537 117 else \
mbed_official 376:cb4d9db17537 118 { \
mbed_official 376:cb4d9db17537 119 (__HANDLE__)->Lock = HAL_LOCKED; \
mbed_official 376:cb4d9db17537 120 } \
mbed_official 376:cb4d9db17537 121 }while (0)
mbed_official 376:cb4d9db17537 122
mbed_official 376:cb4d9db17537 123 #define __HAL_UNLOCK(__HANDLE__) \
mbed_official 376:cb4d9db17537 124 do{ \
mbed_official 376:cb4d9db17537 125 (__HANDLE__)->Lock = HAL_UNLOCKED; \
mbed_official 376:cb4d9db17537 126 }while (0)
mbed_official 376:cb4d9db17537 127 #endif /* USE_RTOS */
mbed_official 376:cb4d9db17537 128
mbed_official 376:cb4d9db17537 129 #if defined ( __GNUC__ )
mbed_official 376:cb4d9db17537 130 #ifndef __weak
mbed_official 376:cb4d9db17537 131 #define __weak __attribute__((weak))
mbed_official 376:cb4d9db17537 132 #endif /* __weak */
mbed_official 376:cb4d9db17537 133 #ifndef __packed
mbed_official 376:cb4d9db17537 134 #define __packed __attribute__((__packed__))
mbed_official 376:cb4d9db17537 135 #endif /* __packed */
mbed_official 376:cb4d9db17537 136 #endif /* __GNUC__ */
mbed_official 376:cb4d9db17537 137
mbed_official 376:cb4d9db17537 138
mbed_official 376:cb4d9db17537 139 /* Macro to get variable aligned on 4-bytes, for __ICCARM__ the directive "#pragma data_alignment=4" must be used instead */
mbed_official 376:cb4d9db17537 140 #if defined (__GNUC__) /* GNU Compiler */
mbed_official 376:cb4d9db17537 141 #ifndef __ALIGN_END
mbed_official 376:cb4d9db17537 142 #define __ALIGN_END __attribute__ ((aligned (4)))
mbed_official 376:cb4d9db17537 143 #endif /* __ALIGN_END */
mbed_official 376:cb4d9db17537 144 #ifndef __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 145 #define __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 146 #endif /* __ALIGN_BEGIN */
mbed_official 376:cb4d9db17537 147 #else
mbed_official 376:cb4d9db17537 148 #ifndef __ALIGN_END
mbed_official 376:cb4d9db17537 149 #define __ALIGN_END
mbed_official 376:cb4d9db17537 150 #endif /* __ALIGN_END */
mbed_official 376:cb4d9db17537 151 #ifndef __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 152 #if defined (__CC_ARM) /* ARM Compiler */
mbed_official 376:cb4d9db17537 153 #define __ALIGN_BEGIN __align(4)
mbed_official 376:cb4d9db17537 154 #elif defined (__ICCARM__) /* IAR Compiler */
mbed_official 376:cb4d9db17537 155 #define __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 156 #endif /* __CC_ARM */
mbed_official 376:cb4d9db17537 157 #endif /* __ALIGN_BEGIN */
mbed_official 376:cb4d9db17537 158 #endif /* __GNUC__ */
mbed_official 376:cb4d9db17537 159
mbed_official 376:cb4d9db17537 160 /**
mbed_official 376:cb4d9db17537 161 * @brief __RAM_FUNC definition
mbed_official 376:cb4d9db17537 162 */
mbed_official 376:cb4d9db17537 163 #if defined ( __CC_ARM )
mbed_official 376:cb4d9db17537 164 /* ARM Compiler
mbed_official 376:cb4d9db17537 165 ------------
mbed_official 376:cb4d9db17537 166 RAM functions are defined using the toolchain options.
mbed_official 376:cb4d9db17537 167 Functions that are executed in RAM should reside in a separate source module.
mbed_official 376:cb4d9db17537 168 Using the 'Options for File' dialog you can simply change the 'Code / Const'
mbed_official 376:cb4d9db17537 169 area of a module to a memory space in physical RAM.
mbed_official 376:cb4d9db17537 170 Available memory areas are declared in the 'Target' tab of the 'Options for Target'
mbed_official 376:cb4d9db17537 171 dialog.
mbed_official 376:cb4d9db17537 172 */
mbed_official 376:cb4d9db17537 173 #define __RAM_FUNC HAL_StatusTypeDef
mbed_official 376:cb4d9db17537 174
mbed_official 376:cb4d9db17537 175 #elif defined ( __ICCARM__ )
mbed_official 376:cb4d9db17537 176 /* ICCARM Compiler
mbed_official 376:cb4d9db17537 177 ---------------
mbed_official 376:cb4d9db17537 178 RAM functions are defined using a specific toolchain keyword "__ramfunc".
mbed_official 376:cb4d9db17537 179 */
mbed_official 376:cb4d9db17537 180 #define __RAM_FUNC __ramfunc HAL_StatusTypeDef
mbed_official 376:cb4d9db17537 181
mbed_official 376:cb4d9db17537 182 #elif defined ( __GNUC__ )
mbed_official 376:cb4d9db17537 183 /* GNU Compiler
mbed_official 376:cb4d9db17537 184 ------------
mbed_official 376:cb4d9db17537 185 RAM functions are defined using a specific toolchain attribute
mbed_official 376:cb4d9db17537 186 "__attribute__((section(".RamFunc")))".
mbed_official 376:cb4d9db17537 187 */
mbed_official 376:cb4d9db17537 188 #define __RAM_FUNC HAL_StatusTypeDef __attribute__((section(".RamFunc")))
mbed_official 376:cb4d9db17537 189
mbed_official 376:cb4d9db17537 190 #endif
mbed_official 376:cb4d9db17537 191
mbed_official 376:cb4d9db17537 192 #ifdef __cplusplus
mbed_official 376:cb4d9db17537 193 }
mbed_official 376:cb4d9db17537 194 #endif
mbed_official 376:cb4d9db17537 195
mbed_official 376:cb4d9db17537 196 #endif /* ___STM32L0xx_HAL_DEF */
mbed_official 376:cb4d9db17537 197
mbed_official 376:cb4d9db17537 198 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/