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