441 lines
12 KiB
C
441 lines
12 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32f4xx_hal_exti.c
|
|
* @author MCD Application Team
|
|
* @brief EXTI HAL module driver.
|
|
* This file provides firmware functions to manage the following
|
|
* functionalities of the Extended Interrupts and events controller (EXTI) peripheral:
|
|
* + Initialization and de-initialization functions
|
|
* + IO operation functions
|
|
*
|
|
@verbatim
|
|
==============================================================================
|
|
##### EXTI Peripheral features #####
|
|
==============================================================================
|
|
[..]
|
|
(+) Each Exti line can be configured within this driver.
|
|
|
|
(+) Exti line can be configured in 3 different modes
|
|
(++) Interrupt
|
|
(++) Event
|
|
(++) Both of them
|
|
|
|
(+) Configurable Exti lines can be configured with 3 different triggers
|
|
(++) Rising
|
|
(++) Falling
|
|
(++) Both of them
|
|
|
|
(+) When set in interrupt mode, configurable Exti lines have two different
|
|
interrupts pending registers which allow to distinguish which transition
|
|
occurs:
|
|
(++) Rising edge pending interrupt
|
|
(++) Falling
|
|
|
|
(+) Exti lines 0 to 15 are linked to gpio pin number 0 to 15. Gpio port can
|
|
be selected through multiplexer.
|
|
|
|
##### How to use this driver #####
|
|
==============================================================================
|
|
[..]
|
|
|
|
(#) Configure the EXTI line using HAL_EXTI_SetConfigLine().
|
|
(++) Choose the interrupt line number by setting "Line" member from
|
|
EXTI_ConfigTypeDef structure.
|
|
(++) Configure the interrupt and/or event mode using "Mode" member from
|
|
EXTI_ConfigTypeDef structure.
|
|
(++) For configurable lines, configure rising and/or falling trigger
|
|
"Trigger" member from EXTI_ConfigTypeDef structure.
|
|
|
|
(#) Get current Exti configuration of a dedicated line using
|
|
HAL_EXTI_GetConfigLine().
|
|
(++) Provide exiting handle as parameter.
|
|
(++) Provide pointer on EXTI_ConfigTypeDef structure as second parameter.
|
|
|
|
(#) Clear Exti configuration of a dedicated line using HAL_EXTI_GetConfigLine().
|
|
(++) Provide exiting handle as parameter.
|
|
|
|
(#) Register callback to treat Exti interrupts using HAL_EXTI_RegisterCallback().
|
|
(++) Provide exiting handle as first parameter.
|
|
(++) Provide which callback will be registered using one value from
|
|
EXTI_CallbackIDTypeDef.
|
|
(++) Provide callback function pointer.
|
|
|
|
(#) Get interrupt pending bit using HAL_EXTI_GetPending().
|
|
|
|
(#) Clear interrupt pending bit using HAL_EXTI_GetPending().
|
|
|
|
(#) Generate software interrupt using HAL_EXTI_GenerateSWI().
|
|
|
|
@endverbatim
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© Copyright (c) 2018 STMicroelectronics.
|
|
* All rights reserved.</center></h2>
|
|
*
|
|
* This software component is licensed by ST under BSD 3-Clause license,
|
|
* the "License"; You may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at:
|
|
* opensource.org/licenses/BSD-3-Clause
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32f4xx_hal.h"
|
|
|
|
/** @addtogroup STM32F4xx_HAL_Driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup EXTI
|
|
* @{
|
|
*/
|
|
/** MISRA C:2012 deviation rule has been granted for following rule:
|
|
* Rule-18.1_b - Medium: Array `EXTICR' 1st subscript interval [0,7] may be out
|
|
* of bounds [0,3] in following API :
|
|
* HAL_EXTI_SetConfigLine
|
|
* HAL_EXTI_GetConfigLine
|
|
* HAL_EXTI_ClearConfigLine
|
|
*/
|
|
|
|
#ifdef HAL_EXTI_MODULE_ENABLED
|
|
|
|
/* Private typedef -----------------------------------------------------------*/
|
|
/* Private defines -----------------------------------------------------------*/
|
|
/** @defgroup EXTI_Private_Constants EXTI Private Constants
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Private macros ------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
/* Exported functions --------------------------------------------------------*/
|
|
|
|
/** @addtogroup EXTI_Exported_Functions
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup EXTI_Exported_Functions_Group1
|
|
* @brief Configuration functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### Configuration functions #####
|
|
===============================================================================
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Set configuration of a dedicated Exti line.
|
|
* @param hexti Exti handle.
|
|
* @param pExtiConfig Pointer on EXTI configuration to be set.
|
|
* @retval HAL Status.
|
|
*/
|
|
HAL_StatusTypeDef HAL_EXTI_SetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
|
|
{
|
|
uint32_t regval;
|
|
|
|
/* Check null pointer */
|
|
if ((hexti == NULL) || (pExtiConfig == NULL))
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(pExtiConfig->Line));
|
|
assert_param(IS_EXTI_MODE(pExtiConfig->Mode));
|
|
assert_param(IS_EXTI_TRIGGER(pExtiConfig->Trigger));
|
|
|
|
/* Assign line number to handle */
|
|
hexti->Line = pExtiConfig->Line;
|
|
|
|
/* Clear EXTI line configuration */
|
|
EXTI->IMR &= ~pExtiConfig->Line;
|
|
EXTI->EMR &= ~pExtiConfig->Line;
|
|
|
|
/* Select the Mode for the selected external interrupts */
|
|
regval = (uint32_t)EXTI_BASE;
|
|
regval += pExtiConfig->Mode;
|
|
*(__IO uint32_t *) regval |= pExtiConfig->Line;
|
|
|
|
/* Clear Rising Falling edge configuration */
|
|
EXTI->RTSR &= ~pExtiConfig->Line;
|
|
EXTI->FTSR &= ~pExtiConfig->Line;
|
|
|
|
/* Select the trigger for the selected external interrupts */
|
|
if (pExtiConfig->Trigger == EXTI_TRIGGER_RISING_FALLING)
|
|
{
|
|
/* Rising Falling edge */
|
|
EXTI->RTSR |= pExtiConfig->Line;
|
|
EXTI->FTSR |= pExtiConfig->Line;
|
|
}
|
|
else
|
|
{
|
|
regval = (uint32_t)EXTI_BASE;
|
|
regval += pExtiConfig->Trigger;
|
|
*(__IO uint32_t *) regval |= pExtiConfig->Line;
|
|
}
|
|
return HAL_OK;
|
|
}
|
|
|
|
/**
|
|
* @brief Get configuration of a dedicated Exti line.
|
|
* @param hexti Exti handle.
|
|
* @param pExtiConfig Pointer on structure to store Exti configuration.
|
|
* @retval HAL Status.
|
|
*/
|
|
HAL_StatusTypeDef HAL_EXTI_GetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
|
|
{
|
|
/* Check null pointer */
|
|
if ((hexti == NULL) || (pExtiConfig == NULL))
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
|
|
/* Check the parameter */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
|
|
/* Store handle line number to configuration structure */
|
|
pExtiConfig->Line = hexti->Line;
|
|
|
|
/* Get EXTI mode to configiguration structure */
|
|
if ((EXTI->IMR & hexti->Line) == hexti->Line)
|
|
{
|
|
pExtiConfig->Mode = EXTI_MODE_INTERRUPT;
|
|
}
|
|
else if ((EXTI->EMR & hexti->Line) == hexti->Line)
|
|
{
|
|
pExtiConfig->Mode = EXTI_MODE_EVENT;
|
|
}
|
|
else
|
|
{
|
|
/* No MODE selected */
|
|
pExtiConfig->Mode = 0x0Bu;
|
|
}
|
|
|
|
/* Get EXTI Trigger to configiguration structure */
|
|
if ((EXTI->RTSR & hexti->Line) == hexti->Line)
|
|
{
|
|
if ((EXTI->FTSR & hexti->Line) == hexti->Line)
|
|
{
|
|
pExtiConfig->Trigger = EXTI_TRIGGER_RISING_FALLING;
|
|
}
|
|
else
|
|
{
|
|
pExtiConfig->Trigger = EXTI_TRIGGER_RISING;
|
|
}
|
|
}
|
|
else if ((EXTI->FTSR & hexti->Line) == hexti->Line)
|
|
{
|
|
pExtiConfig->Trigger = EXTI_TRIGGER_FALLING;
|
|
}
|
|
else
|
|
{
|
|
/* No Trigger selected */
|
|
pExtiConfig->Trigger = 0x00u;
|
|
}
|
|
|
|
return HAL_OK;
|
|
}
|
|
|
|
/**
|
|
* @brief Clear whole configuration of a dedicated Exti line.
|
|
* @param hexti Exti handle.
|
|
* @retval HAL Status.
|
|
*/
|
|
HAL_StatusTypeDef HAL_EXTI_ClearConfigLine(EXTI_HandleTypeDef *hexti)
|
|
{
|
|
/* Check null pointer */
|
|
if (hexti == NULL)
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
|
|
/* Check the parameter */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
|
|
/* 1] Clear interrupt mode */
|
|
EXTI->IMR = (EXTI->IMR & ~hexti->Line);
|
|
|
|
/* 2] Clear event mode */
|
|
EXTI->EMR = (EXTI->EMR & ~hexti->Line);
|
|
|
|
/* 3] Clear triggers */
|
|
EXTI->RTSR = (EXTI->RTSR & ~hexti->Line);
|
|
EXTI->FTSR = (EXTI->FTSR & ~hexti->Line);
|
|
|
|
return HAL_OK;
|
|
}
|
|
|
|
/**
|
|
* @brief Register callback for a dedicated Exti line.
|
|
* @param hexti Exti handle.
|
|
* @param CallbackID User callback identifier.
|
|
* This parameter can be one of @arg @ref EXTI_CallbackIDTypeDef values.
|
|
* @param pPendingCbfn function pointer to be stored as callback.
|
|
* @retval HAL Status.
|
|
*/
|
|
HAL_StatusTypeDef HAL_EXTI_RegisterCallback(EXTI_HandleTypeDef *hexti, EXTI_CallbackIDTypeDef CallbackID, void (*pPendingCbfn)(void))
|
|
{
|
|
HAL_StatusTypeDef status = HAL_OK;
|
|
|
|
switch (CallbackID)
|
|
{
|
|
case HAL_EXTI_COMMON_CB_ID:
|
|
hexti->RisingCallback = pPendingCbfn;
|
|
break;
|
|
|
|
default:
|
|
status = HAL_ERROR;
|
|
break;
|
|
}
|
|
|
|
return status;
|
|
}
|
|
|
|
/**
|
|
* @brief Store line number as handle private field.
|
|
* @param hexti Exti handle.
|
|
* @param ExtiLine Exti line number.
|
|
* This parameter can be from 0 to @ref EXTI_LINE_NB.
|
|
* @retval HAL Status.
|
|
*/
|
|
HAL_StatusTypeDef HAL_EXTI_GetHandle(EXTI_HandleTypeDef *hexti, uint32_t ExtiLine)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_EXTI_LINE(ExtiLine));
|
|
|
|
/* Check null pointer */
|
|
if (hexti == NULL)
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
else
|
|
{
|
|
/* Store line number as handle private field */
|
|
hexti->Line = ExtiLine;
|
|
|
|
return HAL_OK;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @addtogroup EXTI_Exported_Functions_Group2
|
|
* @brief EXTI IO functions.
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### IO operation functions #####
|
|
===============================================================================
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Handle EXTI interrupt request.
|
|
* @param hexti Exti handle.
|
|
* @retval none.
|
|
*/
|
|
void HAL_EXTI_IRQHandler(EXTI_HandleTypeDef *hexti)
|
|
{
|
|
if (EXTI->PR != 0x00u)
|
|
{
|
|
/* Clear pending bit */
|
|
EXTI->PR = hexti->Line;
|
|
|
|
/* Call callback */
|
|
if (hexti->RisingCallback != NULL)
|
|
{
|
|
hexti->RisingCallback();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Get interrupt pending bit of a dedicated line.
|
|
* @param hexti Exti handle.
|
|
* @param Edge Specify which pending edge as to be checked.
|
|
* This parameter can be one of the following values:
|
|
* @arg @ref EXTI_TRIGGER_RISING_FALLING
|
|
* This parameter is kept for compatibility with other series.
|
|
* @retval 1 if interrupt is pending else 0.
|
|
*/
|
|
uint32_t HAL_EXTI_GetPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
|
|
{
|
|
__IO uint32_t *regaddr;
|
|
uint32_t regval;
|
|
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_PENDING_EDGE(Edge));
|
|
|
|
/* Get pending bit */
|
|
regaddr = &EXTI->PR;
|
|
|
|
/* return 1 if bit is set else 0 */
|
|
regval = ((*regaddr & hexti->Line) >> POSITION_VAL(hexti->Line));
|
|
|
|
return regval;
|
|
}
|
|
|
|
/**
|
|
* @brief Clear interrupt pending bit of a dedicated line.
|
|
* @param hexti Exti handle.
|
|
* @param Edge Specify which pending edge as to be clear.
|
|
* This parameter can be one of the following values:
|
|
* @arg @ref EXTI_TRIGGER_RISING_FALLING
|
|
* This parameter is kept for compatibility with other series.
|
|
* @retval None.
|
|
*/
|
|
void HAL_EXTI_ClearPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
|
|
{
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_PENDING_EDGE(Edge));
|
|
|
|
EXTI->PR = hexti->Line;
|
|
}
|
|
|
|
/**
|
|
* @brief Generate a software interrupt for a dedicated line.
|
|
* @param hexti Exti handle.
|
|
* @retval None.
|
|
*/
|
|
void HAL_EXTI_GenerateSWI(EXTI_HandleTypeDef *hexti)
|
|
{
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
|
|
EXTI->SWIER = hexti->Line;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* HAL_EXTI_MODULE_ENABLED */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|