1 /**
2   ******************************************************************************
3   * @file    stm32mp1xx_ll_gpio.h
4   * @author  MCD Application Team
5   * @brief   Header file of GPIO LL module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2019 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef __STM32MP1xx_LL_GPIO_H
21 #define __STM32MP1xx_LL_GPIO_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32mp1xx.h"
29 
30 /** @addtogroup STM32MP1xx_LL_Driver
31   * @{
32   */
33 
34 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI) || defined (GPIOJ) || defined (GPIOK)
35 
36 /** @defgroup GPIO_LL GPIO
37   * @{
38   */
39 
40 /* Private types -------------------------------------------------------------*/
41 /* Private variables ---------------------------------------------------------*/
42 /* Private constants ---------------------------------------------------------*/
43 /* Private macros ------------------------------------------------------------*/
44 #if defined(USE_FULL_LL_DRIVER)
45 /** @defgroup GPIO_LL_Private_Macros GPIO Private Macros
46   * @{
47   */
48 
49 /**
50   * @}
51   */
52 #endif /*USE_FULL_LL_DRIVER*/
53 
54 /* Exported types ------------------------------------------------------------*/
55 #if defined(USE_FULL_LL_DRIVER)
56 /** @defgroup GPIO_LL_ES_INIT GPIO Exported Init structures
57   * @{
58   */
59 
60 /**
61   * @brief LL GPIO Init Structure definition
62   */
63 typedef struct
64 {
65   uint32_t Pin;          /*!< Specifies the GPIO pins to be configured.
66                               This parameter can be any value of @ref GPIO_LL_EC_PIN */
67 
68   uint32_t Mode;         /*!< Specifies the operating mode for the selected pins.
69                               This parameter can be a value of @ref GPIO_LL_EC_MODE.
70 
71                               GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinMode().*/
72 
73   uint32_t Speed;        /*!< Specifies the speed for the selected pins.
74                               This parameter can be a value of @ref GPIO_LL_EC_SPEED.
75 
76                               GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinSpeed().*/
77 
78   uint32_t OutputType;   /*!< Specifies the operating output type for the selected pins.
79                               This parameter can be a value of @ref GPIO_LL_EC_OUTPUT.
80 
81                               GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinOutputType().*/
82 
83   uint32_t Pull;         /*!< Specifies the operating Pull-up/Pull down for the selected pins.
84                               This parameter can be a value of @ref GPIO_LL_EC_PULL.
85 
86                               GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinPull().*/
87 
88   uint32_t Alternate;    /*!< Specifies the Peripheral to be connected to the selected pins.
89                               This parameter can be a value of @ref GPIO_LL_EC_AF.
90 
91                               GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetAFPin_0_7() and LL_GPIO_SetAFPin_8_15().*/
92 } LL_GPIO_InitTypeDef;
93 
94 /**
95   * @}
96   */
97 #endif /* USE_FULL_LL_DRIVER */
98 
99 /* Exported constants --------------------------------------------------------*/
100 /** @defgroup GPIO_LL_Exported_Constants GPIO Exported Constants
101   * @{
102   */
103 
104 /** @defgroup GPIO_LL_EC_PIN PIN
105   * @{
106   */
107 #define LL_GPIO_PIN_0                      GPIO_BSRR_BS0 /*!< Select pin 0 */
108 #define LL_GPIO_PIN_1                      GPIO_BSRR_BS1 /*!< Select pin 1 */
109 #define LL_GPIO_PIN_2                      GPIO_BSRR_BS2 /*!< Select pin 2 */
110 #define LL_GPIO_PIN_3                      GPIO_BSRR_BS3 /*!< Select pin 3 */
111 #define LL_GPIO_PIN_4                      GPIO_BSRR_BS4 /*!< Select pin 4 */
112 #define LL_GPIO_PIN_5                      GPIO_BSRR_BS5 /*!< Select pin 5 */
113 #define LL_GPIO_PIN_6                      GPIO_BSRR_BS6 /*!< Select pin 6 */
114 #define LL_GPIO_PIN_7                      GPIO_BSRR_BS7 /*!< Select pin 7 */
115 #define LL_GPIO_PIN_8                      GPIO_BSRR_BS8 /*!< Select pin 8 */
116 #define LL_GPIO_PIN_9                      GPIO_BSRR_BS9 /*!< Select pin 9 */
117 #define LL_GPIO_PIN_10                     GPIO_BSRR_BS10 /*!< Select pin 10 */
118 #define LL_GPIO_PIN_11                     GPIO_BSRR_BS11 /*!< Select pin 11 */
119 #define LL_GPIO_PIN_12                     GPIO_BSRR_BS12 /*!< Select pin 12 */
120 #define LL_GPIO_PIN_13                     GPIO_BSRR_BS13 /*!< Select pin 13 */
121 #define LL_GPIO_PIN_14                     GPIO_BSRR_BS14 /*!< Select pin 14 */
122 #define LL_GPIO_PIN_15                     GPIO_BSRR_BS15 /*!< Select pin 15 */
123 #define LL_GPIO_PIN_ALL                    (GPIO_BSRR_BS0 | GPIO_BSRR_BS1  | GPIO_BSRR_BS2  | \
124                                            GPIO_BSRR_BS3  | GPIO_BSRR_BS4  | GPIO_BSRR_BS5  | \
125                                            GPIO_BSRR_BS6  | GPIO_BSRR_BS7  | GPIO_BSRR_BS8  | \
126                                            GPIO_BSRR_BS9  | GPIO_BSRR_BS10 | GPIO_BSRR_BS11 | \
127                                            GPIO_BSRR_BS12 | GPIO_BSRR_BS13 | GPIO_BSRR_BS14 | \
128                                            GPIO_BSRR_BS15) /*!< Select all pins */
129 /**
130   * @}
131   */
132 
133 /** @defgroup GPIO_LL_EC_MODE Mode
134   * @{
135   */
136 #define LL_GPIO_MODE_INPUT                 (0x00000000U) /*!< Select input mode */
137 #define LL_GPIO_MODE_OUTPUT                GPIO_MODER_MODER0_0  /*!< Select output mode */
138 #define LL_GPIO_MODE_ALTERNATE             GPIO_MODER_MODER0_1  /*!< Select alternate function mode */
139 #define LL_GPIO_MODE_ANALOG                GPIO_MODER_MODER0    /*!< Select analog mode */
140 /**
141   * @}
142   */
143 
144 /** @defgroup GPIO_LL_EC_OUTPUT Output Type
145   * @{
146   */
147 #define LL_GPIO_OUTPUT_PUSHPULL            (0x00000000U) /*!< Select push-pull as output type */
148 #define LL_GPIO_OUTPUT_OPENDRAIN           GPIO_OTYPER_OT0 /*!< Select open-drain as output type */
149 /**
150   * @}
151   */
152 
153 /** @defgroup GPIO_LL_EC_SPEED Output Speed
154   * @{
155   */
156 #define LL_GPIO_SPEED_FREQ_LOW             (0x00000000U) /*!< Select I/O low output speed    */
157 #define LL_GPIO_SPEED_FREQ_MEDIUM          GPIO_OSPEEDR_OSPEEDR0_0 /*!< Select I/O medium output speed */
158 #define LL_GPIO_SPEED_FREQ_HIGH            GPIO_OSPEEDR_OSPEEDR0_1 /*!< Select I/O fast output speed   */
159 #define LL_GPIO_SPEED_FREQ_VERY_HIGH       GPIO_OSPEEDR_OSPEEDR0   /*!< Select I/O high output speed   */
160 /**
161   * @}
162   */
163 #define LL_GPIO_SPEED_LOW                  LL_GPIO_SPEED_FREQ_LOW
164 #define LL_GPIO_SPEED_MEDIUM               LL_GPIO_SPEED_FREQ_MEDIUM
165 #define LL_GPIO_SPEED_FAST                 LL_GPIO_SPEED_FREQ_HIGH
166 #define LL_GPIO_SPEED_HIGH                 LL_GPIO_SPEED_FREQ_VERY_HIGH
167 
168 
169 /** @defgroup GPIO_LL_EC_PULL Pull Up Pull Down
170   * @{
171   */
172 #define LL_GPIO_PULL_NO                    (0x00000000U) /*!< Select I/O no pull */
173 #define LL_GPIO_PULL_UP                    GPIO_PUPDR_PUPDR0_0 /*!< Select I/O pull up */
174 #define LL_GPIO_PULL_DOWN                  GPIO_PUPDR_PUPDR0_1 /*!< Select I/O pull down */
175 /**
176   * @}
177   */
178 
179 /** @defgroup GPIO_LL_EC_AF Alternate Function
180   * @{
181   */
182 #define LL_GPIO_AF_0                       (0x0000000U) /*!< Select alternate function 0 */
183 #define LL_GPIO_AF_1                       (0x0000001U) /*!< Select alternate function 1 */
184 #define LL_GPIO_AF_2                       (0x0000002U) /*!< Select alternate function 2 */
185 #define LL_GPIO_AF_3                       (0x0000003U) /*!< Select alternate function 3 */
186 #define LL_GPIO_AF_4                       (0x0000004U) /*!< Select alternate function 4 */
187 #define LL_GPIO_AF_5                       (0x0000005U) /*!< Select alternate function 5 */
188 #define LL_GPIO_AF_6                       (0x0000006U) /*!< Select alternate function 6 */
189 #define LL_GPIO_AF_7                       (0x0000007U) /*!< Select alternate function 7 */
190 #define LL_GPIO_AF_8                       (0x0000008U) /*!< Select alternate function 8 */
191 #define LL_GPIO_AF_9                       (0x0000009U) /*!< Select alternate function 9 */
192 #define LL_GPIO_AF_10                      (0x000000AU) /*!< Select alternate function 10 */
193 #define LL_GPIO_AF_11                      (0x000000BU) /*!< Select alternate function 11 */
194 #define LL_GPIO_AF_12                      (0x000000CU) /*!< Select alternate function 12 */
195 #define LL_GPIO_AF_13                      (0x000000DU) /*!< Select alternate function 13 */
196 #define LL_GPIO_AF_14                      (0x000000EU) /*!< Select alternate function 14 */
197 #define LL_GPIO_AF_15                      (0x000000FU) /*!< Select alternate function 15 */
198 /**
199   * @}
200   */
201 
202 /**
203   * @}
204   */
205 
206 /* Exported macro ------------------------------------------------------------*/
207 /** @defgroup GPIO_LL_Exported_Macros GPIO Exported Macros
208   * @{
209   */
210 
211 /** @defgroup GPIO_LL_EM_WRITE_READ Common Write and read registers Macros
212   * @{
213   */
214 
215 /**
216   * @brief  Write a value in GPIO register
217   * @param  __INSTANCE__ GPIO Instance
218   * @param  __REG__ Register to be written
219   * @param  __VALUE__ Value to be written in the register
220   * @retval None
221   */
222 #define LL_GPIO_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
223 
224 /**
225   * @brief  Read a value in GPIO register
226   * @param  __INSTANCE__ GPIO Instance
227   * @param  __REG__ Register to be read
228   * @retval Register value
229   */
230 #define LL_GPIO_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
231 /**
232   * @}
233   */
234 
235 /**
236   * @}
237   */
238 
239 /* Exported functions --------------------------------------------------------*/
240 /** @defgroup GPIO_LL_Exported_Functions GPIO Exported Functions
241   * @{
242   */
243 
244 /** @defgroup GPIO_LL_EF_Port_Configuration Port Configuration
245   * @{
246   */
247 
248 /**
249   * @brief  Configure gpio mode for a dedicated pin on dedicated port.
250   * @note   I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
251   * @note   Warning: only one pin can be passed as parameter.
252   * @rmtoll MODER        MODEy         LL_GPIO_SetPinMode
253   * @param  GPIOx GPIO Port
254   * @param  Pin This parameter can be one of the following values:
255   *         @arg @ref LL_GPIO_PIN_0
256   *         @arg @ref LL_GPIO_PIN_1
257   *         @arg @ref LL_GPIO_PIN_2
258   *         @arg @ref LL_GPIO_PIN_3
259   *         @arg @ref LL_GPIO_PIN_4
260   *         @arg @ref LL_GPIO_PIN_5
261   *         @arg @ref LL_GPIO_PIN_6
262   *         @arg @ref LL_GPIO_PIN_7
263   *         @arg @ref LL_GPIO_PIN_8
264   *         @arg @ref LL_GPIO_PIN_9
265   *         @arg @ref LL_GPIO_PIN_10
266   *         @arg @ref LL_GPIO_PIN_11
267   *         @arg @ref LL_GPIO_PIN_12
268   *         @arg @ref LL_GPIO_PIN_13
269   *         @arg @ref LL_GPIO_PIN_14
270   *         @arg @ref LL_GPIO_PIN_15
271   * @param  Mode This parameter can be one of the following values:
272   *         @arg @ref LL_GPIO_MODE_INPUT
273   *         @arg @ref LL_GPIO_MODE_OUTPUT
274   *         @arg @ref LL_GPIO_MODE_ALTERNATE
275   *         @arg @ref LL_GPIO_MODE_ANALOG
276   * @retval None
277   */
LL_GPIO_SetPinMode(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Mode)278 __STATIC_INLINE void LL_GPIO_SetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Mode)
279 {
280   MODIFY_REG(GPIOx->MODER, ((Pin * Pin) * GPIO_MODER_MODER0), ((Pin * Pin) * Mode));
281 }
282 
283 /**
284   * @brief  Return gpio mode for a dedicated pin on dedicated port.
285   * @note   I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
286   * @note   Warning: only one pin can be passed as parameter.
287   * @rmtoll MODER        MODEy         LL_GPIO_GetPinMode
288   * @param  GPIOx GPIO Port
289   * @param  Pin This parameter can be one of the following values:
290   *         @arg @ref LL_GPIO_PIN_0
291   *         @arg @ref LL_GPIO_PIN_1
292   *         @arg @ref LL_GPIO_PIN_2
293   *         @arg @ref LL_GPIO_PIN_3
294   *         @arg @ref LL_GPIO_PIN_4
295   *         @arg @ref LL_GPIO_PIN_5
296   *         @arg @ref LL_GPIO_PIN_6
297   *         @arg @ref LL_GPIO_PIN_7
298   *         @arg @ref LL_GPIO_PIN_8
299   *         @arg @ref LL_GPIO_PIN_9
300   *         @arg @ref LL_GPIO_PIN_10
301   *         @arg @ref LL_GPIO_PIN_11
302   *         @arg @ref LL_GPIO_PIN_12
303   *         @arg @ref LL_GPIO_PIN_13
304   *         @arg @ref LL_GPIO_PIN_14
305   *         @arg @ref LL_GPIO_PIN_15
306   * @retval Returned value can be one of the following values:
307   *         @arg @ref LL_GPIO_MODE_INPUT
308   *         @arg @ref LL_GPIO_MODE_OUTPUT
309   *         @arg @ref LL_GPIO_MODE_ALTERNATE
310   *         @arg @ref LL_GPIO_MODE_ANALOG
311   */
LL_GPIO_GetPinMode(GPIO_TypeDef * GPIOx,uint32_t Pin)312 __STATIC_INLINE uint32_t LL_GPIO_GetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin)
313 {
314   return (uint32_t)(READ_BIT(GPIOx->MODER, ((Pin * Pin) * GPIO_MODER_MODER0)) / (Pin * Pin));
315 }
316 
317 /**
318   * @brief  Configure gpio output type for several pins on dedicated port.
319   * @note   Output type as to be set when gpio pin is in output or
320   *         alternate modes. Possible type are Push-pull or Open-drain.
321   * @rmtoll OTYPER       OTy           LL_GPIO_SetPinOutputType
322   * @param  GPIOx GPIO Port
323   * @param  PinMask This parameter can be a combination of the following values:
324   *         @arg @ref LL_GPIO_PIN_0
325   *         @arg @ref LL_GPIO_PIN_1
326   *         @arg @ref LL_GPIO_PIN_2
327   *         @arg @ref LL_GPIO_PIN_3
328   *         @arg @ref LL_GPIO_PIN_4
329   *         @arg @ref LL_GPIO_PIN_5
330   *         @arg @ref LL_GPIO_PIN_6
331   *         @arg @ref LL_GPIO_PIN_7
332   *         @arg @ref LL_GPIO_PIN_8
333   *         @arg @ref LL_GPIO_PIN_9
334   *         @arg @ref LL_GPIO_PIN_10
335   *         @arg @ref LL_GPIO_PIN_11
336   *         @arg @ref LL_GPIO_PIN_12
337   *         @arg @ref LL_GPIO_PIN_13
338   *         @arg @ref LL_GPIO_PIN_14
339   *         @arg @ref LL_GPIO_PIN_15
340   *         @arg @ref LL_GPIO_PIN_ALL
341   * @param  OutputType This parameter can be one of the following values:
342   *         @arg @ref LL_GPIO_OUTPUT_PUSHPULL
343   *         @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
344   * @retval None
345   */
LL_GPIO_SetPinOutputType(GPIO_TypeDef * GPIOx,uint32_t PinMask,uint32_t OutputType)346 __STATIC_INLINE void LL_GPIO_SetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t PinMask, uint32_t OutputType)
347 {
348   MODIFY_REG(GPIOx->OTYPER, PinMask, (PinMask * OutputType));
349 }
350 
351 /**
352   * @brief  Return gpio output type for several pins on dedicated port.
353   * @note   Output type as to be set when gpio pin is in output or
354   *         alternate modes. Possible type are Push-pull or Open-drain.
355   * @note   Warning: only one pin can be passed as parameter.
356   * @rmtoll OTYPER       OTy           LL_GPIO_GetPinOutputType
357   * @param  GPIOx GPIO Port
358   * @param  Pin This parameter can be one of the following values:
359   *         @arg @ref LL_GPIO_PIN_0
360   *         @arg @ref LL_GPIO_PIN_1
361   *         @arg @ref LL_GPIO_PIN_2
362   *         @arg @ref LL_GPIO_PIN_3
363   *         @arg @ref LL_GPIO_PIN_4
364   *         @arg @ref LL_GPIO_PIN_5
365   *         @arg @ref LL_GPIO_PIN_6
366   *         @arg @ref LL_GPIO_PIN_7
367   *         @arg @ref LL_GPIO_PIN_8
368   *         @arg @ref LL_GPIO_PIN_9
369   *         @arg @ref LL_GPIO_PIN_10
370   *         @arg @ref LL_GPIO_PIN_11
371   *         @arg @ref LL_GPIO_PIN_12
372   *         @arg @ref LL_GPIO_PIN_13
373   *         @arg @ref LL_GPIO_PIN_14
374   *         @arg @ref LL_GPIO_PIN_15
375   *         @arg @ref LL_GPIO_PIN_ALL
376   * @retval Returned value can be one of the following values:
377   *         @arg @ref LL_GPIO_OUTPUT_PUSHPULL
378   *         @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
379   */
LL_GPIO_GetPinOutputType(GPIO_TypeDef * GPIOx,uint32_t Pin)380 __STATIC_INLINE uint32_t LL_GPIO_GetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t Pin)
381 {
382   return (uint32_t)(READ_BIT(GPIOx->OTYPER, Pin) / Pin);
383 }
384 
385 /**
386   * @brief  Configure gpio speed for a dedicated pin on dedicated port.
387   * @note   I/O speed can be Low, Medium, Fast or High speed.
388   * @note   Warning: only one pin can be passed as parameter.
389   * @note   Refer to datasheet for frequency specifications and the power
390   *         supply and load conditions for each speed.
391   * @rmtoll OSPEEDR      OSPEEDy       LL_GPIO_SetPinSpeed
392   * @param  GPIOx GPIO Port
393   * @param  Pin This parameter can be one of the following values:
394   *         @arg @ref LL_GPIO_PIN_0
395   *         @arg @ref LL_GPIO_PIN_1
396   *         @arg @ref LL_GPIO_PIN_2
397   *         @arg @ref LL_GPIO_PIN_3
398   *         @arg @ref LL_GPIO_PIN_4
399   *         @arg @ref LL_GPIO_PIN_5
400   *         @arg @ref LL_GPIO_PIN_6
401   *         @arg @ref LL_GPIO_PIN_7
402   *         @arg @ref LL_GPIO_PIN_8
403   *         @arg @ref LL_GPIO_PIN_9
404   *         @arg @ref LL_GPIO_PIN_10
405   *         @arg @ref LL_GPIO_PIN_11
406   *         @arg @ref LL_GPIO_PIN_12
407   *         @arg @ref LL_GPIO_PIN_13
408   *         @arg @ref LL_GPIO_PIN_14
409   *         @arg @ref LL_GPIO_PIN_15
410   * @param  Speed This parameter can be one of the following values:
411   *         @arg @ref LL_GPIO_SPEED_FREQ_LOW
412   *         @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
413   *         @arg @ref LL_GPIO_SPEED_FREQ_HIGH
414   *         @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
415   * @retval None
416   */
LL_GPIO_SetPinSpeed(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Speed)417 __STATIC_INLINE void LL_GPIO_SetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t  Speed)
418 {
419   MODIFY_REG(GPIOx->OSPEEDR, ((Pin * Pin) * GPIO_OSPEEDR_OSPEEDR0), ((Pin * Pin) * Speed));
420 }
421 
422 /**
423   * @brief  Return gpio speed for a dedicated pin on dedicated port.
424   * @note   I/O speed can be Low, Medium, Fast or High speed.
425   * @note   Warning: only one pin can be passed as parameter.
426   * @note   Refer to datasheet for frequency specifications and the power
427   *         supply and load conditions for each speed.
428   * @rmtoll OSPEEDR      OSPEEDy       LL_GPIO_GetPinSpeed
429   * @param  GPIOx GPIO Port
430   * @param  Pin This parameter can be one of the following values:
431   *         @arg @ref LL_GPIO_PIN_0
432   *         @arg @ref LL_GPIO_PIN_1
433   *         @arg @ref LL_GPIO_PIN_2
434   *         @arg @ref LL_GPIO_PIN_3
435   *         @arg @ref LL_GPIO_PIN_4
436   *         @arg @ref LL_GPIO_PIN_5
437   *         @arg @ref LL_GPIO_PIN_6
438   *         @arg @ref LL_GPIO_PIN_7
439   *         @arg @ref LL_GPIO_PIN_8
440   *         @arg @ref LL_GPIO_PIN_9
441   *         @arg @ref LL_GPIO_PIN_10
442   *         @arg @ref LL_GPIO_PIN_11
443   *         @arg @ref LL_GPIO_PIN_12
444   *         @arg @ref LL_GPIO_PIN_13
445   *         @arg @ref LL_GPIO_PIN_14
446   *         @arg @ref LL_GPIO_PIN_15
447   * @retval Returned value can be one of the following values:
448   *         @arg @ref LL_GPIO_SPEED_FREQ_LOW
449   *         @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
450   *         @arg @ref LL_GPIO_SPEED_FREQ_HIGH
451   *         @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
452   */
LL_GPIO_GetPinSpeed(GPIO_TypeDef * GPIOx,uint32_t Pin)453 __STATIC_INLINE uint32_t LL_GPIO_GetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin)
454 {
455   return (uint32_t)(READ_BIT(GPIOx->OSPEEDR, ((Pin * Pin) * GPIO_OSPEEDR_OSPEEDR0)) / (Pin * Pin));
456 }
457 
458 /**
459   * @brief  Configure gpio pull-up or pull-down for a dedicated pin on a dedicated port.
460   * @note   Warning: only one pin can be passed as parameter.
461   * @rmtoll PUPDR        PUPDy         LL_GPIO_SetPinPull
462   * @param  GPIOx GPIO Port
463   * @param  Pin This parameter can be one of the following values:
464   *         @arg @ref LL_GPIO_PIN_0
465   *         @arg @ref LL_GPIO_PIN_1
466   *         @arg @ref LL_GPIO_PIN_2
467   *         @arg @ref LL_GPIO_PIN_3
468   *         @arg @ref LL_GPIO_PIN_4
469   *         @arg @ref LL_GPIO_PIN_5
470   *         @arg @ref LL_GPIO_PIN_6
471   *         @arg @ref LL_GPIO_PIN_7
472   *         @arg @ref LL_GPIO_PIN_8
473   *         @arg @ref LL_GPIO_PIN_9
474   *         @arg @ref LL_GPIO_PIN_10
475   *         @arg @ref LL_GPIO_PIN_11
476   *         @arg @ref LL_GPIO_PIN_12
477   *         @arg @ref LL_GPIO_PIN_13
478   *         @arg @ref LL_GPIO_PIN_14
479   *         @arg @ref LL_GPIO_PIN_15
480   * @param  Pull This parameter can be one of the following values:
481   *         @arg @ref LL_GPIO_PULL_NO
482   *         @arg @ref LL_GPIO_PULL_UP
483   *         @arg @ref LL_GPIO_PULL_DOWN
484   * @retval None
485   */
LL_GPIO_SetPinPull(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Pull)486 __STATIC_INLINE void LL_GPIO_SetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Pull)
487 {
488   MODIFY_REG(GPIOx->PUPDR, ((Pin * Pin) * GPIO_PUPDR_PUPDR0), ((Pin * Pin) * Pull));
489 }
490 
491 /**
492   * @brief  Return gpio pull-up or pull-down for a dedicated pin on a dedicated port
493   * @note   Warning: only one pin can be passed as parameter.
494   * @rmtoll PUPDR        PUPDy         LL_GPIO_GetPinPull
495   * @param  GPIOx GPIO Port
496   * @param  Pin This parameter can be one of the following values:
497   *         @arg @ref LL_GPIO_PIN_0
498   *         @arg @ref LL_GPIO_PIN_1
499   *         @arg @ref LL_GPIO_PIN_2
500   *         @arg @ref LL_GPIO_PIN_3
501   *         @arg @ref LL_GPIO_PIN_4
502   *         @arg @ref LL_GPIO_PIN_5
503   *         @arg @ref LL_GPIO_PIN_6
504   *         @arg @ref LL_GPIO_PIN_7
505   *         @arg @ref LL_GPIO_PIN_8
506   *         @arg @ref LL_GPIO_PIN_9
507   *         @arg @ref LL_GPIO_PIN_10
508   *         @arg @ref LL_GPIO_PIN_11
509   *         @arg @ref LL_GPIO_PIN_12
510   *         @arg @ref LL_GPIO_PIN_13
511   *         @arg @ref LL_GPIO_PIN_14
512   *         @arg @ref LL_GPIO_PIN_15
513   * @retval Returned value can be one of the following values:
514   *         @arg @ref LL_GPIO_PULL_NO
515   *         @arg @ref LL_GPIO_PULL_UP
516   *         @arg @ref LL_GPIO_PULL_DOWN
517   */
LL_GPIO_GetPinPull(GPIO_TypeDef * GPIOx,uint32_t Pin)518 __STATIC_INLINE uint32_t LL_GPIO_GetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin)
519 {
520   return (uint32_t)(READ_BIT(GPIOx->PUPDR, ((Pin * Pin) * GPIO_PUPDR_PUPDR0)) / (Pin * Pin));
521 }
522 
523 /**
524   * @brief  Configure gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
525   * @note   Possible values are from AF0 to AF15 depending on target.
526   * @note   Warning: only one pin can be passed as parameter.
527   * @rmtoll AFRL         AFRy        LL_GPIO_SetAFPin_0_7
528   * @param  GPIOx GPIO Port
529   * @param  Pin This parameter can be one of the following values:
530   *         @arg @ref LL_GPIO_PIN_0
531   *         @arg @ref LL_GPIO_PIN_1
532   *         @arg @ref LL_GPIO_PIN_2
533   *         @arg @ref LL_GPIO_PIN_3
534   *         @arg @ref LL_GPIO_PIN_4
535   *         @arg @ref LL_GPIO_PIN_5
536   *         @arg @ref LL_GPIO_PIN_6
537   *         @arg @ref LL_GPIO_PIN_7
538   * @param  Alternate This parameter can be one of the following values:
539   *         @arg @ref LL_GPIO_AF_0
540   *         @arg @ref LL_GPIO_AF_1
541   *         @arg @ref LL_GPIO_AF_2
542   *         @arg @ref LL_GPIO_AF_3
543   *         @arg @ref LL_GPIO_AF_4
544   *         @arg @ref LL_GPIO_AF_5
545   *         @arg @ref LL_GPIO_AF_6
546   *         @arg @ref LL_GPIO_AF_7
547   *         @arg @ref LL_GPIO_AF_8
548   *         @arg @ref LL_GPIO_AF_9
549   *         @arg @ref LL_GPIO_AF_10
550   *         @arg @ref LL_GPIO_AF_11
551   *         @arg @ref LL_GPIO_AF_12
552   *         @arg @ref LL_GPIO_AF_13
553   *         @arg @ref LL_GPIO_AF_14
554   *         @arg @ref LL_GPIO_AF_15
555   * @retval None
556   */
LL_GPIO_SetAFPin_0_7(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)557 __STATIC_INLINE void LL_GPIO_SetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
558 {
559   MODIFY_REG(GPIOx->AFR[0], ((((Pin * Pin) * Pin) * Pin) * GPIO_AFRL_AFR0),
560              ((((Pin * Pin) * Pin) * Pin) * Alternate));
561 }
562 
563 /**
564   * @brief  Return gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
565   * @rmtoll AFRL         AFRy        LL_GPIO_GetAFPin_0_7
566   * @param  GPIOx GPIO Port
567   * @param  Pin This parameter can be one of the following values:
568   *         @arg @ref LL_GPIO_PIN_0
569   *         @arg @ref LL_GPIO_PIN_1
570   *         @arg @ref LL_GPIO_PIN_2
571   *         @arg @ref LL_GPIO_PIN_3
572   *         @arg @ref LL_GPIO_PIN_4
573   *         @arg @ref LL_GPIO_PIN_5
574   *         @arg @ref LL_GPIO_PIN_6
575   *         @arg @ref LL_GPIO_PIN_7
576   * @retval Returned value can be one of the following values:
577   *         @arg @ref LL_GPIO_AF_0
578   *         @arg @ref LL_GPIO_AF_1
579   *         @arg @ref LL_GPIO_AF_2
580   *         @arg @ref LL_GPIO_AF_3
581   *         @arg @ref LL_GPIO_AF_4
582   *         @arg @ref LL_GPIO_AF_5
583   *         @arg @ref LL_GPIO_AF_6
584   *         @arg @ref LL_GPIO_AF_7
585   *         @arg @ref LL_GPIO_AF_8
586   *         @arg @ref LL_GPIO_AF_9
587   *         @arg @ref LL_GPIO_AF_10
588   *         @arg @ref LL_GPIO_AF_11
589   *         @arg @ref LL_GPIO_AF_12
590   *         @arg @ref LL_GPIO_AF_13
591   *         @arg @ref LL_GPIO_AF_14
592   *         @arg @ref LL_GPIO_AF_15
593   */
LL_GPIO_GetAFPin_0_7(GPIO_TypeDef * GPIOx,uint32_t Pin)594 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin)
595 {
596   return (uint32_t)(READ_BIT(GPIOx->AFR[0],
597                              ((((Pin * Pin) * Pin) * Pin) * GPIO_AFRL_AFR0)) / (((Pin * Pin) * Pin) * Pin));
598 }
599 
600 /**
601   * @brief  Configure gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
602   * @note   Possible values are from AF0 to AF15 depending on target.
603   * @note   Warning: only one pin can be passed as parameter.
604   * @rmtoll AFRH         AFRy        LL_GPIO_SetAFPin_8_15
605   * @param  GPIOx GPIO Port
606   * @param  Pin This parameter can be one of the following values:
607   *         @arg @ref LL_GPIO_PIN_8
608   *         @arg @ref LL_GPIO_PIN_9
609   *         @arg @ref LL_GPIO_PIN_10
610   *         @arg @ref LL_GPIO_PIN_11
611   *         @arg @ref LL_GPIO_PIN_12
612   *         @arg @ref LL_GPIO_PIN_13
613   *         @arg @ref LL_GPIO_PIN_14
614   *         @arg @ref LL_GPIO_PIN_15
615   * @param  Alternate This parameter can be one of the following values:
616   *         @arg @ref LL_GPIO_AF_0
617   *         @arg @ref LL_GPIO_AF_1
618   *         @arg @ref LL_GPIO_AF_2
619   *         @arg @ref LL_GPIO_AF_3
620   *         @arg @ref LL_GPIO_AF_4
621   *         @arg @ref LL_GPIO_AF_5
622   *         @arg @ref LL_GPIO_AF_6
623   *         @arg @ref LL_GPIO_AF_7
624   *         @arg @ref LL_GPIO_AF_8
625   *         @arg @ref LL_GPIO_AF_9
626   *         @arg @ref LL_GPIO_AF_10
627   *         @arg @ref LL_GPIO_AF_11
628   *         @arg @ref LL_GPIO_AF_12
629   *         @arg @ref LL_GPIO_AF_13
630   *         @arg @ref LL_GPIO_AF_14
631   *         @arg @ref LL_GPIO_AF_15
632   * @retval None
633   */
LL_GPIO_SetAFPin_8_15(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)634 __STATIC_INLINE void LL_GPIO_SetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
635 {
636   MODIFY_REG(GPIOx->AFR[1], (((((Pin >> 8U) * (Pin >> 8U)) * (Pin >> 8U)) * (Pin >> 8U)) * GPIO_AFRH_AFR8),
637              (((((Pin >> 8U) * (Pin >> 8U)) * (Pin >> 8U)) * (Pin >> 8U)) * Alternate));
638 }
639 
640 /**
641   * @brief  Return gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
642   * @note   Possible values are from AF0 to AF15 depending on target.
643   * @rmtoll AFRH         AFRy        LL_GPIO_GetAFPin_8_15
644   * @param  GPIOx GPIO Port
645   * @param  Pin This parameter can be one of the following values:
646   *         @arg @ref LL_GPIO_PIN_8
647   *         @arg @ref LL_GPIO_PIN_9
648   *         @arg @ref LL_GPIO_PIN_10
649   *         @arg @ref LL_GPIO_PIN_11
650   *         @arg @ref LL_GPIO_PIN_12
651   *         @arg @ref LL_GPIO_PIN_13
652   *         @arg @ref LL_GPIO_PIN_14
653   *         @arg @ref LL_GPIO_PIN_15
654   * @retval Returned value can be one of the following values:
655   *         @arg @ref LL_GPIO_AF_0
656   *         @arg @ref LL_GPIO_AF_1
657   *         @arg @ref LL_GPIO_AF_2
658   *         @arg @ref LL_GPIO_AF_3
659   *         @arg @ref LL_GPIO_AF_4
660   *         @arg @ref LL_GPIO_AF_5
661   *         @arg @ref LL_GPIO_AF_6
662   *         @arg @ref LL_GPIO_AF_7
663   *         @arg @ref LL_GPIO_AF_8
664   *         @arg @ref LL_GPIO_AF_9
665   *         @arg @ref LL_GPIO_AF_10
666   *         @arg @ref LL_GPIO_AF_11
667   *         @arg @ref LL_GPIO_AF_12
668   *         @arg @ref LL_GPIO_AF_13
669   *         @arg @ref LL_GPIO_AF_14
670   *         @arg @ref LL_GPIO_AF_15
671   */
LL_GPIO_GetAFPin_8_15(GPIO_TypeDef * GPIOx,uint32_t Pin)672 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin)
673 {
674   return (uint32_t)(READ_BIT(GPIOx->AFR[1],
675                              (((((Pin >> 8U) * (Pin >> 8U)) * (Pin >> 8U)) * (Pin >> 8U)) * GPIO_AFRH_AFR8)) / ((((Pin >> 8U) *
676                                  (Pin >> 8U)) * (Pin >> 8U)) * (Pin >> 8U)));
677 }
678 
679 
680 /**
681   * @brief  Lock configuration of several pins for a dedicated port.
682   * @note   When the lock sequence has been applied on a port bit, the
683   *         value of this port bit can no longer be modified until the
684   *         next reset.
685   * @note   Each lock bit freezes a specific configuration register
686   *         (control and alternate function registers).
687   * @rmtoll LCKR         LCKK          LL_GPIO_LockPin
688   * @param  GPIOx GPIO Port
689   * @param  PinMask This parameter can be a combination of the following values:
690   *         @arg @ref LL_GPIO_PIN_0
691   *         @arg @ref LL_GPIO_PIN_1
692   *         @arg @ref LL_GPIO_PIN_2
693   *         @arg @ref LL_GPIO_PIN_3
694   *         @arg @ref LL_GPIO_PIN_4
695   *         @arg @ref LL_GPIO_PIN_5
696   *         @arg @ref LL_GPIO_PIN_6
697   *         @arg @ref LL_GPIO_PIN_7
698   *         @arg @ref LL_GPIO_PIN_8
699   *         @arg @ref LL_GPIO_PIN_9
700   *         @arg @ref LL_GPIO_PIN_10
701   *         @arg @ref LL_GPIO_PIN_11
702   *         @arg @ref LL_GPIO_PIN_12
703   *         @arg @ref LL_GPIO_PIN_13
704   *         @arg @ref LL_GPIO_PIN_14
705   *         @arg @ref LL_GPIO_PIN_15
706   *         @arg @ref LL_GPIO_PIN_ALL
707   * @retval None
708   */
LL_GPIO_LockPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)709 __STATIC_INLINE void LL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
710 {
711   __IO uint32_t temp;
712   WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
713   WRITE_REG(GPIOx->LCKR, PinMask);
714   WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
715   /* Read LCKK register. This read is mandatory to complete key lock sequence */
716   temp = READ_REG(GPIOx->LCKR);
717   (void) temp;
718 }
719 
720 /**
721   * @brief  Return 1 if all pins passed as parameter, of a dedicated port, are locked. else Return 0.
722   * @rmtoll LCKR         LCKy          LL_GPIO_IsPinLocked
723   * @param  GPIOx GPIO Port
724   * @param  PinMask This parameter can be a combination of the following values:
725   *         @arg @ref LL_GPIO_PIN_0
726   *         @arg @ref LL_GPIO_PIN_1
727   *         @arg @ref LL_GPIO_PIN_2
728   *         @arg @ref LL_GPIO_PIN_3
729   *         @arg @ref LL_GPIO_PIN_4
730   *         @arg @ref LL_GPIO_PIN_5
731   *         @arg @ref LL_GPIO_PIN_6
732   *         @arg @ref LL_GPIO_PIN_7
733   *         @arg @ref LL_GPIO_PIN_8
734   *         @arg @ref LL_GPIO_PIN_9
735   *         @arg @ref LL_GPIO_PIN_10
736   *         @arg @ref LL_GPIO_PIN_11
737   *         @arg @ref LL_GPIO_PIN_12
738   *         @arg @ref LL_GPIO_PIN_13
739   *         @arg @ref LL_GPIO_PIN_14
740   *         @arg @ref LL_GPIO_PIN_15
741   *         @arg @ref LL_GPIO_PIN_ALL
742   * @retval State of bit (1 or 0).
743   */
LL_GPIO_IsPinLocked(GPIO_TypeDef * GPIOx,uint32_t PinMask)744 __STATIC_INLINE uint32_t LL_GPIO_IsPinLocked(GPIO_TypeDef *GPIOx, uint32_t PinMask)
745 {
746   return (READ_BIT(GPIOx->LCKR, PinMask) == (PinMask));
747 }
748 
749 /**
750   * @brief  Return 1 if one of the pin of a dedicated port is locked. else return 0.
751   * @rmtoll LCKR         LCKK          LL_GPIO_IsAnyPinLocked
752   * @param  GPIOx GPIO Port
753   * @retval State of bit (1 or 0).
754   */
LL_GPIO_IsAnyPinLocked(GPIO_TypeDef * GPIOx)755 __STATIC_INLINE uint32_t LL_GPIO_IsAnyPinLocked(GPIO_TypeDef *GPIOx)
756 {
757   return (READ_BIT(GPIOx->LCKR, GPIO_LCKR_LCKK) == (GPIO_LCKR_LCKK));
758 }
759 
760 /**
761   * @}
762   */
763 
764 /** @defgroup GPIO_LL_EF_Data_Access Data Access
765   * @{
766   */
767 
768 /**
769   * @brief  Return full input data register value for a dedicated port.
770   * @rmtoll IDR          IDy           LL_GPIO_ReadInputPort
771   * @param  GPIOx GPIO Port
772   * @retval Input data register value of port
773   */
LL_GPIO_ReadInputPort(GPIO_TypeDef * GPIOx)774 __STATIC_INLINE uint32_t LL_GPIO_ReadInputPort(GPIO_TypeDef *GPIOx)
775 {
776   return (uint32_t)(READ_REG(GPIOx->IDR));
777 }
778 
779 /**
780   * @brief  Return if input data level for several pins of dedicated port is high or low.
781   * @rmtoll IDR          IDy           LL_GPIO_IsInputPinSet
782   * @param  GPIOx GPIO Port
783   * @param  PinMask This parameter can be a combination of the following values:
784   *         @arg @ref LL_GPIO_PIN_0
785   *         @arg @ref LL_GPIO_PIN_1
786   *         @arg @ref LL_GPIO_PIN_2
787   *         @arg @ref LL_GPIO_PIN_3
788   *         @arg @ref LL_GPIO_PIN_4
789   *         @arg @ref LL_GPIO_PIN_5
790   *         @arg @ref LL_GPIO_PIN_6
791   *         @arg @ref LL_GPIO_PIN_7
792   *         @arg @ref LL_GPIO_PIN_8
793   *         @arg @ref LL_GPIO_PIN_9
794   *         @arg @ref LL_GPIO_PIN_10
795   *         @arg @ref LL_GPIO_PIN_11
796   *         @arg @ref LL_GPIO_PIN_12
797   *         @arg @ref LL_GPIO_PIN_13
798   *         @arg @ref LL_GPIO_PIN_14
799   *         @arg @ref LL_GPIO_PIN_15
800   *         @arg @ref LL_GPIO_PIN_ALL
801   * @retval State of bit (1 or 0).
802   */
LL_GPIO_IsInputPinSet(GPIO_TypeDef * GPIOx,uint32_t PinMask)803 __STATIC_INLINE uint32_t LL_GPIO_IsInputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
804 {
805   return (READ_BIT(GPIOx->IDR, PinMask) == (PinMask));
806 }
807 
808 /**
809   * @brief  Write output data register for the port.
810   * @rmtoll ODR          ODy           LL_GPIO_WriteOutputPort
811   * @param  GPIOx GPIO Port
812   * @param  PortValue Level value for each pin of the port
813   * @retval None
814   */
LL_GPIO_WriteOutputPort(GPIO_TypeDef * GPIOx,uint32_t PortValue)815 __STATIC_INLINE void LL_GPIO_WriteOutputPort(GPIO_TypeDef *GPIOx, uint32_t PortValue)
816 {
817   WRITE_REG(GPIOx->ODR, PortValue);
818 }
819 
820 /**
821   * @brief  Return full output data register value for a dedicated port.
822   * @rmtoll ODR          ODy           LL_GPIO_ReadOutputPort
823   * @param  GPIOx GPIO Port
824   * @retval Output data register value of port
825   */
LL_GPIO_ReadOutputPort(GPIO_TypeDef * GPIOx)826 __STATIC_INLINE uint32_t LL_GPIO_ReadOutputPort(GPIO_TypeDef *GPIOx)
827 {
828   return (uint32_t)(READ_REG(GPIOx->ODR));
829 }
830 
831 /**
832   * @brief  Return if input data level for several pins of dedicated port is high or low.
833   * @rmtoll ODR          ODy           LL_GPIO_IsOutputPinSet
834   * @param  GPIOx GPIO Port
835   * @param  PinMask This parameter can be a combination of the following values:
836   *         @arg @ref LL_GPIO_PIN_0
837   *         @arg @ref LL_GPIO_PIN_1
838   *         @arg @ref LL_GPIO_PIN_2
839   *         @arg @ref LL_GPIO_PIN_3
840   *         @arg @ref LL_GPIO_PIN_4
841   *         @arg @ref LL_GPIO_PIN_5
842   *         @arg @ref LL_GPIO_PIN_6
843   *         @arg @ref LL_GPIO_PIN_7
844   *         @arg @ref LL_GPIO_PIN_8
845   *         @arg @ref LL_GPIO_PIN_9
846   *         @arg @ref LL_GPIO_PIN_10
847   *         @arg @ref LL_GPIO_PIN_11
848   *         @arg @ref LL_GPIO_PIN_12
849   *         @arg @ref LL_GPIO_PIN_13
850   *         @arg @ref LL_GPIO_PIN_14
851   *         @arg @ref LL_GPIO_PIN_15
852   *         @arg @ref LL_GPIO_PIN_ALL
853   * @retval State of bit (1 or 0).
854   */
LL_GPIO_IsOutputPinSet(GPIO_TypeDef * GPIOx,uint32_t PinMask)855 __STATIC_INLINE uint32_t LL_GPIO_IsOutputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
856 {
857   return (READ_BIT(GPIOx->ODR, PinMask) == (PinMask));
858 }
859 
860 /**
861   * @brief  Set several pins to high level on dedicated gpio port.
862   * @rmtoll BSRR         BSy           LL_GPIO_SetOutputPin
863   * @param  GPIOx GPIO Port
864   * @param  PinMask This parameter can be a combination of the following values:
865   *         @arg @ref LL_GPIO_PIN_0
866   *         @arg @ref LL_GPIO_PIN_1
867   *         @arg @ref LL_GPIO_PIN_2
868   *         @arg @ref LL_GPIO_PIN_3
869   *         @arg @ref LL_GPIO_PIN_4
870   *         @arg @ref LL_GPIO_PIN_5
871   *         @arg @ref LL_GPIO_PIN_6
872   *         @arg @ref LL_GPIO_PIN_7
873   *         @arg @ref LL_GPIO_PIN_8
874   *         @arg @ref LL_GPIO_PIN_9
875   *         @arg @ref LL_GPIO_PIN_10
876   *         @arg @ref LL_GPIO_PIN_11
877   *         @arg @ref LL_GPIO_PIN_12
878   *         @arg @ref LL_GPIO_PIN_13
879   *         @arg @ref LL_GPIO_PIN_14
880   *         @arg @ref LL_GPIO_PIN_15
881   *         @arg @ref LL_GPIO_PIN_ALL
882   * @retval None
883   */
LL_GPIO_SetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)884 __STATIC_INLINE void LL_GPIO_SetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
885 {
886   WRITE_REG(GPIOx->BSRR, PinMask);
887 }
888 
889 /**
890   * @brief  Set several pins to low level on dedicated gpio port.
891   * @rmtoll BSRR         BRy           LL_GPIO_ResetOutputPin
892   * @param  GPIOx GPIO Port
893   * @param  PinMask This parameter can be a combination of the following values:
894   *         @arg @ref LL_GPIO_PIN_0
895   *         @arg @ref LL_GPIO_PIN_1
896   *         @arg @ref LL_GPIO_PIN_2
897   *         @arg @ref LL_GPIO_PIN_3
898   *         @arg @ref LL_GPIO_PIN_4
899   *         @arg @ref LL_GPIO_PIN_5
900   *         @arg @ref LL_GPIO_PIN_6
901   *         @arg @ref LL_GPIO_PIN_7
902   *         @arg @ref LL_GPIO_PIN_8
903   *         @arg @ref LL_GPIO_PIN_9
904   *         @arg @ref LL_GPIO_PIN_10
905   *         @arg @ref LL_GPIO_PIN_11
906   *         @arg @ref LL_GPIO_PIN_12
907   *         @arg @ref LL_GPIO_PIN_13
908   *         @arg @ref LL_GPIO_PIN_14
909   *         @arg @ref LL_GPIO_PIN_15
910   *         @arg @ref LL_GPIO_PIN_ALL
911   * @retval None
912   */
LL_GPIO_ResetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)913 __STATIC_INLINE void LL_GPIO_ResetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
914 {
915   WRITE_REG(GPIOx->BSRR, PinMask << 16U);
916 }
917 
918 /**
919   * @brief  Toggle data value for several pin of dedicated port.
920   * @rmtoll ODR          ODy           LL_GPIO_TogglePin
921   * @param  GPIOx GPIO Port
922   * @param  PinMask This parameter can be a combination of the following values:
923   *         @arg @ref LL_GPIO_PIN_0
924   *         @arg @ref LL_GPIO_PIN_1
925   *         @arg @ref LL_GPIO_PIN_2
926   *         @arg @ref LL_GPIO_PIN_3
927   *         @arg @ref LL_GPIO_PIN_4
928   *         @arg @ref LL_GPIO_PIN_5
929   *         @arg @ref LL_GPIO_PIN_6
930   *         @arg @ref LL_GPIO_PIN_7
931   *         @arg @ref LL_GPIO_PIN_8
932   *         @arg @ref LL_GPIO_PIN_9
933   *         @arg @ref LL_GPIO_PIN_10
934   *         @arg @ref LL_GPIO_PIN_11
935   *         @arg @ref LL_GPIO_PIN_12
936   *         @arg @ref LL_GPIO_PIN_13
937   *         @arg @ref LL_GPIO_PIN_14
938   *         @arg @ref LL_GPIO_PIN_15
939   *         @arg @ref LL_GPIO_PIN_ALL
940   * @retval None
941   */
LL_GPIO_TogglePin(GPIO_TypeDef * GPIOx,uint32_t PinMask)942 __STATIC_INLINE void LL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
943 {
944   WRITE_REG(GPIOx->ODR, READ_REG(GPIOx->ODR) ^ PinMask);
945 }
946 
947 /**
948   * @}
949   */
950 
951 #if defined(USE_FULL_LL_DRIVER)
952 /** @defgroup GPIO_LL_EF_Init Initialization and de-initialization functions
953   * @{
954   */
955 
956 ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx);
957 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct);
958 void        LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct);
959 
960 /**
961   * @}
962   */
963 #endif /* USE_FULL_LL_DRIVER */
964 
965 /**
966   * @}
967   */
968 
969 /**
970   * @}
971   */
972 
973 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) */
974 /**
975   * @}
976   */
977 
978 #ifdef __cplusplus
979 }
980 #endif
981 
982 #endif /* __STM32MP1xx_LL_GPIO_H */
983