1 /**
2   ******************************************************************************
3   * @file    stm32l1xx_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 "stm32l1xx_ll_gpio.h"
23 #include "stm32l1xx_ll_bus.h"
24 #ifdef  USE_FULL_ASSERT
25 #include "stm32_assert.h"
26 #else
27 #define assert_param(expr) ((void)0U)
28 #endif
29 
30 /** @addtogroup STM32L1xx_LL_Driver
31   * @{
32   */
33 
34 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH)
35 
36 /** @addtogroup GPIO_LL
37   * @{
38   */
39 
40 /* Private types -------------------------------------------------------------*/
41 /* Private variables ---------------------------------------------------------*/
42 /* Private constants ---------------------------------------------------------*/
43 /* Private macros ------------------------------------------------------------*/
44 /** @addtogroup GPIO_LL_Private_Macros
45   * @{
46   */
47 #define IS_LL_GPIO_PIN(__VALUE__)          (((0x00000000U) < (__VALUE__)) && ((__VALUE__) <= (LL_GPIO_PIN_ALL)))
48 
49 #define IS_LL_GPIO_MODE(__VALUE__)         (((__VALUE__) == LL_GPIO_MODE_INPUT)     ||\
50                                             ((__VALUE__) == LL_GPIO_MODE_OUTPUT)    ||\
51                                             ((__VALUE__) == LL_GPIO_MODE_ALTERNATE) ||\
52                                             ((__VALUE__) == LL_GPIO_MODE_ANALOG))
53 
54 #define IS_LL_GPIO_OUTPUT_TYPE(__VALUE__)  (((__VALUE__) == LL_GPIO_OUTPUT_PUSHPULL)  ||\
55                                             ((__VALUE__) == LL_GPIO_OUTPUT_OPENDRAIN))
56 
57 #define IS_LL_GPIO_SPEED(__VALUE__)        (((__VALUE__) == LL_GPIO_SPEED_FREQ_LOW)       ||\
58                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_MEDIUM)    ||\
59                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_HIGH)      ||\
60                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_VERY_HIGH))
61 
62 #define IS_LL_GPIO_PULL(__VALUE__)         (((__VALUE__) == LL_GPIO_PULL_NO)   ||\
63                                             ((__VALUE__) == LL_GPIO_PULL_UP)   ||\
64                                             ((__VALUE__) == LL_GPIO_PULL_DOWN))
65 
66 #define IS_LL_GPIO_ALTERNATE(__VALUE__)    (((__VALUE__) == LL_GPIO_AF_0  )   ||\
67                                             ((__VALUE__) == LL_GPIO_AF_1  )   ||\
68                                             ((__VALUE__) == LL_GPIO_AF_2  )   ||\
69                                             ((__VALUE__) == LL_GPIO_AF_3  )   ||\
70                                             ((__VALUE__) == LL_GPIO_AF_4  )   ||\
71                                             ((__VALUE__) == LL_GPIO_AF_5  )   ||\
72                                             ((__VALUE__) == LL_GPIO_AF_6  )   ||\
73                                             ((__VALUE__) == LL_GPIO_AF_7  )   ||\
74                                             ((__VALUE__) == LL_GPIO_AF_8  )   ||\
75                                             ((__VALUE__) == LL_GPIO_AF_9  )   ||\
76                                             ((__VALUE__) == LL_GPIO_AF_10 )   ||\
77                                             ((__VALUE__) == LL_GPIO_AF_11 )   ||\
78                                             ((__VALUE__) == LL_GPIO_AF_12 )   ||\
79                                             ((__VALUE__) == LL_GPIO_AF_13 )   ||\
80                                             ((__VALUE__) == LL_GPIO_AF_14 )   ||\
81                                             ((__VALUE__) == LL_GPIO_AF_15 ))
82 /**
83   * @}
84   */
85 
86 /* Private function prototypes -----------------------------------------------*/
87 
88 /* Exported functions --------------------------------------------------------*/
89 /** @addtogroup GPIO_LL_Exported_Functions
90   * @{
91   */
92 
93 /** @addtogroup GPIO_LL_EF_Init
94   * @{
95   */
96 
97 /**
98   * @brief  De-initialize GPIO registers (Registers restored to their default values).
99   * @param  GPIOx GPIO Port
100   * @retval An ErrorStatus enumeration value:
101   *          - SUCCESS: GPIO registers are de-initialized
102   *          - ERROR:   Wrong GPIO Port
103   */
LL_GPIO_DeInit(GPIO_TypeDef * GPIOx)104 ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx)
105 {
106   ErrorStatus status = SUCCESS;
107 
108   /* Check the parameters */
109   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
110 
111   /* Force and Release reset on clock of GPIOx Port */
112   if (GPIOx == GPIOA)
113   {
114     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOA);
115     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOA);
116   }
117   else if (GPIOx == GPIOB)
118   {
119     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOB);
120     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOB);
121   }
122   else if (GPIOx == GPIOC)
123   {
124     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOC);
125     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOC);
126   }
127 #if defined(GPIOD)
128   else if (GPIOx == GPIOD)
129   {
130     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOD);
131     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOD);
132   }
133 #endif /* GPIOD */
134 #if defined(GPIOE)
135   else if (GPIOx == GPIOE)
136   {
137     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOE);
138     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOE);
139   }
140 #endif /* GPIOE */
141 #if defined(GPIOF)
142   else if (GPIOx == GPIOF)
143   {
144     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOF);
145     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOF);
146   }
147 #endif /* GPIOF */
148 #if defined(GPIOG)
149   else if (GPIOx == GPIOG)
150   {
151     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOG);
152     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOG);
153   }
154 #endif /* GPIOG */
155 #if defined(GPIOH)
156   else if (GPIOx == GPIOH)
157   {
158     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOH);
159     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOH);
160   }
161 #endif /* GPIOH */
162   else
163   {
164     status = ERROR;
165   }
166 
167   return (status);
168 }
169 
170 /**
171   * @brief  Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
172   * @param  GPIOx GPIO Port
173   * @param  GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
174   *         that contains the configuration information for the specified GPIO peripheral.
175   * @retval An ErrorStatus enumeration value:
176   *          - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
177   *          - ERROR:   Not applicable
178   */
LL_GPIO_Init(GPIO_TypeDef * GPIOx,LL_GPIO_InitTypeDef * GPIO_InitStruct)179 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
180 {
181   uint32_t pinpos     = 0x00000000U;
182   uint32_t currentpin = 0x00000000U;
183 
184   /* Check the parameters */
185   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
186   assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
187   assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
188   assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
189 
190   /* ------------------------- Configure the port pins ---------------- */
191   /* Initialize  pinpos on first pin set */
192   pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
193 
194   /* Configure the port pins */
195   while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
196   {
197     /* Get current io position */
198     currentpin = (GPIO_InitStruct->Pin) & (0x00000001U << pinpos);
199 
200     if (currentpin)
201     {
202 
203       if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
204       {
205         /* Check Speed mode parameters */
206         assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
207 
208         /* Speed mode configuration */
209         LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
210 
211         /* Check Output mode parameters */
212         assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
213 
214         /* Output mode configuration*/
215         LL_GPIO_SetPinOutputType(GPIOx, currentpin, GPIO_InitStruct->OutputType);
216       }
217 
218       /* Pull-up Pull down resistor configuration*/
219       LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
220 
221       if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
222       {
223         /* Check Alternate parameter */
224         assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
225 
226         /* Speed mode configuration */
227         if (POSITION_VAL(currentpin) < 0x00000008U)
228         {
229           LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
230         }
231         else
232         {
233           LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
234         }
235       }
236 
237       /* Pin Mode configuration */
238       LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
239     }
240     pinpos++;
241   }
242 
243   return (SUCCESS);
244 }
245 
246 /**
247   * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
248   * @param GPIO_InitStruct: pointer to a @ref LL_GPIO_InitTypeDef structure
249   *                          whose fields will be set to default values.
250   * @retval None
251   */
252 
LL_GPIO_StructInit(LL_GPIO_InitTypeDef * GPIO_InitStruct)253 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
254 {
255   /* Reset GPIO init structure parameters values */
256   GPIO_InitStruct->Pin        = LL_GPIO_PIN_ALL;
257   GPIO_InitStruct->Mode       = LL_GPIO_MODE_ANALOG;
258   GPIO_InitStruct->Speed      = LL_GPIO_SPEED_FREQ_LOW;
259   GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
260   GPIO_InitStruct->Pull       = LL_GPIO_PULL_NO;
261   GPIO_InitStruct->Alternate  = LL_GPIO_AF_0;
262 }
263 
264 /**
265   * @}
266   */
267 
268 /**
269   * @}
270   */
271 
272 /**
273   * @}
274   */
275 
276 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) */
277 
278 /**
279   * @}
280   */
281 
282 #endif /* USE_FULL_LL_DRIVER */
283 
284 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
285