1 /**
2 ******************************************************************************
3 * @file stm32l5xx_ll_gpio.h
4 * @author MCD Application Team
5 * @brief Header file of GPIO LL module.
6 ******************************************************************************
7 * @attention
8 *
9 * Copyright (c) 2019 STMicroelectronics.
10 * All rights reserved.
11 *
12 * This software is licensed under terms that can be found in the LICENSE file
13 * in the root directory of this software component.
14 * If no LICENSE file comes with this software, it is provided AS-IS.
15 *
16 ******************************************************************************
17 */
18
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32L5xx_LL_GPIO_H
21 #define STM32L5xx_LL_GPIO_H
22
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32l5xx.h"
29
30 /** @addtogroup STM32L5xx_LL_Driver
31 * @{
32 */
33
34 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH)
35
36 /** @defgroup GPIO_LL GPIO
37 * @{
38 */
39
40 /* Private types -------------------------------------------------------------*/
41 /* Private variables ---------------------------------------------------------*/
42 /* Private constants ---------------------------------------------------------*/
43 /* Private macros ------------------------------------------------------------*/
44 #if defined(USE_FULL_LL_DRIVER)
45 /** @defgroup GPIO_LL_Private_Macros GPIO Private Macros
46 * @{
47 */
48
49 /**
50 * @}
51 */
52 #endif /*USE_FULL_LL_DRIVER*/
53
54 /* Exported types ------------------------------------------------------------*/
55 #if defined(USE_FULL_LL_DRIVER)
56 /** @defgroup GPIO_LL_ES_INIT GPIO Exported Init structures
57 * @{
58 */
59
60 /**
61 * @brief LL GPIO Init Structure definition
62 */
63 typedef struct
64 {
65 uint32_t Pin; /*!< Specifies the GPIO pins to be configured.
66 This parameter can be any value of @ref GPIO_LL_EC_PIN */
67
68 uint32_t Mode; /*!< Specifies the operating mode for the selected pins.
69 This parameter can be a value of @ref GPIO_LL_EC_MODE.
70
71 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinMode().*/
72
73 uint32_t Speed; /*!< Specifies the speed for the selected pins.
74 This parameter can be a value of @ref GPIO_LL_EC_SPEED.
75
76 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinSpeed().*/
77
78 uint32_t OutputType; /*!< Specifies the operating output type for the selected pins.
79 This parameter can be a value of @ref GPIO_LL_EC_OUTPUT.
80
81 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinOutputType().*/
82
83 uint32_t Pull; /*!< Specifies the operating Pull-up/Pull down for the selected pins.
84 This parameter can be a value of @ref GPIO_LL_EC_PULL.
85
86 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinPull().*/
87
88 uint32_t Alternate; /*!< Specifies the Peripheral to be connected to the selected pins.
89 This parameter can be a value of @ref GPIO_LL_EC_AF.
90
91 GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetAFPin_0_7() and LL_GPIO_SetAFPin_8_15().*/
92 } LL_GPIO_InitTypeDef;
93
94 /**
95 * @}
96 */
97 #endif /* USE_FULL_LL_DRIVER */
98
99 /* Exported constants --------------------------------------------------------*/
100 /** @defgroup GPIO_LL_Exported_Constants GPIO Exported Constants
101 * @{
102 */
103
104 /** @defgroup GPIO_LL_EC_PIN PIN
105 * @{
106 */
107 #define LL_GPIO_PIN_0 GPIO_BSRR_BS0 /*!< Select pin 0 */
108 #define LL_GPIO_PIN_1 GPIO_BSRR_BS1 /*!< Select pin 1 */
109 #define LL_GPIO_PIN_2 GPIO_BSRR_BS2 /*!< Select pin 2 */
110 #define LL_GPIO_PIN_3 GPIO_BSRR_BS3 /*!< Select pin 3 */
111 #define LL_GPIO_PIN_4 GPIO_BSRR_BS4 /*!< Select pin 4 */
112 #define LL_GPIO_PIN_5 GPIO_BSRR_BS5 /*!< Select pin 5 */
113 #define LL_GPIO_PIN_6 GPIO_BSRR_BS6 /*!< Select pin 6 */
114 #define LL_GPIO_PIN_7 GPIO_BSRR_BS7 /*!< Select pin 7 */
115 #define LL_GPIO_PIN_8 GPIO_BSRR_BS8 /*!< Select pin 8 */
116 #define LL_GPIO_PIN_9 GPIO_BSRR_BS9 /*!< Select pin 9 */
117 #define LL_GPIO_PIN_10 GPIO_BSRR_BS10 /*!< Select pin 10 */
118 #define LL_GPIO_PIN_11 GPIO_BSRR_BS11 /*!< Select pin 11 */
119 #define LL_GPIO_PIN_12 GPIO_BSRR_BS12 /*!< Select pin 12 */
120 #define LL_GPIO_PIN_13 GPIO_BSRR_BS13 /*!< Select pin 13 */
121 #define LL_GPIO_PIN_14 GPIO_BSRR_BS14 /*!< Select pin 14 */
122 #define LL_GPIO_PIN_15 GPIO_BSRR_BS15 /*!< Select pin 15 */
123 #define LL_GPIO_PIN_ALL (GPIO_BSRR_BS0 | GPIO_BSRR_BS1 | GPIO_BSRR_BS2 | \
124 GPIO_BSRR_BS3 | GPIO_BSRR_BS4 | GPIO_BSRR_BS5 | \
125 GPIO_BSRR_BS6 | GPIO_BSRR_BS7 | GPIO_BSRR_BS8 | \
126 GPIO_BSRR_BS9 | GPIO_BSRR_BS10 | GPIO_BSRR_BS11 | \
127 GPIO_BSRR_BS12 | GPIO_BSRR_BS13 | GPIO_BSRR_BS14 | \
128 GPIO_BSRR_BS15) /*!< Select all pins */
129 /**
130 * @}
131 */
132
133 /** @defgroup GPIO_LL_EC_MODE Mode
134 * @{
135 */
136 #define LL_GPIO_MODE_INPUT (0x00000000U) /*!< Select input mode */
137 #define LL_GPIO_MODE_OUTPUT GPIO_MODER_MODE0_0 /*!< Select output mode */
138 #define LL_GPIO_MODE_ALTERNATE GPIO_MODER_MODE0_1 /*!< Select alternate function mode */
139 #define LL_GPIO_MODE_ANALOG GPIO_MODER_MODE0 /*!< Select analog mode */
140 /**
141 * @}
142 */
143
144 /** @defgroup GPIO_LL_EC_OUTPUT Output Type
145 * @{
146 */
147 #define LL_GPIO_OUTPUT_PUSHPULL (0x00000000U) /*!< Select push-pull as output type */
148 #define LL_GPIO_OUTPUT_OPENDRAIN GPIO_OTYPER_OT0 /*!< Select open-drain as output type */
149 /**
150 * @}
151 */
152
153 /** @defgroup GPIO_LL_EC_SPEED Output Speed
154 * @{
155 */
156 #define LL_GPIO_SPEED_FREQ_LOW (0x00000000U) /*!< Select I/O low output speed */
157 #define LL_GPIO_SPEED_FREQ_MEDIUM GPIO_OSPEEDR_OSPEED0_0 /*!< Select I/O medium output speed */
158 #define LL_GPIO_SPEED_FREQ_HIGH GPIO_OSPEEDR_OSPEED0_1 /*!< Select I/O fast output speed */
159 #define LL_GPIO_SPEED_FREQ_VERY_HIGH GPIO_OSPEEDR_OSPEED0 /*!< Select I/O high output speed */
160 /**
161 * @}
162 */
163 #define LL_GPIO_SPEED_LOW LL_GPIO_SPEED_FREQ_LOW
164 #define LL_GPIO_SPEED_MEDIUM LL_GPIO_SPEED_FREQ_MEDIUM
165 #define LL_GPIO_SPEED_FAST LL_GPIO_SPEED_FREQ_HIGH
166 #define LL_GPIO_SPEED_HIGH LL_GPIO_SPEED_FREQ_VERY_HIGH
167
168 /** @defgroup GPIO_LL_EC_PULL Pull Up Pull Down
169 * @{
170 */
171 #define LL_GPIO_PULL_NO (0x00000000U) /*!< Select I/O no pull */
172 #define LL_GPIO_PULL_UP GPIO_PUPDR_PUPD0_0 /*!< Select I/O pull up */
173 #define LL_GPIO_PULL_DOWN GPIO_PUPDR_PUPD0_1 /*!< Select I/O pull down */
174 /**
175 * @}
176 */
177
178 /** @defgroup GPIO_LL_EC_AF Alternate Function
179 * @{
180 */
181 #define LL_GPIO_AF_0 (0x0000000U) /*!< Select alternate function 0 */
182 #define LL_GPIO_AF_1 (0x0000001U) /*!< Select alternate function 1 */
183 #define LL_GPIO_AF_2 (0x0000002U) /*!< Select alternate function 2 */
184 #define LL_GPIO_AF_3 (0x0000003U) /*!< Select alternate function 3 */
185 #define LL_GPIO_AF_4 (0x0000004U) /*!< Select alternate function 4 */
186 #define LL_GPIO_AF_5 (0x0000005U) /*!< Select alternate function 5 */
187 #define LL_GPIO_AF_6 (0x0000006U) /*!< Select alternate function 6 */
188 #define LL_GPIO_AF_7 (0x0000007U) /*!< Select alternate function 7 */
189 #define LL_GPIO_AF_8 (0x0000008U) /*!< Select alternate function 8 */
190 #define LL_GPIO_AF_9 (0x0000009U) /*!< Select alternate function 9 */
191 #define LL_GPIO_AF_10 (0x000000AU) /*!< Select alternate function 10 */
192 #define LL_GPIO_AF_11 (0x000000BU) /*!< Select alternate function 11 */
193 #define LL_GPIO_AF_12 (0x000000CU) /*!< Select alternate function 12 */
194 #define LL_GPIO_AF_13 (0x000000DU) /*!< Select alternate function 13 */
195 #define LL_GPIO_AF_14 (0x000000EU) /*!< Select alternate function 14 */
196 #define LL_GPIO_AF_15 (0x000000FU) /*!< Select alternate function 15 */
197 /**
198 * @}
199 */
200
201 /**
202 * @}
203 */
204
205 /* Exported macro ------------------------------------------------------------*/
206 /** @defgroup GPIO_LL_Exported_Macros GPIO Exported Macros
207 * @{
208 */
209
210 /** @defgroup GPIO_LL_EM_WRITE_READ Common Write and read registers Macros
211 * @{
212 */
213
214 /**
215 * @brief Write a value in GPIO register
216 * @param __INSTANCE__ GPIO Instance
217 * @param __REG__ Register to be written
218 * @param __VALUE__ Value to be written in the register
219 * @retval None
220 */
221 #define LL_GPIO_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
222
223 /**
224 * @brief Read a value in GPIO register
225 * @param __INSTANCE__ GPIO Instance
226 * @param __REG__ Register to be read
227 * @retval Register value
228 */
229 #define LL_GPIO_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
230 /**
231 * @}
232 */
233
234 /**
235 * @}
236 */
237
238 /* Exported functions --------------------------------------------------------*/
239 /** @defgroup GPIO_LL_Exported_Functions GPIO Exported Functions
240 * @{
241 */
242
243 /** @defgroup GPIO_LL_EF_Port_Configuration Port Configuration
244 * @{
245 */
246
247 /**
248 * @brief Configure gpio mode for a dedicated pin on dedicated port.
249 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
250 * @note Warning: only one pin can be passed as parameter.
251 * @rmtoll MODER MODEy LL_GPIO_SetPinMode
252 * @param GPIOx GPIO Port
253 * @param Pin This parameter can be one of the following values:
254 * @arg @ref LL_GPIO_PIN_0
255 * @arg @ref LL_GPIO_PIN_1
256 * @arg @ref LL_GPIO_PIN_2
257 * @arg @ref LL_GPIO_PIN_3
258 * @arg @ref LL_GPIO_PIN_4
259 * @arg @ref LL_GPIO_PIN_5
260 * @arg @ref LL_GPIO_PIN_6
261 * @arg @ref LL_GPIO_PIN_7
262 * @arg @ref LL_GPIO_PIN_8
263 * @arg @ref LL_GPIO_PIN_9
264 * @arg @ref LL_GPIO_PIN_10
265 * @arg @ref LL_GPIO_PIN_11
266 * @arg @ref LL_GPIO_PIN_12
267 * @arg @ref LL_GPIO_PIN_13
268 * @arg @ref LL_GPIO_PIN_14
269 * @arg @ref LL_GPIO_PIN_15
270 * @param Mode This parameter can be one of the following values:
271 * @arg @ref LL_GPIO_MODE_INPUT
272 * @arg @ref LL_GPIO_MODE_OUTPUT
273 * @arg @ref LL_GPIO_MODE_ALTERNATE
274 * @arg @ref LL_GPIO_MODE_ANALOG
275 * @retval None
276 */
LL_GPIO_SetPinMode(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Mode)277 __STATIC_INLINE void LL_GPIO_SetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Mode)
278 {
279 MODIFY_REG(GPIOx->MODER, (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U)), (Mode << (POSITION_VAL(Pin) * 2U)));
280 }
281
282 /**
283 * @brief Return gpio mode for a dedicated pin on dedicated port.
284 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
285 * @note Warning: only one pin can be passed as parameter.
286 * @rmtoll MODER MODEy LL_GPIO_GetPinMode
287 * @param GPIOx GPIO Port
288 * @param Pin This parameter can be one of the following values:
289 * @arg @ref LL_GPIO_PIN_0
290 * @arg @ref LL_GPIO_PIN_1
291 * @arg @ref LL_GPIO_PIN_2
292 * @arg @ref LL_GPIO_PIN_3
293 * @arg @ref LL_GPIO_PIN_4
294 * @arg @ref LL_GPIO_PIN_5
295 * @arg @ref LL_GPIO_PIN_6
296 * @arg @ref LL_GPIO_PIN_7
297 * @arg @ref LL_GPIO_PIN_8
298 * @arg @ref LL_GPIO_PIN_9
299 * @arg @ref LL_GPIO_PIN_10
300 * @arg @ref LL_GPIO_PIN_11
301 * @arg @ref LL_GPIO_PIN_12
302 * @arg @ref LL_GPIO_PIN_13
303 * @arg @ref LL_GPIO_PIN_14
304 * @arg @ref LL_GPIO_PIN_15
305 * @retval Returned value can be one of the following values:
306 * @arg @ref LL_GPIO_MODE_INPUT
307 * @arg @ref LL_GPIO_MODE_OUTPUT
308 * @arg @ref LL_GPIO_MODE_ALTERNATE
309 * @arg @ref LL_GPIO_MODE_ANALOG
310 */
LL_GPIO_GetPinMode(GPIO_TypeDef * GPIOx,uint32_t Pin)311 __STATIC_INLINE uint32_t LL_GPIO_GetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin)
312 {
313 return (uint32_t)(READ_BIT(GPIOx->MODER,
314 (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
315 }
316
317 /**
318 * @brief Configure gpio output type for several pins on dedicated port.
319 * @note Output type as to be set when gpio pin is in output or
320 * alternate modes. Possible type are Push-pull or Open-drain.
321 * @rmtoll OTYPER OTy LL_GPIO_SetPinOutputType
322 * @param GPIOx GPIO Port
323 * @param PinMask This parameter can be a combination of the following values:
324 * @arg @ref LL_GPIO_PIN_0
325 * @arg @ref LL_GPIO_PIN_1
326 * @arg @ref LL_GPIO_PIN_2
327 * @arg @ref LL_GPIO_PIN_3
328 * @arg @ref LL_GPIO_PIN_4
329 * @arg @ref LL_GPIO_PIN_5
330 * @arg @ref LL_GPIO_PIN_6
331 * @arg @ref LL_GPIO_PIN_7
332 * @arg @ref LL_GPIO_PIN_8
333 * @arg @ref LL_GPIO_PIN_9
334 * @arg @ref LL_GPIO_PIN_10
335 * @arg @ref LL_GPIO_PIN_11
336 * @arg @ref LL_GPIO_PIN_12
337 * @arg @ref LL_GPIO_PIN_13
338 * @arg @ref LL_GPIO_PIN_14
339 * @arg @ref LL_GPIO_PIN_15
340 * @arg @ref LL_GPIO_PIN_ALL
341 * @param OutputType This parameter can be one of the following values:
342 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
343 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
344 * @retval None
345 */
LL_GPIO_SetPinOutputType(GPIO_TypeDef * GPIOx,uint32_t PinMask,uint32_t OutputType)346 __STATIC_INLINE void LL_GPIO_SetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t PinMask, uint32_t OutputType)
347 {
348 MODIFY_REG(GPIOx->OTYPER, PinMask, (PinMask * OutputType));
349 }
350
351 /**
352 * @brief Return gpio output type for several pins on dedicated port.
353 * @note Output type as to be set when gpio pin is in output or
354 * alternate modes. Possible type are Push-pull or Open-drain.
355 * @note Warning: only one pin can be passed as parameter.
356 * @rmtoll OTYPER OTy LL_GPIO_GetPinOutputType
357 * @param GPIOx GPIO Port
358 * @param Pin This parameter can be one of the following values:
359 * @arg @ref LL_GPIO_PIN_0
360 * @arg @ref LL_GPIO_PIN_1
361 * @arg @ref LL_GPIO_PIN_2
362 * @arg @ref LL_GPIO_PIN_3
363 * @arg @ref LL_GPIO_PIN_4
364 * @arg @ref LL_GPIO_PIN_5
365 * @arg @ref LL_GPIO_PIN_6
366 * @arg @ref LL_GPIO_PIN_7
367 * @arg @ref LL_GPIO_PIN_8
368 * @arg @ref LL_GPIO_PIN_9
369 * @arg @ref LL_GPIO_PIN_10
370 * @arg @ref LL_GPIO_PIN_11
371 * @arg @ref LL_GPIO_PIN_12
372 * @arg @ref LL_GPIO_PIN_13
373 * @arg @ref LL_GPIO_PIN_14
374 * @arg @ref LL_GPIO_PIN_15
375 * @arg @ref LL_GPIO_PIN_ALL
376 * @retval Returned value can be one of the following values:
377 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
378 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
379 */
LL_GPIO_GetPinOutputType(GPIO_TypeDef * GPIOx,uint32_t Pin)380 __STATIC_INLINE uint32_t LL_GPIO_GetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t Pin)
381 {
382 return (uint32_t)(READ_BIT(GPIOx->OTYPER, Pin) >> POSITION_VAL(Pin));
383 }
384
385 /**
386 * @brief Configure gpio speed for a dedicated pin on dedicated port.
387 * @note I/O speed can be Low, Medium, Fast or High speed.
388 * @note Warning: only one pin can be passed as parameter.
389 * @note Refer to datasheet for frequency specifications and the power
390 * supply and load conditions for each speed.
391 * @rmtoll OSPEEDR OSPEEDy LL_GPIO_SetPinSpeed
392 * @param GPIOx GPIO Port
393 * @param Pin This parameter can be one of the following values:
394 * @arg @ref LL_GPIO_PIN_0
395 * @arg @ref LL_GPIO_PIN_1
396 * @arg @ref LL_GPIO_PIN_2
397 * @arg @ref LL_GPIO_PIN_3
398 * @arg @ref LL_GPIO_PIN_4
399 * @arg @ref LL_GPIO_PIN_5
400 * @arg @ref LL_GPIO_PIN_6
401 * @arg @ref LL_GPIO_PIN_7
402 * @arg @ref LL_GPIO_PIN_8
403 * @arg @ref LL_GPIO_PIN_9
404 * @arg @ref LL_GPIO_PIN_10
405 * @arg @ref LL_GPIO_PIN_11
406 * @arg @ref LL_GPIO_PIN_12
407 * @arg @ref LL_GPIO_PIN_13
408 * @arg @ref LL_GPIO_PIN_14
409 * @arg @ref LL_GPIO_PIN_15
410 * @param Speed This parameter can be one of the following values:
411 * @arg @ref LL_GPIO_SPEED_FREQ_LOW
412 * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
413 * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
414 * @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
415 * @retval None
416 */
LL_GPIO_SetPinSpeed(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Speed)417 __STATIC_INLINE void LL_GPIO_SetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Speed)
418 {
419 MODIFY_REG(GPIOx->OSPEEDR, (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U)),
420 (Speed << (POSITION_VAL(Pin) * 2U)));
421 }
422
423 /**
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
453 */
LL_GPIO_GetPinSpeed(GPIO_TypeDef * GPIOx,uint32_t Pin)454 __STATIC_INLINE uint32_t LL_GPIO_GetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin)
455 {
456 return (uint32_t)(READ_BIT(GPIOx->OSPEEDR,
457 (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
458 }
459
460 /**
461 * @brief Configure gpio pull-up or pull-down for a dedicated pin on a dedicated port.
462 * @note Warning: only one pin can be passed as parameter.
463 * @rmtoll PUPDR PUPDy LL_GPIO_SetPinPull
464 * @param GPIOx GPIO Port
465 * @param Pin This parameter can be one of the following values:
466 * @arg @ref LL_GPIO_PIN_0
467 * @arg @ref LL_GPIO_PIN_1
468 * @arg @ref LL_GPIO_PIN_2
469 * @arg @ref LL_GPIO_PIN_3
470 * @arg @ref LL_GPIO_PIN_4
471 * @arg @ref LL_GPIO_PIN_5
472 * @arg @ref LL_GPIO_PIN_6
473 * @arg @ref LL_GPIO_PIN_7
474 * @arg @ref LL_GPIO_PIN_8
475 * @arg @ref LL_GPIO_PIN_9
476 * @arg @ref LL_GPIO_PIN_10
477 * @arg @ref LL_GPIO_PIN_11
478 * @arg @ref LL_GPIO_PIN_12
479 * @arg @ref LL_GPIO_PIN_13
480 * @arg @ref LL_GPIO_PIN_14
481 * @arg @ref LL_GPIO_PIN_15
482 * @param Pull This parameter can be one of the following values:
483 * @arg @ref LL_GPIO_PULL_NO
484 * @arg @ref LL_GPIO_PULL_UP
485 * @arg @ref LL_GPIO_PULL_DOWN
486 * @retval None
487 */
LL_GPIO_SetPinPull(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Pull)488 __STATIC_INLINE void LL_GPIO_SetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Pull)
489 {
490 MODIFY_REG(GPIOx->PUPDR, (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U)), (Pull << (POSITION_VAL(Pin) * 2U)));
491 }
492
493 /**
494 * @brief Return gpio pull-up or pull-down for a dedicated pin on a dedicated port
495 * @note Warning: only one pin can be passed as parameter.
496 * @rmtoll PUPDR PUPDy LL_GPIO_GetPinPull
497 * @param GPIOx GPIO Port
498 * @param Pin This parameter can be one of the following values:
499 * @arg @ref LL_GPIO_PIN_0
500 * @arg @ref LL_GPIO_PIN_1
501 * @arg @ref LL_GPIO_PIN_2
502 * @arg @ref LL_GPIO_PIN_3
503 * @arg @ref LL_GPIO_PIN_4
504 * @arg @ref LL_GPIO_PIN_5
505 * @arg @ref LL_GPIO_PIN_6
506 * @arg @ref LL_GPIO_PIN_7
507 * @arg @ref LL_GPIO_PIN_8
508 * @arg @ref LL_GPIO_PIN_9
509 * @arg @ref LL_GPIO_PIN_10
510 * @arg @ref LL_GPIO_PIN_11
511 * @arg @ref LL_GPIO_PIN_12
512 * @arg @ref LL_GPIO_PIN_13
513 * @arg @ref LL_GPIO_PIN_14
514 * @arg @ref LL_GPIO_PIN_15
515 * @retval Returned value can be one of the following values:
516 * @arg @ref LL_GPIO_PULL_NO
517 * @arg @ref LL_GPIO_PULL_UP
518 * @arg @ref LL_GPIO_PULL_DOWN
519 */
LL_GPIO_GetPinPull(GPIO_TypeDef * GPIOx,uint32_t Pin)520 __STATIC_INLINE uint32_t LL_GPIO_GetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin)
521 {
522 return (uint32_t)(READ_BIT(GPIOx->PUPDR,
523 (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
524 }
525
526 /**
527 * @brief Configure gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
528 * @note Possible values are from AF0 to AF15 depending on target.
529 * @note Warning: only one pin can be passed as parameter.
530 * @rmtoll AFRL AFSELy LL_GPIO_SetAFPin_0_7
531 * @param GPIOx GPIO Port
532 * @param Pin This parameter can be one of the following values:
533 * @arg @ref LL_GPIO_PIN_0
534 * @arg @ref LL_GPIO_PIN_1
535 * @arg @ref LL_GPIO_PIN_2
536 * @arg @ref LL_GPIO_PIN_3
537 * @arg @ref LL_GPIO_PIN_4
538 * @arg @ref LL_GPIO_PIN_5
539 * @arg @ref LL_GPIO_PIN_6
540 * @arg @ref LL_GPIO_PIN_7
541 * @param Alternate This parameter can be one of the following values:
542 * @arg @ref LL_GPIO_AF_0
543 * @arg @ref LL_GPIO_AF_1
544 * @arg @ref LL_GPIO_AF_2
545 * @arg @ref LL_GPIO_AF_3
546 * @arg @ref LL_GPIO_AF_4
547 * @arg @ref LL_GPIO_AF_5
548 * @arg @ref LL_GPIO_AF_6
549 * @arg @ref LL_GPIO_AF_7
550 * @arg @ref LL_GPIO_AF_8
551 * @arg @ref LL_GPIO_AF_9
552 * @arg @ref LL_GPIO_AF_10
553 * @arg @ref LL_GPIO_AF_11
554 * @arg @ref LL_GPIO_AF_12
555 * @arg @ref LL_GPIO_AF_13
556 * @arg @ref LL_GPIO_AF_14
557 * @arg @ref LL_GPIO_AF_15
558 * @retval None
559 */
LL_GPIO_SetAFPin_0_7(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)560 __STATIC_INLINE void LL_GPIO_SetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
561 {
562 MODIFY_REG(GPIOx->AFR[0], (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U)),
563 (Alternate << (POSITION_VAL(Pin) * 4U)));
564 }
565
566 /**
567 * @brief Return gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
568 * @rmtoll AFRL AFSELy LL_GPIO_GetAFPin_0_7
569 * @param GPIOx GPIO Port
570 * @param Pin This parameter can be one of the following values:
571 * @arg @ref LL_GPIO_PIN_0
572 * @arg @ref LL_GPIO_PIN_1
573 * @arg @ref LL_GPIO_PIN_2
574 * @arg @ref LL_GPIO_PIN_3
575 * @arg @ref LL_GPIO_PIN_4
576 * @arg @ref LL_GPIO_PIN_5
577 * @arg @ref LL_GPIO_PIN_6
578 * @arg @ref LL_GPIO_PIN_7
579 * @retval Returned value can be one of the following values:
580 * @arg @ref LL_GPIO_AF_0
581 * @arg @ref LL_GPIO_AF_1
582 * @arg @ref LL_GPIO_AF_2
583 * @arg @ref LL_GPIO_AF_3
584 * @arg @ref LL_GPIO_AF_4
585 * @arg @ref LL_GPIO_AF_5
586 * @arg @ref LL_GPIO_AF_6
587 * @arg @ref LL_GPIO_AF_7
588 * @arg @ref LL_GPIO_AF_8
589 * @arg @ref LL_GPIO_AF_9
590 * @arg @ref LL_GPIO_AF_10
591 * @arg @ref LL_GPIO_AF_11
592 * @arg @ref LL_GPIO_AF_12
593 * @arg @ref LL_GPIO_AF_13
594 * @arg @ref LL_GPIO_AF_14
595 * @arg @ref LL_GPIO_AF_15
596 */
LL_GPIO_GetAFPin_0_7(GPIO_TypeDef * GPIOx,uint32_t Pin)597 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin)
598 {
599 return (uint32_t)(READ_BIT(GPIOx->AFR[0],
600 (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U))) >> (POSITION_VAL(Pin) * 4U));
601 }
602
603 /**
604 * @brief Configure gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
605 * @note Possible values are from AF0 to AF15 depending on target.
606 * @note Warning: only one pin can be passed as parameter.
607 * @rmtoll AFRH AFSELy LL_GPIO_SetAFPin_8_15
608 * @param GPIOx GPIO Port
609 * @param Pin This parameter can be one of the following values:
610 * @arg @ref LL_GPIO_PIN_8
611 * @arg @ref LL_GPIO_PIN_9
612 * @arg @ref LL_GPIO_PIN_10
613 * @arg @ref LL_GPIO_PIN_11
614 * @arg @ref LL_GPIO_PIN_12
615 * @arg @ref LL_GPIO_PIN_13
616 * @arg @ref LL_GPIO_PIN_14
617 * @arg @ref LL_GPIO_PIN_15
618 * @param Alternate This parameter can be one of the following values:
619 * @arg @ref LL_GPIO_AF_0
620 * @arg @ref LL_GPIO_AF_1
621 * @arg @ref LL_GPIO_AF_2
622 * @arg @ref LL_GPIO_AF_3
623 * @arg @ref LL_GPIO_AF_4
624 * @arg @ref LL_GPIO_AF_5
625 * @arg @ref LL_GPIO_AF_6
626 * @arg @ref LL_GPIO_AF_7
627 * @arg @ref LL_GPIO_AF_8
628 * @arg @ref LL_GPIO_AF_9
629 * @arg @ref LL_GPIO_AF_10
630 * @arg @ref LL_GPIO_AF_11
631 * @arg @ref LL_GPIO_AF_12
632 * @arg @ref LL_GPIO_AF_13
633 * @arg @ref LL_GPIO_AF_14
634 * @arg @ref LL_GPIO_AF_15
635 * @retval None
636 */
LL_GPIO_SetAFPin_8_15(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)637 __STATIC_INLINE void LL_GPIO_SetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
638 {
639 MODIFY_REG(GPIOx->AFR[1], (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U)),
640 (Alternate << (POSITION_VAL(Pin >> 8U) * 4U)));
641 }
642
643 /**
644 * @brief Return gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
645 * @note Possible values are from AF0 to AF15 depending on target.
646 * @rmtoll AFRH AFSELy LL_GPIO_GetAFPin_8_15
647 * @param GPIOx GPIO Port
648 * @param Pin This parameter can be one of the following values:
649 * @arg @ref LL_GPIO_PIN_8
650 * @arg @ref LL_GPIO_PIN_9
651 * @arg @ref LL_GPIO_PIN_10
652 * @arg @ref LL_GPIO_PIN_11
653 * @arg @ref LL_GPIO_PIN_12
654 * @arg @ref LL_GPIO_PIN_13
655 * @arg @ref LL_GPIO_PIN_14
656 * @arg @ref LL_GPIO_PIN_15
657 * @retval Returned value can be one of the following values:
658 * @arg @ref LL_GPIO_AF_0
659 * @arg @ref LL_GPIO_AF_1
660 * @arg @ref LL_GPIO_AF_2
661 * @arg @ref LL_GPIO_AF_3
662 * @arg @ref LL_GPIO_AF_4
663 * @arg @ref LL_GPIO_AF_5
664 * @arg @ref LL_GPIO_AF_6
665 * @arg @ref LL_GPIO_AF_7
666 * @arg @ref LL_GPIO_AF_8
667 * @arg @ref LL_GPIO_AF_9
668 * @arg @ref LL_GPIO_AF_10
669 * @arg @ref LL_GPIO_AF_11
670 * @arg @ref LL_GPIO_AF_12
671 * @arg @ref LL_GPIO_AF_13
672 * @arg @ref LL_GPIO_AF_14
673 * @arg @ref LL_GPIO_AF_15
674 */
LL_GPIO_GetAFPin_8_15(GPIO_TypeDef * GPIOx,uint32_t Pin)675 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin)
676 {
677 return (uint32_t)(READ_BIT(GPIOx->AFR[1],
678 (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U))) >> (POSITION_VAL(Pin >> 8U) * 4U));
679 }
680
681 /**
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
685 * next reset.
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
708 * @retval None
709 */
LL_GPIO_LockPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)710 __STATIC_INLINE void LL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
711 {
712 __IO uint32_t temp;
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);
718 (void) temp;
719 }
720
721 /**
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).
744 */
LL_GPIO_IsPinLocked(GPIO_TypeDef * GPIOx,uint32_t PinMask)745 __STATIC_INLINE uint32_t LL_GPIO_IsPinLocked(GPIO_TypeDef *GPIOx, uint32_t PinMask)
746 {
747 return ((READ_BIT(GPIOx->LCKR, PinMask) == (PinMask)) ? 1UL : 0UL);
748 }
749
750 /**
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).
755 */
LL_GPIO_IsAnyPinLocked(GPIO_TypeDef * GPIOx)756 __STATIC_INLINE uint32_t LL_GPIO_IsAnyPinLocked(GPIO_TypeDef *GPIOx)
757 {
758 return ((READ_BIT(GPIOx->LCKR, GPIO_LCKR_LCKK) == (GPIO_LCKR_LCKK)) ? 1UL : 0UL);
759 }
760
761 /**
762 * @}
763 */
764
765 /** @defgroup GPIO_LL_EF_Data_Access Data Access
766 * @{
767 */
768
769 /**
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
774 */
LL_GPIO_ReadInputPort(GPIO_TypeDef * GPIOx)775 __STATIC_INLINE uint32_t LL_GPIO_ReadInputPort(GPIO_TypeDef *GPIOx)
776 {
777 return (uint32_t)(READ_REG(GPIOx->IDR));
778 }
779
780 /**
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).
803 */
LL_GPIO_IsInputPinSet(GPIO_TypeDef * GPIOx,uint32_t PinMask)804 __STATIC_INLINE uint32_t LL_GPIO_IsInputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
805 {
806 return ((READ_BIT(GPIOx->IDR, PinMask) == (PinMask)) ? 1UL : 0UL);
807 }
808
809 /**
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
814 * @retval None
815 */
LL_GPIO_WriteOutputPort(GPIO_TypeDef * GPIOx,uint32_t PortValue)816 __STATIC_INLINE void LL_GPIO_WriteOutputPort(GPIO_TypeDef *GPIOx, uint32_t PortValue)
817 {
818 WRITE_REG(GPIOx->ODR, PortValue);
819 }
820
821 /**
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
826 */
LL_GPIO_ReadOutputPort(GPIO_TypeDef * GPIOx)827 __STATIC_INLINE uint32_t LL_GPIO_ReadOutputPort(GPIO_TypeDef *GPIOx)
828 {
829 return (uint32_t)(READ_REG(GPIOx->ODR));
830 }
831
832 /**
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).
855 */
LL_GPIO_IsOutputPinSet(GPIO_TypeDef * GPIOx,uint32_t PinMask)856 __STATIC_INLINE uint32_t LL_GPIO_IsOutputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
857 {
858 return ((READ_BIT(GPIOx->ODR, PinMask) == (PinMask)) ? 1UL : 0UL);
859 }
860
861 /**
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
883 * @retval None
884 */
LL_GPIO_SetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)885 __STATIC_INLINE void LL_GPIO_SetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
886 {
887 WRITE_REG(GPIOx->BSRR, PinMask);
888 }
889
890 /**
891 * @brief Set several pins to low level on dedicated gpio port.
892 * @rmtoll BRR 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
912 * @retval None
913 */
LL_GPIO_ResetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)914 __STATIC_INLINE void LL_GPIO_ResetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
915 {
916 WRITE_REG(GPIOx->BRR, PinMask);
917 }
918
919 /**
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
941 * @retval None
942 */
LL_GPIO_TogglePin(GPIO_TypeDef * GPIOx,uint32_t PinMask)943 __STATIC_INLINE void LL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
944 {
945 uint32_t odr = READ_REG(GPIOx->ODR);
946 WRITE_REG(GPIOx->BSRR, ((odr & PinMask) << 16u) | (~odr & PinMask));
947 }
948
949 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
950
951 /**
952 * @brief Enable secure write only access for several pin of dedicated port.
953 * @rmtoll SECCFGR SECy LL_GPIO_EnablePinSecure
954 * @param GPIOx GPIO Port
955 * @param PinMask This parameter can be a combination of the following values:
956 * @arg @ref LL_GPIO_PIN_0
957 * @arg @ref LL_GPIO_PIN_1
958 * @arg @ref LL_GPIO_PIN_2
959 * @arg @ref LL_GPIO_PIN_3
960 * @arg @ref LL_GPIO_PIN_4
961 * @arg @ref LL_GPIO_PIN_5
962 * @arg @ref LL_GPIO_PIN_6
963 * @arg @ref LL_GPIO_PIN_7
964 * @arg @ref LL_GPIO_PIN_8
965 * @arg @ref LL_GPIO_PIN_9
966 * @arg @ref LL_GPIO_PIN_10
967 * @arg @ref LL_GPIO_PIN_11
968 * @arg @ref LL_GPIO_PIN_12
969 * @arg @ref LL_GPIO_PIN_13
970 * @arg @ref LL_GPIO_PIN_14
971 * @arg @ref LL_GPIO_PIN_15
972 * @arg @ref LL_GPIO_PIN_ALL
973 * @retval None
974 */
LL_GPIO_EnablePinSecure(GPIO_TypeDef * GPIOx,uint32_t PinMask)975 __STATIC_INLINE void LL_GPIO_EnablePinSecure(GPIO_TypeDef *GPIOx, uint32_t PinMask)
976 {
977 SET_BIT(GPIOx->SECCFGR, PinMask);
978 }
979
980
981 /**
982 * @brief Disable secure write only access for several pin of dedicated port.
983 * @rmtoll SECCFGR SECy LL_GPIO_DisablePinSecure
984 * @param GPIOx GPIO Port
985 * @param PinMask This parameter can be a combination of the following values:
986 * @arg @ref LL_GPIO_PIN_0
987 * @arg @ref LL_GPIO_PIN_1
988 * @arg @ref LL_GPIO_PIN_2
989 * @arg @ref LL_GPIO_PIN_3
990 * @arg @ref LL_GPIO_PIN_4
991 * @arg @ref LL_GPIO_PIN_5
992 * @arg @ref LL_GPIO_PIN_6
993 * @arg @ref LL_GPIO_PIN_7
994 * @arg @ref LL_GPIO_PIN_8
995 * @arg @ref LL_GPIO_PIN_9
996 * @arg @ref LL_GPIO_PIN_10
997 * @arg @ref LL_GPIO_PIN_11
998 * @arg @ref LL_GPIO_PIN_12
999 * @arg @ref LL_GPIO_PIN_13
1000 * @arg @ref LL_GPIO_PIN_14
1001 * @arg @ref LL_GPIO_PIN_15
1002 * @arg @ref LL_GPIO_PIN_ALL
1003 * @retval None
1004 */
LL_GPIO_DisablePinSecure(GPIO_TypeDef * GPIOx,uint32_t PinMask)1005 __STATIC_INLINE void LL_GPIO_DisablePinSecure(GPIO_TypeDef *GPIOx, uint32_t PinMask)
1006 {
1007 CLEAR_BIT(GPIOx->SECCFGR, PinMask);
1008 }
1009
1010 #endif /* __ARM_FEATURE_CMSE */
1011
1012 /**
1013 * @brief Return if secure write only access for several pin of dedicated port is enabled or not.
1014 * @rmtoll SECCFGR SECy LL_GPIO_IsEnabledPinSecure
1015 * @param GPIOx GPIO Port
1016 * @param PinMask This parameter can be a combination of the following values:
1017 * @arg @ref LL_GPIO_PIN_0
1018 * @arg @ref LL_GPIO_PIN_1
1019 * @arg @ref LL_GPIO_PIN_2
1020 * @arg @ref LL_GPIO_PIN_3
1021 * @arg @ref LL_GPIO_PIN_4
1022 * @arg @ref LL_GPIO_PIN_5
1023 * @arg @ref LL_GPIO_PIN_6
1024 * @arg @ref LL_GPIO_PIN_7
1025 * @arg @ref LL_GPIO_PIN_8
1026 * @arg @ref LL_GPIO_PIN_9
1027 * @arg @ref LL_GPIO_PIN_10
1028 * @arg @ref LL_GPIO_PIN_11
1029 * @arg @ref LL_GPIO_PIN_12
1030 * @arg @ref LL_GPIO_PIN_13
1031 * @arg @ref LL_GPIO_PIN_14
1032 * @arg @ref LL_GPIO_PIN_15
1033 * @arg @ref LL_GPIO_PIN_ALL
1034 * @retval State of bit (1 or 0).
1035 */
LL_GPIO_IsEnabledPinSecure(GPIO_TypeDef * GPIOx,uint32_t PinMask)1036 __STATIC_INLINE uint32_t LL_GPIO_IsEnabledPinSecure(GPIO_TypeDef *GPIOx, uint32_t PinMask)
1037 {
1038 return ((READ_BIT(GPIOx->SECCFGR, PinMask) == (PinMask)) ? 1UL : 0UL);
1039 }
1040
1041
1042 /**
1043 * @}
1044 */
1045
1046 #if defined(USE_FULL_LL_DRIVER)
1047 /** @defgroup GPIO_LL_EF_Init Initialization and de-initialization functions
1048 * @{
1049 */
1050
1051 ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx);
1052 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct);
1053 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct);
1054
1055 /**
1056 * @}
1057 */
1058 #endif /* USE_FULL_LL_DRIVER */
1059
1060 /**
1061 * @}
1062 */
1063
1064 /**
1065 * @}
1066 */
1067
1068 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) */
1069 /**
1070 * @}
1071 */
1072
1073 #ifdef __cplusplus
1074 }
1075 #endif
1076
1077 #endif /* STM32L5xx_LL_GPIO_H */
1078
1079
