[303] | 1 | /**
|
---|
| 2 | ******************************************************************************
|
---|
| 3 | * @file stm32f4xx_hal_gpio.c
|
---|
| 4 | * @author MCD Application Team
|
---|
| 5 | * @version V1.4.1
|
---|
| 6 | * @date 09-October-2015
|
---|
| 7 | * @brief GPIO HAL module driver.
|
---|
| 8 | * This file provides firmware functions to manage the following
|
---|
| 9 | * functionalities of the General Purpose Input/Output (GPIO) peripheral:
|
---|
| 10 | * + Initialization and de-initialization functions
|
---|
| 11 | * + IO operation functions
|
---|
| 12 | *
|
---|
| 13 | @verbatim
|
---|
| 14 | ==============================================================================
|
---|
| 15 | ##### GPIO Peripheral features #####
|
---|
| 16 | ==============================================================================
|
---|
| 17 | [..]
|
---|
| 18 | Subject to the specific hardware characteristics of each I/O port listed in the datasheet, each
|
---|
| 19 | port bit of the General Purpose IO (GPIO) Ports, can be individually configured by software
|
---|
| 20 | in several modes:
|
---|
| 21 | (+) Input mode
|
---|
| 22 | (+) Analog mode
|
---|
| 23 | (+) Output mode
|
---|
| 24 | (+) Alternate function mode
|
---|
| 25 | (+) External interrupt/event lines
|
---|
| 26 |
|
---|
| 27 | [..]
|
---|
| 28 | During and just after reset, the alternate functions and external interrupt
|
---|
| 29 | lines are not active and the I/O ports are configured in input floating mode.
|
---|
| 30 |
|
---|
| 31 | [..]
|
---|
| 32 | All GPIO pins have weak internal pull-up and pull-down resistors, which can be
|
---|
| 33 | activated or not.
|
---|
| 34 |
|
---|
| 35 | [..]
|
---|
| 36 | In Output or Alternate mode, each IO can be configured on open-drain or push-pull
|
---|
| 37 | type and the IO speed can be selected depending on the VDD value.
|
---|
| 38 |
|
---|
| 39 | [..]
|
---|
| 40 | All ports have external interrupt/event capability. To use external interrupt
|
---|
| 41 | lines, the port must be configured in input mode. All available GPIO pins are
|
---|
| 42 | connected to the 16 external interrupt/event lines from EXTI0 to EXTI15.
|
---|
| 43 |
|
---|
| 44 | [..]
|
---|
| 45 | The external interrupt/event controller consists of up to 23 edge detectors
|
---|
| 46 | (16 lines are connected to GPIO) for generating event/interrupt requests (each
|
---|
| 47 | input line can be independently configured to select the type (interrupt or event)
|
---|
| 48 | and the corresponding trigger event (rising or falling or both). Each line can
|
---|
| 49 | also be masked independently.
|
---|
| 50 |
|
---|
| 51 | ##### How to use this driver #####
|
---|
| 52 | ==============================================================================
|
---|
| 53 | [..]
|
---|
| 54 | (#) Enable the GPIO AHB clock using the following function: __HAL_RCC_GPIOx_CLK_ENABLE().
|
---|
| 55 |
|
---|
| 56 | (#) Configure the GPIO pin(s) using HAL_GPIO_Init().
|
---|
| 57 | (++) Configure the IO mode using "Mode" member from GPIO_InitTypeDef structure
|
---|
| 58 | (++) Activate Pull-up, Pull-down resistor using "Pull" member from GPIO_InitTypeDef
|
---|
| 59 | structure.
|
---|
| 60 | (++) In case of Output or alternate function mode selection: the speed is
|
---|
| 61 | configured through "Speed" member from GPIO_InitTypeDef structure.
|
---|
| 62 | (++) In alternate mode is selection, the alternate function connected to the IO
|
---|
| 63 | is configured through "Alternate" member from GPIO_InitTypeDef structure.
|
---|
| 64 | (++) Analog mode is required when a pin is to be used as ADC channel
|
---|
| 65 | or DAC output.
|
---|
| 66 | (++) In case of external interrupt/event selection the "Mode" member from
|
---|
| 67 | GPIO_InitTypeDef structure select the type (interrupt or event) and
|
---|
| 68 | the corresponding trigger event (rising or falling or both).
|
---|
| 69 |
|
---|
| 70 | (#) In case of external interrupt/event mode selection, configure NVIC IRQ priority
|
---|
| 71 | mapped to the EXTI line using HAL_NVIC_SetPriority() and enable it using
|
---|
| 72 | HAL_NVIC_EnableIRQ().
|
---|
| 73 |
|
---|
| 74 | (#) To get the level of a pin configured in input mode use HAL_GPIO_ReadPin().
|
---|
| 75 |
|
---|
| 76 | (#) To set/reset the level of a pin configured in output mode use
|
---|
| 77 | HAL_GPIO_WritePin()/HAL_GPIO_TogglePin().
|
---|
| 78 |
|
---|
| 79 | (#) To lock pin configuration until next reset use HAL_GPIO_LockPin().
|
---|
| 80 |
|
---|
| 81 |
|
---|
| 82 | (#) During and just after reset, the alternate functions are not
|
---|
| 83 | active and the GPIO pins are configured in input floating mode (except JTAG
|
---|
| 84 | pins).
|
---|
| 85 |
|
---|
| 86 | (#) The LSE oscillator pins OSC32_IN and OSC32_OUT can be used as general purpose
|
---|
| 87 | (PC14 and PC15, respectively) when the LSE oscillator is off. The LSE has
|
---|
| 88 | priority over the GPIO function.
|
---|
| 89 |
|
---|
| 90 | (#) The HSE oscillator pins OSC_IN/OSC_OUT can be used as
|
---|
| 91 | general purpose PH0 and PH1, respectively, when the HSE oscillator is off.
|
---|
| 92 | The HSE has priority over the GPIO function.
|
---|
| 93 |
|
---|
| 94 | @endverbatim
|
---|
| 95 | ******************************************************************************
|
---|
| 96 | * @attention
|
---|
| 97 | *
|
---|
| 98 | * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
|
---|
| 99 | *
|
---|
| 100 | * Redistribution and use in source and binary forms, with or without modification,
|
---|
| 101 | * are permitted provided that the following conditions are met:
|
---|
| 102 | * 1. Redistributions of source code must retain the above copyright notice,
|
---|
| 103 | * this list of conditions and the following disclaimer.
|
---|
| 104 | * 2. Redistributions in binary form must reproduce the above copyright notice,
|
---|
| 105 | * this list of conditions and the following disclaimer in the documentation
|
---|
| 106 | * and/or other materials provided with the distribution.
|
---|
| 107 | * 3. Neither the name of STMicroelectronics nor the names of its contributors
|
---|
| 108 | * may be used to endorse or promote products derived from this software
|
---|
| 109 | * without specific prior written permission.
|
---|
| 110 | *
|
---|
| 111 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
---|
| 112 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
---|
| 113 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
---|
| 114 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
---|
| 115 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
---|
| 116 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
---|
| 117 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
---|
| 118 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
---|
| 119 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
---|
| 120 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
---|
| 121 | *
|
---|
| 122 | ******************************************************************************
|
---|
| 123 | */
|
---|
| 124 |
|
---|
| 125 | /* Includes ------------------------------------------------------------------*/
|
---|
| 126 | #include "stm32f4xx_hal.h"
|
---|
| 127 |
|
---|
| 128 | /** @addtogroup STM32F4xx_HAL_Driver
|
---|
| 129 | * @{
|
---|
| 130 | */
|
---|
| 131 |
|
---|
| 132 | /** @defgroup GPIO GPIO
|
---|
| 133 | * @brief GPIO HAL module driver
|
---|
| 134 | * @{
|
---|
| 135 | */
|
---|
| 136 |
|
---|
| 137 | #ifdef HAL_GPIO_MODULE_ENABLED
|
---|
| 138 |
|
---|
| 139 | /* Private typedef -----------------------------------------------------------*/
|
---|
| 140 | /* Private define ------------------------------------------------------------*/
|
---|
| 141 | /** @addtogroup GPIO_Private_Constants GPIO Private Constants
|
---|
| 142 | * @{
|
---|
| 143 | */
|
---|
| 144 | #define GPIO_MODE ((uint32_t)0x00000003)
|
---|
| 145 | #define EXTI_MODE ((uint32_t)0x10000000)
|
---|
| 146 | #define GPIO_MODE_IT ((uint32_t)0x00010000)
|
---|
| 147 | #define GPIO_MODE_EVT ((uint32_t)0x00020000)
|
---|
| 148 | #define RISING_EDGE ((uint32_t)0x00100000)
|
---|
| 149 | #define FALLING_EDGE ((uint32_t)0x00200000)
|
---|
| 150 | #define GPIO_OUTPUT_TYPE ((uint32_t)0x00000010)
|
---|
| 151 |
|
---|
| 152 | #define GPIO_NUMBER ((uint32_t)16)
|
---|
| 153 | /**
|
---|
| 154 | * @}
|
---|
| 155 | */
|
---|
| 156 | /* Private macro -------------------------------------------------------------*/
|
---|
| 157 | /* Private variables ---------------------------------------------------------*/
|
---|
| 158 | /* Private function prototypes -----------------------------------------------*/
|
---|
| 159 | /* Private functions ---------------------------------------------------------*/
|
---|
| 160 | /* Exported functions --------------------------------------------------------*/
|
---|
| 161 | /** @defgroup GPIO_Exported_Functions GPIO Exported Functions
|
---|
| 162 | * @{
|
---|
| 163 | */
|
---|
| 164 |
|
---|
| 165 | /** @defgroup GPIO_Exported_Functions_Group1 Initialization and de-initialization functions
|
---|
| 166 | * @brief Initialization and Configuration functions
|
---|
| 167 | *
|
---|
| 168 | @verbatim
|
---|
| 169 | ===============================================================================
|
---|
| 170 | ##### Initialization and de-initialization functions #####
|
---|
| 171 | ===============================================================================
|
---|
| 172 | [..]
|
---|
| 173 | This section provides functions allowing to initialize and de-initialize the GPIOs
|
---|
| 174 | to be ready for use.
|
---|
| 175 |
|
---|
| 176 | @endverbatim
|
---|
| 177 | * @{
|
---|
| 178 | */
|
---|
| 179 |
|
---|
| 180 |
|
---|
| 181 | /**
|
---|
| 182 | * @brief Initializes the GPIOx peripheral according to the specified parameters in the GPIO_Init.
|
---|
| 183 | * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F429X device or
|
---|
| 184 | * x can be (A..I) to select the GPIO peripheral for STM32F40XX and STM32F427X devices.
|
---|
| 185 | * @param GPIO_Init: pointer to a GPIO_InitTypeDef structure that contains
|
---|
| 186 | * the configuration information for the specified GPIO peripheral.
|
---|
| 187 | * @retval None
|
---|
| 188 | */
|
---|
| 189 | void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init)
|
---|
| 190 | {
|
---|
| 191 | uint32_t position;
|
---|
| 192 | uint32_t ioposition = 0x00;
|
---|
| 193 | uint32_t iocurrent = 0x00;
|
---|
| 194 | uint32_t temp = 0x00;
|
---|
| 195 |
|
---|
| 196 | /* Check the parameters */
|
---|
| 197 | assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
|
---|
| 198 | assert_param(IS_GPIO_PIN(GPIO_Init->Pin));
|
---|
| 199 | assert_param(IS_GPIO_MODE(GPIO_Init->Mode));
|
---|
| 200 | assert_param(IS_GPIO_PULL(GPIO_Init->Pull));
|
---|
| 201 |
|
---|
| 202 | /* Configure the port pins */
|
---|
| 203 | for(position = 0; position < GPIO_NUMBER; position++)
|
---|
| 204 | {
|
---|
| 205 | /* Get the IO position */
|
---|
| 206 | ioposition = ((uint32_t)0x01) << position;
|
---|
| 207 | /* Get the current IO position */
|
---|
| 208 | iocurrent = (uint32_t)(GPIO_Init->Pin) & ioposition;
|
---|
| 209 |
|
---|
| 210 | if(iocurrent == ioposition)
|
---|
| 211 | {
|
---|
| 212 | /*--------------------- GPIO Mode Configuration ------------------------*/
|
---|
| 213 | /* In case of Alternate function mode selection */
|
---|
| 214 | if((GPIO_Init->Mode == GPIO_MODE_AF_PP) || (GPIO_Init->Mode == GPIO_MODE_AF_OD))
|
---|
| 215 | {
|
---|
| 216 | /* Check the Alternate function parameter */
|
---|
| 217 | assert_param(IS_GPIO_AF(GPIO_Init->Alternate));
|
---|
| 218 | /* Configure Alternate function mapped with the current IO */
|
---|
| 219 | temp = GPIOx->AFR[position >> 3];
|
---|
| 220 | temp &= ~((uint32_t)0xF << ((uint32_t)(position & (uint32_t)0x07) * 4)) ;
|
---|
| 221 | temp |= ((uint32_t)(GPIO_Init->Alternate) << (((uint32_t)position & (uint32_t)0x07) * 4));
|
---|
| 222 | GPIOx->AFR[position >> 3] = temp;
|
---|
| 223 | }
|
---|
| 224 |
|
---|
| 225 | /* Configure IO Direction mode (Input, Output, Alternate or Analog) */
|
---|
| 226 | temp = GPIOx->MODER;
|
---|
| 227 | temp &= ~(GPIO_MODER_MODER0 << (position * 2));
|
---|
| 228 | temp |= ((GPIO_Init->Mode & GPIO_MODE) << (position * 2));
|
---|
| 229 | GPIOx->MODER = temp;
|
---|
| 230 |
|
---|
| 231 | /* In case of Output or Alternate function mode selection */
|
---|
| 232 | if((GPIO_Init->Mode == GPIO_MODE_OUTPUT_PP) || (GPIO_Init->Mode == GPIO_MODE_AF_PP) ||
|
---|
| 233 | (GPIO_Init->Mode == GPIO_MODE_OUTPUT_OD) || (GPIO_Init->Mode == GPIO_MODE_AF_OD))
|
---|
| 234 | {
|
---|
| 235 | /* Check the Speed parameter */
|
---|
| 236 | assert_param(IS_GPIO_SPEED(GPIO_Init->Speed));
|
---|
| 237 | /* Configure the IO Speed */
|
---|
| 238 | temp = GPIOx->OSPEEDR;
|
---|
| 239 | temp &= ~(GPIO_OSPEEDER_OSPEEDR0 << (position * 2));
|
---|
| 240 | temp |= (GPIO_Init->Speed << (position * 2));
|
---|
| 241 | GPIOx->OSPEEDR = temp;
|
---|
| 242 |
|
---|
| 243 | /* Configure the IO Output Type */
|
---|
| 244 | temp = GPIOx->OTYPER;
|
---|
| 245 | temp &= ~(GPIO_OTYPER_OT_0 << position) ;
|
---|
| 246 | temp |= (((GPIO_Init->Mode & GPIO_OUTPUT_TYPE) >> 4) << position);
|
---|
| 247 | GPIOx->OTYPER = temp;
|
---|
| 248 | }
|
---|
| 249 |
|
---|
| 250 | /* Activate the Pull-up or Pull down resistor for the current IO */
|
---|
| 251 | temp = GPIOx->PUPDR;
|
---|
| 252 | temp &= ~(GPIO_PUPDR_PUPDR0 << (position * 2));
|
---|
| 253 | temp |= ((GPIO_Init->Pull) << (position * 2));
|
---|
| 254 | GPIOx->PUPDR = temp;
|
---|
| 255 |
|
---|
| 256 | /*--------------------- EXTI Mode Configuration ------------------------*/
|
---|
| 257 | /* Configure the External Interrupt or event for the current IO */
|
---|
| 258 | if((GPIO_Init->Mode & EXTI_MODE) == EXTI_MODE)
|
---|
| 259 | {
|
---|
| 260 | /* Enable SYSCFG Clock */
|
---|
| 261 | __HAL_RCC_SYSCFG_CLK_ENABLE();
|
---|
| 262 |
|
---|
| 263 | temp = SYSCFG->EXTICR[position >> 2];
|
---|
| 264 | temp &= ~(((uint32_t)0x0F) << (4 * (position & 0x03)));
|
---|
| 265 | temp |= ((uint32_t)(GPIO_GET_INDEX(GPIOx)) << (4 * (position & 0x03)));
|
---|
| 266 | SYSCFG->EXTICR[position >> 2] = temp;
|
---|
| 267 |
|
---|
| 268 | /* Clear EXTI line configuration */
|
---|
| 269 | temp = EXTI->IMR;
|
---|
| 270 | temp &= ~((uint32_t)iocurrent);
|
---|
| 271 | if((GPIO_Init->Mode & GPIO_MODE_IT) == GPIO_MODE_IT)
|
---|
| 272 | {
|
---|
| 273 | temp |= iocurrent;
|
---|
| 274 | }
|
---|
| 275 | EXTI->IMR = temp;
|
---|
| 276 |
|
---|
| 277 | temp = EXTI->EMR;
|
---|
| 278 | temp &= ~((uint32_t)iocurrent);
|
---|
| 279 | if((GPIO_Init->Mode & GPIO_MODE_EVT) == GPIO_MODE_EVT)
|
---|
| 280 | {
|
---|
| 281 | temp |= iocurrent;
|
---|
| 282 | }
|
---|
| 283 | EXTI->EMR = temp;
|
---|
| 284 |
|
---|
| 285 | /* Clear Rising Falling edge configuration */
|
---|
| 286 | temp = EXTI->RTSR;
|
---|
| 287 | temp &= ~((uint32_t)iocurrent);
|
---|
| 288 | if((GPIO_Init->Mode & RISING_EDGE) == RISING_EDGE)
|
---|
| 289 | {
|
---|
| 290 | temp |= iocurrent;
|
---|
| 291 | }
|
---|
| 292 | EXTI->RTSR = temp;
|
---|
| 293 |
|
---|
| 294 | temp = EXTI->FTSR;
|
---|
| 295 | temp &= ~((uint32_t)iocurrent);
|
---|
| 296 | if((GPIO_Init->Mode & FALLING_EDGE) == FALLING_EDGE)
|
---|
| 297 | {
|
---|
| 298 | temp |= iocurrent;
|
---|
| 299 | }
|
---|
| 300 | EXTI->FTSR = temp;
|
---|
| 301 | }
|
---|
| 302 | }
|
---|
| 303 | }
|
---|
| 304 | }
|
---|
| 305 |
|
---|
| 306 | /**
|
---|
| 307 | * @brief De-initializes the GPIOx peripheral registers to their default reset values.
|
---|
| 308 | * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F429X device or
|
---|
| 309 | * x can be (A..I) to select the GPIO peripheral for STM32F40XX and STM32F427X devices.
|
---|
| 310 | * @param GPIO_Pin: specifies the port bit to be written.
|
---|
| 311 | * This parameter can be one of GPIO_PIN_x where x can be (0..15).
|
---|
| 312 | * @retval None
|
---|
| 313 | */
|
---|
| 314 | void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin)
|
---|
| 315 | {
|
---|
| 316 | uint32_t position;
|
---|
| 317 | uint32_t ioposition = 0x00;
|
---|
| 318 | uint32_t iocurrent = 0x00;
|
---|
| 319 | uint32_t tmp = 0x00;
|
---|
| 320 |
|
---|
| 321 | /* Check the parameters */
|
---|
| 322 | assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
|
---|
| 323 |
|
---|
| 324 | /* Configure the port pins */
|
---|
| 325 | for(position = 0; position < GPIO_NUMBER; position++)
|
---|
| 326 | {
|
---|
| 327 | /* Get the IO position */
|
---|
| 328 | ioposition = ((uint32_t)0x01) << position;
|
---|
| 329 | /* Get the current IO position */
|
---|
| 330 | iocurrent = (GPIO_Pin) & ioposition;
|
---|
| 331 |
|
---|
| 332 | if(iocurrent == ioposition)
|
---|
| 333 | {
|
---|
| 334 | /*------------------------- GPIO Mode Configuration --------------------*/
|
---|
| 335 | /* Configure IO Direction in Input Floating Mode */
|
---|
| 336 | GPIOx->MODER &= ~(GPIO_MODER_MODER0 << (position * 2));
|
---|
| 337 |
|
---|
| 338 | /* Configure the default Alternate Function in current IO */
|
---|
| 339 | GPIOx->AFR[position >> 3] &= ~((uint32_t)0xF << ((uint32_t)(position & (uint32_t)0x07) * 4)) ;
|
---|
| 340 |
|
---|
| 341 | /* Configure the default value for IO Speed */
|
---|
| 342 | GPIOx->OSPEEDR &= ~(GPIO_OSPEEDER_OSPEEDR0 << (position * 2));
|
---|
| 343 |
|
---|
| 344 | /* Configure the default value IO Output Type */
|
---|
| 345 | GPIOx->OTYPER &= ~(GPIO_OTYPER_OT_0 << position) ;
|
---|
| 346 |
|
---|
| 347 | /* Deactivate the Pull-up and Pull-down resistor for the current IO */
|
---|
| 348 | GPIOx->PUPDR &= ~(GPIO_PUPDR_PUPDR0 << (position * 2));
|
---|
| 349 |
|
---|
| 350 | /*------------------------- EXTI Mode Configuration --------------------*/
|
---|
| 351 | tmp = SYSCFG->EXTICR[position >> 2];
|
---|
| 352 | tmp &= (((uint32_t)0x0F) << (4 * (position & 0x03)));
|
---|
| 353 | if(tmp == ((uint32_t)(GPIO_GET_INDEX(GPIOx)) << (4 * (position & 0x03))))
|
---|
| 354 | {
|
---|
| 355 | /* Configure the External Interrupt or event for the current IO */
|
---|
| 356 | tmp = ((uint32_t)0x0F) << (4 * (position & 0x03));
|
---|
| 357 | SYSCFG->EXTICR[position >> 2] &= ~tmp;
|
---|
| 358 |
|
---|
| 359 | /* Clear EXTI line configuration */
|
---|
| 360 | EXTI->IMR &= ~((uint32_t)iocurrent);
|
---|
| 361 | EXTI->EMR &= ~((uint32_t)iocurrent);
|
---|
| 362 |
|
---|
| 363 | /* Clear Rising Falling edge configuration */
|
---|
| 364 | EXTI->RTSR &= ~((uint32_t)iocurrent);
|
---|
| 365 | EXTI->FTSR &= ~((uint32_t)iocurrent);
|
---|
| 366 | }
|
---|
| 367 | }
|
---|
| 368 | }
|
---|
| 369 | }
|
---|
| 370 |
|
---|
| 371 | /**
|
---|
| 372 | * @}
|
---|
| 373 | */
|
---|
| 374 |
|
---|
| 375 | /** @defgroup GPIO_Exported_Functions_Group2 IO operation functions
|
---|
| 376 | * @brief GPIO Read and Write
|
---|
| 377 | *
|
---|
| 378 | @verbatim
|
---|
| 379 | ===============================================================================
|
---|
| 380 | ##### IO operation functions #####
|
---|
| 381 | ===============================================================================
|
---|
| 382 |
|
---|
| 383 | @endverbatim
|
---|
| 384 | * @{
|
---|
| 385 | */
|
---|
| 386 |
|
---|
| 387 | /**
|
---|
| 388 | * @brief Reads the specified input port pin.
|
---|
| 389 | * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F429X device or
|
---|
| 390 | * x can be (A..I) to select the GPIO peripheral for STM32F40XX and STM32F427X devices.
|
---|
| 391 | * @param GPIO_Pin: specifies the port bit to read.
|
---|
| 392 | * This parameter can be GPIO_PIN_x where x can be (0..15).
|
---|
| 393 | * @retval The input port pin value.
|
---|
| 394 | */
|
---|
| 395 | GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
|
---|
| 396 | {
|
---|
| 397 | GPIO_PinState bitstatus;
|
---|
| 398 |
|
---|
| 399 | /* Check the parameters */
|
---|
| 400 | assert_param(IS_GPIO_PIN(GPIO_Pin));
|
---|
| 401 |
|
---|
| 402 | if((GPIOx->IDR & GPIO_Pin) != (uint32_t)GPIO_PIN_RESET)
|
---|
| 403 | {
|
---|
| 404 | bitstatus = GPIO_PIN_SET;
|
---|
| 405 | }
|
---|
| 406 | else
|
---|
| 407 | {
|
---|
| 408 | bitstatus = GPIO_PIN_RESET;
|
---|
| 409 | }
|
---|
| 410 | return bitstatus;
|
---|
| 411 | }
|
---|
| 412 |
|
---|
| 413 | /**
|
---|
| 414 | * @brief Sets or clears the selected data port bit.
|
---|
| 415 | *
|
---|
| 416 | * @note This function uses GPIOx_BSRR register to allow atomic read/modify
|
---|
| 417 | * accesses. In this way, there is no risk of an IRQ occurring between
|
---|
| 418 | * the read and the modify access.
|
---|
| 419 | *
|
---|
| 420 | * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F429X device or
|
---|
| 421 | * x can be (A..I) to select the GPIO peripheral for STM32F40XX and STM32F427X devices.
|
---|
| 422 | * @param GPIO_Pin: specifies the port bit to be written.
|
---|
| 423 | * This parameter can be one of GPIO_PIN_x where x can be (0..15).
|
---|
| 424 | * @param PinState: specifies the value to be written to the selected bit.
|
---|
| 425 | * This parameter can be one of the GPIO_PinState enum values:
|
---|
| 426 | * @arg GPIO_PIN_RESET: to clear the port pin
|
---|
| 427 | * @arg GPIO_PIN_SET: to set the port pin
|
---|
| 428 | * @retval None
|
---|
| 429 | */
|
---|
| 430 | void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
|
---|
| 431 | {
|
---|
| 432 | /* Check the parameters */
|
---|
| 433 | assert_param(IS_GPIO_PIN(GPIO_Pin));
|
---|
| 434 | assert_param(IS_GPIO_PIN_ACTION(PinState));
|
---|
| 435 |
|
---|
| 436 | if(PinState != GPIO_PIN_RESET)
|
---|
| 437 | {
|
---|
| 438 | GPIOx->BSRR = GPIO_Pin;
|
---|
| 439 | }
|
---|
| 440 | else
|
---|
| 441 | {
|
---|
| 442 | GPIOx->BSRR = (uint32_t)GPIO_Pin << 16;
|
---|
| 443 | }
|
---|
| 444 | }
|
---|
| 445 |
|
---|
| 446 | /**
|
---|
| 447 | * @brief Toggles the specified GPIO pins.
|
---|
| 448 | * @param GPIOx: Where x can be (A..K) to select the GPIO peripheral for STM32F429X device or
|
---|
| 449 | * x can be (A..I) to select the GPIO peripheral for STM32F40XX and STM32F427X devices.
|
---|
| 450 | * @param GPIO_Pin: Specifies the pins to be toggled.
|
---|
| 451 | * @retval None
|
---|
| 452 | */
|
---|
| 453 | void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
|
---|
| 454 | {
|
---|
| 455 | /* Check the parameters */
|
---|
| 456 | assert_param(IS_GPIO_PIN(GPIO_Pin));
|
---|
| 457 |
|
---|
| 458 | GPIOx->ODR ^= GPIO_Pin;
|
---|
| 459 | }
|
---|
| 460 |
|
---|
| 461 | /**
|
---|
| 462 | * @brief Locks GPIO Pins configuration registers.
|
---|
| 463 | * @note The locked registers are GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR,
|
---|
| 464 | * GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH.
|
---|
| 465 | * @note The configuration of the locked GPIO pins can no longer be modified
|
---|
| 466 | * until the next reset.
|
---|
| 467 | * @param GPIOx: where x can be (A..F) to select the GPIO peripheral for STM32F4 family
|
---|
| 468 | * @param GPIO_Pin: specifies the port bit to be locked.
|
---|
| 469 | * This parameter can be any combination of GPIO_PIN_x where x can be (0..15).
|
---|
| 470 | * @retval None
|
---|
| 471 | */
|
---|
| 472 | HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
|
---|
| 473 | {
|
---|
| 474 | __IO uint32_t tmp = GPIO_LCKR_LCKK;
|
---|
| 475 |
|
---|
| 476 | /* Check the parameters */
|
---|
| 477 | assert_param(IS_GPIO_PIN(GPIO_Pin));
|
---|
| 478 |
|
---|
| 479 | /* Apply lock key write sequence */
|
---|
| 480 | tmp |= GPIO_Pin;
|
---|
| 481 | /* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
|
---|
| 482 | GPIOx->LCKR = tmp;
|
---|
| 483 | /* Reset LCKx bit(s): LCKK='0' + LCK[15-0] */
|
---|
| 484 | GPIOx->LCKR = GPIO_Pin;
|
---|
| 485 | /* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
|
---|
| 486 | GPIOx->LCKR = tmp;
|
---|
| 487 | /* Read LCKK bit*/
|
---|
| 488 | tmp = GPIOx->LCKR;
|
---|
| 489 |
|
---|
| 490 | if((GPIOx->LCKR & GPIO_LCKR_LCKK) != RESET)
|
---|
| 491 | {
|
---|
| 492 | return HAL_OK;
|
---|
| 493 | }
|
---|
| 494 | else
|
---|
| 495 | {
|
---|
| 496 | return HAL_ERROR;
|
---|
| 497 | }
|
---|
| 498 | }
|
---|
| 499 |
|
---|
| 500 | /**
|
---|
| 501 | * @brief This function handles EXTI interrupt request.
|
---|
| 502 | * @param GPIO_Pin: Specifies the pins connected EXTI line
|
---|
| 503 | * @retval None
|
---|
| 504 | */
|
---|
| 505 | void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
|
---|
| 506 | {
|
---|
| 507 | /* EXTI line interrupt detected */
|
---|
| 508 | if(__HAL_GPIO_EXTI_GET_IT(GPIO_Pin) != RESET)
|
---|
| 509 | {
|
---|
| 510 | __HAL_GPIO_EXTI_CLEAR_IT(GPIO_Pin);
|
---|
| 511 | HAL_GPIO_EXTI_Callback(GPIO_Pin);
|
---|
| 512 | }
|
---|
| 513 | }
|
---|
| 514 |
|
---|
| 515 | /**
|
---|
| 516 | * @brief EXTI line detection callbacks.
|
---|
| 517 | * @param GPIO_Pin: Specifies the pins connected EXTI line
|
---|
| 518 | * @retval None
|
---|
| 519 | */
|
---|
| 520 | __weak void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
|
---|
| 521 | {
|
---|
| 522 | /* NOTE: This function Should not be modified, when the callback is needed,
|
---|
| 523 | the HAL_GPIO_EXTI_Callback could be implemented in the user file
|
---|
| 524 | */
|
---|
| 525 | }
|
---|
| 526 |
|
---|
| 527 | /**
|
---|
| 528 | * @}
|
---|
| 529 | */
|
---|
| 530 |
|
---|
| 531 |
|
---|
| 532 | /**
|
---|
| 533 | * @}
|
---|
| 534 | */
|
---|
| 535 |
|
---|
| 536 | #endif /* HAL_GPIO_MODULE_ENABLED */
|
---|
| 537 | /**
|
---|
| 538 | * @}
|
---|
| 539 | */
|
---|
| 540 |
|
---|
| 541 | /**
|
---|
| 542 | * @}
|
---|
| 543 | */
|
---|
| 544 |
|
---|
| 545 | /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
---|