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