WebSVN – canSerial – Diff – /trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_exti.c

 /**
   ******************************************************************************
   * @file    stm32f1xx_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
+  ******************************************************************************
-  ==============================================================================
+  * @attention
-                    ##### EXTI Peripheral features #####
+  *
-  ==============================================================================
+  * Copyright (c) 2019 STMicroelectronics.
-  [..]
+  * All rights reserved.
-    (+) Each Exti line can be configured within this driver.
+  *
+  * This software is licensed under terms that can be found in the LICENSE file
-    (+) Exti line can be configured in 3 different modes
+  * in the root directory of this software component.
-        (++) Interrupt
+  * If no LICENSE file comes with this software, it is provided AS-IS.
-        (++) Event
+  *
-        (++) Both of them
+  ******************************************************************************
+  @verbatim
-    (+) Configurable Exti lines can be configured with 3 different triggers
+  ==============================================================================
-        (++) Rising
+                    ##### EXTI Peripheral features #####
-        (++) Falling
+  ==============================================================================
-        (++) Both of them
+  [..]
+    (+) Each Exti line can be configured within this driver.
-    (+) When set in interrupt mode, configurable Exti lines have two different
-        interrupts pending registers which allow to distinguish which transition
+    (+) Exti line can be configured in 3 different modes
-        occurs:
+        (++) Interrupt
-        (++) Rising edge pending interrupt
+        (++) Event
-        (++) Falling
+        (++) Both of them
-    (+) Exti lines 0 to 15 are linked to gpio pin number 0 to 15. Gpio port can
+    (+) Configurable Exti lines can be configured with 3 different triggers
-        be selected through multiplexer.
+        (++) Rising
+        (++) Falling
-                     ##### How to use this driver #####
+        (++) Both of them
-  ==============================================================================
-  [..]
+    (+) When set in interrupt mode, configurable Exti lines have two different
+        interrupts pending registers which allow to distinguish which transition
-    (#) Configure the EXTI line using HAL_EXTI_SetConfigLine().
+        occurs:
-        (++) Choose the interrupt line number by setting "Line" member from
+        (++) Rising edge pending interrupt
-             EXTI_ConfigTypeDef structure.
+        (++) Falling
-        (++) Configure the interrupt and/or event mode using "Mode" member from
-             EXTI_ConfigTypeDef structure.
+    (+) Exti lines 0 to 15 are linked to gpio pin number 0 to 15. Gpio port can
-        (++) For configurable lines, configure rising and/or falling trigger
+        be selected through multiplexer.
-             "Trigger" member from EXTI_ConfigTypeDef structure.
-        (++) For Exti lines linked to gpio, choose gpio port using "GPIOSel"
+                     ##### How to use this driver #####
-             member from GPIO_InitTypeDef structure.
+  ==============================================================================
+  [..]
-    (#) Get current Exti configuration of a dedicated line using
-        HAL_EXTI_GetConfigLine().
+    (#) Configure the EXTI line using HAL_EXTI_SetConfigLine().
-        (++) Provide exiting handle as parameter.
+        (++) Choose the interrupt line number by setting "Line" member from
-        (++) Provide pointer on EXTI_ConfigTypeDef structure as second parameter.
+             EXTI_ConfigTypeDef structure.
+        (++) Configure the interrupt and/or event mode using "Mode" member from
-    (#) Clear Exti configuration of a dedicated line using HAL_EXTI_GetConfigLine().
+             EXTI_ConfigTypeDef structure.
-        (++) Provide exiting handle as parameter.
+        (++) For configurable lines, configure rising and/or falling trigger
+             "Trigger" member from EXTI_ConfigTypeDef structure.
-    (#) Register callback to treat Exti interrupts using HAL_EXTI_RegisterCallback().
+        (++) For Exti lines linked to gpio, choose gpio port using "GPIOSel"
-        (++) Provide exiting handle as first parameter.
+             member from GPIO_InitTypeDef structure.
-        (++) Provide which callback will be registered using one value from
-             EXTI_CallbackIDTypeDef.
+    (#) Get current Exti configuration of a dedicated line using
-        (++) Provide callback function pointer.
+        HAL_EXTI_GetConfigLine().
+        (++) Provide exiting handle as parameter.
-    (#) Get interrupt pending bit using HAL_EXTI_GetPending().
+        (++) Provide pointer on EXTI_ConfigTypeDef structure as second parameter.
-    (#) Clear interrupt pending bit using HAL_EXTI_GetPending().
+    (#) Clear Exti configuration of a dedicated line using HAL_EXTI_ClearConfigLine().
+        (++) Provide exiting handle as parameter.
-    (#) Generate software interrupt using HAL_EXTI_GenerateSWI().
+    (#) Register callback to treat Exti interrupts using HAL_EXTI_RegisterCallback().
-  @endverbatim
+        (++) Provide exiting handle as first parameter.
-  ******************************************************************************
+        (++) Provide which callback will be registered using one value from
-  * @attention
+             EXTI_CallbackIDTypeDef.
-  *
+        (++) Provide callback function pointer.
-  * <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
-  * All rights reserved.</center></h2>
+    (#) Get interrupt pending bit using HAL_EXTI_GetPending().
-  *
-  * This software component is licensed by ST under BSD 3-Clause license,
+    (#) Clear interrupt pending bit using HAL_EXTI_ClearPending().
-  * the "License"; You may not use this file except in compliance with the
-  * License. You may obtain a copy of the License at:
+    (#) Generate software interrupt using HAL_EXTI_GenerateSWI().
-  *                        opensource.org/licenses/BSD-3-Clause
-  *
+  @endverbatim
-  ******************************************************************************
+  */
-  */
+/* Includes ------------------------------------------------------------------*/
-/* Includes ------------------------------------------------------------------*/
+#include "stm32f1xx_hal.h"
-#include "stm32f1xx_hal.h"
+/** @addtogroup STM32F1xx_HAL_Driver
-/** @addtogroup STM32F1xx_HAL_Driver
+  * @{
-  * @{
+  */
-  */
+/** @addtogroup EXTI
-/** @addtogroup EXTI
+  * @{
-  * @{
+  */
-  */
+/** MISRA C:2012 deviation rule has been granted for following rule:
-/** 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
-  * Rule-18.1_b - Medium: Array `EXTICR' 1st subscript interval [0,7] may be out
+  * of bounds [0,3] in following API :
-  * of bounds [0,3] in following API :
+  * HAL_EXTI_SetConfigLine
-  * HAL_EXTI_SetConfigLine
+  * HAL_EXTI_GetConfigLine
-  * HAL_EXTI_GetConfigLine
+  * HAL_EXTI_ClearConfigLine
-  * HAL_EXTI_ClearConfigLine
+  */
-  */
+#ifdef HAL_EXTI_MODULE_ENABLED
-#ifdef HAL_EXTI_MODULE_ENABLED
+/* Private typedef -----------------------------------------------------------*/
-/* Private typedef -----------------------------------------------------------*/
+/* Private defines -----------------------------------------------------------*/
-/* Private defines -----------------------------------------------------------*/
+/** @defgroup EXTI_Private_Constants EXTI Private Constants
-/** @defgroup EXTI_Private_Constants EXTI Private Constants
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/* Private macros ------------------------------------------------------------*/
-/* Private macros ------------------------------------------------------------*/
+/* Private variables ---------------------------------------------------------*/
-/* Private variables ---------------------------------------------------------*/
+/* Private function prototypes -----------------------------------------------*/
-/* Private function prototypes -----------------------------------------------*/
+/* Exported functions --------------------------------------------------------*/
-/* Exported functions --------------------------------------------------------*/
+/** @addtogroup EXTI_Exported_Functions
-/** @addtogroup EXTI_Exported_Functions
+  * @{
-  * @{
+  */
-  */
+/** @addtogroup EXTI_Exported_Functions_Group1
-/** @addtogroup EXTI_Exported_Functions_Group1
+  *  @brief    Configuration functions
-  *  @brief    Configuration functions
+  *
-  *
+@verbatim
-@verbatim
+ ===============================================================================
- ===============================================================================
+              ##### Configuration functions #####
-              ##### Configuration functions #####
+ ===============================================================================
- ===============================================================================
+@endverbatim
-@endverbatim
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @brief  Set configuration of a dedicated Exti line.
-  * @brief  Set configuration of a dedicated Exti line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  pExtiConfig Pointer on EXTI configuration to be set.
-  * @param  pExtiConfig Pointer on EXTI configuration to be set.
+  * @retval HAL Status.
-  * @retval HAL Status.
+  */
-  */
+HAL_StatusTypeDef HAL_EXTI_SetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
-HAL_StatusTypeDef HAL_EXTI_SetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
+{
-{
+  uint32_t regval;
-  uint32_t regval;
+  uint32_t linepos;
-  uint32_t linepos;
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Check null pointer */
-  /* Check null pointer */
+  if ((hexti == NULL) || (pExtiConfig == NULL))
-  if ((hexti == NULL) || (pExtiConfig == NULL))
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Check parameters */
-  /* Check parameters */
+  assert_param(IS_EXTI_LINE(pExtiConfig->Line));
-  assert_param(IS_EXTI_LINE(pExtiConfig->Line));
+  assert_param(IS_EXTI_MODE(pExtiConfig->Mode));
-  assert_param(IS_EXTI_MODE(pExtiConfig->Mode));
+  /* Assign line number to handle */
-  /* Assign line number to handle */
+  hexti->Line = pExtiConfig->Line;
-  hexti->Line = pExtiConfig->Line;
+  /* Compute line mask */
-  /* Compute line mask */
+  linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
-  linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
+  maskline = (1uL << linepos);
-  maskline = (1uL << linepos);
+  /* Configure triggers for configurable lines */
-  /* Configure triggers for configurable lines */
+  if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
-  if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
+  {
-  {
+    assert_param(IS_EXTI_TRIGGER(pExtiConfig->Trigger));
-    assert_param(IS_EXTI_TRIGGER(pExtiConfig->Trigger));
+    /* Configure rising trigger */
-    /* Configure rising trigger */
+    /* Mask or set line */
-    /* Mask or set line */
+    if ((pExtiConfig->Trigger & EXTI_TRIGGER_RISING) != 0x00u)
-    if ((pExtiConfig->Trigger & EXTI_TRIGGER_RISING) != 0x00u)
+    {
-    {
+      EXTI->RTSR |= maskline;
-      EXTI->RTSR |= maskline;
+    }
-    }
+    else
-    else
+    {
-    {
+      EXTI->RTSR &= ~maskline;
-      EXTI->RTSR &= ~maskline;
+    }
-    }
+    /* Configure falling trigger */
-    /* Configure falling trigger */
+    /* Mask or set line */
-    /* Mask or set line */
+    if ((pExtiConfig->Trigger & EXTI_TRIGGER_FALLING) != 0x00u)
-    if ((pExtiConfig->Trigger & EXTI_TRIGGER_FALLING) != 0x00u)
+    {
-    {
+      EXTI->FTSR |= maskline;
-      EXTI->FTSR |= maskline;
+    }
-    }
+    else
-    else
+    {
-    {
+      EXTI->FTSR &= ~maskline;
-      EXTI->FTSR &= ~maskline;
+    }
-    }
+    /* Configure gpio port selection in case of gpio exti line */
-    /* Configure gpio port selection in case of gpio exti line */
+    if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
-    if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
+    {
-    {
+      assert_param(IS_EXTI_GPIO_PORT(pExtiConfig->GPIOSel));
-      assert_param(IS_EXTI_GPIO_PORT(pExtiConfig->GPIOSel));
+      assert_param(IS_EXTI_GPIO_PIN(linepos));
-      assert_param(IS_EXTI_GPIO_PIN(linepos));
+      regval = AFIO->EXTICR[linepos >> 2u];
-      regval = AFIO->EXTICR[linepos >> 2u];
+      regval &= ~(AFIO_EXTICR1_EXTI0 << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
-      regval &= ~(AFIO_EXTICR1_EXTI0 << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
+      regval |= (pExtiConfig->GPIOSel << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
-      regval |= (pExtiConfig->GPIOSel << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
+      AFIO->EXTICR[linepos >> 2u] = regval;
-      AFIO->EXTICR[linepos >> 2u] = regval;
+    }
-    }
+  }
-  }
+  /* Configure interrupt mode : read current mode */
-  /* Configure interrupt mode : read current mode */
+  /* Mask or set line */
-  /* Mask or set line */
+  if ((pExtiConfig->Mode & EXTI_MODE_INTERRUPT) != 0x00u)
-  if ((pExtiConfig->Mode & EXTI_MODE_INTERRUPT) != 0x00u)
+  {
-  {
+    EXTI->IMR |= maskline;
-    EXTI->IMR |= maskline;
+  }
-  }
+  else
-  else
+  {
-  {
+    EXTI->IMR &= ~maskline;
-    EXTI->IMR &= ~maskline;
+  }
-  }
+  /* Configure event mode : read current mode */
-  /* Configure event mode : read current mode */
+  /* Mask or set line */
-  /* Mask or set line */
+  if ((pExtiConfig->Mode & EXTI_MODE_EVENT) != 0x00u)
-  if ((pExtiConfig->Mode & EXTI_MODE_EVENT) != 0x00u)
+  {
-  {
+    EXTI->EMR |= maskline;
-    EXTI->EMR |= maskline;
+  }
-  }
+  else
-  else
+  {
-  {
+    EXTI->EMR &= ~maskline;
-    EXTI->EMR &= ~maskline;
+  }
-  }
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Get configuration of a dedicated Exti line.
-  * @brief  Get configuration of a dedicated Exti line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  pExtiConfig Pointer on structure to store Exti configuration.
-  * @param  pExtiConfig Pointer on structure to store Exti configuration.
+  * @retval HAL Status.
-  * @retval HAL Status.
+  */
-  */
+HAL_StatusTypeDef HAL_EXTI_GetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
-HAL_StatusTypeDef HAL_EXTI_GetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig)
+{
-{
+  uint32_t regval;
-  uint32_t regval;
+  uint32_t linepos;
-  uint32_t linepos;
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Check null pointer */
-  /* Check null pointer */
+  if ((hexti == NULL) || (pExtiConfig == NULL))
-  if ((hexti == NULL) || (pExtiConfig == NULL))
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Check the parameter */
-  /* Check the parameter */
+  assert_param(IS_EXTI_LINE(hexti->Line));
-  assert_param(IS_EXTI_LINE(hexti->Line));
+  /* Store handle line number to configuration structure */
-  /* Store handle line number to configuration structure */
+  pExtiConfig->Line = hexti->Line;
-  pExtiConfig->Line = hexti->Line;
+  /* Compute line mask */
-  /* Compute line mask */
+  linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
-  linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
+  maskline = (1uL << linepos);
-  maskline = (1uL << linepos);
+  /* 1] Get core mode : interrupt */
-  /* 1] Get core mode : interrupt */
+  /* Check if selected line is enable */
-  /* Check if selected line is enable */
+  if ((EXTI->IMR & maskline) != 0x00u)
-  if ((EXTI->IMR & maskline) != 0x00u)
+  {
-  {
+    pExtiConfig->Mode = EXTI_MODE_INTERRUPT;
-    pExtiConfig->Mode = EXTI_MODE_INTERRUPT;
+  }
-  }
+  else
-  else
+  {
-  {
+    pExtiConfig->Mode = EXTI_MODE_NONE;
-    pExtiConfig->Mode = EXTI_MODE_NONE;
+  }
-  }
+  /* Get event mode */
-  /* Get event mode */
+  /* Check if selected line is enable */
-  /* Check if selected line is enable */
+  if ((EXTI->EMR & maskline) != 0x00u)
-  if ((EXTI->EMR & maskline) != 0x00u)
+  {
-  {
+    pExtiConfig->Mode |= EXTI_MODE_EVENT;
-    pExtiConfig->Mode |= EXTI_MODE_EVENT;
+  }
-  }
+  /* Get default Trigger and GPIOSel configuration */
-  /* Get default Trigger and GPIOSel configuration */
+  pExtiConfig->Trigger = EXTI_TRIGGER_NONE;
-  pExtiConfig->Trigger = EXTI_TRIGGER_NONE;
+  pExtiConfig->GPIOSel = 0x00u;
-  pExtiConfig->GPIOSel = 0x00u;
+  /* 2] Get trigger for configurable lines : rising */
-  /* 2] Get trigger for configurable lines : rising */
+  if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
-  if ((pExtiConfig->Line & EXTI_CONFIG) != 0x00u)
+  {
-  {
+    /* Check if configuration of selected line is enable */
-    /* Check if configuration of selected line is enable */
+    if ((EXTI->RTSR & maskline) != 0x00u)
-    if ((EXTI->RTSR & maskline) != 0x00u)
+    {
-    {
+      pExtiConfig->Trigger = EXTI_TRIGGER_RISING;
-      pExtiConfig->Trigger = EXTI_TRIGGER_RISING;
+    }
-    }
+    /* Get falling configuration */
-    /* Get falling configuration */
+    /* Check if configuration of selected line is enable */
-    /* Check if configuration of selected line is enable */
+    if ((EXTI->FTSR & maskline) != 0x00u)
-    if ((EXTI->FTSR & maskline) != 0x00u)
+    {
-    {
+      pExtiConfig->Trigger |= EXTI_TRIGGER_FALLING;
-      pExtiConfig->Trigger |= EXTI_TRIGGER_FALLING;
+    }
-    }
+    /* Get Gpio port selection for gpio lines */
-    /* Get Gpio port selection for gpio lines */
+    if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
-    if ((pExtiConfig->Line & EXTI_GPIO) == EXTI_GPIO)
+    {
-    {
+      assert_param(IS_EXTI_GPIO_PIN(linepos));
-      assert_param(IS_EXTI_GPIO_PIN(linepos));
+      regval = AFIO->EXTICR[linepos >> 2u];
-      regval = AFIO->EXTICR[linepos >> 2u];
+      pExtiConfig->GPIOSel = (regval >> (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u))) & AFIO_EXTICR1_EXTI0;
-      pExtiConfig->GPIOSel = ((regval << (AFIO_EXTICR1_EXTI1_Pos * (3uL - (linepos & 0x03u)))) >> 24);
+    }
-    }
+  }
-  }
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Clear whole configuration of a dedicated Exti line.
-  * @brief  Clear whole configuration of a dedicated Exti line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @retval HAL Status.
-  * @retval HAL Status.
+  */
-  */
+HAL_StatusTypeDef HAL_EXTI_ClearConfigLine(EXTI_HandleTypeDef *hexti)
-HAL_StatusTypeDef HAL_EXTI_ClearConfigLine(EXTI_HandleTypeDef *hexti)
+{
-{
+  uint32_t regval;
-  uint32_t regval;
+  uint32_t linepos;
-  uint32_t linepos;
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Check null pointer */
-  /* Check null pointer */
+  if (hexti == NULL)
-  if (hexti == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  /* Check the parameter */
-  /* Check the parameter */
+  assert_param(IS_EXTI_LINE(hexti->Line));
-  assert_param(IS_EXTI_LINE(hexti->Line));
+  /* compute line mask */
-  /* compute line mask */
+  linepos = (hexti->Line & EXTI_PIN_MASK);
-  linepos = (hexti->Line & EXTI_PIN_MASK);
+  maskline = (1uL << linepos);
-  maskline = (1uL << linepos);
+  /* 1] Clear interrupt mode */
-  /* 1] Clear interrupt mode */
+  EXTI->IMR = (EXTI->IMR & ~maskline);
-  EXTI->IMR = (EXTI->IMR & ~maskline);
+  /* 2] Clear event mode */
-  /* 2] Clear event mode */
+  EXTI->EMR = (EXTI->EMR & ~maskline);
-  EXTI->EMR = (EXTI->EMR & ~maskline);
+  /* 3] Clear triggers in case of configurable lines */
-  /* 3] Clear triggers in case of configurable lines */
+  if ((hexti->Line & EXTI_CONFIG) != 0x00u)
-  if ((hexti->Line & EXTI_CONFIG) != 0x00u)
+  {
-  {
+    EXTI->RTSR = (EXTI->RTSR & ~maskline);
-    EXTI->RTSR = (EXTI->RTSR & ~maskline);
+    EXTI->FTSR = (EXTI->FTSR & ~maskline);
-    EXTI->FTSR = (EXTI->FTSR & ~maskline);
+    /* Get Gpio port selection for gpio lines */
-    /* Get Gpio port selection for gpio lines */
+    if ((hexti->Line & EXTI_GPIO) == EXTI_GPIO)
-    if ((hexti->Line & EXTI_GPIO) == EXTI_GPIO)
+    {
-    {
+      assert_param(IS_EXTI_GPIO_PIN(linepos));
-      assert_param(IS_EXTI_GPIO_PIN(linepos));
+      regval = AFIO->EXTICR[linepos >> 2u];
-      regval = AFIO->EXTICR[linepos >> 2u];
+      regval &= ~(AFIO_EXTICR1_EXTI0 << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
-      regval &= ~(AFIO_EXTICR1_EXTI0 << (AFIO_EXTICR1_EXTI1_Pos * (linepos & 0x03u)));
+      AFIO->EXTICR[linepos >> 2u] = regval;
-      AFIO->EXTICR[linepos >> 2u] = regval;
+    }
-    }
+  }
-  }
+  return HAL_OK;
-  return HAL_OK;
+}
-}
+/**
-/**
+  * @brief  Register callback for a dedicated Exti line.
-  * @brief  Register callback for a dedicated Exti line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  CallbackID User callback identifier.
-  * @param  CallbackID User callback identifier.
+  *         This parameter can be one of @arg @ref EXTI_CallbackIDTypeDef values.
-  *         This parameter can be one of @arg @ref EXTI_CallbackIDTypeDef values.
+  * @param  pPendingCbfn function pointer to be stored as callback.
-  * @param  pPendingCbfn function pointer to be stored as callback.
+  * @retval HAL Status.
-  * @retval HAL Status.
+  */
-  */
+HAL_StatusTypeDef HAL_EXTI_RegisterCallback(EXTI_HandleTypeDef *hexti, EXTI_CallbackIDTypeDef CallbackID, void (*pPendingCbfn)(void))
-HAL_StatusTypeDef HAL_EXTI_RegisterCallback(EXTI_HandleTypeDef *hexti, EXTI_CallbackIDTypeDef CallbackID, void (*pPendingCbfn)(void))
+{
-{
+  HAL_StatusTypeDef status = HAL_OK;
-  HAL_StatusTypeDef status = HAL_OK;
+  switch (CallbackID)
-  switch (CallbackID)
+  {
-  {
+    case  HAL_EXTI_COMMON_CB_ID:
-    case  HAL_EXTI_COMMON_CB_ID:
+      hexti->PendingCallback = pPendingCbfn;
-      hexti->PendingCallback = pPendingCbfn;
+      break;
-      break;
+    default:
-    default:
+      status = HAL_ERROR;
-      status = HAL_ERROR;
+      break;
-      break;
+  }
-  }
+  return status;
-  return status;
+}
-}
+/**
-/**
+  * @brief  Store line number as handle private field.
-  * @brief  Store line number as handle private field.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  ExtiLine Exti line number.
-  * @param  ExtiLine Exti line number.
+  *         This parameter can be from 0 to @ref EXTI_LINE_NB.
-  *         This parameter can be from 0 to @ref EXTI_LINE_NB.
+  * @retval HAL Status.
-  * @retval HAL Status.
+  */
-  */
+HAL_StatusTypeDef HAL_EXTI_GetHandle(EXTI_HandleTypeDef *hexti, uint32_t ExtiLine)
-HAL_StatusTypeDef HAL_EXTI_GetHandle(EXTI_HandleTypeDef *hexti, uint32_t ExtiLine)
+{
-{
+  /* Check the parameters */
-  /* Check the parameters */
+  assert_param(IS_EXTI_LINE(ExtiLine));
-  assert_param(IS_EXTI_LINE(ExtiLine));
+  /* Check null pointer */
-  /* Check null pointer */
+  if (hexti == NULL)
-  if (hexti == NULL)
+  {
-  {
+    return HAL_ERROR;
-    return HAL_ERROR;
+  }
-  }
+  else
-  else
+  {
-  {
+    /* Store line number as handle private field */
-    /* Store line number as handle private field */
+    hexti->Line = ExtiLine;
-    hexti->Line = ExtiLine;
+    return HAL_OK;
-    return HAL_OK;
+  }
-  }
+}
-}
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/** @addtogroup EXTI_Exported_Functions_Group2
-/** @addtogroup EXTI_Exported_Functions_Group2
+  *  @brief EXTI IO functions.
-  *  @brief EXTI IO functions.
+  *
-  *
+@verbatim
-@verbatim
+ ===============================================================================
- ===============================================================================
+                       ##### IO operation functions #####
-                       ##### IO operation functions #####
+ ===============================================================================
- ===============================================================================
+@endverbatim
-@endverbatim
+  * @{
-  * @{
+  */
-  */
+/**
-/**
+  * @brief  Handle EXTI interrupt request.
-  * @brief  Handle EXTI interrupt request.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @retval none.
-  * @retval none.
+  */
-  */
+void HAL_EXTI_IRQHandler(EXTI_HandleTypeDef *hexti)
-void HAL_EXTI_IRQHandler(EXTI_HandleTypeDef *hexti)
+{
-{
+  uint32_t regval;
-  uint32_t regval;
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Compute line mask */
-  /* Compute line mask */
+  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
-  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
+  /* Get pending bit  */
-  /* Get pending bit  */
+  regval = (EXTI->PR & maskline);
-  regval = (EXTI->PR & maskline);
+  if (regval != 0x00u)
-  if (regval != 0x00u)
+  {
-  {
+    /* Clear pending bit */
-    /* Clear pending bit */
+    EXTI->PR = maskline;
-    EXTI->PR = maskline;
+    /* Call callback */
-    /* Call callback */
+    if (hexti->PendingCallback != NULL)
-    if (hexti->PendingCallback != NULL)
+    {
-    {
+      hexti->PendingCallback();
-      hexti->PendingCallback();
+    }
-    }
+  }
-  }
+}
-}
+/**
-/**
+  * @brief  Get interrupt pending bit of a dedicated line.
-  * @brief  Get interrupt pending bit of a dedicated line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  Edge Specify which pending edge as to be checked.
-  * @param  Edge Specify which pending edge as to be checked.
+  *         This parameter can be one of the following values:
-  *         This parameter can be one of the following values:
+  *           @arg @ref EXTI_TRIGGER_RISING_FALLING
-  *           @arg @ref EXTI_TRIGGER_RISING_FALLING
+  *         This parameter is kept for compatibility with other series.
-  *         This parameter is kept for compatibility with other series.
+  * @retval 1 if interrupt is pending else 0.
-  * @retval 1 if interrupt is pending else 0.
+  */
-  */
+uint32_t HAL_EXTI_GetPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
-uint32_t HAL_EXTI_GetPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
+{
-{
+  uint32_t regval;
-  uint32_t regval;
+  uint32_t maskline;
-  uint32_t maskline;
+  uint32_t linepos;
-  uint32_t linepos;
+  /* Check parameters */
-  /* Check parameters */
+  assert_param(IS_EXTI_LINE(hexti->Line));
-  assert_param(IS_EXTI_LINE(hexti->Line));
+  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
-  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
+  assert_param(IS_EXTI_PENDING_EDGE(Edge));
-  assert_param(IS_EXTI_PENDING_EDGE(Edge));
+  /* Prevent unused argument compilation warning */
-  /* Prevent unused argument compilation warning */
+  UNUSED(Edge);
-  UNUSED(Edge);
+  /* Compute line mask */
-  /* Compute line mask */
+  linepos = (hexti->Line & EXTI_PIN_MASK);
-  linepos = (hexti->Line & EXTI_PIN_MASK);
+  maskline = (1uL << linepos);
-  maskline = (1uL << linepos);
+  /* return 1 if bit is set else 0 */
-  /* return 1 if bit is set else 0 */
+  regval = ((EXTI->PR & maskline) >> linepos);
-  regval = ((EXTI->PR & maskline) >> linepos);
+  return regval;
-  return regval;
+}
-}
+/**
-/**
+  * @brief  Clear interrupt pending bit of a dedicated line.
-  * @brief  Clear interrupt pending bit of a dedicated line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @param  Edge Specify which pending edge as to be clear.
-  * @param  Edge Specify which pending edge as to be clear.
+  *         This parameter can be one of the following values:
-  *         This parameter can be one of the following values:
+  *           @arg @ref EXTI_TRIGGER_RISING_FALLING
-  *           @arg @ref EXTI_TRIGGER_RISING_FALLING
+  *         This parameter is kept for compatibility with other series.
-  *         This parameter is kept for compatibility with other series.
+  * @retval None.
-  * @retval None.
+  */
-  */
+void HAL_EXTI_ClearPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
-void HAL_EXTI_ClearPending(EXTI_HandleTypeDef *hexti, uint32_t Edge)
+{
-{
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Check parameters */
-  /* Check parameters */
+  assert_param(IS_EXTI_LINE(hexti->Line));
-  assert_param(IS_EXTI_LINE(hexti->Line));
+  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
-  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
+  assert_param(IS_EXTI_PENDING_EDGE(Edge));
-  assert_param(IS_EXTI_PENDING_EDGE(Edge));
+  /* Prevent unused argument compilation warning */
-  /* Prevent unused argument compilation warning */
+  UNUSED(Edge);
-  UNUSED(Edge);
+  /* Compute line mask */
-  /* Compute line mask */
+  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
-  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
+  /* Clear Pending bit */
-  /* Clear Pending bit */
+  EXTI->PR =  maskline;
-  EXTI->PR =  maskline;
+}
-}
+/**
-/**
+  * @brief  Generate a software interrupt for a dedicated line.
-  * @brief  Generate a software interrupt for a dedicated line.
+  * @param  hexti Exti handle.
-  * @param  hexti Exti handle.
+  * @retval None.
-  * @retval None.
+  */
-  */
+void HAL_EXTI_GenerateSWI(EXTI_HandleTypeDef *hexti)
-void HAL_EXTI_GenerateSWI(EXTI_HandleTypeDef *hexti)
+{
-{
+  uint32_t maskline;
-  uint32_t maskline;
+  /* Check parameters */
-  /* Check parameters */
+  assert_param(IS_EXTI_LINE(hexti->Line));
-  assert_param(IS_EXTI_LINE(hexti->Line));
+  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
-  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
+  /* Compute line mask */
-  /* Compute line mask */
+  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
-  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
+  /* Generate Software interrupt */
-  /* Generate Software interrupt */
+  EXTI->SWIER = maskline;
-  EXTI->SWIER = maskline;
+}
-}
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+#endif /* HAL_EXTI_MODULE_ENABLED */
-#endif /* HAL_EXTI_MODULE_ENABLED */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
+/**
-/**
+  * @}
-  * @}
+  */
-  */
-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Subversion Repositories canSerial

(root)/trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_exti.c – Rev 2 → 3