548 lines
15 KiB
C
548 lines
15 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
|
|
*
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2018 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
@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.
|
|
(++) For Exti lines linked to gpio, choose gpio port using "GPIOSel"
|
|
member from GPIO_InitTypeDef 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
|
|
*/
|
|
|
|
/* 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;
|
|
uint32_t linepos;
|
|
uint32_t maskline;
|
|
|
|
/* 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));
|
|
|
|
/* Assign line number to handle */
|
|
hexti->Line = pExtiConfig->Line;
|
|
|
|
/* Compute line mask */
|
|
linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
|
|
maskline = (1uL << linepos);
|
|
|
|
/* Configure triggers for configurable lines */
|
|
if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
|
|
{
|
|
assert_param(IS_EXTI_TRIGGER(pExtiConfig->Trigger));
|
|
|
|
/* Configure rising trigger */
|
|
/* Mask or set line */
|
|
if ((pExtiConfig->Trigger & EXTI_TRIGGER_RISING) != 0x00u)
|
|
{
|
|
EXTI->RTSR |= maskline;
|
|
}
|
|
else
|
|
{
|
|
EXTI->RTSR &= ~maskline;
|
|
}
|
|
|
|
/* Configure falling trigger */
|
|
/* Mask or set line */
|
|
if ((pExtiConfig->Trigger & EXTI_TRIGGER_FALLING) != 0x00u)
|
|
{
|
|
EXTI->FTSR |= maskline;
|
|
}
|
|
else
|
|
{
|
|
EXTI->FTSR &= ~maskline;
|
|
}
|
|
|
|
|
|
/* Configure gpio port selection in case of gpio exti line */
|
|
if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
|
|
{
|
|
assert_param(IS_EXTI_GPIO_PORT(pExtiConfig->GPIOSel));
|
|
assert_param(IS_EXTI_GPIO_PIN(linepos));
|
|
|
|
regval = SYSCFG->EXTICR[linepos >> 2u];
|
|
regval &= ~(SYSCFG_EXTICR1_EXTI0 << (SYSCFG_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
|
|
regval |= (pExtiConfig->GPIOSel << (SYSCFG_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
|
|
SYSCFG->EXTICR[linepos >> 2u] = regval;
|
|
}
|
|
}
|
|
|
|
/* Configure interrupt mode : read current mode */
|
|
/* Mask or set line */
|
|
if ((pExtiConfig->Mode & EXTI_MODE_INTERRUPT) != 0x00u)
|
|
{
|
|
EXTI->IMR |= maskline;
|
|
}
|
|
else
|
|
{
|
|
EXTI->IMR &= ~maskline;
|
|
}
|
|
|
|
/* Configure event mode : read current mode */
|
|
/* Mask or set line */
|
|
if ((pExtiConfig->Mode & EXTI_MODE_EVENT) != 0x00u)
|
|
{
|
|
EXTI->EMR |= maskline;
|
|
}
|
|
else
|
|
{
|
|
EXTI->EMR &= ~maskline;
|
|
}
|
|
|
|
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)
|
|
{
|
|
uint32_t regval;
|
|
uint32_t linepos;
|
|
uint32_t maskline;
|
|
|
|
/* 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;
|
|
|
|
/* Compute line mask */
|
|
linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
|
|
maskline = (1uL << linepos);
|
|
|
|
/* 1] Get core mode : interrupt */
|
|
|
|
/* Check if selected line is enable */
|
|
if ((EXTI->IMR & maskline) != 0x00u)
|
|
{
|
|
pExtiConfig->Mode = EXTI_MODE_INTERRUPT;
|
|
}
|
|
else
|
|
{
|
|
pExtiConfig->Mode = EXTI_MODE_NONE;
|
|
}
|
|
|
|
/* Get event mode */
|
|
/* Check if selected line is enable */
|
|
if ((EXTI->EMR & maskline) != 0x00u)
|
|
{
|
|
pExtiConfig->Mode |= EXTI_MODE_EVENT;
|
|
}
|
|
|
|
/* Get default Trigger and GPIOSel configuration */
|
|
pExtiConfig->Trigger = EXTI_TRIGGER_NONE;
|
|
pExtiConfig->GPIOSel = 0x00u;
|
|
|
|
/* 2] Get trigger for configurable lines : rising */
|
|
if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
|
|
{
|
|
/* Check if configuration of selected line is enable */
|
|
if ((EXTI->RTSR & maskline) != 0x00u)
|
|
{
|
|
pExtiConfig->Trigger = EXTI_TRIGGER_RISING;
|
|
}
|
|
|
|
/* Get falling configuration */
|
|
/* Check if configuration of selected line is enable */
|
|
if ((EXTI->FTSR & maskline) != 0x00u)
|
|
{
|
|
pExtiConfig->Trigger |= EXTI_TRIGGER_FALLING;
|
|
}
|
|
|
|
/* Get Gpio port selection for gpio lines */
|
|
if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
|
|
{
|
|
assert_param(IS_EXTI_GPIO_PIN(linepos));
|
|
|
|
regval = (SYSCFG->EXTICR[linepos >> 2u] << 16u );
|
|
pExtiConfig->GPIOSel = ((regval << (SYSCFG_EXTICR1_EXTI1_Pos * (3uL - (linepos & 0x03u)))) >> 28u);
|
|
}
|
|
}
|
|
|
|
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)
|
|
{
|
|
uint32_t regval;
|
|
uint32_t linepos;
|
|
uint32_t maskline;
|
|
|
|
/* Check null pointer */
|
|
if (hexti == NULL)
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
|
|
/* Check the parameter */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
|
|
/* compute line mask */
|
|
linepos = (hexti->Line & EXTI_PIN_MASK);
|
|
maskline = (1uL << linepos);
|
|
|
|
/* 1] Clear interrupt mode */
|
|
EXTI->IMR = (EXTI->IMR & ~maskline);
|
|
|
|
/* 2] Clear event mode */
|
|
EXTI->EMR = (EXTI->EMR & ~maskline);
|
|
|
|
/* 3] Clear triggers in case of configurable lines */
|
|
if ((hexti->Line & EXTI_CONFIG) != 0x00u)
|
|
{
|
|
EXTI->RTSR = (EXTI->RTSR & ~maskline);
|
|
EXTI->FTSR = (EXTI->FTSR & ~maskline);
|
|
|
|
/* Get Gpio port selection for gpio lines */
|
|
if ((hexti->Line & EXTI_GPIO) == EXTI_GPIO)
|
|
{
|
|
assert_param(IS_EXTI_GPIO_PIN(linepos));
|
|
|
|
regval = SYSCFG->EXTICR[linepos >> 2u];
|
|
regval &= ~(SYSCFG_EXTICR1_EXTI0 << (SYSCFG_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
|
|
SYSCFG->EXTICR[linepos >> 2u] = regval;
|
|
}
|
|
}
|
|
|
|
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->PendingCallback = 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)
|
|
{
|
|
uint32_t regval;
|
|
uint32_t maskline;
|
|
|
|
/* Compute line mask */
|
|
maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
|
|
|
|
/* Get pending bit */
|
|
regval = (EXTI->PR & maskline);
|
|
if (regval != 0x00u)
|
|
{
|
|
/* Clear pending bit */
|
|
EXTI->PR = maskline;
|
|
|
|
/* Call callback */
|
|
if (hexti->PendingCallback != NULL)
|
|
{
|
|
hexti->PendingCallback();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @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)
|
|
{
|
|
uint32_t regval;
|
|
uint32_t linepos;
|
|
uint32_t maskline;
|
|
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_PENDING_EDGE(Edge));
|
|
|
|
/* Compute line mask */
|
|
linepos = (hexti->Line & EXTI_PIN_MASK);
|
|
maskline = (1uL << linepos);
|
|
|
|
/* return 1 if bit is set else 0 */
|
|
regval = ((EXTI->PR & maskline) >> linepos);
|
|
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)
|
|
{
|
|
uint32_t maskline;
|
|
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_PENDING_EDGE(Edge));
|
|
|
|
/* Compute line mask */
|
|
maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
|
|
|
|
/* Clear Pending bit */
|
|
EXTI->PR = maskline;
|
|
}
|
|
|
|
/**
|
|
* @brief Generate a software interrupt for a dedicated line.
|
|
* @param hexti Exti handle.
|
|
* @retval None.
|
|
*/
|
|
void HAL_EXTI_GenerateSWI(EXTI_HandleTypeDef *hexti)
|
|
{
|
|
uint32_t maskline;
|
|
|
|
/* Check parameters */
|
|
assert_param(IS_EXTI_LINE(hexti->Line));
|
|
assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
|
|
|
|
/* Compute line mask */
|
|
maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
|
|
|
|
/* Generate Software interrupt */
|
|
EXTI->SWIER = maskline;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* HAL_EXTI_MODULE_ENABLED */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|