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@579:53297373a894, 2015-07-01 (annotated)

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
489:119543c9f674 
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081



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



Initial version of drivers for SAMR21

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 489:119543c9f674 5 * @version V1.2.0
mbed_official 489:119543c9f674 6 * @date 06-February-2015
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 489:119543c9f674 12 * <h2><center>&copy; COPYRIGHT(c) 2015 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 489:119543c9f674 49 #include "stm32_hal_legacy.h"
mbed_official 489:119543c9f674 50 #include <stdio.h>
mbed_official 376:cb4d9db17537 51
mbed_official 376:cb4d9db17537 52 /* Exported types ------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 53
mbed_official 376:cb4d9db17537 54 /**
mbed_official 376:cb4d9db17537 55 * @brief HAL Status structures definition
mbed_official 376:cb4d9db17537 56 */
mbed_official 376:cb4d9db17537 57 typedef enum
mbed_official 376:cb4d9db17537 58 {
mbed_official 376:cb4d9db17537 59 HAL_OK = 0x00,
mbed_official 376:cb4d9db17537 60 HAL_ERROR = 0x01,
mbed_official 376:cb4d9db17537 61 HAL_BUSY = 0x02,
mbed_official 376:cb4d9db17537 62 HAL_TIMEOUT = 0x03
mbed_official 376:cb4d9db17537 63 } HAL_StatusTypeDef;
mbed_official 376:cb4d9db17537 64
mbed_official 376:cb4d9db17537 65 /**
mbed_official 376:cb4d9db17537 66 * @brief HAL Lock structures definition
mbed_official 376:cb4d9db17537 67 */
mbed_official 376:cb4d9db17537 68 typedef enum
mbed_official 376:cb4d9db17537 69 {
mbed_official 376:cb4d9db17537 70 HAL_UNLOCKED = 0x00,
mbed_official 376:cb4d9db17537 71 HAL_LOCKED = 0x01
mbed_official 376:cb4d9db17537 72 } HAL_LockTypeDef;
mbed_official 376:cb4d9db17537 73
mbed_official 376:cb4d9db17537 74 /* Exported macro ------------------------------------------------------------*/
mbed_official 489:119543c9f674 75
mbed_official 489:119543c9f674 76 #define UNUSED(x) ((void)(x))
mbed_official 376:cb4d9db17537 77
mbed_official 376:cb4d9db17537 78 #define HAL_MAX_DELAY 0xFFFFFFFF
mbed_official 376:cb4d9db17537 79
mbed_official 376:cb4d9db17537 80 #define HAL_IS_BIT_SET(REG, BIT) (((REG) & (BIT)) != RESET)
mbed_official 376:cb4d9db17537 81 #define HAL_IS_BIT_CLR(REG, BIT) (((REG) & (BIT)) == RESET)
mbed_official 376:cb4d9db17537 82
mbed_official 376:cb4d9db17537 83 #define __HAL_LINKDMA(__HANDLE__, __PPP_DMA_FIELD__, __DMA_HANDLE__) \
mbed_official 376:cb4d9db17537 84 do{ \
mbed_official 376:cb4d9db17537 85 (__HANDLE__)->__PPP_DMA_FIELD__ = &(__DMA_HANDLE__); \
mbed_official 376:cb4d9db17537 86 (__DMA_HANDLE__).Parent = (__HANDLE__); \
mbed_official 376:cb4d9db17537 87 } while(0)
mbed_official 376:cb4d9db17537 88
mbed_official 376:cb4d9db17537 89 /** @brief Reset the Handle's State field.
mbed_official 376:cb4d9db17537 90 * @param __HANDLE__: specifies the Peripheral Handle.
mbed_official 376:cb4d9db17537 91 * @note This macro can be used for the following purpose:
mbed_official 376:cb4d9db17537 92 * - When the Handle is declared as local variable; before passing it as parameter
mbed_official 376:cb4d9db17537 93 * to HAL_PPP_Init() for the first time, it is mandatory to use this macro
mbed_official 376:cb4d9db17537 94 * to set to 0 the Handle's "State" field.
mbed_official 376:cb4d9db17537 95 * Otherwise, "State" field may have any random value and the first time the function
mbed_official 376:cb4d9db17537 96 * HAL_PPP_Init() is called, the low level hardware initialization will be missed
mbed_official 376:cb4d9db17537 97 * (i.e. HAL_PPP_MspInit() will not be executed).
mbed_official 376:cb4d9db17537 98 * - When there is a need to reconfigure the low level hardware: instead of calling
mbed_official 376:cb4d9db17537 99 * HAL_PPP_DeInit() then HAL_PPP_Init(), user can make a call to this macro then HAL_PPP_Init().
mbed_official 376:cb4d9db17537 100 * In this later function, when the Handle's "State" field is set to 0, it will execute the function
mbed_official 376:cb4d9db17537 101 * HAL_PPP_MspInit() which will reconfigure the low level hardware.
mbed_official 376:cb4d9db17537 102 * @retval None
mbed_official 376:cb4d9db17537 103 */
mbed_official 376:cb4d9db17537 104 #define __HAL_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = 0)
mbed_official 376:cb4d9db17537 105
mbed_official 376:cb4d9db17537 106 #if (USE_RTOS == 1)
mbed_official 376:cb4d9db17537 107
mbed_official 376:cb4d9db17537 108 /* Reserved for future use */
mbed_official 376:cb4d9db17537 109 #error “USE_RTOS should be 0 in the current HAL release”
mbed_official 376:cb4d9db17537 110
mbed_official 376:cb4d9db17537 111 #else
mbed_official 376:cb4d9db17537 112 #define __HAL_LOCK(__HANDLE__) \
mbed_official 376:cb4d9db17537 113 do{ \
mbed_official 376:cb4d9db17537 114 if((__HANDLE__)->Lock == HAL_LOCKED) \
mbed_official 376:cb4d9db17537 115 { \
mbed_official 376:cb4d9db17537 116 return HAL_BUSY; \
mbed_official 376:cb4d9db17537 117 } \
mbed_official 376:cb4d9db17537 118 else \
mbed_official 376:cb4d9db17537 119 { \
mbed_official 376:cb4d9db17537 120 (__HANDLE__)->Lock = HAL_LOCKED; \
mbed_official 376:cb4d9db17537 121 } \
mbed_official 376:cb4d9db17537 122 }while (0)
mbed_official 376:cb4d9db17537 123
mbed_official 376:cb4d9db17537 124 #define __HAL_UNLOCK(__HANDLE__) \
mbed_official 376:cb4d9db17537 125 do{ \
mbed_official 376:cb4d9db17537 126 (__HANDLE__)->Lock = HAL_UNLOCKED; \
mbed_official 376:cb4d9db17537 127 }while (0)
mbed_official 376:cb4d9db17537 128 #endif /* USE_RTOS */
mbed_official 376:cb4d9db17537 129
mbed_official 376:cb4d9db17537 130 #if defined ( __GNUC__ )
mbed_official 376:cb4d9db17537 131 #ifndef __weak
mbed_official 376:cb4d9db17537 132 #define __weak __attribute__((weak))
mbed_official 376:cb4d9db17537 133 #endif /* __weak */
mbed_official 376:cb4d9db17537 134 #ifndef __packed
mbed_official 376:cb4d9db17537 135 #define __packed __attribute__((__packed__))
mbed_official 376:cb4d9db17537 136 #endif /* __packed */
mbed_official 489:119543c9f674 137
mbed_official 489:119543c9f674 138 #define __NOINLINE __attribute__ ( (noinline) )
mbed_official 489:119543c9f674 139
mbed_official 376:cb4d9db17537 140 #endif /* __GNUC__ */
mbed_official 376:cb4d9db17537 141
mbed_official 376:cb4d9db17537 142
mbed_official 376:cb4d9db17537 143 /* Macro to get variable aligned on 4-bytes, for __ICCARM__ the directive "#pragma data_alignment=4" must be used instead */
mbed_official 376:cb4d9db17537 144 #if defined (__GNUC__) /* GNU Compiler */
mbed_official 376:cb4d9db17537 145 #ifndef __ALIGN_END
mbed_official 376:cb4d9db17537 146 #define __ALIGN_END __attribute__ ((aligned (4)))
mbed_official 376:cb4d9db17537 147 #endif /* __ALIGN_END */
mbed_official 376:cb4d9db17537 148 #ifndef __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 149 #define __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 150 #endif /* __ALIGN_BEGIN */
mbed_official 376:cb4d9db17537 151 #else
mbed_official 376:cb4d9db17537 152 #ifndef __ALIGN_END
mbed_official 376:cb4d9db17537 153 #define __ALIGN_END
mbed_official 376:cb4d9db17537 154 #endif /* __ALIGN_END */
mbed_official 376:cb4d9db17537 155 #ifndef __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 156 #if defined (__CC_ARM) /* ARM Compiler */
mbed_official 376:cb4d9db17537 157 #define __ALIGN_BEGIN __align(4)
mbed_official 376:cb4d9db17537 158 #elif defined (__ICCARM__) /* IAR Compiler */
mbed_official 376:cb4d9db17537 159 #define __ALIGN_BEGIN
mbed_official 376:cb4d9db17537 160 #endif /* __CC_ARM */
mbed_official 376:cb4d9db17537 161 #endif /* __ALIGN_BEGIN */
mbed_official 376:cb4d9db17537 162 #endif /* __GNUC__ */
mbed_official 376:cb4d9db17537 163
mbed_official 376:cb4d9db17537 164 /**
mbed_official 376:cb4d9db17537 165 * @brief __RAM_FUNC definition
mbed_official 376:cb4d9db17537 166 */
mbed_official 376:cb4d9db17537 167 #if defined ( __CC_ARM )
mbed_official 376:cb4d9db17537 168 /* ARM Compiler
mbed_official 376:cb4d9db17537 169 ------------
mbed_official 376:cb4d9db17537 170 RAM functions are defined using the toolchain options.
mbed_official 376:cb4d9db17537 171 Functions that are executed in RAM should reside in a separate source module.
mbed_official 376:cb4d9db17537 172 Using the 'Options for File' dialog you can simply change the 'Code / Const'
mbed_official 376:cb4d9db17537 173 area of a module to a memory space in physical RAM.
mbed_official 376:cb4d9db17537 174 Available memory areas are declared in the 'Target' tab of the 'Options for Target'
mbed_official 376:cb4d9db17537 175 dialog.
mbed_official 376:cb4d9db17537 176 */
mbed_official 376:cb4d9db17537 177 #define __RAM_FUNC HAL_StatusTypeDef
mbed_official 376:cb4d9db17537 178
mbed_official 489:119543c9f674 179 #define __NOINLINE __attribute__ ( (noinline) )
mbed_official 489:119543c9f674 180
mbed_official 489:119543c9f674 181
mbed_official 376:cb4d9db17537 182 #elif defined ( __ICCARM__ )
mbed_official 376:cb4d9db17537 183 /* ICCARM Compiler
mbed_official 376:cb4d9db17537 184 ---------------
mbed_official 376:cb4d9db17537 185 RAM functions are defined using a specific toolchain keyword "__ramfunc".
mbed_official 376:cb4d9db17537 186 */
mbed_official 376:cb4d9db17537 187 #define __RAM_FUNC __ramfunc HAL_StatusTypeDef
mbed_official 376:cb4d9db17537 188
mbed_official 489:119543c9f674 189 #define __NOINLINE _Pragma("optimize = no_inline")
mbed_official 489:119543c9f674 190
mbed_official 376:cb4d9db17537 191 #elif defined ( __GNUC__ )
mbed_official 376:cb4d9db17537 192 /* GNU Compiler
mbed_official 376:cb4d9db17537 193 ------------
mbed_official 376:cb4d9db17537 194 RAM functions are defined using a specific toolchain attribute
mbed_official 376:cb4d9db17537 195 "__attribute__((section(".RamFunc")))".
mbed_official 376:cb4d9db17537 196 */
mbed_official 376:cb4d9db17537 197 #define __RAM_FUNC HAL_StatusTypeDef __attribute__((section(".RamFunc")))
mbed_official 376:cb4d9db17537 198
mbed_official 376:cb4d9db17537 199 #endif
mbed_official 376:cb4d9db17537 200
mbed_official 376:cb4d9db17537 201 #ifdef __cplusplus
mbed_official 376:cb4d9db17537 202 }
mbed_official 376:cb4d9db17537 203 #endif
mbed_official 376:cb4d9db17537 204
mbed_official 376:cb4d9db17537 205 #endif /* ___STM32L0xx_HAL_DEF */
mbed_official 376:cb4d9db17537 206
mbed_official 376:cb4d9db17537 207 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
mbed_official 489:119543c9f674 208