lib/main/STM32G4/Drivers/STM32G4xx_HAL_Driver/Src/stm32g4xx_ll_gpio.c

   1 /**
   2   ******************************************************************************
   3   * @file    stm32g4xx_ll_gpio.c
   4   * @author  MCD Application Team
   5   * @brief   GPIO LL module driver.
   6   ******************************************************************************
   7   * @attention
   8   *
   9   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
  10   * All rights reserved.</center></h2>
  11   *
  12   * This software component is licensed by ST under BSD 3-Clause license,
  13   * the "License"; You may not use this file except in compliance with the
  14   * License. You may obtain a copy of the License at:
  15   *                        opensource.org/licenses/BSD-3-Clause
  16   *
  17   ******************************************************************************
  18   */
  19 #if defined(USE_FULL_LL_DRIVER)
  20
  21 /* Includes ------------------------------------------------------------------*/
  22 #include "stm32g4xx_ll_gpio.h"
  23 #include "stm32g4xx_ll_bus.h"
  24 #ifdef  USE_FULL_ASSERT
  25 #include "stm32_assert.h"
  26 #else
  27 #define assert_param(expr) ((void)0U)
  28 #endif /* USE_FULL_ASSERT */
  29
  30 /** @addtogroup STM32G4xx_LL_Driver
  31   * @{
  32   */
  33
  34 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG)
  35
  36 /** @addtogroup GPIO_LL
  37   * @{
  38   */
  39 /** MISRA C:2012 deviation rule has been granted for following rules:
  40   * Rule-12.2 - Medium: RHS argument is in interval [0,INF] which is out of
  41   * range of the shift operator in following API :
  42   * LL_GPIO_Init
  43   */
  44
  45 /* Private types -------------------------------------------------------------*/
  46 /* Private variables ---------------------------------------------------------*/
  47 /* Private constants ---------------------------------------------------------*/
  48 /* Private macros ------------------------------------------------------------*/
  49 /** @addtogroup GPIO_LL_Private_Macros
  50   * @{
  51   */
  52 #define IS_LL_GPIO_PIN(__VALUE__)          (((0x00000000U) < (__VALUE__)) && ((__VALUE__) <= (LL_GPIO_PIN_ALL)))
  53
  54 #define IS_LL_GPIO_MODE(__VALUE__)         (((__VALUE__) == LL_GPIO_MODE_INPUT)     ||\
  55                                             ((__VALUE__) == LL_GPIO_MODE_OUTPUT)    ||\
  56                                             ((__VALUE__) == LL_GPIO_MODE_ALTERNATE) ||\
  57                                             ((__VALUE__) == LL_GPIO_MODE_ANALOG))
  58
  59 #define IS_LL_GPIO_OUTPUT_TYPE(__VALUE__)  (((__VALUE__) == LL_GPIO_OUTPUT_PUSHPULL)  ||\
  60                                             ((__VALUE__) == LL_GPIO_OUTPUT_OPENDRAIN))
  61
  62 #define IS_LL_GPIO_SPEED(__VALUE__)        (((__VALUE__) == LL_GPIO_SPEED_FREQ_LOW)       ||\
  63                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_MEDIUM)    ||\
  64                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_HIGH)      ||\
  65                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_VERY_HIGH))
  66
  67 #define IS_LL_GPIO_PULL(__VALUE__)         (((__VALUE__) == LL_GPIO_PULL_NO)   ||\
  68                                             ((__VALUE__) == LL_GPIO_PULL_UP)   ||\
  69                                             ((__VALUE__) == LL_GPIO_PULL_DOWN))
  70
  71 #define IS_LL_GPIO_ALTERNATE(__VALUE__)    (((__VALUE__) == LL_GPIO_AF_0  )   ||\
  72                                             ((__VALUE__) == LL_GPIO_AF_1  )   ||\
  73                                             ((__VALUE__) == LL_GPIO_AF_2  )   ||\
  74                                             ((__VALUE__) == LL_GPIO_AF_3  )   ||\
  75                                             ((__VALUE__) == LL_GPIO_AF_4  )   ||\
  76                                             ((__VALUE__) == LL_GPIO_AF_5  )   ||\
  77                                             ((__VALUE__) == LL_GPIO_AF_6  )   ||\
  78                                             ((__VALUE__) == LL_GPIO_AF_7  )   ||\
  79                                             ((__VALUE__) == LL_GPIO_AF_8  )   ||\
  80                                             ((__VALUE__) == LL_GPIO_AF_9  )   ||\
  81                                             ((__VALUE__) == LL_GPIO_AF_10 )   ||\
  82                                             ((__VALUE__) == LL_GPIO_AF_11 )   ||\
  83                                             ((__VALUE__) == LL_GPIO_AF_12 )   ||\
  84                                             ((__VALUE__) == LL_GPIO_AF_13 )   ||\
  85                                             ((__VALUE__) == LL_GPIO_AF_14 )   ||\
  86                                             ((__VALUE__) == LL_GPIO_AF_15 ))
  87 /**
  88   * @}
  89   */
  90
  91 /* Private function prototypes -----------------------------------------------*/
  92
  93 /* Exported functions --------------------------------------------------------*/
  94 /** @addtogroup GPIO_LL_Exported_Functions
  95   * @{
  96   */
  97
  98 /** @addtogroup GPIO_LL_EF_Init
  99   * @{
 100   */
 101
 102 /**
 103   * @brief  De-initialize GPIO registers (Registers restored to their default values).
 104   * @param  GPIOx GPIO Port
 105   * @retval An ErrorStatus enumeration value:
 106   *          - SUCCESS: GPIO registers are de-initialized
 107   *          - ERROR:   Wrong GPIO Port
 108   */
 109 ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx)
 110 {
 111   ErrorStatus status = SUCCESS;
 112
 113   /* Check the parameters */
 114   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
 115
 116   /* Force and Release reset on clock of GPIOx Port */
 117   if (GPIOx == GPIOA)
 118   {
 119     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOA);
 120     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOA);
 121   }
 122   else if (GPIOx == GPIOB)
 123   {
 124     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOB);
 125     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOB);
 126   }
 127   else if (GPIOx == GPIOC)
 128   {
 129     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOC);
 130     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOC);
 131   }
 132   else if (GPIOx == GPIOD)
 133   {
 134     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOD);
 135     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOD);
 136   }
 137   else if (GPIOx == GPIOE)
 138   {
 139     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOE);
 140     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOE);
 141   }
 142   else if (GPIOx == GPIOF)
 143   {
 144     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOF);
 145     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOF);
 146   }
 147   else if (GPIOx == GPIOG)
 148   {
 149     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_GPIOG);
 150     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_GPIOG);
 151   }
 152   else
 153   {
 154     status = ERROR;
 155   }
 156
 157   return (status);
 158 }
 159
 160 /**
 161   * @brief  Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
 162   * @param  GPIOx GPIO Port
 163   * @param  GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
 164   *         that contains the configuration information for the specified GPIO peripheral.
 165   * @retval An ErrorStatus enumeration value:
 166   *          - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
 167   *          - ERROR:   Not applicable
 168   */
 169 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
 170 {
 171   uint32_t pinpos;
 172   uint32_t currentpin;
 173
 174   /* Check the parameters */
 175   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
 176   assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
 177   assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
 178   assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
 179
 180   /* ------------------------- Configure the port pins ---------------- */
 181   /* Initialize  pinpos on first pin set */
 182   pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
 183
 184   /* Configure the port pins */
 185   while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
 186   {
 187     /* Get current io position */
 188     currentpin = (GPIO_InitStruct->Pin) & (0x00000001UL << pinpos);
 189
 190     if (currentpin != 0x00u)
 191     {
 192       /* Pin Mode configuration */
 193       LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
 194
 195       if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
 196       {
 197         /* Check Speed mode parameters */
 198         assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
 199
 200         /* Speed mode configuration */
 201         LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
 202       }
 203
 204       /* Pull-up Pull down resistor configuration*/
 205       LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
 206
 207       if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
 208       {
 209         /* Check Alternate parameter */
 210         assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
 211
 212         /* Speed mode configuration */
 213         if (currentpin < LL_GPIO_PIN_8)
 214         {
 215           LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
 216         }
 217         else
 218         {
 219           LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
 220         }
 221       }
 222     }
 223     pinpos++;
 224   }
 225
 226   if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
 227   {
 228     /* Check Output mode parameters */
 229     assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
 230
 231     /* Output mode configuration*/
 232     LL_GPIO_SetPinOutputType(GPIOx, GPIO_InitStruct->Pin, GPIO_InitStruct->OutputType);
 233
 234   }
 235   return (SUCCESS);
 236 }
 237
 238 /**
 239   * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
 240   * @param GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
 241   *                          whose fields will be set to default values.
 242   * @retval None
 243   */
 244
 245 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
 246 {
 247   /* Reset GPIO init structure parameters values */
 248   GPIO_InitStruct->Pin        = LL_GPIO_PIN_ALL;
 249   GPIO_InitStruct->Mode       = LL_GPIO_MODE_ANALOG;
 250   GPIO_InitStruct->Speed      = LL_GPIO_SPEED_FREQ_LOW;
 251   GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
 252   GPIO_InitStruct->Pull       = LL_GPIO_PULL_NO;
 253   GPIO_InitStruct->Alternate  = LL_GPIO_AF_0;
 254 }
 255
 256 /**
 257   * @}
 258   */
 259
 260 /**
 261   * @}
 262   */
 263
 264 /**
 265   * @}
 266   */
 267
 268 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) */
 269
 270 /**
 271   * @}
 272   */
 273
 274 #endif /* USE_FULL_LL_DRIVER */
 275
 276 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/