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