Subversion Repositories DashDisplay

/**

  ******************************************************************************

  * @file    stm32l1xx_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_ClearConfigLine().

        (++) 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_ClearPending().

    (#) Generate software interrupt using HAL_EXTI_GenerateSWI().

  @endverbatim

  */

/* Includes ------------------------------------------------------------------*/

#include "stm32l1xx_hal.h"

/** @addtogroup STM32L1xx_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];

      pExtiConfig->GPIOSel = (regval >> (SYSCFG_EXTICR1_EXTI1_Pos * (linepos & 0x03u))) & SYSCFG_EXTICR1_EXTI0;

    }

  }

  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 */

/**

  * @}

  */

/**

  * @}

  */