1 /**
2 ******************************************************************************
3 * @file stm32wbaxx_ll_gpio.h
4 * @author MCD Application Team
5 * @brief Header file of GPIO LL module.
6 ******************************************************************************
7 * @attention
8 *
9 * Copyright (c) 2022 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 __STM32WBAxx_LL_GPIO_H
21 #define __STM32WBAxx_LL_GPIO_H
22
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32wbaxx.h"
29
30 /** @addtogroup STM32WBAxx_LL_Driver
31 * @{
32 */
33
34 #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOH)
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 /**
168 * @}
169 */
170 #define LL_GPIO_SPEED_LOW LL_GPIO_SPEED_FREQ_LOW
171 #define LL_GPIO_SPEED_MEDIUM LL_GPIO_SPEED_FREQ_MEDIUM
172 #define LL_GPIO_SPEED_FAST LL_GPIO_SPEED_FREQ_HIGH
173
174
175 /** @defgroup GPIO_LL_EC_PULL Pull Up Pull Down
176 * @{
177 */
178 #define LL_GPIO_PULL_NO (0x00000000U) /*!< Select I/O no pull */
179 #define LL_GPIO_PULL_UP GPIO_PUPDR_PUPD0_0 /*!< Select I/O pull up */
180 #define LL_GPIO_PULL_DOWN GPIO_PUPDR_PUPD0_1 /*!< Select I/O pull down */
181 /**
182 * @}
183 */
184
185 /** @defgroup GPIO_LL_EC_AF Alternate Function
186 * @{
187 */
188 #define LL_GPIO_AF_0 (0x0000000U) /*!< Select alternate function 0 */
189 #define LL_GPIO_AF_1 (0x0000001U) /*!< Select alternate function 1 */
190 #define LL_GPIO_AF_2 (0x0000002U) /*!< Select alternate function 2 */
191 #define LL_GPIO_AF_3 (0x0000003U) /*!< Select alternate function 3 */
192 #define LL_GPIO_AF_4 (0x0000004U) /*!< Select alternate function 4 */
193 #define LL_GPIO_AF_5 (0x0000005U) /*!< Select alternate function 5 */
194 #define LL_GPIO_AF_6 (0x0000006U) /*!< Select alternate function 6 */
195 #define LL_GPIO_AF_7 (0x0000007U) /*!< Select alternate function 7 */
196 #define LL_GPIO_AF_8 (0x0000008U) /*!< Select alternate function 8 */
197 #define LL_GPIO_AF_9 (0x0000009U) /*!< Select alternate function 9 */
198 #define LL_GPIO_AF_10 (0x000000AU) /*!< Select alternate function 10 */
199 #define LL_GPIO_AF_11 (0x000000BU) /*!< Select alternate function 11 */
200 #define LL_GPIO_AF_12 (0x000000CU) /*!< Select alternate function 12 */
201 #define LL_GPIO_AF_13 (0x000000DU) /*!< Select alternate function 13 */
202 #define LL_GPIO_AF_14 (0x000000EU) /*!< Select alternate function 14 */
203 #define LL_GPIO_AF_15 (0x000000FU) /*!< Select alternate function 15 */
204 /**
205 * @}
206 */
207
208 /**
209 * @}
210 */
211
212 /* Exported macro ------------------------------------------------------------*/
213 /** @defgroup GPIO_LL_Exported_Macros GPIO Exported Macros
214 * @{
215 */
216
217 /** @defgroup GPIO_LL_EM_WRITE_READ Common Write and read registers Macros
218 * @{
219 */
220
221 /**
222 * @brief Write a value in GPIO register
223 * @param __INSTANCE__ GPIO Instance
224 * @param __REG__ Register to be written
225 * @param __VALUE__ Value to be written in the register
226 * @retval None
227 */
228 #define LL_GPIO_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
229
230 /**
231 * @brief Read a value in GPIO register
232 * @param __INSTANCE__ GPIO Instance
233 * @param __REG__ Register to be read
234 * @retval Register value
235 */
236 #define LL_GPIO_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
237 /**
238 * @}
239 */
240
241 /**
242 * @}
243 */
244
245 /* Exported functions --------------------------------------------------------*/
246 /** @defgroup GPIO_LL_Exported_Functions GPIO Exported Functions
247 * @{
248 */
249
250 /** @defgroup GPIO_LL_EF_Port_Configuration Port Configuration
251 * @{
252 */
253
254 /**
255 * @brief Configure gpio mode for a dedicated pin on dedicated port.
256 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
257 * @note Warning: only one pin can be passed as parameter.
258 * @rmtoll MODER MODEy LL_GPIO_SetPinMode
259 * @param GPIOx GPIO Port
260 * @param Pin This parameter can be one of the following values:
261 * @arg @ref LL_GPIO_PIN_0
262 * @arg @ref LL_GPIO_PIN_1
263 * @arg @ref LL_GPIO_PIN_2
264 * @arg @ref LL_GPIO_PIN_3
265 * @arg @ref LL_GPIO_PIN_4
266 * @arg @ref LL_GPIO_PIN_5
267 * @arg @ref LL_GPIO_PIN_6
268 * @arg @ref LL_GPIO_PIN_7
269 * @arg @ref LL_GPIO_PIN_8
270 * @arg @ref LL_GPIO_PIN_9
271 * @arg @ref LL_GPIO_PIN_10
272 * @arg @ref LL_GPIO_PIN_11
273 * @arg @ref LL_GPIO_PIN_12
274 * @arg @ref LL_GPIO_PIN_13
275 * @arg @ref LL_GPIO_PIN_14
276 * @arg @ref LL_GPIO_PIN_15
277 * @param Mode This parameter can be one of the following values:
278 * @arg @ref LL_GPIO_MODE_INPUT
279 * @arg @ref LL_GPIO_MODE_OUTPUT
280 * @arg @ref LL_GPIO_MODE_ALTERNATE
281 * @arg @ref LL_GPIO_MODE_ANALOG
282 * @retval None
283 */
LL_GPIO_SetPinMode(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Mode)284 __STATIC_INLINE void LL_GPIO_SetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Mode)
285 {
286 MODIFY_REG(GPIOx->MODER, (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U)), (Mode << (POSITION_VAL(Pin) * 2U)));
287 }
288
289 /**
290 * @brief Return gpio mode for a dedicated pin on dedicated port.
291 * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
292 * @note Warning: only one pin can be passed as parameter.
293 * @rmtoll MODER MODEy LL_GPIO_GetPinMode
294 * @param GPIOx GPIO Port
295 * @param Pin This parameter can be one of the following values:
296 * @arg @ref LL_GPIO_PIN_0
297 * @arg @ref LL_GPIO_PIN_1
298 * @arg @ref LL_GPIO_PIN_2
299 * @arg @ref LL_GPIO_PIN_3
300 * @arg @ref LL_GPIO_PIN_4
301 * @arg @ref LL_GPIO_PIN_5
302 * @arg @ref LL_GPIO_PIN_6
303 * @arg @ref LL_GPIO_PIN_7
304 * @arg @ref LL_GPIO_PIN_8
305 * @arg @ref LL_GPIO_PIN_9
306 * @arg @ref LL_GPIO_PIN_10
307 * @arg @ref LL_GPIO_PIN_11
308 * @arg @ref LL_GPIO_PIN_12
309 * @arg @ref LL_GPIO_PIN_13
310 * @arg @ref LL_GPIO_PIN_14
311 * @arg @ref LL_GPIO_PIN_15
312 * @retval Returned value can be one of the following values:
313 * @arg @ref LL_GPIO_MODE_INPUT
314 * @arg @ref LL_GPIO_MODE_OUTPUT
315 * @arg @ref LL_GPIO_MODE_ALTERNATE
316 * @arg @ref LL_GPIO_MODE_ANALOG
317 */
LL_GPIO_GetPinMode(const GPIO_TypeDef * GPIOx,uint32_t Pin)318 __STATIC_INLINE uint32_t LL_GPIO_GetPinMode(const GPIO_TypeDef *GPIOx, uint32_t Pin)
319 {
320 return (uint32_t)(READ_BIT(GPIOx->MODER,
321 (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
322 }
323
324 /**
325 * @brief Configure gpio output type for several pins on dedicated port.
326 * @note Output type as to be set when gpio pin is in output or
327 * alternate modes. Possible type are Push-pull or Open-drain.
328 * @rmtoll OTYPER OTy LL_GPIO_SetPinOutputType
329 * @param GPIOx GPIO Port
330 * @param PinMask This parameter can be a combination of the following values:
331 * @arg @ref LL_GPIO_PIN_0
332 * @arg @ref LL_GPIO_PIN_1
333 * @arg @ref LL_GPIO_PIN_2
334 * @arg @ref LL_GPIO_PIN_3
335 * @arg @ref LL_GPIO_PIN_4
336 * @arg @ref LL_GPIO_PIN_5
337 * @arg @ref LL_GPIO_PIN_6
338 * @arg @ref LL_GPIO_PIN_7
339 * @arg @ref LL_GPIO_PIN_8
340 * @arg @ref LL_GPIO_PIN_9
341 * @arg @ref LL_GPIO_PIN_10
342 * @arg @ref LL_GPIO_PIN_11
343 * @arg @ref LL_GPIO_PIN_12
344 * @arg @ref LL_GPIO_PIN_13
345 * @arg @ref LL_GPIO_PIN_14
346 * @arg @ref LL_GPIO_PIN_15
347 * @arg @ref LL_GPIO_PIN_ALL
348 * @param OutputType This parameter can be one of the following values:
349 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
350 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
351 * @retval None
352 */
LL_GPIO_SetPinOutputType(GPIO_TypeDef * GPIOx,uint32_t PinMask,uint32_t OutputType)353 __STATIC_INLINE void LL_GPIO_SetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t PinMask, uint32_t OutputType)
354 {
355 MODIFY_REG(GPIOx->OTYPER, PinMask, (PinMask * OutputType));
356 }
357
358 /**
359 * @brief Return gpio output type for several pins on dedicated port.
360 * @note Output type as to be set when gpio pin is in output or
361 * alternate modes. Possible type are Push-pull or Open-drain.
362 * @note Warning: only one pin can be passed as parameter.
363 * @rmtoll OTYPER OTy LL_GPIO_GetPinOutputType
364 * @param GPIOx GPIO Port
365 * @param Pin This parameter can be one of the following values:
366 * @arg @ref LL_GPIO_PIN_0
367 * @arg @ref LL_GPIO_PIN_1
368 * @arg @ref LL_GPIO_PIN_2
369 * @arg @ref LL_GPIO_PIN_3
370 * @arg @ref LL_GPIO_PIN_4
371 * @arg @ref LL_GPIO_PIN_5
372 * @arg @ref LL_GPIO_PIN_6
373 * @arg @ref LL_GPIO_PIN_7
374 * @arg @ref LL_GPIO_PIN_8
375 * @arg @ref LL_GPIO_PIN_9
376 * @arg @ref LL_GPIO_PIN_10
377 * @arg @ref LL_GPIO_PIN_11
378 * @arg @ref LL_GPIO_PIN_12
379 * @arg @ref LL_GPIO_PIN_13
380 * @arg @ref LL_GPIO_PIN_14
381 * @arg @ref LL_GPIO_PIN_15
382 * @arg @ref LL_GPIO_PIN_ALL
383 * @retval Returned value can be one of the following values:
384 * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
385 * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
386 */
LL_GPIO_GetPinOutputType(const GPIO_TypeDef * GPIOx,uint32_t Pin)387 __STATIC_INLINE uint32_t LL_GPIO_GetPinOutputType(const GPIO_TypeDef *GPIOx, uint32_t Pin)
388 {
389 return (uint32_t)(READ_BIT(GPIOx->OTYPER, Pin) >> POSITION_VAL(Pin));
390 }
391
392 /**
393 * @brief Configure gpio speed for a dedicated pin on dedicated port.
394 * @note I/O speed can be Low, Medium, Fast or High speed.
395 * @note Warning: only one pin can be passed as parameter.
396 * @note Refer to datasheet for frequency specifications and the power
397 * supply and load conditions for each speed.
398 * @rmtoll OSPEEDR OSPEEDy LL_GPIO_SetPinSpeed
399 * @param GPIOx GPIO Port
400 * @param Pin This parameter can be one of the following values:
401 * @arg @ref LL_GPIO_PIN_0
402 * @arg @ref LL_GPIO_PIN_1
403 * @arg @ref LL_GPIO_PIN_2
404 * @arg @ref LL_GPIO_PIN_3
405 * @arg @ref LL_GPIO_PIN_4
406 * @arg @ref LL_GPIO_PIN_5
407 * @arg @ref LL_GPIO_PIN_6
408 * @arg @ref LL_GPIO_PIN_7
409 * @arg @ref LL_GPIO_PIN_8
410 * @arg @ref LL_GPIO_PIN_9
411 * @arg @ref LL_GPIO_PIN_10
412 * @arg @ref LL_GPIO_PIN_11
413 * @arg @ref LL_GPIO_PIN_12
414 * @arg @ref LL_GPIO_PIN_13
415 * @arg @ref LL_GPIO_PIN_14
416 * @arg @ref LL_GPIO_PIN_15
417 * @param Speed This parameter can be one of the following values:
418 * @arg @ref LL_GPIO_SPEED_FREQ_LOW
419 * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
420 * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
421 * @retval None
422 */
LL_GPIO_SetPinSpeed(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Speed)423 __STATIC_INLINE void LL_GPIO_SetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Speed)
424 {
425 MODIFY_REG(GPIOx->OSPEEDR, (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U)),
426 (Speed << (POSITION_VAL(Pin) * 2U)));
427 }
428
429 /**
430 * @brief Return gpio speed for a dedicated pin on dedicated port.
431 * @note I/O speed can be Low, Medium, Fast or High speed.
432 * @note Warning: only one pin can be passed as parameter.
433 * @note Refer to datasheet for frequency specifications and the power
434 * supply and load conditions for each speed.
435 * @rmtoll OSPEEDR OSPEEDy LL_GPIO_GetPinSpeed
436 * @param GPIOx GPIO Port
437 * @param Pin This parameter can be one of the following values:
438 * @arg @ref LL_GPIO_PIN_0
439 * @arg @ref LL_GPIO_PIN_1
440 * @arg @ref LL_GPIO_PIN_2
441 * @arg @ref LL_GPIO_PIN_3
442 * @arg @ref LL_GPIO_PIN_4
443 * @arg @ref LL_GPIO_PIN_5
444 * @arg @ref LL_GPIO_PIN_6
445 * @arg @ref LL_GPIO_PIN_7
446 * @arg @ref LL_GPIO_PIN_8
447 * @arg @ref LL_GPIO_PIN_9
448 * @arg @ref LL_GPIO_PIN_10
449 * @arg @ref LL_GPIO_PIN_11
450 * @arg @ref LL_GPIO_PIN_12
451 * @arg @ref LL_GPIO_PIN_13
452 * @arg @ref LL_GPIO_PIN_14
453 * @arg @ref LL_GPIO_PIN_15
454 * @retval Returned value can be one of the following values:
455 * @arg @ref LL_GPIO_SPEED_FREQ_LOW
456 * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
457 * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
458 */
LL_GPIO_GetPinSpeed(const GPIO_TypeDef * GPIOx,uint32_t Pin)459 __STATIC_INLINE uint32_t LL_GPIO_GetPinSpeed(const GPIO_TypeDef *GPIOx, uint32_t Pin)
460 {
461 return (uint32_t)(READ_BIT(GPIOx->OSPEEDR,
462 (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
463 }
464
465 /**
466 * @brief Configure gpio pull-up or pull-down for a dedicated pin on a dedicated port.
467 * @note Warning: only one pin can be passed as parameter.
468 * @rmtoll PUPDR PUPDy LL_GPIO_SetPinPull
469 * @param GPIOx GPIO Port
470 * @param Pin This parameter can be one of the following values:
471 * @arg @ref LL_GPIO_PIN_0
472 * @arg @ref LL_GPIO_PIN_1
473 * @arg @ref LL_GPIO_PIN_2
474 * @arg @ref LL_GPIO_PIN_3
475 * @arg @ref LL_GPIO_PIN_4
476 * @arg @ref LL_GPIO_PIN_5
477 * @arg @ref LL_GPIO_PIN_6
478 * @arg @ref LL_GPIO_PIN_7
479 * @arg @ref LL_GPIO_PIN_8
480 * @arg @ref LL_GPIO_PIN_9
481 * @arg @ref LL_GPIO_PIN_10
482 * @arg @ref LL_GPIO_PIN_11
483 * @arg @ref LL_GPIO_PIN_12
484 * @arg @ref LL_GPIO_PIN_13
485 * @arg @ref LL_GPIO_PIN_14
486 * @arg @ref LL_GPIO_PIN_15
487 * @param Pull This parameter can be one of the following values:
488 * @arg @ref LL_GPIO_PULL_NO
489 * @arg @ref LL_GPIO_PULL_UP
490 * @arg @ref LL_GPIO_PULL_DOWN
491 * @retval None
492 */
LL_GPIO_SetPinPull(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Pull)493 __STATIC_INLINE void LL_GPIO_SetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Pull)
494 {
495 MODIFY_REG(GPIOx->PUPDR, (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U)), (Pull << (POSITION_VAL(Pin) * 2U)));
496 }
497
498 /**
499 * @brief Return gpio pull-up or pull-down for a dedicated pin on a dedicated port
500 * @note Warning: only one pin can be passed as parameter.
501 * @rmtoll PUPDR PUPDy LL_GPIO_GetPinPull
502 * @param GPIOx GPIO Port
503 * @param Pin This parameter can be one of the following values:
504 * @arg @ref LL_GPIO_PIN_0
505 * @arg @ref LL_GPIO_PIN_1
506 * @arg @ref LL_GPIO_PIN_2
507 * @arg @ref LL_GPIO_PIN_3
508 * @arg @ref LL_GPIO_PIN_4
509 * @arg @ref LL_GPIO_PIN_5
510 * @arg @ref LL_GPIO_PIN_6
511 * @arg @ref LL_GPIO_PIN_7
512 * @arg @ref LL_GPIO_PIN_8
513 * @arg @ref LL_GPIO_PIN_9
514 * @arg @ref LL_GPIO_PIN_10
515 * @arg @ref LL_GPIO_PIN_11
516 * @arg @ref LL_GPIO_PIN_12
517 * @arg @ref LL_GPIO_PIN_13
518 * @arg @ref LL_GPIO_PIN_14
519 * @arg @ref LL_GPIO_PIN_15
520 * @retval Returned value can be one of the following values:
521 * @arg @ref LL_GPIO_PULL_NO
522 * @arg @ref LL_GPIO_PULL_UP
523 * @arg @ref LL_GPIO_PULL_DOWN
524 */
LL_GPIO_GetPinPull(const GPIO_TypeDef * GPIOx,uint32_t Pin)525 __STATIC_INLINE uint32_t LL_GPIO_GetPinPull(const GPIO_TypeDef *GPIOx, uint32_t Pin)
526 {
527 return (uint32_t)(READ_BIT(GPIOx->PUPDR,
528 (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
529 }
530
531 /**
532 * @brief Configure gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
533 * @note Possible values are from AF0 to AF15 depending on target.
534 * @note Warning: only one pin can be passed as parameter.
535 * @rmtoll AFRL AFSELy LL_GPIO_SetAFPin_0_7
536 * @param GPIOx GPIO Port
537 * @param Pin This parameter can be one of the following values:
538 * @arg @ref LL_GPIO_PIN_0
539 * @arg @ref LL_GPIO_PIN_1
540 * @arg @ref LL_GPIO_PIN_2
541 * @arg @ref LL_GPIO_PIN_3
542 * @arg @ref LL_GPIO_PIN_4
543 * @arg @ref LL_GPIO_PIN_5
544 * @arg @ref LL_GPIO_PIN_6
545 * @arg @ref LL_GPIO_PIN_7
546 * @param Alternate This parameter can be one of the following values:
547 * @arg @ref LL_GPIO_AF_0
548 * @arg @ref LL_GPIO_AF_1
549 * @arg @ref LL_GPIO_AF_2
550 * @arg @ref LL_GPIO_AF_3
551 * @arg @ref LL_GPIO_AF_4
552 * @arg @ref LL_GPIO_AF_5
553 * @arg @ref LL_GPIO_AF_6
554 * @arg @ref LL_GPIO_AF_7
555 * @arg @ref LL_GPIO_AF_8
556 * @arg @ref LL_GPIO_AF_9
557 * @arg @ref LL_GPIO_AF_10
558 * @arg @ref LL_GPIO_AF_11
559 * @arg @ref LL_GPIO_AF_12
560 * @arg @ref LL_GPIO_AF_13
561 * @arg @ref LL_GPIO_AF_14
562 * @arg @ref LL_GPIO_AF_15
563 * @retval None
564 */
LL_GPIO_SetAFPin_0_7(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)565 __STATIC_INLINE void LL_GPIO_SetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
566 {
567 MODIFY_REG(GPIOx->AFR[0], (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U)),
568 (Alternate << (POSITION_VAL(Pin) * 4U)));
569 }
570
571 /**
572 * @brief Return gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
573 * @rmtoll AFRL AFSELy LL_GPIO_GetAFPin_0_7
574 * @param GPIOx GPIO Port
575 * @param Pin This parameter can be one of the following values:
576 * @arg @ref LL_GPIO_PIN_0
577 * @arg @ref LL_GPIO_PIN_1
578 * @arg @ref LL_GPIO_PIN_2
579 * @arg @ref LL_GPIO_PIN_3
580 * @arg @ref LL_GPIO_PIN_4
581 * @arg @ref LL_GPIO_PIN_5
582 * @arg @ref LL_GPIO_PIN_6
583 * @arg @ref LL_GPIO_PIN_7
584 * @retval Returned value can be one of the following values:
585 * @arg @ref LL_GPIO_AF_0
586 * @arg @ref LL_GPIO_AF_1
587 * @arg @ref LL_GPIO_AF_2
588 * @arg @ref LL_GPIO_AF_3
589 * @arg @ref LL_GPIO_AF_4
590 * @arg @ref LL_GPIO_AF_5
591 * @arg @ref LL_GPIO_AF_6
592 * @arg @ref LL_GPIO_AF_7
593 * @arg @ref LL_GPIO_AF_8
594 * @arg @ref LL_GPIO_AF_9
595 * @arg @ref LL_GPIO_AF_10
596 * @arg @ref LL_GPIO_AF_11
597 * @arg @ref LL_GPIO_AF_12
598 * @arg @ref LL_GPIO_AF_13
599 * @arg @ref LL_GPIO_AF_14
600 * @arg @ref LL_GPIO_AF_15
601 */
LL_GPIO_GetAFPin_0_7(const GPIO_TypeDef * GPIOx,uint32_t Pin)602 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_0_7(const GPIO_TypeDef *GPIOx, uint32_t Pin)
603 {
604 return (uint32_t)(READ_BIT(GPIOx->AFR[0],
605 (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U))) >> (POSITION_VAL(Pin) * 4U));
606 }
607
608 /**
609 * @brief Configure gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
610 * @note Possible values are from AF0 to AF15 depending on target.
611 * @note Warning: only one pin can be passed as parameter.
612 * @rmtoll AFRH AFSELy LL_GPIO_SetAFPin_8_15
613 * @param GPIOx GPIO Port
614 * @param Pin This parameter can be one of the following values:
615 * @arg @ref LL_GPIO_PIN_8
616 * @arg @ref LL_GPIO_PIN_9
617 * @arg @ref LL_GPIO_PIN_10
618 * @arg @ref LL_GPIO_PIN_11
619 * @arg @ref LL_GPIO_PIN_12
620 * @arg @ref LL_GPIO_PIN_13
621 * @arg @ref LL_GPIO_PIN_14
622 * @arg @ref LL_GPIO_PIN_15
623 * @param Alternate This parameter can be one of the following values:
624 * @arg @ref LL_GPIO_AF_0
625 * @arg @ref LL_GPIO_AF_1
626 * @arg @ref LL_GPIO_AF_2
627 * @arg @ref LL_GPIO_AF_3
628 * @arg @ref LL_GPIO_AF_4
629 * @arg @ref LL_GPIO_AF_5
630 * @arg @ref LL_GPIO_AF_6
631 * @arg @ref LL_GPIO_AF_7
632 * @arg @ref LL_GPIO_AF_8
633 * @arg @ref LL_GPIO_AF_9
634 * @arg @ref LL_GPIO_AF_10
635 * @arg @ref LL_GPIO_AF_11
636 * @arg @ref LL_GPIO_AF_12
637 * @arg @ref LL_GPIO_AF_13
638 * @arg @ref LL_GPIO_AF_14
639 * @arg @ref LL_GPIO_AF_15
640 * @retval None
641 */
LL_GPIO_SetAFPin_8_15(GPIO_TypeDef * GPIOx,uint32_t Pin,uint32_t Alternate)642 __STATIC_INLINE void LL_GPIO_SetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
643 {
644 MODIFY_REG(GPIOx->AFR[1], (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U)),
645 (Alternate << (POSITION_VAL(Pin >> 8U) * 4U)));
646 }
647
648 /**
649 * @brief Return gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
650 * @note Possible values are from AF0 to AF15 depending on target.
651 * @rmtoll AFRH AFSELy LL_GPIO_GetAFPin_8_15
652 * @param GPIOx GPIO Port
653 * @param Pin This parameter can be one of the following values:
654 * @arg @ref LL_GPIO_PIN_8
655 * @arg @ref LL_GPIO_PIN_9
656 * @arg @ref LL_GPIO_PIN_10
657 * @arg @ref LL_GPIO_PIN_11
658 * @arg @ref LL_GPIO_PIN_12
659 * @arg @ref LL_GPIO_PIN_13
660 * @arg @ref LL_GPIO_PIN_14
661 * @arg @ref LL_GPIO_PIN_15
662 * @retval Returned value can be one of the following values:
663 * @arg @ref LL_GPIO_AF_0
664 * @arg @ref LL_GPIO_AF_1
665 * @arg @ref LL_GPIO_AF_2
666 * @arg @ref LL_GPIO_AF_3
667 * @arg @ref LL_GPIO_AF_4
668 * @arg @ref LL_GPIO_AF_5
669 * @arg @ref LL_GPIO_AF_6
670 * @arg @ref LL_GPIO_AF_7
671 * @arg @ref LL_GPIO_AF_8
672 * @arg @ref LL_GPIO_AF_9
673 * @arg @ref LL_GPIO_AF_10
674 * @arg @ref LL_GPIO_AF_11
675 * @arg @ref LL_GPIO_AF_12
676 * @arg @ref LL_GPIO_AF_13
677 * @arg @ref LL_GPIO_AF_14
678 * @arg @ref LL_GPIO_AF_15
679 */
LL_GPIO_GetAFPin_8_15(const GPIO_TypeDef * GPIOx,uint32_t Pin)680 __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_8_15(const GPIO_TypeDef *GPIOx, uint32_t Pin)
681 {
682 return (uint32_t)(READ_BIT(GPIOx->AFR[1],
683 (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U))) >> (POSITION_VAL(Pin >> 8U) * 4U));
684 }
685
686
687 /**
688 * @brief Lock configuration of several pins for a dedicated port.
689 * @note When the lock sequence has been applied on a port bit, the
690 * value of this port bit can no longer be modified until the
691 * next reset.
692 * @note Each lock bit freezes a specific configuration register
693 * (control and alternate function registers).
694 * @rmtoll LCKR LCKK LL_GPIO_LockPin
695 * @param GPIOx GPIO Port
696 * @param PinMask This parameter can be a combination of the following values:
697 * @arg @ref LL_GPIO_PIN_0
698 * @arg @ref LL_GPIO_PIN_1
699 * @arg @ref LL_GPIO_PIN_2
700 * @arg @ref LL_GPIO_PIN_3
701 * @arg @ref LL_GPIO_PIN_4
702 * @arg @ref LL_GPIO_PIN_5
703 * @arg @ref LL_GPIO_PIN_6
704 * @arg @ref LL_GPIO_PIN_7
705 * @arg @ref LL_GPIO_PIN_8
706 * @arg @ref LL_GPIO_PIN_9
707 * @arg @ref LL_GPIO_PIN_10
708 * @arg @ref LL_GPIO_PIN_11
709 * @arg @ref LL_GPIO_PIN_12
710 * @arg @ref LL_GPIO_PIN_13
711 * @arg @ref LL_GPIO_PIN_14
712 * @arg @ref LL_GPIO_PIN_15
713 * @arg @ref LL_GPIO_PIN_ALL
714 * @retval None
715 */
LL_GPIO_LockPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)716 __STATIC_INLINE void LL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
717 {
718 __IO uint32_t temp;
719 WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
720 WRITE_REG(GPIOx->LCKR, PinMask);
721 WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
722 /* Read LCKK register. This read is mandatory to complete key lock sequence */
723 temp = READ_REG(GPIOx->LCKR);
724 (void) temp;
725 }
726
727 /**
728 * @brief Return 1 if all pins passed as parameter, of a dedicated port, are locked. else Return 0.
729 * @rmtoll LCKR LCKy LL_GPIO_IsPinLocked
730 * @param GPIOx GPIO Port
731 * @param PinMask This parameter can be a combination of the following values:
732 * @arg @ref LL_GPIO_PIN_0
733 * @arg @ref LL_GPIO_PIN_1
734 * @arg @ref LL_GPIO_PIN_2
735 * @arg @ref LL_GPIO_PIN_3
736 * @arg @ref LL_GPIO_PIN_4
737 * @arg @ref LL_GPIO_PIN_5
738 * @arg @ref LL_GPIO_PIN_6
739 * @arg @ref LL_GPIO_PIN_7
740 * @arg @ref LL_GPIO_PIN_8
741 * @arg @ref LL_GPIO_PIN_9
742 * @arg @ref LL_GPIO_PIN_10
743 * @arg @ref LL_GPIO_PIN_11
744 * @arg @ref LL_GPIO_PIN_12
745 * @arg @ref LL_GPIO_PIN_13
746 * @arg @ref LL_GPIO_PIN_14
747 * @arg @ref LL_GPIO_PIN_15
748 * @arg @ref LL_GPIO_PIN_ALL
749 * @retval State of bit (1 or 0).
750 */
LL_GPIO_IsPinLocked(const GPIO_TypeDef * GPIOx,uint32_t PinMask)751 __STATIC_INLINE uint32_t LL_GPIO_IsPinLocked(const GPIO_TypeDef *GPIOx, uint32_t PinMask)
752 {
753 return ((READ_BIT(GPIOx->LCKR, PinMask) == (PinMask)) ? 1UL : 0UL);
754 }
755
756 /**
757 * @brief Return 1 if one of the pin of a dedicated port is locked. else return 0.
758 * @rmtoll LCKR LCKK LL_GPIO_IsAnyPinLocked
759 * @param GPIOx GPIO Port
760 * @retval State of bit (1 or 0).
761 */
LL_GPIO_IsAnyPinLocked(const GPIO_TypeDef * GPIOx)762 __STATIC_INLINE uint32_t LL_GPIO_IsAnyPinLocked(const GPIO_TypeDef *GPIOx)
763 {
764 return ((READ_BIT(GPIOx->LCKR, GPIO_LCKR_LCKK) == (GPIO_LCKR_LCKK)) ? 1UL : 0UL);
765 }
766
767 /**
768 * @}
769 */
770
771 /** @defgroup GPIO_LL_EF_Data_Access Data Access
772 * @{
773 */
774
775 /**
776 * @brief Return full input data register value for a dedicated port.
777 * @rmtoll IDR IDy LL_GPIO_ReadInputPort
778 * @param GPIOx GPIO Port
779 * @retval Input data register value of port
780 */
LL_GPIO_ReadInputPort(const GPIO_TypeDef * GPIOx)781 __STATIC_INLINE uint32_t LL_GPIO_ReadInputPort(const GPIO_TypeDef *GPIOx)
782 {
783 return (uint32_t)(READ_REG(GPIOx->IDR));
784 }
785
786 /**
787 * @brief Return if input data level for several pins of dedicated port is high or low.
788 * @rmtoll IDR IDy LL_GPIO_IsInputPinSet
789 * @param GPIOx GPIO Port
790 * @param PinMask This parameter can be a combination of the following values:
791 * @arg @ref LL_GPIO_PIN_0
792 * @arg @ref LL_GPIO_PIN_1
793 * @arg @ref LL_GPIO_PIN_2
794 * @arg @ref LL_GPIO_PIN_3
795 * @arg @ref LL_GPIO_PIN_4
796 * @arg @ref LL_GPIO_PIN_5
797 * @arg @ref LL_GPIO_PIN_6
798 * @arg @ref LL_GPIO_PIN_7
799 * @arg @ref LL_GPIO_PIN_8
800 * @arg @ref LL_GPIO_PIN_9
801 * @arg @ref LL_GPIO_PIN_10
802 * @arg @ref LL_GPIO_PIN_11
803 * @arg @ref LL_GPIO_PIN_12
804 * @arg @ref LL_GPIO_PIN_13
805 * @arg @ref LL_GPIO_PIN_14
806 * @arg @ref LL_GPIO_PIN_15
807 * @arg @ref LL_GPIO_PIN_ALL
808 * @retval State of bit (1 or 0).
809 */
LL_GPIO_IsInputPinSet(const GPIO_TypeDef * GPIOx,uint32_t PinMask)810 __STATIC_INLINE uint32_t LL_GPIO_IsInputPinSet(const GPIO_TypeDef *GPIOx, uint32_t PinMask)
811 {
812 return ((READ_BIT(GPIOx->IDR, PinMask) == (PinMask)) ? 1UL : 0UL);
813 }
814
815 /**
816 * @brief Write output data register for the port.
817 * @rmtoll ODR ODy LL_GPIO_WriteOutputPort
818 * @param GPIOx GPIO Port
819 * @param PortValue Level value for each pin of the port
820 * @retval None
821 */
LL_GPIO_WriteOutputPort(GPIO_TypeDef * GPIOx,uint32_t PortValue)822 __STATIC_INLINE void LL_GPIO_WriteOutputPort(GPIO_TypeDef *GPIOx, uint32_t PortValue)
823 {
824 WRITE_REG(GPIOx->ODR, PortValue);
825 }
826
827 /**
828 * @brief Return full output data register value for a dedicated port.
829 * @rmtoll ODR ODy LL_GPIO_ReadOutputPort
830 * @param GPIOx GPIO Port
831 * @retval Output data register value of port
832 */
LL_GPIO_ReadOutputPort(const GPIO_TypeDef * GPIOx)833 __STATIC_INLINE uint32_t LL_GPIO_ReadOutputPort(const GPIO_TypeDef *GPIOx)
834 {
835 return (uint32_t)(READ_REG(GPIOx->ODR));
836 }
837
838 /**
839 * @brief Return if input data level for several pins of dedicated port is high or low.
840 * @rmtoll ODR ODy LL_GPIO_IsOutputPinSet
841 * @param GPIOx GPIO Port
842 * @param PinMask This parameter can be a combination of the following values:
843 * @arg @ref LL_GPIO_PIN_0
844 * @arg @ref LL_GPIO_PIN_1
845 * @arg @ref LL_GPIO_PIN_2
846 * @arg @ref LL_GPIO_PIN_3
847 * @arg @ref LL_GPIO_PIN_4
848 * @arg @ref LL_GPIO_PIN_5
849 * @arg @ref LL_GPIO_PIN_6
850 * @arg @ref LL_GPIO_PIN_7
851 * @arg @ref LL_GPIO_PIN_8
852 * @arg @ref LL_GPIO_PIN_9
853 * @arg @ref LL_GPIO_PIN_10
854 * @arg @ref LL_GPIO_PIN_11
855 * @arg @ref LL_GPIO_PIN_12
856 * @arg @ref LL_GPIO_PIN_13
857 * @arg @ref LL_GPIO_PIN_14
858 * @arg @ref LL_GPIO_PIN_15
859 * @arg @ref LL_GPIO_PIN_ALL
860 * @retval State of bit (1 or 0).
861 */
LL_GPIO_IsOutputPinSet(const GPIO_TypeDef * GPIOx,uint32_t PinMask)862 __STATIC_INLINE uint32_t LL_GPIO_IsOutputPinSet(const GPIO_TypeDef *GPIOx, uint32_t PinMask)
863 {
864 return ((READ_BIT(GPIOx->ODR, PinMask) == (PinMask)) ? 1UL : 0UL);
865 }
866
867 /**
868 * @brief Set several pins to high level on dedicated gpio port.
869 * @rmtoll BSRR BSy LL_GPIO_SetOutputPin
870 * @param GPIOx GPIO Port
871 * @param PinMask This parameter can be a combination of the following values:
872 * @arg @ref LL_GPIO_PIN_0
873 * @arg @ref LL_GPIO_PIN_1
874 * @arg @ref LL_GPIO_PIN_2
875 * @arg @ref LL_GPIO_PIN_3
876 * @arg @ref LL_GPIO_PIN_4
877 * @arg @ref LL_GPIO_PIN_5
878 * @arg @ref LL_GPIO_PIN_6
879 * @arg @ref LL_GPIO_PIN_7
880 * @arg @ref LL_GPIO_PIN_8
881 * @arg @ref LL_GPIO_PIN_9
882 * @arg @ref LL_GPIO_PIN_10
883 * @arg @ref LL_GPIO_PIN_11
884 * @arg @ref LL_GPIO_PIN_12
885 * @arg @ref LL_GPIO_PIN_13
886 * @arg @ref LL_GPIO_PIN_14
887 * @arg @ref LL_GPIO_PIN_15
888 * @arg @ref LL_GPIO_PIN_ALL
889 * @retval None
890 */
LL_GPIO_SetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)891 __STATIC_INLINE void LL_GPIO_SetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
892 {
893 WRITE_REG(GPIOx->BSRR, PinMask);
894 }
895
896 /**
897 * @brief Set several pins to low level on dedicated gpio port.
898 * @rmtoll BRR BRy LL_GPIO_ResetOutputPin
899 * @param GPIOx GPIO Port
900 * @param PinMask This parameter can be a combination of the following values:
901 * @arg @ref LL_GPIO_PIN_0
902 * @arg @ref LL_GPIO_PIN_1
903 * @arg @ref LL_GPIO_PIN_2
904 * @arg @ref LL_GPIO_PIN_3
905 * @arg @ref LL_GPIO_PIN_4
906 * @arg @ref LL_GPIO_PIN_5
907 * @arg @ref LL_GPIO_PIN_6
908 * @arg @ref LL_GPIO_PIN_7
909 * @arg @ref LL_GPIO_PIN_8
910 * @arg @ref LL_GPIO_PIN_9
911 * @arg @ref LL_GPIO_PIN_10
912 * @arg @ref LL_GPIO_PIN_11
913 * @arg @ref LL_GPIO_PIN_12
914 * @arg @ref LL_GPIO_PIN_13
915 * @arg @ref LL_GPIO_PIN_14
916 * @arg @ref LL_GPIO_PIN_15
917 * @arg @ref LL_GPIO_PIN_ALL
918 * @retval None
919 */
LL_GPIO_ResetOutputPin(GPIO_TypeDef * GPIOx,uint32_t PinMask)920 __STATIC_INLINE void LL_GPIO_ResetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
921 {
922 WRITE_REG(GPIOx->BRR, PinMask);
923 }
924
925 /**
926 * @brief Toggle data value for several pin of dedicated port.
927 * @rmtoll ODR ODy LL_GPIO_TogglePin
928 * @param GPIOx GPIO Port
929 * @param PinMask This parameter can be a combination of the following values:
930 * @arg @ref LL_GPIO_PIN_0
931 * @arg @ref LL_GPIO_PIN_1
932 * @arg @ref LL_GPIO_PIN_2
933 * @arg @ref LL_GPIO_PIN_3
934 * @arg @ref LL_GPIO_PIN_4
935 * @arg @ref LL_GPIO_PIN_5
936 * @arg @ref LL_GPIO_PIN_6
937 * @arg @ref LL_GPIO_PIN_7
938 * @arg @ref LL_GPIO_PIN_8
939 * @arg @ref LL_GPIO_PIN_9
940 * @arg @ref LL_GPIO_PIN_10
941 * @arg @ref LL_GPIO_PIN_11
942 * @arg @ref LL_GPIO_PIN_12
943 * @arg @ref LL_GPIO_PIN_13
944 * @arg @ref LL_GPIO_PIN_14
945 * @arg @ref LL_GPIO_PIN_15
946 * @arg @ref LL_GPIO_PIN_ALL
947 * @retval None
948 */
LL_GPIO_TogglePin(GPIO_TypeDef * GPIOx,uint32_t PinMask)949 __STATIC_INLINE void LL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
950 {
951 uint32_t odr = READ_REG(GPIOx->ODR);
952 WRITE_REG(GPIOx->BSRR, ((odr & PinMask) << 16u) | (~odr & PinMask));
953 }
954
955
956 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
957
958 /**
959 * @brief Enable secure write only access for several pin of dedicated port.
960 * @rmtoll SECCFGR SECy LL_GPIO_EnablePinSecure
961 * @param GPIOx GPIO Port
962 * @param PinMask This parameter can be a combination of the following values:
963 * @arg @ref LL_GPIO_PIN_0
964 * @arg @ref LL_GPIO_PIN_1
965 * @arg @ref LL_GPIO_PIN_2
966 * @arg @ref LL_GPIO_PIN_3
967 * @arg @ref LL_GPIO_PIN_4
968 * @arg @ref LL_GPIO_PIN_5
969 * @arg @ref LL_GPIO_PIN_6
970 * @arg @ref LL_GPIO_PIN_7
971 * @arg @ref LL_GPIO_PIN_8
972 * @arg @ref LL_GPIO_PIN_9
973 * @arg @ref LL_GPIO_PIN_10
974 * @arg @ref LL_GPIO_PIN_11
975 * @arg @ref LL_GPIO_PIN_12
976 * @arg @ref LL_GPIO_PIN_13
977 * @arg @ref LL_GPIO_PIN_14
978 * @arg @ref LL_GPIO_PIN_15
979 * @arg @ref LL_GPIO_PIN_ALL
980 * @retval None
981 */
LL_GPIO_EnablePinSecure(GPIO_TypeDef * GPIOx,uint32_t PinMask)982 __STATIC_INLINE void LL_GPIO_EnablePinSecure(GPIO_TypeDef *GPIOx, uint32_t PinMask)
983 {
984 SET_BIT(GPIOx->SECCFGR, PinMask);
985 }
986
987
988 /**
989 * @brief Disable secure write only access for several pin of dedicated port.
990 * @rmtoll SECCFGR SECy LL_GPIO_DisablePinSecure
991 * @param GPIOx GPIO Port
992 * @param PinMask This parameter can be a combination of the following values:
993 * @arg @ref LL_GPIO_PIN_0
994 * @arg @ref LL_GPIO_PIN_1
995 * @arg @ref LL_GPIO_PIN_2
996 * @arg @ref LL_GPIO_PIN_3
997 * @arg @ref LL_GPIO_PIN_4
998 * @arg @ref LL_GPIO_PIN_5
999 * @arg @ref LL_GPIO_PIN_6
1000 * @arg @ref LL_GPIO_PIN_7
1001 * @arg @ref LL_GPIO_PIN_8
1002 * @arg @ref LL_GPIO_PIN_9
1003 * @arg @ref LL_GPIO_PIN_10
1004 * @arg @ref LL_GPIO_PIN_11
1005 * @arg @ref LL_GPIO_PIN_12
1006 * @arg @ref LL_GPIO_PIN_13
1007 * @arg @ref LL_GPIO_PIN_14
1008 * @arg @ref LL_GPIO_PIN_15
1009 * @arg @ref LL_GPIO_PIN_ALL
1010 * @retval None
1011 */
LL_GPIO_DisablePinSecure(GPIO_TypeDef * GPIOx,uint32_t PinMask)1012 __STATIC_INLINE void LL_GPIO_DisablePinSecure(GPIO_TypeDef *GPIOx, uint32_t PinMask)
1013 {
1014 CLEAR_BIT(GPIOx->SECCFGR, PinMask);
1015 }
1016
1017
1018 /**
1019 * @brief Return if secure write only access for several pin of dedicated port is enabled or not.
1020 * @rmtoll SECCFGR SECy LL_GPIO_IsEnabledPinSecure
1021 * @param GPIOx GPIO Port
1022 * @param PinMask This parameter can be a combination of the following values:
1023 * @arg @ref LL_GPIO_PIN_0
1024 * @arg @ref LL_GPIO_PIN_1
1025 * @arg @ref LL_GPIO_PIN_2
1026 * @arg @ref LL_GPIO_PIN_3
1027 * @arg @ref LL_GPIO_PIN_4
1028 * @arg @ref LL_GPIO_PIN_5
1029 * @arg @ref LL_GPIO_PIN_6
1030 * @arg @ref LL_GPIO_PIN_7
1031 * @arg @ref LL_GPIO_PIN_8
1032 * @arg @ref LL_GPIO_PIN_9
1033 * @arg @ref LL_GPIO_PIN_10
1034 * @arg @ref LL_GPIO_PIN_11
1035 * @arg @ref LL_GPIO_PIN_12
1036 * @arg @ref LL_GPIO_PIN_13
1037 * @arg @ref LL_GPIO_PIN_14
1038 * @arg @ref LL_GPIO_PIN_15
1039 * @arg @ref LL_GPIO_PIN_ALL
1040 * @retval State of bit (1 or 0).
1041 */
LL_GPIO_IsEnabledPinSecure(const GPIO_TypeDef * GPIOx,uint32_t PinMask)1042 __STATIC_INLINE uint32_t LL_GPIO_IsEnabledPinSecure(const GPIO_TypeDef *GPIOx, uint32_t PinMask)
1043 {
1044 return ((READ_BIT(GPIOx->SECCFGR, PinMask) == (PinMask)) ? 1UL : 0UL);
1045 }
1046
1047 #endif /* __ARM_FEATURE_CMSE */
1048
1049 /**
1050 * @}
1051 */
1052
1053 #if defined(USE_FULL_LL_DRIVER)
1054 /** @defgroup GPIO_LL_EF_Init Initialization and de-initialization functions
1055 * @{
1056 */
1057
1058 ErrorStatus LL_GPIO_DeInit(const GPIO_TypeDef *GPIOx);
1059 ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct);
1060 void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct);
1061
1062 /**
1063 * @}
1064 */
1065 #endif /* USE_FULL_LL_DRIVER */
1066
1067 /**
1068 * @}
1069 */
1070
1071 /**
1072 * @}
1073 */
1074
1075 #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOH) */
1076 /**
1077 * @}
1078 */
1079
1080 #ifdef __cplusplus
1081 }
1082 #endif
1083
1084 #endif /* STM32WBAxx_LL_GPIO_H */
1085
