source: S-port/trunk/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_ll_gpio.c

Last change on this file was 1, checked in by AlexLir, 3 years ago
File size: 10.8 KB
Line 
1/**
2 ******************************************************************************
3 * @file stm32f4xx_ll_gpio.c
4 * @author MCD Application Team
5 * @brief GPIO LL module driver.
6 ******************************************************************************
7 * @attention
8 *
9 * <h2><center>&copy; 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#if defined(USE_FULL_LL_DRIVER)
20
21/* Includes ------------------------------------------------------------------*/
22#include "stm32f4xx_ll_gpio.h"
23#include "stm32f4xx_ll_bus.h"
24#ifdef USE_FULL_ASSERT
25#include "stm32_assert.h"
26#else
27#define assert_param(expr) ((void)0U)
28#endif
29
30/** @addtogroup STM32F4xx_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) || defined (GPIOJ) || defined (GPIOK)
35
36/** @addtogroup GPIO_LL
37 * @{
38 */
39
40/* Private types -------------------------------------------------------------*/
41/* Private variables ---------------------------------------------------------*/
42/* Private constants ---------------------------------------------------------*/
43/* Private macros ------------------------------------------------------------*/
44/** @addtogroup GPIO_LL_Private_Macros
45 * @{
46 */
47#define IS_LL_GPIO_PIN(__VALUE__) (((0x00000000U) < (__VALUE__)) && ((__VALUE__) <= (LL_GPIO_PIN_ALL)))
48
49#define IS_LL_GPIO_MODE(__VALUE__) (((__VALUE__) == LL_GPIO_MODE_INPUT) ||\
50 ((__VALUE__) == LL_GPIO_MODE_OUTPUT) ||\
51 ((__VALUE__) == LL_GPIO_MODE_ALTERNATE) ||\
52 ((__VALUE__) == LL_GPIO_MODE_ANALOG))
53
54#define IS_LL_GPIO_OUTPUT_TYPE(__VALUE__) (((__VALUE__) == LL_GPIO_OUTPUT_PUSHPULL) ||\
55 ((__VALUE__) == LL_GPIO_OUTPUT_OPENDRAIN))
56
57#define IS_LL_GPIO_SPEED(__VALUE__) (((__VALUE__) == LL_GPIO_SPEED_FREQ_LOW) ||\
58 ((__VALUE__) == LL_GPIO_SPEED_FREQ_MEDIUM) ||\
59 ((__VALUE__) == LL_GPIO_SPEED_FREQ_HIGH) ||\
60 ((__VALUE__) == LL_GPIO_SPEED_FREQ_VERY_HIGH))
61
62#define IS_LL_GPIO_PULL(__VALUE__) (((__VALUE__) == LL_GPIO_PULL_NO) ||\
63 ((__VALUE__) == LL_GPIO_PULL_UP) ||\
64 ((__VALUE__) == LL_GPIO_PULL_DOWN))
65
66#define IS_LL_GPIO_ALTERNATE(__VALUE__) (((__VALUE__) == LL_GPIO_AF_0 ) ||\
67 ((__VALUE__) == LL_GPIO_AF_1 ) ||\
68 ((__VALUE__) == LL_GPIO_AF_2 ) ||\
69 ((__VALUE__) == LL_GPIO_AF_3 ) ||\
70 ((__VALUE__) == LL_GPIO_AF_4 ) ||\
71 ((__VALUE__) == LL_GPIO_AF_5 ) ||\
72 ((__VALUE__) == LL_GPIO_AF_6 ) ||\
73 ((__VALUE__) == LL_GPIO_AF_7 ) ||\
74 ((__VALUE__) == LL_GPIO_AF_8 ) ||\
75 ((__VALUE__) == LL_GPIO_AF_9 ) ||\
76 ((__VALUE__) == LL_GPIO_AF_10 ) ||\
77 ((__VALUE__) == LL_GPIO_AF_11 ) ||\
78 ((__VALUE__) == LL_GPIO_AF_12 ) ||\
79 ((__VALUE__) == LL_GPIO_AF_13 ) ||\
80 ((__VALUE__) == LL_GPIO_AF_14 ) ||\
81 ((__VALUE__) == LL_GPIO_AF_15 ))
82/**
83 * @}
84 */
85
86/* Private function prototypes -----------------------------------------------*/
87
88/* Exported functions --------------------------------------------------------*/
89/** @addtogroup GPIO_LL_Exported_Functions
90 * @{
91 */
92
93/** @addtogroup GPIO_LL_EF_Init
94 * @{
95 */
96
97/**
98 * @brief De-initialize GPIO registers (Registers restored to their default values).
99 * @param GPIOx GPIO Port
100 * @retval An ErrorStatus enumeration value:
101 * - SUCCESS: GPIO registers are de-initialized
102 * - ERROR: Wrong GPIO Port
103 */
104ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx)
105{
106 ErrorStatus status = SUCCESS;
107
108 /* Check the parameters */
109 assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
110
111 /* Force and Release reset on clock of GPIOx Port */
112 if (GPIOx == GPIOA)
113 {
114 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOA);
115 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOA);
116 }
117 else if (GPIOx == GPIOB)
118 {
119 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOB);
120 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOB);
121 }
122 else if (GPIOx == GPIOC)
123 {
124 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOC);
125 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOC);
126 }
127#if defined(GPIOD)
128 else if (GPIOx == GPIOD)
129 {
130 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOD);
131 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOD);
132 }
133#endif /* GPIOD */
134#if defined(GPIOE)
135 else if (GPIOx == GPIOE)
136 {
137 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOE);
138 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOE);
139 }
140#endif /* GPIOE */
141#if defined(GPIOF)
142 else if (GPIOx == GPIOF)
143 {
144 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOF);
145 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOF);
146 }
147#endif /* GPIOF */
148#if defined(GPIOG)
149 else if (GPIOx == GPIOG)
150 {
151 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOG);
152 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOG);
153 }
154#endif /* GPIOG */
155#if defined(GPIOH)
156 else if (GPIOx == GPIOH)
157 {
158 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOH);
159 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOH);
160 }
161#endif /* GPIOH */
162#if defined(GPIOI)
163 else if (GPIOx == GPIOI)
164 {
165 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOI);
166 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOI);
167 }
168#endif /* GPIOI */
169#if defined(GPIOJ)
170 else if (GPIOx == GPIOJ)
171 {
172 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOJ);
173 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOJ);
174 }
175#endif /* GPIOJ */
176#if defined(GPIOK)
177 else if (GPIOx == GPIOK)
178 {
179 LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOK);
180 LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOK);
181 }
182#endif /* GPIOK */
183 else
184 {
185 status = ERROR;
186 }
187
188 return (status);
189}
190
191/**
192 * @brief Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
193 * @param GPIOx GPIO Port
194 * @param GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
195 * that contains the configuration information for the specified GPIO peripheral.
196 * @retval An ErrorStatus enumeration value:
197 * - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
198 * - ERROR: Not applicable
199 */
200ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
201{
202 uint32_t pinpos = 0x00000000U;
203 uint32_t currentpin = 0x00000000U;
204
205 /* Check the parameters */
206 assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
207 assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
208 assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
209 assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
210
211 /* ------------------------- Configure the port pins ---------------- */
212 /* Initialize pinpos on first pin set */
213 pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
214
215 /* Configure the port pins */
216 while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
217 {
218 /* Get current io position */
219 currentpin = (GPIO_InitStruct->Pin) & (0x00000001U << pinpos);
220
221 if (currentpin)
222 {
223
224 if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
225 {
226 /* Check Speed mode parameters */
227 assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
228
229 /* Speed mode configuration */
230 LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
231
232 /* Check Output mode parameters */
233 assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
234
235 /* Output mode configuration*/
236 LL_GPIO_SetPinOutputType(GPIOx, currentpin, GPIO_InitStruct->OutputType);
237 }
238
239 /* Pull-up Pull down resistor configuration*/
240 LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
241
242 if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
243 {
244 /* Check Alternate parameter */
245 assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
246
247 /* Speed mode configuration */
248 if (POSITION_VAL(currentpin) < 0x00000008U)
249 {
250 LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
251 }
252 else
253 {
254 LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
255 }
256 }
257
258 /* Pin Mode configuration */
259 LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
260 }
261 pinpos++;
262 }
263
264 return (SUCCESS);
265}
266
267/**
268 * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
269 * @param GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
270 * whose fields will be set to default values.
271 * @retval None
272 */
273
274void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
275{
276 /* Reset GPIO init structure parameters values */
277 GPIO_InitStruct->Pin = LL_GPIO_PIN_ALL;
278 GPIO_InitStruct->Mode = LL_GPIO_MODE_ANALOG;
279 GPIO_InitStruct->Speed = LL_GPIO_SPEED_FREQ_LOW;
280 GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
281 GPIO_InitStruct->Pull = LL_GPIO_PULL_NO;
282 GPIO_InitStruct->Alternate = LL_GPIO_AF_0;
283}
284
285/**
286 * @}
287 */
288
289/**
290 * @}
291 */
292
293/**
294 * @}
295 */
296
297#endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI) || defined (GPIOJ) || defined (GPIOK) */
298
299/**
300 * @}
301 */
302
303#endif /* USE_FULL_LL_DRIVER */
304
305/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Note: See TracBrowser for help on using the repository browser.