3ef911345c
This patch updates ST's HAL to the latest version, V1.3.0, dated 19 June 2014. Files were copied verbatim from the ST package. Only change was to suppress compiler warning of unused variables in 4 places. A lot of the changes from ST are cosmetic: comments and white space. Some small code changes here and there, and addition of F411 header. Main code change is how SysTick interrupt is set: it now has a configuration variable to set the priority, so we no longer need to work around this (originall in system_stm32f4xx.c).
272 lines
12 KiB
C
272 lines
12 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32f4xx_hal_gpio.h
|
|
* @author MCD Application Team
|
|
* @version V1.1.0
|
|
* @date 19-June-2014
|
|
* @brief Header file of GPIO HAL module.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted provided that the following conditions are met:
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of STMicroelectronics nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef __STM32F4xx_HAL_GPIO_H
|
|
#define __STM32F4xx_HAL_GPIO_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32f4xx_hal_def.h"
|
|
|
|
/** @addtogroup STM32F4xx_HAL_Driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup GPIO
|
|
* @{
|
|
*/
|
|
|
|
/* Exported types ------------------------------------------------------------*/
|
|
|
|
/**
|
|
* @brief GPIO Init structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t Pin; /*!< Specifies the GPIO pins to be configured.
|
|
This parameter can be any value of @ref GPIO_pins_define */
|
|
|
|
uint32_t Mode; /*!< Specifies the operating mode for the selected pins.
|
|
This parameter can be a value of @ref GPIO_mode_define */
|
|
|
|
uint32_t Pull; /*!< Specifies the Pull-up or Pull-Down activation for the selected pins.
|
|
This parameter can be a value of @ref GPIO_pull_define */
|
|
|
|
uint32_t Speed; /*!< Specifies the speed for the selected pins.
|
|
This parameter can be a value of @ref GPIO_speed_define */
|
|
|
|
uint32_t Alternate; /*!< Peripheral to be connected to the selected pins.
|
|
This parameter can be a value of @ref GPIO_Alternat_function_selection */
|
|
}GPIO_InitTypeDef;
|
|
|
|
/**
|
|
* @brief GPIO Bit SET and Bit RESET enumeration
|
|
*/
|
|
typedef enum
|
|
{
|
|
GPIO_PIN_RESET = 0,
|
|
GPIO_PIN_SET
|
|
}GPIO_PinState;
|
|
#define IS_GPIO_PIN_ACTION(ACTION) (((ACTION) == GPIO_PIN_RESET) || ((ACTION) == GPIO_PIN_SET))
|
|
|
|
/* Exported constants --------------------------------------------------------*/
|
|
|
|
/** @defgroup GPIO_Exported_Constants
|
|
* @{
|
|
*/
|
|
|
|
/** @defgroup GPIO_pins_define
|
|
* @{
|
|
*/
|
|
#define GPIO_PIN_0 ((uint16_t)0x0001) /* Pin 0 selected */
|
|
#define GPIO_PIN_1 ((uint16_t)0x0002) /* Pin 1 selected */
|
|
#define GPIO_PIN_2 ((uint16_t)0x0004) /* Pin 2 selected */
|
|
#define GPIO_PIN_3 ((uint16_t)0x0008) /* Pin 3 selected */
|
|
#define GPIO_PIN_4 ((uint16_t)0x0010) /* Pin 4 selected */
|
|
#define GPIO_PIN_5 ((uint16_t)0x0020) /* Pin 5 selected */
|
|
#define GPIO_PIN_6 ((uint16_t)0x0040) /* Pin 6 selected */
|
|
#define GPIO_PIN_7 ((uint16_t)0x0080) /* Pin 7 selected */
|
|
#define GPIO_PIN_8 ((uint16_t)0x0100) /* Pin 8 selected */
|
|
#define GPIO_PIN_9 ((uint16_t)0x0200) /* Pin 9 selected */
|
|
#define GPIO_PIN_10 ((uint16_t)0x0400) /* Pin 10 selected */
|
|
#define GPIO_PIN_11 ((uint16_t)0x0800) /* Pin 11 selected */
|
|
#define GPIO_PIN_12 ((uint16_t)0x1000) /* Pin 12 selected */
|
|
#define GPIO_PIN_13 ((uint16_t)0x2000) /* Pin 13 selected */
|
|
#define GPIO_PIN_14 ((uint16_t)0x4000) /* Pin 14 selected */
|
|
#define GPIO_PIN_15 ((uint16_t)0x8000) /* Pin 15 selected */
|
|
#define GPIO_PIN_All ((uint16_t)0xFFFF) /* All pins selected */
|
|
|
|
#define GPIO_PIN_MASK ((uint32_t)0x0000FFFF) /* PIN mask for assert test */
|
|
#define IS_GPIO_PIN(PIN) (((PIN) & GPIO_PIN_MASK ) != (uint32_t)0x00)
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup GPIO_mode_define
|
|
* @brief GPIO Configuration Mode
|
|
* Elements values convention: 0xX0yz00YZ
|
|
* - X : GPIO mode or EXTI Mode
|
|
* - y : External IT or Event trigger detection
|
|
* - z : IO configuration on External IT or Event
|
|
* - Y : Output type (Push Pull or Open Drain)
|
|
* - Z : IO Direction mode (Input, Output, Alternate or Analog)
|
|
* @{
|
|
*/
|
|
#define GPIO_MODE_INPUT ((uint32_t)0x00000000) /*!< Input Floating Mode */
|
|
#define GPIO_MODE_OUTPUT_PP ((uint32_t)0x00000001) /*!< Output Push Pull Mode */
|
|
#define GPIO_MODE_OUTPUT_OD ((uint32_t)0x00000011) /*!< Output Open Drain Mode */
|
|
#define GPIO_MODE_AF_PP ((uint32_t)0x00000002) /*!< Alternate Function Push Pull Mode */
|
|
#define GPIO_MODE_AF_OD ((uint32_t)0x00000012) /*!< Alternate Function Open Drain Mode */
|
|
|
|
#define GPIO_MODE_ANALOG ((uint32_t)0x00000003) /*!< Analog Mode */
|
|
|
|
#define GPIO_MODE_IT_RISING ((uint32_t)0x10110000) /*!< External Interrupt Mode with Rising edge trigger detection */
|
|
#define GPIO_MODE_IT_FALLING ((uint32_t)0x10210000) /*!< External Interrupt Mode with Falling edge trigger detection */
|
|
#define GPIO_MODE_IT_RISING_FALLING ((uint32_t)0x10310000) /*!< External Interrupt Mode with Rising/Falling edge trigger detection */
|
|
|
|
#define GPIO_MODE_EVT_RISING ((uint32_t)0x10120000) /*!< External Event Mode with Rising edge trigger detection */
|
|
#define GPIO_MODE_EVT_FALLING ((uint32_t)0x10220000) /*!< External Event Mode with Falling edge trigger detection */
|
|
#define GPIO_MODE_EVT_RISING_FALLING ((uint32_t)0x10320000) /*!< External Event Mode with Rising/Falling edge trigger detection */
|
|
|
|
#define IS_GPIO_MODE(MODE) (((MODE) == GPIO_MODE_INPUT) ||\
|
|
((MODE) == GPIO_MODE_OUTPUT_PP) ||\
|
|
((MODE) == GPIO_MODE_OUTPUT_OD) ||\
|
|
((MODE) == GPIO_MODE_AF_PP) ||\
|
|
((MODE) == GPIO_MODE_AF_OD) ||\
|
|
((MODE) == GPIO_MODE_IT_RISING) ||\
|
|
((MODE) == GPIO_MODE_IT_FALLING) ||\
|
|
((MODE) == GPIO_MODE_IT_RISING_FALLING) ||\
|
|
((MODE) == GPIO_MODE_EVT_RISING) ||\
|
|
((MODE) == GPIO_MODE_EVT_FALLING) ||\
|
|
((MODE) == GPIO_MODE_EVT_RISING_FALLING) ||\
|
|
((MODE) == GPIO_MODE_ANALOG))
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
/** @defgroup GPIO_speed_define
|
|
* @brief GPIO Output Maximum frequency
|
|
* @{
|
|
*/
|
|
#define GPIO_SPEED_LOW ((uint32_t)0x00000000) /*!< Low speed */
|
|
#define GPIO_SPEED_MEDIUM ((uint32_t)0x00000001) /*!< Medium speed */
|
|
#define GPIO_SPEED_FAST ((uint32_t)0x00000002) /*!< Fast speed */
|
|
#define GPIO_SPEED_HIGH ((uint32_t)0x00000003) /*!< High speed */
|
|
|
|
#define IS_GPIO_SPEED(SPEED) (((SPEED) == GPIO_SPEED_LOW) || ((SPEED) == GPIO_SPEED_MEDIUM) || \
|
|
((SPEED) == GPIO_SPEED_FAST) || ((SPEED) == GPIO_SPEED_HIGH))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup GPIO_pull_define
|
|
* @brief GPIO Pull-Up or Pull-Down Activation
|
|
* @{
|
|
*/
|
|
#define GPIO_NOPULL ((uint32_t)0x00000000) /*!< No Pull-up or Pull-down activation */
|
|
#define GPIO_PULLUP ((uint32_t)0x00000001) /*!< Pull-up activation */
|
|
#define GPIO_PULLDOWN ((uint32_t)0x00000002) /*!< Pull-down activation */
|
|
|
|
#define IS_GPIO_PULL(PULL) (((PULL) == GPIO_NOPULL) || ((PULL) == GPIO_PULLUP) || \
|
|
((PULL) == GPIO_PULLDOWN))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Exported macro ------------------------------------------------------------*/
|
|
|
|
/**
|
|
* @brief Checks whether the specified EXTI line flag is set or not.
|
|
* @param __EXTI_LINE__: specifies the EXTI line flag to check.
|
|
* This parameter can be GPIO_PIN_x where x can be(0..15)
|
|
* @retval The new state of __EXTI_LINE__ (SET or RESET).
|
|
*/
|
|
#define __HAL_GPIO_EXTI_GET_FLAG(__EXTI_LINE__) (EXTI->PR & (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Clears the EXTI's line pending flags.
|
|
* @param __EXTI_LINE__: specifies the EXTI lines flags to clear.
|
|
* This parameter can be any combination of GPIO_PIN_x where x can be (0..15)
|
|
* @retval None
|
|
*/
|
|
#define __HAL_GPIO_EXTI_CLEAR_FLAG(__EXTI_LINE__) (EXTI->PR = (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Checks whether the specified EXTI line is asserted or not.
|
|
* @param __EXTI_LINE__: specifies the EXTI line to check.
|
|
* This parameter can be GPIO_PIN_x where x can be(0..15)
|
|
* @retval The new state of __EXTI_LINE__ (SET or RESET).
|
|
*/
|
|
#define __HAL_GPIO_EXTI_GET_IT(__EXTI_LINE__) (EXTI->PR & (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Clears the EXTI's line pending bits.
|
|
* @param __EXTI_LINE__: specifies the EXTI lines to clear.
|
|
* This parameter can be any combination of GPIO_PIN_x where x can be (0..15)
|
|
* @retval None
|
|
*/
|
|
#define __HAL_GPIO_EXTI_CLEAR_IT(__EXTI_LINE__) (EXTI->PR = (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Generates a Software interrupt on selected EXTI line.
|
|
* @param __EXTI_LINE__: specifies the EXTI line to check.
|
|
* This parameter can be GPIO_PIN_x where x can be(0..15)
|
|
* @retval None
|
|
*/
|
|
#define __HAL_GPIO_EXTI_GENERATE_SWIT(__EXTI_LINE__) (EXTI->SWIER |= (__EXTI_LINE__))
|
|
|
|
/* Include GPIO HAL Extension module */
|
|
#include "stm32f4xx_hal_gpio_ex.h"
|
|
|
|
/* Exported functions --------------------------------------------------------*/
|
|
/* Initialization and de-initialization functions *******************************/
|
|
void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);
|
|
void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin);
|
|
|
|
/* IO operation functions *******************************************************/
|
|
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
|
|
void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);
|
|
void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
|
|
HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
|
|
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);
|
|
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __STM32F4xx_HAL_GPIO_H */
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|