2 ******************************************************************************
\r
3 * @file stm32l1xx_gpio.h
\r
4 * @author MCD Application Team
\r
7 * @brief This file contains all the functions prototypes for the GPIO
\r
9 ******************************************************************************
\r
12 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
\r
13 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
\r
14 * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
\r
15 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
\r
16 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
\r
17 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
\r
19 * <h2><center>© COPYRIGHT 2010 STMicroelectronics</center></h2>
\r
22 /* Define to prevent recursive inclusion -------------------------------------*/
\r
23 #ifndef __STM32L1xx_GPIO_H
\r
24 #define __STM32L1xx_GPIO_H
\r
30 /* Includes ------------------------------------------------------------------*/
\r
31 #include "stm32l1xx.h"
\r
33 /** @addtogroup STM32L1xx_StdPeriph_Driver
\r
37 /** @addtogroup GPIO
\r
41 /** @defgroup GPIO_Exported_Types
\r
44 #define IS_GPIO_ALL_PERIPH(PERIPH) (((PERIPH) == GPIOA) || \
\r
45 ((PERIPH) == GPIOB) || \
\r
46 ((PERIPH) == GPIOC) || \
\r
47 ((PERIPH) == GPIOD) || \
\r
48 ((PERIPH) == GPIOE) || \
\r
49 ((PERIPH) == GPIOH))
\r
51 /** @defgroup Configuration_Mode_enumeration
\r
56 GPIO_Mode_IN = 0x00, /*!< GPIO Input Mode */
\r
57 GPIO_Mode_OUT = 0x01, /*!< GPIO Output Mode */
\r
58 GPIO_Mode_AF = 0x02, /*!< GPIO Alternate function Mode */
\r
59 GPIO_Mode_AN = 0x03 /*!< GPIO Analog Mode */
\r
61 #define IS_GPIO_MODE(MODE) (((MODE) == GPIO_Mode_IN) || ((MODE) == GPIO_Mode_OUT) || \
\r
62 ((MODE) == GPIO_Mode_AF)|| ((MODE) == GPIO_Mode_AN))
\r
67 /** @defgroup Output_type_enumeration
\r
71 { GPIO_OType_PP = 0x00,
\r
72 GPIO_OType_OD = 0x01
\r
74 #define IS_GPIO_OTYPE(OTYPE) (((OTYPE) == GPIO_OType_PP) || ((OTYPE) == GPIO_OType_OD))
\r
80 /** @defgroup Output_Maximum_frequency_enumeration
\r
85 GPIO_Speed_400KHz = 0x00, /*!< Very Low Speed */
\r
86 GPIO_Speed_2MHz = 0x01, /*!< Low Speed */
\r
87 GPIO_Speed_10MHz = 0x02, /*!< Medium Speed */
\r
88 GPIO_Speed_40MHz = 0x03 /*!< High Speed */
\r
90 #define IS_GPIO_SPEED(SPEED) (((SPEED) == GPIO_Speed_400KHz) || ((SPEED) == GPIO_Speed_2MHz) || \
\r
91 ((SPEED) == GPIO_Speed_10MHz)|| ((SPEED) == GPIO_Speed_40MHz))
\r
96 /** @defgroup Configuration_Pull-Up_Pull-Down_enumeration
\r
100 { GPIO_PuPd_NOPULL = 0x00,
\r
101 GPIO_PuPd_UP = 0x01,
\r
102 GPIO_PuPd_DOWN = 0x02
\r
104 #define IS_GPIO_PUPD(PUPD) (((PUPD) == GPIO_PuPd_NOPULL) || ((PUPD) == GPIO_PuPd_UP) || \
\r
105 ((PUPD) == GPIO_PuPd_DOWN))
\r
110 /** @defgroup Bit_SET_and_Bit_RESET_enumeration
\r
117 #define IS_GPIO_BIT_ACTION(ACTION) (((ACTION) == Bit_RESET) || ((ACTION) == Bit_SET))
\r
124 * @brief GPIO Init structure definition
\r
128 uint32_t GPIO_Pin; /*!< Specifies the GPIO pins to be configured.
\r
129 This parameter can be any value of @ref GPIO_pins_define */
\r
131 GPIOMode_TypeDef GPIO_Mode; /*!< Specifies the operating mode for the selected pins.
\r
132 This parameter can be a value of @ref GPIOMode_TypeDef */
\r
134 GPIOSpeed_TypeDef GPIO_Speed; /*!< Specifies the speed for the selected pins.
\r
135 This parameter can be a value of @ref GPIOSpeed_TypeDef */
\r
137 GPIOOType_TypeDef GPIO_OType; /*!< Specifies the operating output type for the selected pins.
\r
138 This parameter can be a value of @ref GPIOOType_TypeDef */
\r
140 GPIOPuPd_TypeDef GPIO_PuPd; /*!< Specifies the operating Pull-up/Pull down for the selected pins.
\r
141 This parameter can be a value of @ref GPIOPuPd_TypeDef */
\r
147 /** @defgroup GPIO_Exported_Constants
\r
155 /** @defgroup GPIO_pins_define
\r
158 #define GPIO_Pin_0 ((uint16_t)0x0001) /*!< Pin 0 selected */
\r
159 #define GPIO_Pin_1 ((uint16_t)0x0002) /*!< Pin 1 selected */
\r
160 #define GPIO_Pin_2 ((uint16_t)0x0004) /*!< Pin 2 selected */
\r
161 #define GPIO_Pin_3 ((uint16_t)0x0008) /*!< Pin 3 selected */
\r
162 #define GPIO_Pin_4 ((uint16_t)0x0010) /*!< Pin 4 selected */
\r
163 #define GPIO_Pin_5 ((uint16_t)0x0020) /*!< Pin 5 selected */
\r
164 #define GPIO_Pin_6 ((uint16_t)0x0040) /*!< Pin 6 selected */
\r
165 #define GPIO_Pin_7 ((uint16_t)0x0080) /*!< Pin 7 selected */
\r
166 #define GPIO_Pin_8 ((uint16_t)0x0100) /*!< Pin 8 selected */
\r
167 #define GPIO_Pin_9 ((uint16_t)0x0200) /*!< Pin 9 selected */
\r
168 #define GPIO_Pin_10 ((uint16_t)0x0400) /*!< Pin 10 selected */
\r
169 #define GPIO_Pin_11 ((uint16_t)0x0800) /*!< Pin 11 selected */
\r
170 #define GPIO_Pin_12 ((uint16_t)0x1000) /*!< Pin 12 selected */
\r
171 #define GPIO_Pin_13 ((uint16_t)0x2000) /*!< Pin 13 selected */
\r
172 #define GPIO_Pin_14 ((uint16_t)0x4000) /*!< Pin 14 selected */
\r
173 #define GPIO_Pin_15 ((uint16_t)0x8000) /*!< Pin 15 selected */
\r
174 #define GPIO_Pin_All ((uint16_t)0xFFFF) /*!< All pins selected */
\r
176 #define IS_GPIO_PIN(PIN) ((PIN) != (uint16_t)0x00)
\r
177 #define IS_GET_GPIO_PIN(PIN) (((PIN) == GPIO_Pin_0) || \
\r
178 ((PIN) == GPIO_Pin_1) || \
\r
179 ((PIN) == GPIO_Pin_2) || \
\r
180 ((PIN) == GPIO_Pin_3) || \
\r
181 ((PIN) == GPIO_Pin_4) || \
\r
182 ((PIN) == GPIO_Pin_5) || \
\r
183 ((PIN) == GPIO_Pin_6) || \
\r
184 ((PIN) == GPIO_Pin_7) || \
\r
185 ((PIN) == GPIO_Pin_8) || \
\r
186 ((PIN) == GPIO_Pin_9) || \
\r
187 ((PIN) == GPIO_Pin_10) || \
\r
188 ((PIN) == GPIO_Pin_11) || \
\r
189 ((PIN) == GPIO_Pin_12) || \
\r
190 ((PIN) == GPIO_Pin_13) || \
\r
191 ((PIN) == GPIO_Pin_14) || \
\r
192 ((PIN) == GPIO_Pin_15))
\r
197 /** @defgroup GPIO_Pin_sources
\r
200 #define GPIO_PinSource0 ((uint8_t)0x00)
\r
201 #define GPIO_PinSource1 ((uint8_t)0x01)
\r
202 #define GPIO_PinSource2 ((uint8_t)0x02)
\r
203 #define GPIO_PinSource3 ((uint8_t)0x03)
\r
204 #define GPIO_PinSource4 ((uint8_t)0x04)
\r
205 #define GPIO_PinSource5 ((uint8_t)0x05)
\r
206 #define GPIO_PinSource6 ((uint8_t)0x06)
\r
207 #define GPIO_PinSource7 ((uint8_t)0x07)
\r
208 #define GPIO_PinSource8 ((uint8_t)0x08)
\r
209 #define GPIO_PinSource9 ((uint8_t)0x09)
\r
210 #define GPIO_PinSource10 ((uint8_t)0x0A)
\r
211 #define GPIO_PinSource11 ((uint8_t)0x0B)
\r
212 #define GPIO_PinSource12 ((uint8_t)0x0C)
\r
213 #define GPIO_PinSource13 ((uint8_t)0x0D)
\r
214 #define GPIO_PinSource14 ((uint8_t)0x0E)
\r
215 #define GPIO_PinSource15 ((uint8_t)0x0F)
\r
217 #define IS_GPIO_PIN_SOURCE(PINSOURCE) (((PINSOURCE) == GPIO_PinSource0) || \
\r
218 ((PINSOURCE) == GPIO_PinSource1) || \
\r
219 ((PINSOURCE) == GPIO_PinSource2) || \
\r
220 ((PINSOURCE) == GPIO_PinSource3) || \
\r
221 ((PINSOURCE) == GPIO_PinSource4) || \
\r
222 ((PINSOURCE) == GPIO_PinSource5) || \
\r
223 ((PINSOURCE) == GPIO_PinSource6) || \
\r
224 ((PINSOURCE) == GPIO_PinSource7) || \
\r
225 ((PINSOURCE) == GPIO_PinSource8) || \
\r
226 ((PINSOURCE) == GPIO_PinSource9) || \
\r
227 ((PINSOURCE) == GPIO_PinSource10) || \
\r
228 ((PINSOURCE) == GPIO_PinSource11) || \
\r
229 ((PINSOURCE) == GPIO_PinSource12) || \
\r
230 ((PINSOURCE) == GPIO_PinSource13) || \
\r
231 ((PINSOURCE) == GPIO_PinSource14) || \
\r
232 ((PINSOURCE) == GPIO_PinSource15))
\r
237 /** @defgroup GPIO_Alternat_function_selection_define
\r
242 * @brief AF 0 selection
\r
244 #define GPIO_AF_RTC_50Hz ((uint8_t)0x00) /*!< RTC 50/60 Hz Alternate Function mapping */
\r
245 #define GPIO_AF_MCO ((uint8_t)0x00) /*!< MCO Alternate Function mapping */
\r
246 #define GPIO_AF_RTC_AF1 ((uint8_t)0x00) /*!< RTC_AF1 Alternate Function mapping */
\r
247 #define GPIO_AF_WKUP ((uint8_t)0x00) /*!< Wakeup (WKUP1, WKUP2 and WKUP3) Alternate Function mapping */
\r
248 #define GPIO_AF_SWJ ((uint8_t)0x00) /*!< SWJ (SW and JTAG) Alternate Function mapping */
\r
249 #define GPIO_AF_TRACE ((uint8_t)0x00) /*!< TRACE Alternate Function mapping */
\r
252 * @brief AF 1 selection
\r
254 #define GPIO_AF_TIM2 ((uint8_t)0x01) /*!< TIM2 Alternate Function mapping */
\r
256 * @brief AF 2 selection
\r
258 #define GPIO_AF_TIM3 ((uint8_t)0x02) /*!< TIM3 Alternate Function mapping */
\r
259 #define GPIO_AF_TIM4 ((uint8_t)0x02) /*!< TIM4 Alternate Function mapping */
\r
261 * @brief AF 3 selection
\r
263 #define GPIO_AF_TIM9 ((uint8_t)0x03) /*!< TIM9 Alternate Function mapping */
\r
264 #define GPIO_AF_TIM10 ((uint8_t)0x03) /*!< TIM10 Alternate Function mapping */
\r
265 #define GPIO_AF_TIM11 ((uint8_t)0x03) /*!< TIM11 Alternate Function mapping */
\r
267 * @brief AF 4 selection
\r
269 #define GPIO_AF_I2C1 ((uint8_t)0x04) /*!< I2C1 Alternate Function mapping */
\r
270 #define GPIO_AF_I2C2 ((uint8_t)0x04) /*!< I2C2 Alternate Function mapping */
\r
272 * @brief AF 5 selection
\r
274 #define GPIO_AF_SPI1 ((uint8_t)0x05) /*!< SPI1 Alternate Function mapping */
\r
275 #define GPIO_AF_SPI2 ((uint8_t)0x05) /*!< SPI2 Alternate Function mapping */
\r
277 * @brief AF 7 selection
\r
279 #define GPIO_AF_USART1 ((uint8_t)0x07) /*!< USART1 Alternate Function mapping */
\r
280 #define GPIO_AF_USART2 ((uint8_t)0x07) /*!< USART2 Alternate Function mapping */
\r
281 #define GPIO_AF_USART3 ((uint8_t)0x07) /*!< USART3 Alternate Function mapping */
\r
283 * @brief AF 10 selection
\r
285 #define GPIO_AF_USB ((uint8_t)0xA) /*!< USB Full speed device Alternate Function mapping */
\r
287 * @brief AF 11 selection
\r
289 #define GPIO_AF_LCD ((uint8_t)0x0B) /*!< LCD Alternate Function mapping */
\r
291 * @brief AF 14 selection
\r
293 #define GPIO_AF_RI ((uint8_t)0x0E) /*!< RI Alternate Function mapping */
\r
296 * @brief AF 15 selection
\r
298 #define GPIO_AF_EVENTOUT ((uint8_t)0x0F) /*!< EVENTOUT Alternate Function mapping */
\r
300 #define IS_GPIO_AF(AF) (((AF) == GPIO_AF_RTC_50Hz) || ((AF) == GPIO_AF_MCO) || \
\r
301 ((AF) == GPIO_AF_RTC_AF1) || ((AF) == GPIO_AF_WKUP) || \
\r
302 ((AF) == GPIO_AF_SWJ) || ((AF) == GPIO_AF_TRACE) || \
\r
303 ((AF) == GPIO_AF_TIM2) || ((AF)== GPIO_AF_TIM3) || \
\r
304 ((AF) == GPIO_AF_TIM4) || ((AF)== GPIO_AF_TIM9) || \
\r
305 ((AF) == GPIO_AF_TIM10) || ((AF)== GPIO_AF_TIM11) || \
\r
306 ((AF) == GPIO_AF_I2C1) || ((AF) == GPIO_AF_I2C2) || \
\r
307 ((AF) == GPIO_AF_SPI1) || ((AF) == GPIO_AF_SPI2) || \
\r
308 ((AF) == GPIO_AF_USART1) || ((AF) == GPIO_AF_USART2) || \
\r
309 ((AF) == GPIO_AF_USART3) || ((AF) == GPIO_AF_USB) || \
\r
310 ((AF) == GPIO_AF_LCD) || ((AF) == GPIO_AF_RI) || \
\r
311 ((AF) == GPIO_AF_EVENTOUT))
\r
317 /** @defgroup GPIO_Legacy
\r
321 #define GPIO_Mode_AIN GPIO_Mode_AN
\r
327 /** @defgroup GPIO_Exported_Macros
\r
335 /** @defgroup GPIO_Exported_Functions
\r
338 void GPIO_DeInit(GPIO_TypeDef* GPIOx);
\r
339 void GPIO_StructInit(GPIO_InitTypeDef* GPIO_InitStruct);
\r
340 void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct);
\r
341 uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
\r
342 uint16_t GPIO_ReadInputData(GPIO_TypeDef* GPIOx);
\r
343 uint8_t GPIO_ReadOutputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
\r
344 uint16_t GPIO_ReadOutputData(GPIO_TypeDef* GPIOx);
\r
345 void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
\r
346 void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
\r
347 void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal);
\r
348 void GPIO_Write(GPIO_TypeDef* GPIOx, uint16_t PortVal);
\r
349 void GPIO_PinLockConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
\r
350 void GPIO_PinAFConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinSource, uint8_t GPIO_AF);
\r
356 #endif /*__STM32L1xx_GPIO_H */
\r
369 /******************* (C) COPYRIGHT 2010 STMicroelectronics *****END OF FILE****/
\r