SilentSensors / mbed-dev

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.

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32L1/device/stm32l1xx_ll_gpio.c@188:60408c49b6d4, 2018-09-20 (annotated)

Committer:
WaleedElmughrabi
Date:
Thu Sep 20 16:11:23 2018 +0000
Revision:
188:60408c49b6d4
Parent:
184:08ed48f1de7f 
Fork modified for BG96 error

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 149:156823d33999 1 /**
<> 149:156823d33999 2 ******************************************************************************
<> 149:156823d33999 3 * @file stm32l1xx_ll_gpio.c
<> 149:156823d33999 4 * @author MCD Application Team
<> 149:156823d33999 5 * @brief GPIO LL module driver.
<> 149:156823d33999 6 ******************************************************************************
<> 149:156823d33999 7 * @attention
<> 149:156823d33999 8 *
AnnaBridge 184:08ed48f1de7f 9 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
<> 149:156823d33999 10 *
<> 149:156823d33999 11 * Redistribution and use in source and binary forms, with or without modification,
<> 149:156823d33999 12 * are permitted provided that the following conditions are met:
<> 149:156823d33999 13 * 1. Redistributions of source code must retain the above copyright notice,
<> 149:156823d33999 14 * this list of conditions and the following disclaimer.
<> 149:156823d33999 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 149:156823d33999 16 * this list of conditions and the following disclaimer in the documentation
<> 149:156823d33999 17 * and/or other materials provided with the distribution.
<> 149:156823d33999 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 149:156823d33999 19 * may be used to endorse or promote products derived from this software
<> 149:156823d33999 20 * without specific prior written permission.
<> 149:156823d33999 21 *
<> 149:156823d33999 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 149:156823d33999 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 149:156823d33999 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 149:156823d33999 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 149:156823d33999 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 149:156823d33999 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 149:156823d33999 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 149:156823d33999 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 149:156823d33999 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 149:156823d33999 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 149:156823d33999 32 *
<> 149:156823d33999 33 ******************************************************************************
<> 149:156823d33999 34 */
<> 149:156823d33999 35 #if defined(USE_FULL_LL_DRIVER)
<> 149:156823d33999 36
<> 149:156823d33999 37 /* Includes ------------------------------------------------------------------*/
<> 149:156823d33999 38 #include "stm32l1xx_ll_gpio.h"
<> 149:156823d33999 39 #include "stm32l1xx_ll_bus.h"
<> 149:156823d33999 40 #ifdef USE_FULL_ASSERT
<> 149:156823d33999 41 #include "stm32_assert.h"
<> 149:156823d33999 42 #else
<> 149:156823d33999 43 #define assert_param(expr) ((void)0U)
<> 149:156823d33999 44 #endif
<> 149:156823d33999 45
<> 149:156823d33999 46 /** @addtogroup STM32L1xx_LL_Driver
<> 149:156823d33999 47 * @{
<> 149:156823d33999 48 */
<> 149:156823d33999 49
<> 149:156823d33999 50 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH)
<> 149:156823d33999 51
<> 149:156823d33999 52 /** @addtogroup GPIO_LL
<> 149:156823d33999 53 * @{
<> 149:156823d33999 54 */
<> 149:156823d33999 55
<> 149:156823d33999 56 /* Private types -------------------------------------------------------------*/
<> 149:156823d33999 57 /* Private variables ---------------------------------------------------------*/
<> 149:156823d33999 58 /* Private constants ---------------------------------------------------------*/
<> 149:156823d33999 59 /* Private macros ------------------------------------------------------------*/
<> 149:156823d33999 60 /** @addtogroup GPIO_LL_Private_Macros
<> 149:156823d33999 61 * @{
<> 149:156823d33999 62 */
AnnaBridge 184:08ed48f1de7f 63 #define IS_LL_GPIO_PIN(__VALUE__) (((0x00000000U) < (__VALUE__)) && ((__VALUE__) <= (LL_GPIO_PIN_ALL)))
<> 149:156823d33999 64
<> 149:156823d33999 65 #define IS_LL_GPIO_MODE(__VALUE__) (((__VALUE__) == LL_GPIO_MODE_INPUT) ||\
<> 149:156823d33999 66 ((__VALUE__) == LL_GPIO_MODE_OUTPUT) ||\
<> 149:156823d33999 67 ((__VALUE__) == LL_GPIO_MODE_ALTERNATE) ||\
<> 149:156823d33999 68 ((__VALUE__) == LL_GPIO_MODE_ANALOG))
<> 149:156823d33999 69
<> 149:156823d33999 70 #define IS_LL_GPIO_OUTPUT_TYPE(__VALUE__) (((__VALUE__) == LL_GPIO_OUTPUT_PUSHPULL) ||\
<> 149:156823d33999 71 ((__VALUE__) == LL_GPIO_OUTPUT_OPENDRAIN))
<> 149:156823d33999 72
<> 149:156823d33999 73 #define IS_LL_GPIO_SPEED(__VALUE__) (((__VALUE__) == LL_GPIO_SPEED_FREQ_LOW) ||\
<> 149:156823d33999 74 ((__VALUE__) == LL_GPIO_SPEED_FREQ_MEDIUM) ||\
<> 149:156823d33999 75 ((__VALUE__) == LL_GPIO_SPEED_FREQ_HIGH) ||\
<> 149:156823d33999 76 ((__VALUE__) == LL_GPIO_SPEED_FREQ_VERY_HIGH))
<> 149:156823d33999 77
<> 149:156823d33999 78 #define IS_LL_GPIO_PULL(__VALUE__) (((__VALUE__) == LL_GPIO_PULL_NO) ||\
<> 149:156823d33999 79 ((__VALUE__) == LL_GPIO_PULL_UP) ||\
<> 149:156823d33999 80 ((__VALUE__) == LL_GPIO_PULL_DOWN))
<> 149:156823d33999 81
<> 149:156823d33999 82 #define IS_LL_GPIO_ALTERNATE(__VALUE__) (((__VALUE__) == LL_GPIO_AF_0 ) ||\
<> 149:156823d33999 83 ((__VALUE__) == LL_GPIO_AF_1 ) ||\
<> 149:156823d33999 84 ((__VALUE__) == LL_GPIO_AF_2 ) ||\
<> 149:156823d33999 85 ((__VALUE__) == LL_GPIO_AF_3 ) ||\
<> 149:156823d33999 86 ((__VALUE__) == LL_GPIO_AF_4 ) ||\
<> 149:156823d33999 87 ((__VALUE__) == LL_GPIO_AF_5 ) ||\
<> 149:156823d33999 88 ((__VALUE__) == LL_GPIO_AF_6 ) ||\
<> 149:156823d33999 89 ((__VALUE__) == LL_GPIO_AF_7 ) ||\
<> 149:156823d33999 90 ((__VALUE__) == LL_GPIO_AF_8 ) ||\
<> 149:156823d33999 91 ((__VALUE__) == LL_GPIO_AF_9 ) ||\
<> 149:156823d33999 92 ((__VALUE__) == LL_GPIO_AF_10 ) ||\
<> 149:156823d33999 93 ((__VALUE__) == LL_GPIO_AF_11 ) ||\
<> 149:156823d33999 94 ((__VALUE__) == LL_GPIO_AF_12 ) ||\
<> 149:156823d33999 95 ((__VALUE__) == LL_GPIO_AF_13 ) ||\
<> 149:156823d33999 96 ((__VALUE__) == LL_GPIO_AF_14 ) ||\
<> 149:156823d33999 97 ((__VALUE__) == LL_GPIO_AF_15 ))
<> 149:156823d33999 98 /**
<> 149:156823d33999 99 * @}
<> 149:156823d33999 100 */
<> 149:156823d33999 101
<> 149:156823d33999 102 /* Private function prototypes -----------------------------------------------*/
<> 149:156823d33999 103
<> 149:156823d33999 104 /* Exported functions --------------------------------------------------------*/
<> 149:156823d33999 105 /** @addtogroup GPIO_LL_Exported_Functions
<> 149:156823d33999 106 * @{
<> 149:156823d33999 107 */
<> 149:156823d33999 108
<> 149:156823d33999 109 /** @addtogroup GPIO_LL_EF_Init
<> 149:156823d33999 110 * @{
<> 149:156823d33999 111 */
<> 149:156823d33999 112
<> 149:156823d33999 113 /**
<> 149:156823d33999 114 * @brief De-initialize GPIO registers (Registers restored to their default values).
<> 149:156823d33999 115 * @param GPIOx GPIO Port
<> 149:156823d33999 116 * @retval An ErrorStatus enumeration value:
<> 149:156823d33999 117 * - SUCCESS: GPIO registers are de-initialized
<> 149:156823d33999 118 * - ERROR: Wrong GPIO Port
<> 149:156823d33999 119 */
<> 149:156823d33999 120 ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx)
<> 149:156823d33999 121 {
<> 149:156823d33999 122 ErrorStatus status = SUCCESS;
<> 149:156823d33999 123
<> 149:156823d33999 124 /* Check the parameters */
<> 149:156823d33999 125 assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
<> 149:156823d33999 126
<> 149:156823d33999 127 /* Force and Release reset on clock of GPIOx Port */
<> 149:156823d33999 128 if (GPIOx == GPIOA)
<> 149:156823d33999 129 {
<> 149:156823d33999 130 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOA);
<> 149:156823d33999 131 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOA);
<> 149:156823d33999 132 }
<> 149:156823d33999 133 else if (GPIOx == GPIOB)
<> 149:156823d33999 134 {
<> 149:156823d33999 135 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOB);
<> 149:156823d33999 136 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOB);
<> 149:156823d33999 137 }
<> 149:156823d33999 138 else if (GPIOx == GPIOC)
<> 149:156823d33999 139 {
<> 149:156823d33999 140 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOC);
<> 149:156823d33999 141 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOC);
<> 149:156823d33999 142 }
<> 149:156823d33999 143 #if defined(GPIOD)
<> 149:156823d33999 144 else if (GPIOx == GPIOD)
<> 149:156823d33999 145 {
<> 149:156823d33999 146 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOD);
<> 149:156823d33999 147 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOD);
<> 149:156823d33999 148 }
<> 149:156823d33999 149 #endif /* GPIOD */
<> 149:156823d33999 150 #if defined(GPIOE)
<> 149:156823d33999 151 else if (GPIOx == GPIOE)
<> 149:156823d33999 152 {
<> 149:156823d33999 153 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOE);
<> 149:156823d33999 154 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOE);
<> 149:156823d33999 155 }
<> 149:156823d33999 156 #endif /* GPIOE */
<> 149:156823d33999 157 #if defined(GPIOF)
<> 149:156823d33999 158 else if (GPIOx == GPIOF)
<> 149:156823d33999 159 {
<> 149:156823d33999 160 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOF);
<> 149:156823d33999 161 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOF);
<> 149:156823d33999 162 }
<> 149:156823d33999 163 #endif /* GPIOF */
<> 149:156823d33999 164 #if defined(GPIOG)
<> 149:156823d33999 165 else if (GPIOx == GPIOG)
<> 149:156823d33999 166 {
<> 149:156823d33999 167 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOG);
<> 149:156823d33999 168 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOG);
<> 149:156823d33999 169 }
<> 149:156823d33999 170 #endif /* GPIOG */
<> 149:156823d33999 171 #if defined(GPIOH)
<> 149:156823d33999 172 else if (GPIOx == GPIOH)
<> 149:156823d33999 173 {
<> 149:156823d33999 174 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOH);
<> 149:156823d33999 175 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOH);
<> 149:156823d33999 176 }
<> 149:156823d33999 177 #endif /* GPIOH */
<> 149:156823d33999 178 else
<> 149:156823d33999 179 {
<> 149:156823d33999 180 status = ERROR;
<> 149:156823d33999 181 }
<> 149:156823d33999 182
<> 149:156823d33999 183 return (status);
<> 149:156823d33999 184 }
<> 149:156823d33999 185
<> 149:156823d33999 186 /**
<> 149:156823d33999 187 * @brief Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
<> 149:156823d33999 188 * @param GPIOx GPIO Port
<> 149:156823d33999 189 * @param GPIO_InitStruct: pointer to a @ref LL_GPIO_InitTypeDef structure
<> 149:156823d33999 190 * that contains the configuration information for the specified GPIO peripheral.
<> 149:156823d33999 191 * @retval An ErrorStatus enumeration value:
<> 149:156823d33999 192 * - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
<> 149:156823d33999 193 * - ERROR: Not applicable
<> 149:156823d33999 194 */
<> 149:156823d33999 195 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
<> 149:156823d33999 196 {
<> 149:156823d33999 197 uint32_t pinpos = 0x00000000U;
<> 149:156823d33999 198 uint32_t currentpin = 0x00000000U;
<> 149:156823d33999 199
<> 149:156823d33999 200 /* Check the parameters */
<> 149:156823d33999 201 assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
<> 149:156823d33999 202 assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
<> 149:156823d33999 203 assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
<> 149:156823d33999 204 assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
<> 149:156823d33999 205
<> 149:156823d33999 206 /* ------------------------- Configure the port pins ---------------- */
<> 149:156823d33999 207 /* Initialize pinpos on first pin set */
<> 149:156823d33999 208 pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
<> 149:156823d33999 209
<> 149:156823d33999 210 /* Configure the port pins */
<> 149:156823d33999 211 while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
<> 149:156823d33999 212 {
<> 149:156823d33999 213 /* Get current io position */
<> 149:156823d33999 214 currentpin = (GPIO_InitStruct->Pin) & (0x00000001U << pinpos);
<> 149:156823d33999 215
<> 149:156823d33999 216 if (currentpin)
<> 149:156823d33999 217 {
<> 149:156823d33999 218 /* Pin Mode configuration */
<> 149:156823d33999 219 LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
<> 149:156823d33999 220
<> 149:156823d33999 221 if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
<> 149:156823d33999 222 {
<> 149:156823d33999 223 /* Check Speed mode parameters */
<> 149:156823d33999 224 assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
<> 149:156823d33999 225
<> 149:156823d33999 226 /* Speed mode configuration */
<> 149:156823d33999 227 LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
<> 149:156823d33999 228 }
<> 149:156823d33999 229
<> 149:156823d33999 230 /* Pull-up Pull down resistor configuration*/
<> 149:156823d33999 231 LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
<> 149:156823d33999 232
<> 149:156823d33999 233 if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
<> 149:156823d33999 234 {
<> 149:156823d33999 235 /* Check Alternate parameter */
<> 149:156823d33999 236 assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
<> 149:156823d33999 237
<> 149:156823d33999 238 /* Speed mode configuration */
<> 149:156823d33999 239 if (POSITION_VAL(currentpin) < 0x00000008U)
<> 149:156823d33999 240 {
<> 149:156823d33999 241 LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
<> 149:156823d33999 242 }
<> 149:156823d33999 243 else
<> 149:156823d33999 244 {
<> 149:156823d33999 245 LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
<> 149:156823d33999 246 }
<> 149:156823d33999 247 }
<> 149:156823d33999 248 }
<> 149:156823d33999 249 pinpos++;
<> 149:156823d33999 250 }
<> 149:156823d33999 251
<> 149:156823d33999 252 if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
<> 149:156823d33999 253 {
<> 149:156823d33999 254 /* Check Output mode parameters */
<> 149:156823d33999 255 assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
<> 149:156823d33999 256
<> 149:156823d33999 257 /* Output mode configuration*/
<> 149:156823d33999 258 LL_GPIO_SetPinOutputType(GPIOx, GPIO_InitStruct->Pin, GPIO_InitStruct->OutputType);
<> 149:156823d33999 259
<> 149:156823d33999 260 }
<> 149:156823d33999 261 return (SUCCESS);
<> 149:156823d33999 262 }
<> 149:156823d33999 263
<> 149:156823d33999 264 /**
<> 149:156823d33999 265 * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
<> 149:156823d33999 266 * @param GPIO_InitStruct: pointer to a @ref LL_GPIO_InitTypeDef structure
<> 149:156823d33999 267 * whose fields will be set to default values.
<> 149:156823d33999 268 * @retval None
<> 149:156823d33999 269 */
<> 149:156823d33999 270
<> 149:156823d33999 271 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
<> 149:156823d33999 272 {
<> 149:156823d33999 273 /* Reset GPIO init structure parameters values */
<> 149:156823d33999 274 GPIO_InitStruct->Pin = LL_GPIO_PIN_ALL;
<> 149:156823d33999 275 GPIO_InitStruct->Mode = LL_GPIO_MODE_ANALOG;
<> 149:156823d33999 276 GPIO_InitStruct->Speed = LL_GPIO_SPEED_FREQ_LOW;
<> 149:156823d33999 277 GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
<> 149:156823d33999 278 GPIO_InitStruct->Pull = LL_GPIO_PULL_NO;
<> 149:156823d33999 279 GPIO_InitStruct->Alternate = LL_GPIO_AF_0;
<> 149:156823d33999 280 }
<> 149:156823d33999 281
<> 149:156823d33999 282 /**
<> 149:156823d33999 283 * @}
<> 149:156823d33999 284 */
<> 149:156823d33999 285
<> 149:156823d33999 286 /**
<> 149:156823d33999 287 * @}
<> 149:156823d33999 288 */
<> 149:156823d33999 289
<> 149:156823d33999 290 /**
<> 149:156823d33999 291 * @}
<> 149:156823d33999 292 */
<> 149:156823d33999 293
<> 149:156823d33999 294 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) */
<> 149:156823d33999 295
<> 149:156823d33999 296 /**
<> 149:156823d33999 297 * @}
<> 149:156823d33999 298 */
<> 149:156823d33999 299
<> 149:156823d33999 300 #endif /* USE_FULL_LL_DRIVER */
<> 149:156823d33999 301
<> 149:156823d33999 302 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/