Subversion Repositories DashDisplay

Rev

Rev 56 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
56 mjames 1
/**
2
  ******************************************************************************
3
  * @file    stm32l1xx_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 "stm32l1xx_ll_gpio.h"
23
#include "stm32l1xx_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 STM32L1xx_LL_Driver
31
  * @{
32
  */
33
 
34
#if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH)
35
 
36
/** @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
  */
104
ErrorStatus 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
  else
163
  {
164
    status = ERROR;
165
  }
166
 
167
  return (status);
168
}
169
 
170
/**
171
  * @brief  Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
172
  * @param  GPIOx GPIO Port
173
  * @param  GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
174
  *         that contains the configuration information for the specified GPIO peripheral.
175
  * @retval An ErrorStatus enumeration value:
176
  *          - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
177
  *          - ERROR:   Not applicable
178
  */
179
ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
180
{
181
  uint32_t pinpos     = 0x00000000U;
182
  uint32_t currentpin = 0x00000000U;
183
 
184
  /* Check the parameters */
185
  assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
186
  assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
187
  assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
188
  assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
189
 
190
  /* ------------------------- Configure the port pins ---------------- */
191
  /* Initialize  pinpos on first pin set */
192
  pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
193
 
194
  /* Configure the port pins */
195
  while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
196
  {
197
    /* Get current io position */
198
    currentpin = (GPIO_InitStruct->Pin) & (0x00000001U << pinpos);
199
 
200
    if (currentpin)
201
    {
202
 
203
      if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
204
      {
205
        /* Check Speed mode parameters */
206
        assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
207
 
208
        /* Speed mode configuration */
209
        LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
210
 
211
        /* Check Output mode parameters */
212
        assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
213
 
214
        /* Output mode configuration*/
215
        LL_GPIO_SetPinOutputType(GPIOx, currentpin, GPIO_InitStruct->OutputType);
216
      }
217
 
218
      /* Pull-up Pull down resistor configuration*/
219
      LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
220
 
221
      if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
222
      {
223
        /* Check Alternate parameter */
224
        assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
225
 
226
        /* Speed mode configuration */
227
        if (POSITION_VAL(currentpin) < 0x00000008U)
228
        {
229
          LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
230
        }
231
        else
232
        {
233
          LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
234
        }
235
      }
236
 
237
      /* Pin Mode configuration */
238
      LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
239
    }
240
    pinpos++;
241
  }
242
 
243
  return (SUCCESS);
244
}
245
 
246
/**
247
  * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
248
  * @param GPIO_InitStruct: pointer to a @ref LL_GPIO_InitTypeDef structure
249
  *                          whose fields will be set to default values.
250
  * @retval None
251
  */
252
 
253
void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
254
{
255
  /* Reset GPIO init structure parameters values */
256
  GPIO_InitStruct->Pin        = LL_GPIO_PIN_ALL;
257
  GPIO_InitStruct->Mode       = LL_GPIO_MODE_ANALOG;
258
  GPIO_InitStruct->Speed      = LL_GPIO_SPEED_FREQ_LOW;
259
  GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
260
  GPIO_InitStruct->Pull       = LL_GPIO_PULL_NO;
261
  GPIO_InitStruct->Alternate  = LL_GPIO_AF_0;
262
}
263
 
264
/**
265
  * @}
266
  */
267
 
268
/**
269
  * @}
270
  */
271
 
272
/**
273
  * @}
274
  */
275
 
276
#endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) */
277
 
278
/**
279
  * @}
280
  */
281
 
282
#endif /* USE_FULL_LL_DRIVER */
283
 
284
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/