2 ******************************************************************************
3 * @file stm32h7xx_ll_gpio.h
4 * @author MCD Application Team
5 * @brief Header file of GPIO LL module.
6 ******************************************************************************
9 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics.
10 * All rights reserved.</center></h2>
12 * This software component is licensed by ST under BSD 3-Clause license,
13 * the "License"; You may not use this file except in compliance with the
14 * License. You may obtain a copy of the License at:
15 * opensource.org/licenses/BSD-3-Clause
17 ******************************************************************************
20 /* Define to prevent recursive inclusion -------------------------------------*/
21 #ifndef STM32H7xx_LL_GPIO_H
22 #define STM32H7xx_LL_GPIO_H
28 /* Includes ------------------------------------------------------------------*/
29 #include "stm32h7xx.h"
31 /** @addtogroup STM32H7xx_LL_Driver
35 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI) || defined (GPIOJ) || defined (GPIOK)
37 /** @defgroup GPIO_LL GPIO
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
53 #endif /*USE_FULL_LL_DRIVER*/
55 /* Exported types ------------------------------------------------------------*/
56 #if defined(USE_FULL_LL_DRIVER)
57 /** @defgroup GPIO_LL_ES_INIT GPIO Exported Init structures
62 * @brief LL GPIO Init Structure definition
66 uint32_t Pin
; /*!< Specifies the GPIO pins to be configured.
67 This parameter can be any value of @ref GPIO_LL_EC_PIN */
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.
72 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinMode().*/
74 uint32_t Speed
; /*!< Specifies the speed for the selected pins.
75 This parameter can be a value of @ref GPIO_LL_EC_SPEED.
77 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinSpeed().*/
79 uint32_t OutputType
; /*!< Specifies the operating output type for the selected pins.
80 This parameter can be a value of @ref GPIO_LL_EC_OUTPUT.
82 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinOutputType().*/
84 uint32_t Pull
; /*!< Specifies the operating Pull-up/Pull down for the selected pins.
85 This parameter can be a value of @ref GPIO_LL_EC_PULL.
87 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinPull().*/
89 uint32_t Alternate
; /*!< Specifies the Peripheral to be connected to the selected pins.
90 This parameter can be a value of @ref GPIO_LL_EC_AF.
92 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetAFPin_0_7() and LL_GPIO_SetAFPin_8_15().*/
93 } LL_GPIO_InitTypeDef
;
98 #endif /* USE_FULL_LL_DRIVER */
100 /* Exported constants --------------------------------------------------------*/
101 /** @defgroup GPIO_LL_Exported_Constants GPIO Exported Constants
105 /** @defgroup GPIO_LL_EC_PIN PIN
108 #define LL_GPIO_PIN_0 GPIO_BSRR_BS0 /*!< Select pin 0 */
109 #define LL_GPIO_PIN_1 GPIO_BSRR_BS1 /*!< Select pin 1 */
110 #define LL_GPIO_PIN_2 GPIO_BSRR_BS2 /*!< Select pin 2 */
111 #define LL_GPIO_PIN_3 GPIO_BSRR_BS3 /*!< Select pin 3 */
112 #define LL_GPIO_PIN_4 GPIO_BSRR_BS4 /*!< Select pin 4 */
113 #define LL_GPIO_PIN_5 GPIO_BSRR_BS5 /*!< Select pin 5 */
114 #define LL_GPIO_PIN_6 GPIO_BSRR_BS6 /*!< Select pin 6 */
115 #define LL_GPIO_PIN_7 GPIO_BSRR_BS7 /*!< Select pin 7 */
116 #define LL_GPIO_PIN_8 GPIO_BSRR_BS8 /*!< Select pin 8 */
117 #define LL_GPIO_PIN_9 GPIO_BSRR_BS9 /*!< Select pin 9 */
118 #define LL_GPIO_PIN_10 GPIO_BSRR_BS10 /*!< Select pin 10 */
119 #define LL_GPIO_PIN_11 GPIO_BSRR_BS11 /*!< Select pin 11 */
120 #define LL_GPIO_PIN_12 GPIO_BSRR_BS12 /*!< Select pin 12 */
121 #define LL_GPIO_PIN_13 GPIO_BSRR_BS13 /*!< Select pin 13 */
122 #define LL_GPIO_PIN_14 GPIO_BSRR_BS14 /*!< Select pin 14 */
123 #define LL_GPIO_PIN_15 GPIO_BSRR_BS15 /*!< Select pin 15 */
124 #define LL_GPIO_PIN_ALL (GPIO_BSRR_BS0 | GPIO_BSRR_BS1 | GPIO_BSRR_BS2 | \
125 GPIO_BSRR_BS3 | GPIO_BSRR_BS4 | GPIO_BSRR_BS5 | \
126 GPIO_BSRR_BS6 | GPIO_BSRR_BS7 | GPIO_BSRR_BS8 | \
127 GPIO_BSRR_BS9 | GPIO_BSRR_BS10 | GPIO_BSRR_BS11 | \
128 GPIO_BSRR_BS12 | GPIO_BSRR_BS13 | GPIO_BSRR_BS14 | \
129 GPIO_BSRR_BS15) /*!< Select all pins */
134 /** @defgroup GPIO_LL_EC_MODE Mode
137 #define LL_GPIO_MODE_INPUT (0x00000000U) /*!< Select input mode */
138 #define LL_GPIO_MODE_OUTPUT GPIO_MODER_MODE0_0 /*!< Select output mode */
139 #define LL_GPIO_MODE_ALTERNATE GPIO_MODER_MODE0_1 /*!< Select alternate function mode */
140 #define LL_GPIO_MODE_ANALOG GPIO_MODER_MODE0 /*!< Select analog mode */
145 /** @defgroup GPIO_LL_EC_OUTPUT Output Type
148 #define LL_GPIO_OUTPUT_PUSHPULL (0x00000000U) /*!< Select push-pull as output type */
149 #define LL_GPIO_OUTPUT_OPENDRAIN GPIO_OTYPER_OT0 /*!< Select open-drain as output type */
154 /** @defgroup GPIO_LL_EC_SPEED Output Speed
157 #define LL_GPIO_SPEED_FREQ_LOW (0x00000000U) /*!< Select I/O low output speed */
158 #define LL_GPIO_SPEED_FREQ_MEDIUM GPIO_OSPEEDR_OSPEED0_0 /*!< Select I/O medium output speed */
159 #define LL_GPIO_SPEED_FREQ_HIGH GPIO_OSPEEDR_OSPEED0_1 /*!< Select I/O fast output speed */
160 #define LL_GPIO_SPEED_FREQ_VERY_HIGH GPIO_OSPEEDR_OSPEED0 /*!< Select I/O high output speed */
164 #define LL_GPIO_SPEED_LOW LL_GPIO_SPEED_FREQ_LOW
165 #define LL_GPIO_SPEED_MEDIUM LL_GPIO_SPEED_FREQ_MEDIUM
166 #define LL_GPIO_SPEED_FAST LL_GPIO_SPEED_FREQ_HIGH
167 #define LL_GPIO_SPEED_HIGH LL_GPIO_SPEED_FREQ_VERY_HIGH
170 /** @defgroup GPIO_LL_EC_PULL Pull Up Pull Down
173 #define LL_GPIO_PULL_NO (0x00000000U) /*!< Select I/O no pull */
174 #define LL_GPIO_PULL_UP GPIO_PUPDR_PUPD0_0 /*!< Select I/O pull up */
175 #define LL_GPIO_PULL_DOWN GPIO_PUPDR_PUPD0_1 /*!< Select I/O pull down */
180 /** @defgroup GPIO_LL_EC_AF Alternate Function
183 #define LL_GPIO_AF_0 (0x0000000U) /*!< Select alternate function 0 */
184 #define LL_GPIO_AF_1 (0x0000001U) /*!< Select alternate function 1 */
185 #define LL_GPIO_AF_2 (0x0000002U) /*!< Select alternate function 2 */
186 #define LL_GPIO_AF_3 (0x0000003U) /*!< Select alternate function 3 */
187 #define LL_GPIO_AF_4 (0x0000004U) /*!< Select alternate function 4 */
188 #define LL_GPIO_AF_5 (0x0000005U) /*!< Select alternate function 5 */
189 #define LL_GPIO_AF_6 (0x0000006U) /*!< Select alternate function 6 */
190 #define LL_GPIO_AF_7 (0x0000007U) /*!< Select alternate function 7 */
191 #define LL_GPIO_AF_8 (0x0000008U) /*!< Select alternate function 8 */
192 #define LL_GPIO_AF_9 (0x0000009U) /*!< Select alternate function 9 */
193 #define LL_GPIO_AF_10 (0x000000AU) /*!< Select alternate function 10 */
194 #define LL_GPIO_AF_11 (0x000000BU) /*!< Select alternate function 11 */
195 #define LL_GPIO_AF_12 (0x000000CU) /*!< Select alternate function 12 */
196 #define LL_GPIO_AF_13 (0x000000DU) /*!< Select alternate function 13 */
197 #define LL_GPIO_AF_14 (0x000000EU) /*!< Select alternate function 14 */
198 #define LL_GPIO_AF_15 (0x000000FU) /*!< Select alternate function 15 */
207 /* Exported macro ------------------------------------------------------------*/
208 /** @defgroup GPIO_LL_Exported_Macros GPIO Exported Macros
212 /** @defgroup GPIO_LL_EM_WRITE_READ Common Write and read registers Macros
217 * @brief Write a value in GPIO register
218 * @param __INSTANCE__ GPIO Instance
219 * @param __REG__ Register to be written
220 * @param __VALUE__ Value to be written in the register
223 #define LL_GPIO_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
226 * @brief Read a value in GPIO register
227 * @param __INSTANCE__ GPIO Instance
228 * @param __REG__ Register to be read
229 * @retval Register value
231 #define LL_GPIO_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
240 /* Exported functions --------------------------------------------------------*/
241 /** @defgroup GPIO_LL_Exported_Functions GPIO Exported Functions
245 /** @defgroup GPIO_LL_EF_Port_Configuration Port Configuration
250 * @brief Configure gpio mode for a dedicated pin on dedicated port.
251 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
252 * @note Warning: only one pin can be passed as parameter.
253 * @rmtoll MODER MODEy LL_GPIO_SetPinMode
254 * @param GPIOx GPIO Port
255 * @param Pin This parameter can be one of the following values:
256 * @arg @ref LL_GPIO_PIN_0
257 * @arg @ref LL_GPIO_PIN_1
258 * @arg @ref LL_GPIO_PIN_2
259 * @arg @ref LL_GPIO_PIN_3
260 * @arg @ref LL_GPIO_PIN_4
261 * @arg @ref LL_GPIO_PIN_5
262 * @arg @ref LL_GPIO_PIN_6
263 * @arg @ref LL_GPIO_PIN_7
264 * @arg @ref LL_GPIO_PIN_8
265 * @arg @ref LL_GPIO_PIN_9
266 * @arg @ref LL_GPIO_PIN_10
267 * @arg @ref LL_GPIO_PIN_11
268 * @arg @ref LL_GPIO_PIN_12
269 * @arg @ref LL_GPIO_PIN_13
270 * @arg @ref LL_GPIO_PIN_14
271 * @arg @ref LL_GPIO_PIN_15
272 * @param Mode This parameter can be one of the following values:
273 * @arg @ref LL_GPIO_MODE_INPUT
274 * @arg @ref LL_GPIO_MODE_OUTPUT
275 * @arg @ref LL_GPIO_MODE_ALTERNATE
276 * @arg @ref LL_GPIO_MODE_ANALOG
279 __STATIC_INLINE
void LL_GPIO_SetPinMode(GPIO_TypeDef
*GPIOx
, uint32_t Pin
, uint32_t Mode
)
281 MODIFY_REG(GPIOx
->MODER
, ((Pin
* Pin
) * GPIO_MODER_MODE0
), ((Pin
* Pin
) * Mode
));
285 * @brief Return gpio mode for a dedicated pin on dedicated port.
286 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
287 * @note Warning: only one pin can be passed as parameter.
288 * @rmtoll MODER MODEy LL_GPIO_GetPinMode
289 * @param GPIOx GPIO Port
290 * @param Pin This parameter can be one of the following values:
291 * @arg @ref LL_GPIO_PIN_0
292 * @arg @ref LL_GPIO_PIN_1
293 * @arg @ref LL_GPIO_PIN_2
294 * @arg @ref LL_GPIO_PIN_3
295 * @arg @ref LL_GPIO_PIN_4
296 * @arg @ref LL_GPIO_PIN_5
297 * @arg @ref LL_GPIO_PIN_6
298 * @arg @ref LL_GPIO_PIN_7
299 * @arg @ref LL_GPIO_PIN_8
300 * @arg @ref LL_GPIO_PIN_9
301 * @arg @ref LL_GPIO_PIN_10
302 * @arg @ref LL_GPIO_PIN_11
303 * @arg @ref LL_GPIO_PIN_12
304 * @arg @ref LL_GPIO_PIN_13
305 * @arg @ref LL_GPIO_PIN_14
306 * @arg @ref LL_GPIO_PIN_15
307 * @retval Returned value can be one of the following values:
308 * @arg @ref LL_GPIO_MODE_INPUT
309 * @arg @ref LL_GPIO_MODE_OUTPUT
310 * @arg @ref LL_GPIO_MODE_ALTERNATE
311 * @arg @ref LL_GPIO_MODE_ANALOG
313 __STATIC_INLINE
uint32_t LL_GPIO_GetPinMode(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
315 return (uint32_t)(READ_BIT(GPIOx
->MODER
, ((Pin
* Pin
) * GPIO_MODER_MODE0
)) / (Pin
* Pin
));
319 * @brief Configure gpio output type for several pins on dedicated port.
320 * @note Output type as to be set when gpio pin is in output or
321 * alternate modes. Possible type are Push-pull or Open-drain.
322 * @rmtoll OTYPER OTy LL_GPIO_SetPinOutputType
323 * @param GPIOx GPIO Port
324 * @param PinMask This parameter can be a combination of the following values:
325 * @arg @ref LL_GPIO_PIN_0
326 * @arg @ref LL_GPIO_PIN_1
327 * @arg @ref LL_GPIO_PIN_2
328 * @arg @ref LL_GPIO_PIN_3
329 * @arg @ref LL_GPIO_PIN_4
330 * @arg @ref LL_GPIO_PIN_5
331 * @arg @ref LL_GPIO_PIN_6
332 * @arg @ref LL_GPIO_PIN_7
333 * @arg @ref LL_GPIO_PIN_8
334 * @arg @ref LL_GPIO_PIN_9
335 * @arg @ref LL_GPIO_PIN_10
336 * @arg @ref LL_GPIO_PIN_11
337 * @arg @ref LL_GPIO_PIN_12
338 * @arg @ref LL_GPIO_PIN_13
339 * @arg @ref LL_GPIO_PIN_14
340 * @arg @ref LL_GPIO_PIN_15
341 * @arg @ref LL_GPIO_PIN_ALL
342 * @param OutputType This parameter can be one of the following values:
343 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
344 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
347 __STATIC_INLINE
void LL_GPIO_SetPinOutputType(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
, uint32_t OutputType
)
349 MODIFY_REG(GPIOx
->OTYPER
, PinMask
, (PinMask
* OutputType
));
353 * @brief Return gpio output type for several pins on dedicated port.
354 * @note Output type as to be set when gpio pin is in output or
355 * alternate modes. Possible type are Push-pull or Open-drain.
356 * @note Warning: only one pin can be passed as parameter.
357 * @rmtoll OTYPER OTy LL_GPIO_GetPinOutputType
358 * @param GPIOx GPIO Port
359 * @param Pin This parameter can be one of the following values:
360 * @arg @ref LL_GPIO_PIN_0
361 * @arg @ref LL_GPIO_PIN_1
362 * @arg @ref LL_GPIO_PIN_2
363 * @arg @ref LL_GPIO_PIN_3
364 * @arg @ref LL_GPIO_PIN_4
365 * @arg @ref LL_GPIO_PIN_5
366 * @arg @ref LL_GPIO_PIN_6
367 * @arg @ref LL_GPIO_PIN_7
368 * @arg @ref LL_GPIO_PIN_8
369 * @arg @ref LL_GPIO_PIN_9
370 * @arg @ref LL_GPIO_PIN_10
371 * @arg @ref LL_GPIO_PIN_11
372 * @arg @ref LL_GPIO_PIN_12
373 * @arg @ref LL_GPIO_PIN_13
374 * @arg @ref LL_GPIO_PIN_14
375 * @arg @ref LL_GPIO_PIN_15
376 * @arg @ref LL_GPIO_PIN_ALL
377 * @retval Returned value can be one of the following values:
378 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
379 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
381 __STATIC_INLINE
uint32_t LL_GPIO_GetPinOutputType(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
383 return (uint32_t)(READ_BIT(GPIOx
->OTYPER
, Pin
) / Pin
);
387 * @brief Configure gpio speed for a dedicated pin on dedicated port.
388 * @note I/O speed can be Low, Medium, Fast or High speed.
389 * @note Warning: only one pin can be passed as parameter.
390 * @note Refer to datasheet for frequency specifications and the power
391 * supply and load conditions for each speed.
392 * @rmtoll OSPEEDR OSPEEDy LL_GPIO_SetPinSpeed
393 * @param GPIOx GPIO Port
394 * @param Pin This parameter can be one of the following values:
395 * @arg @ref LL_GPIO_PIN_0
396 * @arg @ref LL_GPIO_PIN_1
397 * @arg @ref LL_GPIO_PIN_2
398 * @arg @ref LL_GPIO_PIN_3
399 * @arg @ref LL_GPIO_PIN_4
400 * @arg @ref LL_GPIO_PIN_5
401 * @arg @ref LL_GPIO_PIN_6
402 * @arg @ref LL_GPIO_PIN_7
403 * @arg @ref LL_GPIO_PIN_8
404 * @arg @ref LL_GPIO_PIN_9
405 * @arg @ref LL_GPIO_PIN_10
406 * @arg @ref LL_GPIO_PIN_11
407 * @arg @ref LL_GPIO_PIN_12
408 * @arg @ref LL_GPIO_PIN_13
409 * @arg @ref LL_GPIO_PIN_14
410 * @arg @ref LL_GPIO_PIN_15
411 * @param Speed This parameter can be one of the following values:
412 * @arg @ref LL_GPIO_SPEED_FREQ_LOW
413 * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
414 * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
415 * @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
418 __STATIC_INLINE
void LL_GPIO_SetPinSpeed(GPIO_TypeDef
*GPIOx
, uint32_t Pin
, uint32_t Speed
)
420 MODIFY_REG(GPIOx
->OSPEEDR
, ((Pin
* Pin
) * GPIO_OSPEEDR_OSPEED0
), ((Pin
* Pin
) * Speed
));
424 * @brief Return gpio speed for a dedicated pin on dedicated port.
425 * @note I/O speed can be Low, Medium, Fast or High speed.
426 * @note Warning: only one pin can be passed as parameter.
427 * @note Refer to datasheet for frequency specifications and the power
428 * supply and load conditions for each speed.
429 * @rmtoll OSPEEDR OSPEEDy LL_GPIO_GetPinSpeed
430 * @param GPIOx GPIO Port
431 * @param Pin This parameter can be one of the following values:
432 * @arg @ref LL_GPIO_PIN_0
433 * @arg @ref LL_GPIO_PIN_1
434 * @arg @ref LL_GPIO_PIN_2
435 * @arg @ref LL_GPIO_PIN_3
436 * @arg @ref LL_GPIO_PIN_4
437 * @arg @ref LL_GPIO_PIN_5
438 * @arg @ref LL_GPIO_PIN_6
439 * @arg @ref LL_GPIO_PIN_7
440 * @arg @ref LL_GPIO_PIN_8
441 * @arg @ref LL_GPIO_PIN_9
442 * @arg @ref LL_GPIO_PIN_10
443 * @arg @ref LL_GPIO_PIN_11
444 * @arg @ref LL_GPIO_PIN_12
445 * @arg @ref LL_GPIO_PIN_13
446 * @arg @ref LL_GPIO_PIN_14
447 * @arg @ref LL_GPIO_PIN_15
448 * @retval Returned value can be one of the following values:
449 * @arg @ref LL_GPIO_SPEED_FREQ_LOW
450 * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
451 * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
452 * @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
454 __STATIC_INLINE
uint32_t LL_GPIO_GetPinSpeed(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
456 return (uint32_t)(READ_BIT(GPIOx
->OSPEEDR
, ((Pin
* Pin
) * GPIO_OSPEEDR_OSPEED0
)) / (Pin
* Pin
));
460 * @brief Configure gpio pull-up or pull-down for a dedicated pin on a dedicated port.
461 * @note Warning: only one pin can be passed as parameter.
462 * @rmtoll PUPDR PUPDy LL_GPIO_SetPinPull
463 * @param GPIOx GPIO Port
464 * @param Pin This parameter can be one of the following values:
465 * @arg @ref LL_GPIO_PIN_0
466 * @arg @ref LL_GPIO_PIN_1
467 * @arg @ref LL_GPIO_PIN_2
468 * @arg @ref LL_GPIO_PIN_3
469 * @arg @ref LL_GPIO_PIN_4
470 * @arg @ref LL_GPIO_PIN_5
471 * @arg @ref LL_GPIO_PIN_6
472 * @arg @ref LL_GPIO_PIN_7
473 * @arg @ref LL_GPIO_PIN_8
474 * @arg @ref LL_GPIO_PIN_9
475 * @arg @ref LL_GPIO_PIN_10
476 * @arg @ref LL_GPIO_PIN_11
477 * @arg @ref LL_GPIO_PIN_12
478 * @arg @ref LL_GPIO_PIN_13
479 * @arg @ref LL_GPIO_PIN_14
480 * @arg @ref LL_GPIO_PIN_15
481 * @param Pull This parameter can be one of the following values:
482 * @arg @ref LL_GPIO_PULL_NO
483 * @arg @ref LL_GPIO_PULL_UP
484 * @arg @ref LL_GPIO_PULL_DOWN
487 __STATIC_INLINE
void LL_GPIO_SetPinPull(GPIO_TypeDef
*GPIOx
, uint32_t Pin
, uint32_t Pull
)
489 MODIFY_REG(GPIOx
->PUPDR
, ((Pin
* Pin
) * GPIO_PUPDR_PUPD0
), ((Pin
* Pin
) * Pull
));
493 * @brief Return gpio pull-up or pull-down for a dedicated pin on a dedicated port
494 * @note Warning: only one pin can be passed as parameter.
495 * @rmtoll PUPDR PUPDy LL_GPIO_GetPinPull
496 * @param GPIOx GPIO Port
497 * @param Pin This parameter can be one of the following values:
498 * @arg @ref LL_GPIO_PIN_0
499 * @arg @ref LL_GPIO_PIN_1
500 * @arg @ref LL_GPIO_PIN_2
501 * @arg @ref LL_GPIO_PIN_3
502 * @arg @ref LL_GPIO_PIN_4
503 * @arg @ref LL_GPIO_PIN_5
504 * @arg @ref LL_GPIO_PIN_6
505 * @arg @ref LL_GPIO_PIN_7
506 * @arg @ref LL_GPIO_PIN_8
507 * @arg @ref LL_GPIO_PIN_9
508 * @arg @ref LL_GPIO_PIN_10
509 * @arg @ref LL_GPIO_PIN_11
510 * @arg @ref LL_GPIO_PIN_12
511 * @arg @ref LL_GPIO_PIN_13
512 * @arg @ref LL_GPIO_PIN_14
513 * @arg @ref LL_GPIO_PIN_15
514 * @retval Returned value can be one of the following values:
515 * @arg @ref LL_GPIO_PULL_NO
516 * @arg @ref LL_GPIO_PULL_UP
517 * @arg @ref LL_GPIO_PULL_DOWN
519 __STATIC_INLINE
uint32_t LL_GPIO_GetPinPull(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
521 return (uint32_t)(READ_BIT(GPIOx
->PUPDR
, ((Pin
* Pin
) * GPIO_PUPDR_PUPD0
)) / (Pin
* Pin
));
525 * @brief Configure gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
526 * @note Possible values are from AF0 to AF15 depending on target.
527 * @note Warning: only one pin can be passed as parameter.
528 * @rmtoll AFRL AFSELy LL_GPIO_SetAFPin_0_7
529 * @param GPIOx GPIO Port
530 * @param Pin This parameter can be one of the following values:
531 * @arg @ref LL_GPIO_PIN_0
532 * @arg @ref LL_GPIO_PIN_1
533 * @arg @ref LL_GPIO_PIN_2
534 * @arg @ref LL_GPIO_PIN_3
535 * @arg @ref LL_GPIO_PIN_4
536 * @arg @ref LL_GPIO_PIN_5
537 * @arg @ref LL_GPIO_PIN_6
538 * @arg @ref LL_GPIO_PIN_7
539 * @param Alternate This parameter can be one of the following values:
540 * @arg @ref LL_GPIO_AF_0
541 * @arg @ref LL_GPIO_AF_1
542 * @arg @ref LL_GPIO_AF_2
543 * @arg @ref LL_GPIO_AF_3
544 * @arg @ref LL_GPIO_AF_4
545 * @arg @ref LL_GPIO_AF_5
546 * @arg @ref LL_GPIO_AF_6
547 * @arg @ref LL_GPIO_AF_7
548 * @arg @ref LL_GPIO_AF_8
549 * @arg @ref LL_GPIO_AF_9
550 * @arg @ref LL_GPIO_AF_10
551 * @arg @ref LL_GPIO_AF_11
552 * @arg @ref LL_GPIO_AF_12
553 * @arg @ref LL_GPIO_AF_13
554 * @arg @ref LL_GPIO_AF_14
555 * @arg @ref LL_GPIO_AF_15
558 __STATIC_INLINE
void LL_GPIO_SetAFPin_0_7(GPIO_TypeDef
*GPIOx
, uint32_t Pin
, uint32_t Alternate
)
560 MODIFY_REG(GPIOx
->AFR
[0], ((((Pin
* Pin
) * Pin
) * Pin
) * GPIO_AFRL_AFSEL0
),
561 ((((Pin
* Pin
) * Pin
) * Pin
) * Alternate
));
565 * @brief Return gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
566 * @rmtoll AFRL AFSELy LL_GPIO_GetAFPin_0_7
567 * @param GPIOx GPIO Port
568 * @param Pin This parameter can be one of the following values:
569 * @arg @ref LL_GPIO_PIN_0
570 * @arg @ref LL_GPIO_PIN_1
571 * @arg @ref LL_GPIO_PIN_2
572 * @arg @ref LL_GPIO_PIN_3
573 * @arg @ref LL_GPIO_PIN_4
574 * @arg @ref LL_GPIO_PIN_5
575 * @arg @ref LL_GPIO_PIN_6
576 * @arg @ref LL_GPIO_PIN_7
577 * @retval Returned value can be one of the following values:
578 * @arg @ref LL_GPIO_AF_0
579 * @arg @ref LL_GPIO_AF_1
580 * @arg @ref LL_GPIO_AF_2
581 * @arg @ref LL_GPIO_AF_3
582 * @arg @ref LL_GPIO_AF_4
583 * @arg @ref LL_GPIO_AF_5
584 * @arg @ref LL_GPIO_AF_6
585 * @arg @ref LL_GPIO_AF_7
586 * @arg @ref LL_GPIO_AF_8
587 * @arg @ref LL_GPIO_AF_9
588 * @arg @ref LL_GPIO_AF_10
589 * @arg @ref LL_GPIO_AF_11
590 * @arg @ref LL_GPIO_AF_12
591 * @arg @ref LL_GPIO_AF_13
592 * @arg @ref LL_GPIO_AF_14
593 * @arg @ref LL_GPIO_AF_15
595 __STATIC_INLINE
uint32_t LL_GPIO_GetAFPin_0_7(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
597 return (uint32_t)(READ_BIT(GPIOx
->AFR
[0],
598 ((((Pin
* Pin
) * Pin
) * Pin
) * GPIO_AFRL_AFSEL0
)) / (((Pin
* Pin
) * Pin
) * Pin
));
602 * @brief Configure gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
603 * @note Possible values are from AF0 to AF15 depending on target.
604 * @note Warning: only one pin can be passed as parameter.
605 * @rmtoll AFRH AFSELy LL_GPIO_SetAFPin_8_15
606 * @param GPIOx GPIO Port
607 * @param Pin This parameter can be one of the following values:
608 * @arg @ref LL_GPIO_PIN_8
609 * @arg @ref LL_GPIO_PIN_9
610 * @arg @ref LL_GPIO_PIN_10
611 * @arg @ref LL_GPIO_PIN_11
612 * @arg @ref LL_GPIO_PIN_12
613 * @arg @ref LL_GPIO_PIN_13
614 * @arg @ref LL_GPIO_PIN_14
615 * @arg @ref LL_GPIO_PIN_15
616 * @param Alternate This parameter can be one of the following values:
617 * @arg @ref LL_GPIO_AF_0
618 * @arg @ref LL_GPIO_AF_1
619 * @arg @ref LL_GPIO_AF_2
620 * @arg @ref LL_GPIO_AF_3
621 * @arg @ref LL_GPIO_AF_4
622 * @arg @ref LL_GPIO_AF_5
623 * @arg @ref LL_GPIO_AF_6
624 * @arg @ref LL_GPIO_AF_7
625 * @arg @ref LL_GPIO_AF_8
626 * @arg @ref LL_GPIO_AF_9
627 * @arg @ref LL_GPIO_AF_10
628 * @arg @ref LL_GPIO_AF_11
629 * @arg @ref LL_GPIO_AF_12
630 * @arg @ref LL_GPIO_AF_13
631 * @arg @ref LL_GPIO_AF_14
632 * @arg @ref LL_GPIO_AF_15
635 __STATIC_INLINE
void LL_GPIO_SetAFPin_8_15(GPIO_TypeDef
*GPIOx
, uint32_t Pin
, uint32_t Alternate
)
637 MODIFY_REG(GPIOx
->AFR
[1], (((((Pin
>> 8U) * (Pin
>> 8U)) * (Pin
>> 8U)) * (Pin
>> 8U)) * GPIO_AFRH_AFSEL8
),
638 (((((Pin
>> 8U) * (Pin
>> 8U)) * (Pin
>> 8U)) * (Pin
>> 8U)) * Alternate
));
642 * @brief Return gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
643 * @note Possible values are from AF0 to AF15 depending on target.
644 * @rmtoll AFRH AFSELy LL_GPIO_GetAFPin_8_15
645 * @param GPIOx GPIO Port
646 * @param Pin This parameter can be one of the following values:
647 * @arg @ref LL_GPIO_PIN_8
648 * @arg @ref LL_GPIO_PIN_9
649 * @arg @ref LL_GPIO_PIN_10
650 * @arg @ref LL_GPIO_PIN_11
651 * @arg @ref LL_GPIO_PIN_12
652 * @arg @ref LL_GPIO_PIN_13
653 * @arg @ref LL_GPIO_PIN_14
654 * @arg @ref LL_GPIO_PIN_15
655 * @retval Returned value can be one of the following values:
656 * @arg @ref LL_GPIO_AF_0
657 * @arg @ref LL_GPIO_AF_1
658 * @arg @ref LL_GPIO_AF_2
659 * @arg @ref LL_GPIO_AF_3
660 * @arg @ref LL_GPIO_AF_4
661 * @arg @ref LL_GPIO_AF_5
662 * @arg @ref LL_GPIO_AF_6
663 * @arg @ref LL_GPIO_AF_7
664 * @arg @ref LL_GPIO_AF_8
665 * @arg @ref LL_GPIO_AF_9
666 * @arg @ref LL_GPIO_AF_10
667 * @arg @ref LL_GPIO_AF_11
668 * @arg @ref LL_GPIO_AF_12
669 * @arg @ref LL_GPIO_AF_13
670 * @arg @ref LL_GPIO_AF_14
671 * @arg @ref LL_GPIO_AF_15
673 __STATIC_INLINE
uint32_t LL_GPIO_GetAFPin_8_15(GPIO_TypeDef
*GPIOx
, uint32_t Pin
)
675 return (uint32_t)(READ_BIT(GPIOx
->AFR
[1],
676 (((((Pin
>> 8U) * (Pin
>> 8U)) * (Pin
>> 8U)) * (Pin
>> 8U)) * GPIO_AFRH_AFSEL8
)) / ((((Pin
>> 8U) *
677 (Pin
>> 8U)) * (Pin
>> 8U)) * (Pin
>> 8U)));
682 * @brief Lock configuration of several pins for a dedicated port.
683 * @note When the lock sequence has been applied on a port bit, the
684 * value of this port bit can no longer be modified until the
686 * @note Each lock bit freezes a specific configuration register
687 * (control and alternate function registers).
688 * @rmtoll LCKR LCKK LL_GPIO_LockPin
689 * @param GPIOx GPIO Port
690 * @param PinMask This parameter can be a combination of the following values:
691 * @arg @ref LL_GPIO_PIN_0
692 * @arg @ref LL_GPIO_PIN_1
693 * @arg @ref LL_GPIO_PIN_2
694 * @arg @ref LL_GPIO_PIN_3
695 * @arg @ref LL_GPIO_PIN_4
696 * @arg @ref LL_GPIO_PIN_5
697 * @arg @ref LL_GPIO_PIN_6
698 * @arg @ref LL_GPIO_PIN_7
699 * @arg @ref LL_GPIO_PIN_8
700 * @arg @ref LL_GPIO_PIN_9
701 * @arg @ref LL_GPIO_PIN_10
702 * @arg @ref LL_GPIO_PIN_11
703 * @arg @ref LL_GPIO_PIN_12
704 * @arg @ref LL_GPIO_PIN_13
705 * @arg @ref LL_GPIO_PIN_14
706 * @arg @ref LL_GPIO_PIN_15
707 * @arg @ref LL_GPIO_PIN_ALL
710 __STATIC_INLINE
void LL_GPIO_LockPin(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
713 WRITE_REG(GPIOx
->LCKR
, GPIO_LCKR_LCKK
| PinMask
);
714 WRITE_REG(GPIOx
->LCKR
, PinMask
);
715 WRITE_REG(GPIOx
->LCKR
, GPIO_LCKR_LCKK
| PinMask
);
716 /* Read LCKK register. This read is mandatory to complete key lock sequence */
717 temp
= READ_REG(GPIOx
->LCKR
);
722 * @brief Return 1 if all pins passed as parameter, of a dedicated port, are locked. else Return 0.
723 * @rmtoll LCKR LCKy LL_GPIO_IsPinLocked
724 * @param GPIOx GPIO Port
725 * @param PinMask This parameter can be a combination of the following values:
726 * @arg @ref LL_GPIO_PIN_0
727 * @arg @ref LL_GPIO_PIN_1
728 * @arg @ref LL_GPIO_PIN_2
729 * @arg @ref LL_GPIO_PIN_3
730 * @arg @ref LL_GPIO_PIN_4
731 * @arg @ref LL_GPIO_PIN_5
732 * @arg @ref LL_GPIO_PIN_6
733 * @arg @ref LL_GPIO_PIN_7
734 * @arg @ref LL_GPIO_PIN_8
735 * @arg @ref LL_GPIO_PIN_9
736 * @arg @ref LL_GPIO_PIN_10
737 * @arg @ref LL_GPIO_PIN_11
738 * @arg @ref LL_GPIO_PIN_12
739 * @arg @ref LL_GPIO_PIN_13
740 * @arg @ref LL_GPIO_PIN_14
741 * @arg @ref LL_GPIO_PIN_15
742 * @arg @ref LL_GPIO_PIN_ALL
743 * @retval State of bit (1 or 0).
745 __STATIC_INLINE
uint32_t LL_GPIO_IsPinLocked(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
747 return ((READ_BIT(GPIOx
->LCKR
, PinMask
) == (PinMask
)) ? 1UL : 0UL);
751 * @brief Return 1 if one of the pin of a dedicated port is locked. else return 0.
752 * @rmtoll LCKR LCKK LL_GPIO_IsAnyPinLocked
753 * @param GPIOx GPIO Port
754 * @retval State of bit (1 or 0).
756 __STATIC_INLINE
uint32_t LL_GPIO_IsAnyPinLocked(GPIO_TypeDef
*GPIOx
)
758 return ((READ_BIT(GPIOx
->LCKR
, GPIO_LCKR_LCKK
) == (GPIO_LCKR_LCKK
)) ? 1UL : 0UL);
765 /** @defgroup GPIO_LL_EF_Data_Access Data Access
770 * @brief Return full input data register value for a dedicated port.
771 * @rmtoll IDR IDy LL_GPIO_ReadInputPort
772 * @param GPIOx GPIO Port
773 * @retval Input data register value of port
775 __STATIC_INLINE
uint32_t LL_GPIO_ReadInputPort(GPIO_TypeDef
*GPIOx
)
777 return (uint32_t)(READ_REG(GPIOx
->IDR
));
781 * @brief Return if input data level for several pins of dedicated port is high or low.
782 * @rmtoll IDR IDy LL_GPIO_IsInputPinSet
783 * @param GPIOx GPIO Port
784 * @param PinMask This parameter can be a combination of the following values:
785 * @arg @ref LL_GPIO_PIN_0
786 * @arg @ref LL_GPIO_PIN_1
787 * @arg @ref LL_GPIO_PIN_2
788 * @arg @ref LL_GPIO_PIN_3
789 * @arg @ref LL_GPIO_PIN_4
790 * @arg @ref LL_GPIO_PIN_5
791 * @arg @ref LL_GPIO_PIN_6
792 * @arg @ref LL_GPIO_PIN_7
793 * @arg @ref LL_GPIO_PIN_8
794 * @arg @ref LL_GPIO_PIN_9
795 * @arg @ref LL_GPIO_PIN_10
796 * @arg @ref LL_GPIO_PIN_11
797 * @arg @ref LL_GPIO_PIN_12
798 * @arg @ref LL_GPIO_PIN_13
799 * @arg @ref LL_GPIO_PIN_14
800 * @arg @ref LL_GPIO_PIN_15
801 * @arg @ref LL_GPIO_PIN_ALL
802 * @retval State of bit (1 or 0).
804 __STATIC_INLINE
uint32_t LL_GPIO_IsInputPinSet(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
806 return ((READ_BIT(GPIOx
->IDR
, PinMask
) == (PinMask
)) ? 1UL : 0UL);
810 * @brief Write output data register for the port.
811 * @rmtoll ODR ODy LL_GPIO_WriteOutputPort
812 * @param GPIOx GPIO Port
813 * @param PortValue Level value for each pin of the port
816 __STATIC_INLINE
void LL_GPIO_WriteOutputPort(GPIO_TypeDef
*GPIOx
, uint32_t PortValue
)
818 WRITE_REG(GPIOx
->ODR
, PortValue
);
822 * @brief Return full output data register value for a dedicated port.
823 * @rmtoll ODR ODy LL_GPIO_ReadOutputPort
824 * @param GPIOx GPIO Port
825 * @retval Output data register value of port
827 __STATIC_INLINE
uint32_t LL_GPIO_ReadOutputPort(GPIO_TypeDef
*GPIOx
)
829 return (uint32_t)(READ_REG(GPIOx
->ODR
));
833 * @brief Return if input data level for several pins of dedicated port is high or low.
834 * @rmtoll ODR ODy LL_GPIO_IsOutputPinSet
835 * @param GPIOx GPIO Port
836 * @param PinMask This parameter can be a combination of the following values:
837 * @arg @ref LL_GPIO_PIN_0
838 * @arg @ref LL_GPIO_PIN_1
839 * @arg @ref LL_GPIO_PIN_2
840 * @arg @ref LL_GPIO_PIN_3
841 * @arg @ref LL_GPIO_PIN_4
842 * @arg @ref LL_GPIO_PIN_5
843 * @arg @ref LL_GPIO_PIN_6
844 * @arg @ref LL_GPIO_PIN_7
845 * @arg @ref LL_GPIO_PIN_8
846 * @arg @ref LL_GPIO_PIN_9
847 * @arg @ref LL_GPIO_PIN_10
848 * @arg @ref LL_GPIO_PIN_11
849 * @arg @ref LL_GPIO_PIN_12
850 * @arg @ref LL_GPIO_PIN_13
851 * @arg @ref LL_GPIO_PIN_14
852 * @arg @ref LL_GPIO_PIN_15
853 * @arg @ref LL_GPIO_PIN_ALL
854 * @retval State of bit (1 or 0).
856 __STATIC_INLINE
uint32_t LL_GPIO_IsOutputPinSet(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
858 return ((READ_BIT(GPIOx
->ODR
, PinMask
) == (PinMask
)) ? 1UL : 0UL);
862 * @brief Set several pins to high level on dedicated gpio port.
863 * @rmtoll BSRR BSy LL_GPIO_SetOutputPin
864 * @param GPIOx GPIO Port
865 * @param PinMask This parameter can be a combination of the following values:
866 * @arg @ref LL_GPIO_PIN_0
867 * @arg @ref LL_GPIO_PIN_1
868 * @arg @ref LL_GPIO_PIN_2
869 * @arg @ref LL_GPIO_PIN_3
870 * @arg @ref LL_GPIO_PIN_4
871 * @arg @ref LL_GPIO_PIN_5
872 * @arg @ref LL_GPIO_PIN_6
873 * @arg @ref LL_GPIO_PIN_7
874 * @arg @ref LL_GPIO_PIN_8
875 * @arg @ref LL_GPIO_PIN_9
876 * @arg @ref LL_GPIO_PIN_10
877 * @arg @ref LL_GPIO_PIN_11
878 * @arg @ref LL_GPIO_PIN_12
879 * @arg @ref LL_GPIO_PIN_13
880 * @arg @ref LL_GPIO_PIN_14
881 * @arg @ref LL_GPIO_PIN_15
882 * @arg @ref LL_GPIO_PIN_ALL
885 __STATIC_INLINE
void LL_GPIO_SetOutputPin(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
887 WRITE_REG(GPIOx
->BSRR
, PinMask
);
891 * @brief Set several pins to low level on dedicated gpio port.
892 * @rmtoll BSRR BRy LL_GPIO_ResetOutputPin
893 * @param GPIOx GPIO Port
894 * @param PinMask This parameter can be a combination of the following values:
895 * @arg @ref LL_GPIO_PIN_0
896 * @arg @ref LL_GPIO_PIN_1
897 * @arg @ref LL_GPIO_PIN_2
898 * @arg @ref LL_GPIO_PIN_3
899 * @arg @ref LL_GPIO_PIN_4
900 * @arg @ref LL_GPIO_PIN_5
901 * @arg @ref LL_GPIO_PIN_6
902 * @arg @ref LL_GPIO_PIN_7
903 * @arg @ref LL_GPIO_PIN_8
904 * @arg @ref LL_GPIO_PIN_9
905 * @arg @ref LL_GPIO_PIN_10
906 * @arg @ref LL_GPIO_PIN_11
907 * @arg @ref LL_GPIO_PIN_12
908 * @arg @ref LL_GPIO_PIN_13
909 * @arg @ref LL_GPIO_PIN_14
910 * @arg @ref LL_GPIO_PIN_15
911 * @arg @ref LL_GPIO_PIN_ALL
914 __STATIC_INLINE
void LL_GPIO_ResetOutputPin(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
916 WRITE_REG(GPIOx
->BSRR
, PinMask
<< 16U);
920 * @brief Toggle data value for several pin of dedicated port.
921 * @rmtoll ODR ODy LL_GPIO_TogglePin
922 * @param GPIOx GPIO Port
923 * @param PinMask This parameter can be a combination of the following values:
924 * @arg @ref LL_GPIO_PIN_0
925 * @arg @ref LL_GPIO_PIN_1
926 * @arg @ref LL_GPIO_PIN_2
927 * @arg @ref LL_GPIO_PIN_3
928 * @arg @ref LL_GPIO_PIN_4
929 * @arg @ref LL_GPIO_PIN_5
930 * @arg @ref LL_GPIO_PIN_6
931 * @arg @ref LL_GPIO_PIN_7
932 * @arg @ref LL_GPIO_PIN_8
933 * @arg @ref LL_GPIO_PIN_9
934 * @arg @ref LL_GPIO_PIN_10
935 * @arg @ref LL_GPIO_PIN_11
936 * @arg @ref LL_GPIO_PIN_12
937 * @arg @ref LL_GPIO_PIN_13
938 * @arg @ref LL_GPIO_PIN_14
939 * @arg @ref LL_GPIO_PIN_15
940 * @arg @ref LL_GPIO_PIN_ALL
943 __STATIC_INLINE
void LL_GPIO_TogglePin(GPIO_TypeDef
*GPIOx
, uint32_t PinMask
)
945 WRITE_REG(GPIOx
->ODR
, READ_REG(GPIOx
->ODR
) ^ PinMask
);
952 #if defined(USE_FULL_LL_DRIVER)
953 /** @defgroup GPIO_LL_EF_Init Initialization and de-initialization functions
957 ErrorStatus
LL_GPIO_DeInit(GPIO_TypeDef
*GPIOx
);
958 ErrorStatus
LL_GPIO_Init(GPIO_TypeDef
*GPIOx
, LL_GPIO_InitTypeDef
*GPIO_InitStruct
);
959 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef
*GPIO_InitStruct
);
964 #endif /* USE_FULL_LL_DRIVER */
974 #endif /*defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI) || defined (GPIOJ) || defined (GPIOK) */
983 #endif /* STM32H7xx_LL_GPIO_H */
985 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/