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