init
This commit is contained in:
		
				commit
				
					
						1f4170c292
					
				
			
		
					 100 changed files with 125459 additions and 0 deletions
				
			
		
							
								
								
									
										765
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										765
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,765 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   HAL module driver.
 | 
			
		||||
  *          This is the common part of the HAL initialization
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                     ##### How to use this driver #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    The common HAL driver contains a set of generic and common APIs that can be
 | 
			
		||||
    used by the PPP peripheral drivers and the user to start using the HAL.
 | 
			
		||||
    [..]
 | 
			
		||||
    The HAL contains two APIs' categories:
 | 
			
		||||
         (+) Common HAL APIs
 | 
			
		||||
         (+) Services HAL APIs
 | 
			
		||||
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL HAL
 | 
			
		||||
  * @brief HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private define ------------------------------------------------------------*/
 | 
			
		||||
/**
 | 
			
		||||
 * @brief STM32L4xx HAL Driver version number
 | 
			
		||||
   */
 | 
			
		||||
#define STM32L4XX_HAL_VERSION_MAIN   (0x01U) /*!< [31:24] main version */
 | 
			
		||||
#define STM32L4XX_HAL_VERSION_SUB1   (0x0DU) /*!< [23:16] sub1 version */
 | 
			
		||||
#define STM32L4XX_HAL_VERSION_SUB2   (0x05U) /*!< [15:8]  sub2 version */
 | 
			
		||||
#define STM32L4XX_HAL_VERSION_RC     (0x00U) /*!< [7:0]  release candidate */
 | 
			
		||||
#define STM32L4XX_HAL_VERSION        ((STM32L4XX_HAL_VERSION_MAIN  << 24U)\
 | 
			
		||||
                                      |(STM32L4XX_HAL_VERSION_SUB1 << 16U)\
 | 
			
		||||
                                      |(STM32L4XX_HAL_VERSION_SUB2 << 8U)\
 | 
			
		||||
                                      |(STM32L4XX_HAL_VERSION_RC))
 | 
			
		||||
 | 
			
		||||
#if defined(VREFBUF)
 | 
			
		||||
#define VREFBUF_TIMEOUT_VALUE     10U   /* 10 ms (to be confirmed) */
 | 
			
		||||
#endif /* VREFBUF */
 | 
			
		||||
 | 
			
		||||
/* ------------ SYSCFG registers bit address in the alias region ------------ */
 | 
			
		||||
#define SYSCFG_OFFSET             (SYSCFG_BASE - PERIPH_BASE)
 | 
			
		||||
/* ---  MEMRMP Register ---*/
 | 
			
		||||
/* Alias word address of FB_MODE bit */
 | 
			
		||||
#define MEMRMP_OFFSET             SYSCFG_OFFSET
 | 
			
		||||
#define FB_MODE_BitNumber         8U
 | 
			
		||||
#define FB_MODE_BB                (PERIPH_BB_BASE + (MEMRMP_OFFSET * 32U) + (FB_MODE_BitNumber * 4U))
 | 
			
		||||
 | 
			
		||||
/* --- SCSR Register ---*/
 | 
			
		||||
/* Alias word address of SRAM2ER bit */
 | 
			
		||||
#define SCSR_OFFSET               (SYSCFG_OFFSET + 0x18U)
 | 
			
		||||
#define BRER_BitNumber            0U
 | 
			
		||||
#define SCSR_SRAM2ER_BB           (PERIPH_BB_BASE + (SCSR_OFFSET * 32U) + (BRER_BitNumber * 4U))
 | 
			
		||||
 | 
			
		||||
/* Private macro -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/* Exported variables --------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Variables HAL Exported Variables
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
__IO uint32_t uwTick;
 | 
			
		||||
uint32_t uwTickPrio = (1UL << __NVIC_PRIO_BITS); /* Invalid priority */
 | 
			
		||||
HAL_TickFreqTypeDef uwTickFreq = HAL_TICK_FREQ_DEFAULT;  /* 1KHz */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Exported functions --------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Functions HAL Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Functions_Group1 Initialization and de-initialization Functions
 | 
			
		||||
 *  @brief    Initialization and de-initialization functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
              ##### Initialization and de-initialization functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]  This section provides functions allowing to:
 | 
			
		||||
      (+) Initialize the Flash interface, the NVIC allocation and initial time base
 | 
			
		||||
          clock configuration.
 | 
			
		||||
      (+) De-initialize common part of the HAL.
 | 
			
		||||
      (+) Configure the time base source to have 1ms time base with a dedicated
 | 
			
		||||
          Tick interrupt priority.
 | 
			
		||||
        (++) SysTick timer is used by default as source of time base, but user
 | 
			
		||||
             can eventually implement his proper time base source (a general purpose
 | 
			
		||||
             timer for example or other time source), keeping in mind that Time base
 | 
			
		||||
             duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
 | 
			
		||||
             handled in milliseconds basis.
 | 
			
		||||
        (++) Time base configuration function (HAL_InitTick ()) is called automatically
 | 
			
		||||
             at the beginning of the program after reset by HAL_Init() or at any time
 | 
			
		||||
             when clock is configured, by HAL_RCC_ClockConfig().
 | 
			
		||||
        (++) Source of time base is configured  to generate interrupts at regular
 | 
			
		||||
             time intervals. Care must be taken if HAL_Delay() is called from a
 | 
			
		||||
             peripheral ISR process, the Tick interrupt line must have higher priority
 | 
			
		||||
            (numerically lower) than the peripheral interrupt. Otherwise the caller
 | 
			
		||||
            ISR process will be blocked.
 | 
			
		||||
       (++) functions affecting time base configurations are declared as __weak
 | 
			
		||||
             to make  override possible  in case of other  implementations in user file.
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure the Flash prefetch, the Instruction and Data caches,
 | 
			
		||||
  *         the time base source, NVIC and any required global low level hardware
 | 
			
		||||
  *         by calling the HAL_MspInit() callback function to be optionally defined in user file
 | 
			
		||||
  *         stm32l4xx_hal_msp.c.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   HAL_Init() function is called at the beginning of program after reset and before
 | 
			
		||||
  *         the clock configuration.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   In the default implementation the System Timer (Systick) is used as source of time base.
 | 
			
		||||
  *         The Systick configuration is based on MSI clock, as MSI is the clock
 | 
			
		||||
  *         used after a system Reset and the NVIC configuration is set to Priority group 4.
 | 
			
		||||
  *         Once done, time base tick starts incrementing: the tick variable counter is incremented
 | 
			
		||||
  *         each 1ms in the SysTick_Handler() interrupt handler.
 | 
			
		||||
  *
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_Init(void)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef  status = HAL_OK;
 | 
			
		||||
 | 
			
		||||
  /* Configure Flash prefetch, Instruction cache, Data cache */
 | 
			
		||||
  /* Default configuration at reset is:                      */
 | 
			
		||||
  /* - Prefetch disabled                                     */
 | 
			
		||||
  /* - Instruction cache enabled                             */
 | 
			
		||||
  /* - Data cache enabled                                    */
 | 
			
		||||
#if (INSTRUCTION_CACHE_ENABLE == 0)
 | 
			
		||||
   __HAL_FLASH_INSTRUCTION_CACHE_DISABLE();
 | 
			
		||||
#endif /* INSTRUCTION_CACHE_ENABLE */
 | 
			
		||||
 | 
			
		||||
#if (DATA_CACHE_ENABLE == 0)
 | 
			
		||||
   __HAL_FLASH_DATA_CACHE_DISABLE();
 | 
			
		||||
#endif /* DATA_CACHE_ENABLE */
 | 
			
		||||
 | 
			
		||||
#if (PREFETCH_ENABLE != 0)
 | 
			
		||||
  __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
 | 
			
		||||
#endif /* PREFETCH_ENABLE */
 | 
			
		||||
 | 
			
		||||
  /* Set Interrupt Group Priority */
 | 
			
		||||
  HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
 | 
			
		||||
 | 
			
		||||
  /* Use SysTick as time base source and configure 1ms tick (default clock after Reset is MSI) */
 | 
			
		||||
  if (HAL_InitTick(TICK_INT_PRIORITY) != HAL_OK)
 | 
			
		||||
  {
 | 
			
		||||
    status = HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    /* Init the low level hardware */
 | 
			
		||||
    HAL_MspInit();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Return function status */
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief De-initialize common part of the HAL and stop the source of time base.
 | 
			
		||||
  * @note This function is optional.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_DeInit(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Reset of all peripherals */
 | 
			
		||||
  __HAL_RCC_APB1_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_APB1_RELEASE_RESET();
 | 
			
		||||
 | 
			
		||||
  __HAL_RCC_APB2_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_APB2_RELEASE_RESET();
 | 
			
		||||
 | 
			
		||||
  __HAL_RCC_AHB1_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_AHB1_RELEASE_RESET();
 | 
			
		||||
 | 
			
		||||
  __HAL_RCC_AHB2_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_AHB2_RELEASE_RESET();
 | 
			
		||||
 | 
			
		||||
  __HAL_RCC_AHB3_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_AHB3_RELEASE_RESET();
 | 
			
		||||
 | 
			
		||||
  /* De-Init the low level hardware */
 | 
			
		||||
  HAL_MspDeInit();
 | 
			
		||||
 | 
			
		||||
  /* Return function status */
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Initialize the MSP.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_MspInit(void)
 | 
			
		||||
{
 | 
			
		||||
  /* NOTE : This function should not be modified, when the callback is needed,
 | 
			
		||||
            the HAL_MspInit could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  DeInitialize the MSP.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_MspDeInit(void)
 | 
			
		||||
{
 | 
			
		||||
  /* NOTE : This function should not be modified, when the callback is needed,
 | 
			
		||||
            the HAL_MspDeInit could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief This function configures the source of the time base:
 | 
			
		||||
  *        The time source is configured to have 1ms time base with a dedicated
 | 
			
		||||
  *        Tick interrupt priority.
 | 
			
		||||
  * @note This function is called  automatically at the beginning of program after
 | 
			
		||||
  *       reset by HAL_Init() or at any time when clock is reconfigured  by HAL_RCC_ClockConfig().
 | 
			
		||||
  * @note In the default implementation, SysTick timer is the source of time base.
 | 
			
		||||
  *       It is used to generate interrupts at regular time intervals.
 | 
			
		||||
  *       Care must be taken if HAL_Delay() is called from a peripheral ISR process,
 | 
			
		||||
  *       The SysTick interrupt must have higher priority (numerically lower)
 | 
			
		||||
  *       than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
 | 
			
		||||
  *       The function is declared as __weak  to be overwritten  in case of other
 | 
			
		||||
  *       implementation  in user file.
 | 
			
		||||
  * @param TickPriority  Tick interrupt priority.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
__weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef  status = HAL_OK;
 | 
			
		||||
 | 
			
		||||
  /* Check uwTickFreq for MisraC 2012 (even if uwTickFreq is a enum type that doesn't take the value zero)*/
 | 
			
		||||
  if ((uint32_t)uwTickFreq != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /*Configure the SysTick to have interrupt in 1ms time basis*/
 | 
			
		||||
    if (HAL_SYSTICK_Config(SystemCoreClock / (1000U / (uint32_t)uwTickFreq)) == 0U)
 | 
			
		||||
    {
 | 
			
		||||
      /* Configure the SysTick IRQ priority */
 | 
			
		||||
      if (TickPriority < (1UL << __NVIC_PRIO_BITS))
 | 
			
		||||
      {
 | 
			
		||||
        HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority, 0U);
 | 
			
		||||
        uwTickPrio = TickPriority;
 | 
			
		||||
      }
 | 
			
		||||
      else
 | 
			
		||||
      {
 | 
			
		||||
        status = HAL_ERROR;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      status = HAL_ERROR;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    status = HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Return function status */
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Functions_Group2 HAL Control functions
 | 
			
		||||
 *  @brief    HAL Control functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### HAL Control functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]  This section provides functions allowing to:
 | 
			
		||||
      (+) Provide a tick value in millisecond
 | 
			
		||||
      (+) Provide a blocking delay in millisecond
 | 
			
		||||
      (+) Suspend the time base source interrupt
 | 
			
		||||
      (+) Resume the time base source interrupt
 | 
			
		||||
      (+) Get the HAL API driver version
 | 
			
		||||
      (+) Get the device identifier
 | 
			
		||||
      (+) Get the device revision identifier
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief This function is called to increment a global variable "uwTick"
 | 
			
		||||
  *        used as application time base.
 | 
			
		||||
  * @note In the default implementation, this variable is incremented each 1ms
 | 
			
		||||
  *       in SysTick ISR.
 | 
			
		||||
 * @note This function is declared as __weak to be overwritten in case of other
 | 
			
		||||
  *      implementations in user file.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_IncTick(void)
 | 
			
		||||
{
 | 
			
		||||
  uwTick += (uint32_t)uwTickFreq;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Provide a tick value in millisecond.
 | 
			
		||||
  * @note This function is declared as __weak to be overwritten in case of other
 | 
			
		||||
  *       implementations in user file.
 | 
			
		||||
  * @retval tick value
 | 
			
		||||
  */
 | 
			
		||||
__weak uint32_t HAL_GetTick(void)
 | 
			
		||||
{
 | 
			
		||||
  return uwTick;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief This function returns a tick priority.
 | 
			
		||||
  * @retval tick priority
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetTickPrio(void)
 | 
			
		||||
{
 | 
			
		||||
  return uwTickPrio;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Set new tick Freq.
 | 
			
		||||
  * @param Freq tick frequency
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_SetTickFreq(HAL_TickFreqTypeDef Freq)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef status  = HAL_OK;
 | 
			
		||||
  HAL_TickFreqTypeDef prevTickFreq;
 | 
			
		||||
 | 
			
		||||
  if (uwTickFreq != Freq)
 | 
			
		||||
  {
 | 
			
		||||
    /* Back up uwTickFreq frequency */
 | 
			
		||||
    prevTickFreq = uwTickFreq;
 | 
			
		||||
 | 
			
		||||
    /* Update uwTickFreq global variable used by HAL_InitTick() */
 | 
			
		||||
    uwTickFreq = Freq;
 | 
			
		||||
 | 
			
		||||
    /* Apply the new tick Freq  */
 | 
			
		||||
    status = HAL_InitTick(uwTickPrio);
 | 
			
		||||
    if (status != HAL_OK)
 | 
			
		||||
    {
 | 
			
		||||
      /* Restore previous tick frequency */
 | 
			
		||||
      uwTickFreq = prevTickFreq;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Return tick frequency.
 | 
			
		||||
  * @retval Tick frequency.
 | 
			
		||||
  *         Value of @ref HAL_TickFreqTypeDef.
 | 
			
		||||
  */
 | 
			
		||||
HAL_TickFreqTypeDef HAL_GetTickFreq(void)
 | 
			
		||||
{
 | 
			
		||||
  return uwTickFreq;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief This function provides minimum delay (in milliseconds) based
 | 
			
		||||
  *        on variable incremented.
 | 
			
		||||
  * @note In the default implementation , SysTick timer is the source of time base.
 | 
			
		||||
  *       It is used to generate interrupts at regular time intervals where uwTick
 | 
			
		||||
  *       is incremented.
 | 
			
		||||
  * @note This function is declared as __weak to be overwritten in case of other
 | 
			
		||||
  *       implementations in user file.
 | 
			
		||||
  * @param Delay  specifies the delay time length, in milliseconds.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_Delay(uint32_t Delay)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t tickstart = HAL_GetTick();
 | 
			
		||||
  uint32_t wait = Delay;
 | 
			
		||||
 | 
			
		||||
  /* Add a period to guaranty minimum wait */
 | 
			
		||||
  if (wait < HAL_MAX_DELAY)
 | 
			
		||||
  {
 | 
			
		||||
    wait += (uint32_t)uwTickFreq;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  while ((HAL_GetTick() - tickstart) < wait)
 | 
			
		||||
  {
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Suspend Tick increment.
 | 
			
		||||
  * @note In the default implementation , SysTick timer is the source of time base. It is
 | 
			
		||||
  *       used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
 | 
			
		||||
  *       is called, the SysTick interrupt will be disabled and so Tick increment
 | 
			
		||||
  *       is suspended.
 | 
			
		||||
  * @note This function is declared as __weak to be overwritten in case of other
 | 
			
		||||
  *       implementations in user file.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_SuspendTick(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Disable SysTick Interrupt */
 | 
			
		||||
  SysTick->CTRL &= ~SysTick_CTRL_TICKINT_Msk;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Resume Tick increment.
 | 
			
		||||
  * @note In the default implementation , SysTick timer is the source of time base. It is
 | 
			
		||||
  *       used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
 | 
			
		||||
  *       is called, the SysTick interrupt will be enabled and so Tick increment
 | 
			
		||||
  *       is resumed.
 | 
			
		||||
  * @note This function is declared as __weak to be overwritten in case of other
 | 
			
		||||
  *       implementations in user file.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_ResumeTick(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Enable SysTick Interrupt */
 | 
			
		||||
  SysTick->CTRL  |= SysTick_CTRL_TICKINT_Msk;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the HAL revision.
 | 
			
		||||
  * @retval version : 0xXYZR (8bits for each decimal, R for RC)
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetHalVersion(void)
 | 
			
		||||
{
 | 
			
		||||
  return STM32L4XX_HAL_VERSION;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the device revision identifier.
 | 
			
		||||
  * @retval Device revision identifier
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetREVID(void)
 | 
			
		||||
{
 | 
			
		||||
  return((DBGMCU->IDCODE & DBGMCU_IDCODE_REV_ID) >> 16);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the device identifier.
 | 
			
		||||
  * @retval Device identifier
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetDEVID(void)
 | 
			
		||||
{
 | 
			
		||||
  return(DBGMCU->IDCODE & DBGMCU_IDCODE_DEV_ID);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the first word of the unique device identifier (UID based on 96 bits)
 | 
			
		||||
  * @retval Device identifier
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetUIDw0(void)
 | 
			
		||||
{
 | 
			
		||||
  return(READ_REG(*((uint32_t *)UID_BASE)));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the second word of the unique device identifier (UID based on 96 bits)
 | 
			
		||||
  * @retval Device identifier
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetUIDw1(void)
 | 
			
		||||
{
 | 
			
		||||
  return(READ_REG(*((uint32_t *)(UID_BASE + 4U))));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Return the third word of the unique device identifier (UID based on 96 bits)
 | 
			
		||||
  * @retval Device identifier
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_GetUIDw2(void)
 | 
			
		||||
{
 | 
			
		||||
  return(READ_REG(*((uint32_t *)(UID_BASE + 8U))));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Functions_Group3 HAL Debug functions
 | 
			
		||||
 *  @brief    HAL Debug functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### HAL Debug functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]  This section provides functions allowing to:
 | 
			
		||||
      (+) Enable/Disable Debug module during SLEEP mode
 | 
			
		||||
      (+) Enable/Disable Debug module during STOP0/STOP1/STOP2 modes
 | 
			
		||||
      (+) Enable/Disable Debug module during STANDBY mode
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the Debug Module during SLEEP mode.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_EnableDBGSleepMode(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the Debug Module during SLEEP mode.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_DisableDBGSleepMode(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the Debug Module during STOP0/STOP1/STOP2 modes.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_EnableDBGStopMode(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the Debug Module during STOP0/STOP1/STOP2 modes.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_DisableDBGStopMode(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the Debug Module during STANDBY mode.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_EnableDBGStandbyMode(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the Debug Module during STANDBY mode.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DBGMCU_DisableDBGStandbyMode(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup HAL_Exported_Functions_Group4 HAL SYSCFG configuration functions
 | 
			
		||||
 *  @brief    HAL SYSCFG configuration functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### HAL SYSCFG configuration functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]  This section provides functions allowing to:
 | 
			
		||||
      (+) Start a hardware SRAM2 erase operation
 | 
			
		||||
      (+) Enable/Disable the Internal FLASH Bank Swapping
 | 
			
		||||
      (+) Configure the Voltage reference buffer
 | 
			
		||||
      (+) Enable/Disable the Voltage reference buffer
 | 
			
		||||
      (+) Enable/Disable the I/O analog switch voltage booster
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Start a hardware SRAM2 erase operation.
 | 
			
		||||
  * @note   As long as SRAM2 is not erased the SRAM2ER bit will be set.
 | 
			
		||||
  *         This bit is automatically reset at the end of the SRAM2 erase operation.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_SRAM2Erase(void)
 | 
			
		||||
{
 | 
			
		||||
  /* unlock the write protection of the SRAM2ER bit */
 | 
			
		||||
  SYSCFG->SKR = 0xCA;
 | 
			
		||||
  SYSCFG->SKR = 0x53;
 | 
			
		||||
  /* Starts a hardware SRAM2 erase operation*/
 | 
			
		||||
  *(__IO uint32_t *) SCSR_SRAM2ER_BB = 0x00000001UL;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the Internal FLASH Bank Swapping.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   This function can be used only for STM32L4xx devices.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   Flash Bank2 mapped at 0x08000000 (and aliased @0x00000000)
 | 
			
		||||
  *         and Flash Bank1 mapped at 0x08100000 (and aliased at 0x00100000)
 | 
			
		||||
  *
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_EnableMemorySwappingBank(void)
 | 
			
		||||
{
 | 
			
		||||
  *(__IO uint32_t *)FB_MODE_BB = 0x00000001UL;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the Internal FLASH Bank Swapping.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   This function can be used only for STM32L4xx devices.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   The default state : Flash Bank1 mapped at 0x08000000 (and aliased @0x0000 0000)
 | 
			
		||||
  *         and Flash Bank2 mapped at 0x08100000 (and aliased at 0x00100000)
 | 
			
		||||
  *
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_DisableMemorySwappingBank(void)
 | 
			
		||||
{
 | 
			
		||||
 | 
			
		||||
  *(__IO uint32_t *)FB_MODE_BB = 0x00000000UL;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
#if defined(VREFBUF)
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Configure the internal voltage reference buffer voltage scale.
 | 
			
		||||
  * @param VoltageScaling  specifies the output voltage to achieve
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg SYSCFG_VREFBUF_VOLTAGE_SCALE0: VREF_OUT1 around 2.048 V.
 | 
			
		||||
  *                                                This requires VDDA equal to or higher than 2.4 V.
 | 
			
		||||
  *            @arg SYSCFG_VREFBUF_VOLTAGE_SCALE1: VREF_OUT2 around 2.5 V.
 | 
			
		||||
  *                                                This requires VDDA equal to or higher than 2.8 V.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_VREFBUF_VoltageScalingConfig(uint32_t VoltageScaling)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_SYSCFG_VREFBUF_VOLTAGE_SCALE(VoltageScaling));
 | 
			
		||||
 | 
			
		||||
  MODIFY_REG(VREFBUF->CSR, VREFBUF_CSR_VRS, VoltageScaling);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Configure the internal voltage reference buffer high impedance mode.
 | 
			
		||||
  * @param Mode  specifies the high impedance mode
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg SYSCFG_VREFBUF_HIGH_IMPEDANCE_DISABLE: VREF+ pin is internally connect to VREFINT output.
 | 
			
		||||
  *            @arg SYSCFG_VREFBUF_HIGH_IMPEDANCE_ENABLE: VREF+ pin is high impedance.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_VREFBUF_HighImpedanceConfig(uint32_t Mode)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_SYSCFG_VREFBUF_HIGH_IMPEDANCE(Mode));
 | 
			
		||||
 | 
			
		||||
  MODIFY_REG(VREFBUF->CSR, VREFBUF_CSR_HIZ, Mode);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Tune the Internal Voltage Reference buffer (VREFBUF).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_VREFBUF_TrimmingConfig(uint32_t TrimmingValue)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_SYSCFG_VREFBUF_TRIMMING(TrimmingValue));
 | 
			
		||||
 | 
			
		||||
  MODIFY_REG(VREFBUF->CCR, VREFBUF_CCR_TRIM, TrimmingValue);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the Internal Voltage Reference buffer (VREFBUF).
 | 
			
		||||
  * @retval HAL_OK/HAL_TIMEOUT
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_SYSCFG_EnableVREFBUF(void)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t  tickstart;
 | 
			
		||||
 | 
			
		||||
  SET_BIT(VREFBUF->CSR, VREFBUF_CSR_ENVR);
 | 
			
		||||
 | 
			
		||||
  /* Get Start Tick*/
 | 
			
		||||
  tickstart = HAL_GetTick();
 | 
			
		||||
 | 
			
		||||
  /* Wait for VRR bit  */
 | 
			
		||||
  while(READ_BIT(VREFBUF->CSR, VREFBUF_CSR_VRR) == 0U)
 | 
			
		||||
  {
 | 
			
		||||
    if((HAL_GetTick() - tickstart) > VREFBUF_TIMEOUT_VALUE)
 | 
			
		||||
    {
 | 
			
		||||
      return HAL_TIMEOUT;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the Internal Voltage Reference buffer (VREFBUF).
 | 
			
		||||
  *
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_DisableVREFBUF(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(VREFBUF->CSR, VREFBUF_CSR_ENVR);
 | 
			
		||||
}
 | 
			
		||||
#endif /* VREFBUF */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the I/O analog switch voltage booster
 | 
			
		||||
  *
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_EnableIOAnalogSwitchBooster(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(SYSCFG->CFGR1, SYSCFG_CFGR1_BOOSTEN);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the I/O analog switch voltage booster
 | 
			
		||||
  *
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSCFG_DisableIOAnalogSwitchBooster(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(SYSCFG->CFGR1, SYSCFG_CFGR1_BOOSTEN);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
							
								
								
									
										541
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_cortex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										541
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_cortex.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,541 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_cortex.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   CORTEX HAL module driver.
 | 
			
		||||
  *          This file provides firmware functions to manage the following
 | 
			
		||||
  *          functionalities of the CORTEX:
 | 
			
		||||
  *           + Initialization and Configuration functions
 | 
			
		||||
  *           + Peripheral Control functions
 | 
			
		||||
  *
 | 
			
		||||
  @verbatim
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                        ##### How to use this driver #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
 | 
			
		||||
    [..]
 | 
			
		||||
    *** How to configure Interrupts using CORTEX HAL driver ***
 | 
			
		||||
    ===========================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    This section provides functions allowing to configure the NVIC interrupts (IRQ).
 | 
			
		||||
    The Cortex-M4 exceptions are managed by CMSIS functions.
 | 
			
		||||
 | 
			
		||||
    (#) Configure the NVIC Priority Grouping using HAL_NVIC_SetPriorityGrouping() function.
 | 
			
		||||
    (#) Configure the priority of the selected IRQ Channels using HAL_NVIC_SetPriority().
 | 
			
		||||
    (#) Enable the selected IRQ Channels using HAL_NVIC_EnableIRQ().
 | 
			
		||||
 | 
			
		||||
     -@- When the NVIC_PRIORITYGROUP_0 is selected, IRQ pre-emption is no more possible.
 | 
			
		||||
         The pending IRQ priority will be managed only by the sub priority.
 | 
			
		||||
 | 
			
		||||
     -@- IRQ priority order (sorted by highest to lowest priority):
 | 
			
		||||
        (+@) Lowest pre-emption priority
 | 
			
		||||
        (+@) Lowest sub priority
 | 
			
		||||
        (+@) Lowest hardware priority (IRQ number)
 | 
			
		||||
 | 
			
		||||
    [..]
 | 
			
		||||
    *** How to configure SysTick using CORTEX HAL driver ***
 | 
			
		||||
    ========================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    Setup SysTick Timer for time base.
 | 
			
		||||
 | 
			
		||||
   (+) The HAL_SYSTICK_Config() function calls the SysTick_Config() function which
 | 
			
		||||
       is a CMSIS function that:
 | 
			
		||||
        (++) Configures the SysTick Reload register with value passed as function parameter.
 | 
			
		||||
        (++) Configures the SysTick IRQ priority to the lowest value (0x0F).
 | 
			
		||||
        (++) Resets the SysTick Counter register.
 | 
			
		||||
        (++) Configures the SysTick Counter clock source to be Core Clock Source (HCLK).
 | 
			
		||||
        (++) Enables the SysTick Interrupt.
 | 
			
		||||
        (++) Starts the SysTick Counter.
 | 
			
		||||
 | 
			
		||||
   (+) You can change the SysTick Clock source to be HCLK_Div8 by calling the macro
 | 
			
		||||
       __HAL_CORTEX_SYSTICKCLK_CONFIG(SYSTICK_CLKSOURCE_HCLK_DIV8) just after the
 | 
			
		||||
       HAL_SYSTICK_Config() function call. The __HAL_CORTEX_SYSTICKCLK_CONFIG() macro is defined
 | 
			
		||||
       inside the stm32l4xx_hal_cortex.h file.
 | 
			
		||||
 | 
			
		||||
   (+) You can change the SysTick IRQ priority by calling the
 | 
			
		||||
       HAL_NVIC_SetPriority(SysTick_IRQn,...) function just after the HAL_SYSTICK_Config() function
 | 
			
		||||
       call. The HAL_NVIC_SetPriority() call the NVIC_SetPriority() function which is a CMSIS function.
 | 
			
		||||
 | 
			
		||||
   (+) To adjust the SysTick time base, use the following formula:
 | 
			
		||||
 | 
			
		||||
       Reload Value = SysTick Counter Clock (Hz) x  Desired Time base (s)
 | 
			
		||||
       (++) Reload Value is the parameter to be passed for HAL_SYSTICK_Config() function
 | 
			
		||||
       (++) Reload Value should not exceed 0xFFFFFF
 | 
			
		||||
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
 | 
			
		||||
  The table below gives the allowed values of the pre-emption priority and subpriority according
 | 
			
		||||
  to the Priority Grouping configuration performed by HAL_NVIC_SetPriorityGrouping() function.
 | 
			
		||||
  
 | 
			
		||||
    ==========================================================================================================================
 | 
			
		||||
      NVIC_PriorityGroup   | NVIC_IRQChannelPreemptionPriority | NVIC_IRQChannelSubPriority  |       Description
 | 
			
		||||
    ==========================================================================================================================
 | 
			
		||||
     NVIC_PRIORITYGROUP_0  |                0                  |            0-15             | 0 bit for pre-emption priority
 | 
			
		||||
                           |                                   |                             | 4 bits for subpriority
 | 
			
		||||
    --------------------------------------------------------------------------------------------------------------------------
 | 
			
		||||
     NVIC_PRIORITYGROUP_1  |                0-1                |            0-7              | 1 bit for pre-emption priority
 | 
			
		||||
                           |                                   |                             | 3 bits for subpriority
 | 
			
		||||
    --------------------------------------------------------------------------------------------------------------------------    
 | 
			
		||||
     NVIC_PRIORITYGROUP_2  |                0-3                |            0-3              | 2 bits for pre-emption priority
 | 
			
		||||
                           |                                   |                             | 2 bits for subpriority
 | 
			
		||||
    --------------------------------------------------------------------------------------------------------------------------    
 | 
			
		||||
     NVIC_PRIORITYGROUP_3  |                0-7                |            0-1              | 3 bits for pre-emption priority
 | 
			
		||||
                           |                                   |                             | 1 bit for subpriority
 | 
			
		||||
    --------------------------------------------------------------------------------------------------------------------------    
 | 
			
		||||
     NVIC_PRIORITYGROUP_4  |                0-15               |            0                | 4 bits for pre-emption priority
 | 
			
		||||
                           |                                   |                             | 0 bit for subpriority                       
 | 
			
		||||
    ==========================================================================================================================
 | 
			
		||||
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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.
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @addtogroup CORTEX
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_CORTEX_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private types -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private constants ---------------------------------------------------------*/
 | 
			
		||||
/* Private macros ------------------------------------------------------------*/
 | 
			
		||||
/* Private functions ---------------------------------------------------------*/
 | 
			
		||||
/* Exported functions --------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @addtogroup CORTEX_Exported_Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/** @addtogroup CORTEX_Exported_Functions_Group1
 | 
			
		||||
 *  @brief    Initialization and Configuration functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
              ##### Initialization and Configuration functions #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
      This section provides the CORTEX HAL driver functions allowing to configure Interrupts
 | 
			
		||||
      SysTick functionalities
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Set the priority grouping field (pre-emption priority and subpriority)
 | 
			
		||||
  *         using the required unlock sequence.
 | 
			
		||||
  * @param  PriorityGroup: The priority grouping bits length.
 | 
			
		||||
  *         This parameter can be one of the following values:
 | 
			
		||||
  *         @arg NVIC_PRIORITYGROUP_0: 0 bit  for pre-emption priority,
 | 
			
		||||
  *                                    4 bits for subpriority
 | 
			
		||||
  *         @arg NVIC_PRIORITYGROUP_1: 1 bit  for pre-emption priority,
 | 
			
		||||
  *                                    3 bits for subpriority
 | 
			
		||||
  *         @arg NVIC_PRIORITYGROUP_2: 2 bits for pre-emption priority,
 | 
			
		||||
  *                                    2 bits for subpriority
 | 
			
		||||
  *         @arg NVIC_PRIORITYGROUP_3: 3 bits for pre-emption priority,
 | 
			
		||||
  *                                    1 bit  for subpriority
 | 
			
		||||
  *         @arg NVIC_PRIORITYGROUP_4: 4 bits for pre-emption priority,
 | 
			
		||||
  *                                    0 bit  for subpriority
 | 
			
		||||
  * @note   When the NVIC_PriorityGroup_0 is selected, IRQ pre-emption is no more possible.
 | 
			
		||||
  *         The pending IRQ priority will be managed only by the subpriority.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_SetPriorityGrouping(uint32_t PriorityGroup)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_PRIORITY_GROUP(PriorityGroup));
 | 
			
		||||
 | 
			
		||||
  /* Set the PRIGROUP[10:8] bits according to the PriorityGroup parameter value */
 | 
			
		||||
  NVIC_SetPriorityGrouping(PriorityGroup);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Set the priority of an interrupt.
 | 
			
		||||
  * @param  IRQn: External interrupt number.
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @param  PreemptPriority: The pre-emption priority for the IRQn channel.
 | 
			
		||||
  *         This parameter can be a value between 0 and 15
 | 
			
		||||
  *         A lower priority value indicates a higher priority
 | 
			
		||||
  * @param  SubPriority: the subpriority level for the IRQ channel.
 | 
			
		||||
  *         This parameter can be a value between 0 and 15
 | 
			
		||||
  *         A lower priority value indicates a higher priority.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_SetPriority(IRQn_Type IRQn, uint32_t PreemptPriority, uint32_t SubPriority)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t prioritygroup = 0x00;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_SUB_PRIORITY(SubPriority));
 | 
			
		||||
  assert_param(IS_NVIC_PREEMPTION_PRIORITY(PreemptPriority));
 | 
			
		||||
 | 
			
		||||
  prioritygroup = NVIC_GetPriorityGrouping();
 | 
			
		||||
 | 
			
		||||
  NVIC_SetPriority(IRQn, NVIC_EncodePriority(prioritygroup, PreemptPriority, SubPriority));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable a device specific interrupt in the NVIC interrupt controller.
 | 
			
		||||
  * @note   To configure interrupts priority correctly, the NVIC_PriorityGroupConfig()
 | 
			
		||||
  *         function should be called before.
 | 
			
		||||
  * @param  IRQn External interrupt number.
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_EnableIRQ(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));
 | 
			
		||||
  
 | 
			
		||||
  /* Enable interrupt */
 | 
			
		||||
  NVIC_EnableIRQ(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable a device specific interrupt in the NVIC interrupt controller.
 | 
			
		||||
  * @param  IRQn External interrupt number.
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_DisableIRQ(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));
 | 
			
		||||
  
 | 
			
		||||
  /* Disable interrupt */
 | 
			
		||||
  NVIC_DisableIRQ(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Initiate a system reset request to reset the MCU.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_SystemReset(void)
 | 
			
		||||
{
 | 
			
		||||
  /* System Reset */
 | 
			
		||||
  NVIC_SystemReset();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Initialize the System Timer with interrupt enabled and start the System Tick Timer (SysTick): 
 | 
			
		||||
  *         Counter is in free running mode to generate periodic interrupts.
 | 
			
		||||
  * @param  TicksNumb: Specifies the ticks Number of ticks between two interrupts.
 | 
			
		||||
  * @retval status:  - 0  Function succeeded.
 | 
			
		||||
  *                  - 1  Function failed.
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_SYSTICK_Config(uint32_t TicksNumb)
 | 
			
		||||
{
 | 
			
		||||
   return SysTick_Config(TicksNumb);
 | 
			
		||||
}
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @addtogroup CORTEX_Exported_Functions_Group2
 | 
			
		||||
 *  @brief   Cortex control functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                      ##### Peripheral Control functions #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
      This subsection provides a set of functions allowing to control the CORTEX
 | 
			
		||||
      (NVIC, SYSTICK, MPU) functionalities.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Get the priority grouping field from the NVIC Interrupt Controller.
 | 
			
		||||
  * @retval Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field)
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_NVIC_GetPriorityGrouping(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Get the PRIGROUP[10:8] field value */
 | 
			
		||||
  return NVIC_GetPriorityGrouping();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Get the priority of an interrupt.
 | 
			
		||||
  * @param  IRQn: External interrupt number.
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @param   PriorityGroup: the priority grouping bits length.
 | 
			
		||||
  *         This parameter can be one of the following values:
 | 
			
		||||
  *           @arg NVIC_PRIORITYGROUP_0: 0 bit for pre-emption priority,
 | 
			
		||||
  *                                      4 bits for subpriority
 | 
			
		||||
  *           @arg NVIC_PRIORITYGROUP_1: 1 bit for pre-emption priority,
 | 
			
		||||
  *                                      3 bits for subpriority
 | 
			
		||||
  *           @arg NVIC_PRIORITYGROUP_2: 2 bits for pre-emption priority,
 | 
			
		||||
  *                                      2 bits for subpriority
 | 
			
		||||
  *           @arg NVIC_PRIORITYGROUP_3: 3 bits for pre-emption priority,
 | 
			
		||||
  *                                      1 bit for subpriority
 | 
			
		||||
  *           @arg NVIC_PRIORITYGROUP_4: 4 bits for pre-emption priority,
 | 
			
		||||
  *                                      0 bit for subpriority
 | 
			
		||||
  * @param  pPreemptPriority: Pointer on the Preemptive priority value (starting from 0).
 | 
			
		||||
  * @param  pSubPriority: Pointer on the Subpriority value (starting from 0).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_GetPriority(IRQn_Type IRQn, uint32_t PriorityGroup, uint32_t *pPreemptPriority, uint32_t *pSubPriority)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_PRIORITY_GROUP(PriorityGroup));
 | 
			
		||||
 /* Get priority for Cortex-M system or device specific interrupts */
 | 
			
		||||
  NVIC_DecodePriority(NVIC_GetPriority(IRQn), PriorityGroup, pPreemptPriority, pSubPriority);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Set Pending bit of an external interrupt.
 | 
			
		||||
  * @param  IRQn External interrupt number
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_SetPendingIRQ(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));
 | 
			
		||||
  
 | 
			
		||||
  /* Set interrupt pending */
 | 
			
		||||
  NVIC_SetPendingIRQ(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Get Pending Interrupt (read the pending register in the NVIC
 | 
			
		||||
  *         and return the pending bit for the specified interrupt).
 | 
			
		||||
  * @param  IRQn External interrupt number.
 | 
			
		||||
  *          This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval status: - 0  Interrupt status is not pending.
 | 
			
		||||
  *                 - 1  Interrupt status is pending.
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_NVIC_GetPendingIRQ(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));
 | 
			
		||||
  
 | 
			
		||||
  /* Return 1 if pending else 0 */
 | 
			
		||||
  return NVIC_GetPendingIRQ(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Clear the pending bit of an external interrupt.
 | 
			
		||||
  * @param  IRQn External interrupt number.
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_NVIC_ClearPendingIRQ(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));
 | 
			
		||||
  
 | 
			
		||||
  /* Clear pending interrupt */
 | 
			
		||||
  NVIC_ClearPendingIRQ(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Get active interrupt (read the active register in NVIC and return the active bit).
 | 
			
		||||
  * @param IRQn External interrupt number
 | 
			
		||||
  *         This parameter can be an enumerator of IRQn_Type enumeration
 | 
			
		||||
  *         (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
 | 
			
		||||
  * @retval status: - 0  Interrupt status is not pending.
 | 
			
		||||
  *                 - 1  Interrupt status is pending.
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_NVIC_GetActive(IRQn_Type IRQn)
 | 
			
		||||
{
 | 
			
		||||
  /* Return 1 if active else 0 */
 | 
			
		||||
  return NVIC_GetActive(IRQn);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure the SysTick clock source.
 | 
			
		||||
  * @param  CLKSource: specifies the SysTick clock source.
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *             @arg SYSTICK_CLKSOURCE_HCLK_DIV8: AHB clock divided by 8 selected as SysTick clock source.
 | 
			
		||||
  *             @arg SYSTICK_CLKSOURCE_HCLK: AHB clock selected as SysTick clock source.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSTICK_CLKSourceConfig(uint32_t CLKSource)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_SYSTICK_CLK_SOURCE(CLKSource));
 | 
			
		||||
  if (CLKSource == SYSTICK_CLKSOURCE_HCLK)
 | 
			
		||||
  {
 | 
			
		||||
    SysTick->CTRL |= SYSTICK_CLKSOURCE_HCLK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    SysTick->CTRL &= ~SYSTICK_CLKSOURCE_HCLK;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Handle SYSTICK interrupt request.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_SYSTICK_IRQHandler(void)
 | 
			
		||||
{
 | 
			
		||||
  HAL_SYSTICK_Callback();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  SYSTICK callback.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_SYSTICK_Callback(void)
 | 
			
		||||
{
 | 
			
		||||
  /* NOTE : This function should not be modified, when the callback is needed,
 | 
			
		||||
            the HAL_SYSTICK_Callback could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
#if (__MPU_PRESENT == 1)
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the MPU.
 | 
			
		||||
  * @param  MPU_Control: Specifies the control mode of the MPU during hard fault, 
 | 
			
		||||
  *          NMI, FAULTMASK and privileged accessto the default memory 
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg MPU_HFNMI_PRIVDEF_NONE
 | 
			
		||||
  *            @arg MPU_HARDFAULT_NMI
 | 
			
		||||
  *            @arg MPU_PRIVILEGED_DEFAULT
 | 
			
		||||
  *            @arg MPU_HFNMI_PRIVDEF
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_MPU_Enable(uint32_t MPU_Control)
 | 
			
		||||
{
 | 
			
		||||
  /* Enable the MPU */
 | 
			
		||||
  MPU->CTRL = (MPU_Control | MPU_CTRL_ENABLE_Msk);
 | 
			
		||||
 | 
			
		||||
  /* Ensure MPU setting take effects */
 | 
			
		||||
  __DSB();
 | 
			
		||||
  __ISB();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the MPU.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_MPU_Disable(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Make sure outstanding transfers are done */
 | 
			
		||||
  __DMB();
 | 
			
		||||
 | 
			
		||||
  /* Disable the MPU and clear the control register*/
 | 
			
		||||
  MPU->CTRL  = 0;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the MPU Region.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_MPU_EnableRegion(uint32_t RegionNumber)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_MPU_REGION_NUMBER(RegionNumber));
 | 
			
		||||
 | 
			
		||||
  /* Set the Region number */
 | 
			
		||||
  MPU->RNR = RegionNumber;
 | 
			
		||||
 | 
			
		||||
  /* Enable the Region */
 | 
			
		||||
  SET_BIT(MPU->RASR, MPU_RASR_ENABLE_Msk);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the MPU Region.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_MPU_DisableRegion(uint32_t RegionNumber)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_MPU_REGION_NUMBER(RegionNumber));
 | 
			
		||||
 | 
			
		||||
  /* Set the Region number */
 | 
			
		||||
  MPU->RNR = RegionNumber;
 | 
			
		||||
 | 
			
		||||
  /* Disable the Region */
 | 
			
		||||
  CLEAR_BIT(MPU->RASR, MPU_RASR_ENABLE_Msk);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Initialize and configure the Region and the memory to be protected.
 | 
			
		||||
  * @param  MPU_Init: Pointer to a MPU_Region_InitTypeDef structure that contains
 | 
			
		||||
  *                the initialization and configuration information.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_MPU_ConfigRegion(MPU_Region_InitTypeDef *MPU_Init)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_MPU_REGION_NUMBER(MPU_Init->Number));
 | 
			
		||||
  assert_param(IS_MPU_REGION_ENABLE(MPU_Init->Enable));
 | 
			
		||||
  assert_param(IS_MPU_INSTRUCTION_ACCESS(MPU_Init->DisableExec));
 | 
			
		||||
  assert_param(IS_MPU_REGION_PERMISSION_ATTRIBUTE(MPU_Init->AccessPermission));
 | 
			
		||||
  assert_param(IS_MPU_TEX_LEVEL(MPU_Init->TypeExtField));
 | 
			
		||||
  assert_param(IS_MPU_ACCESS_SHAREABLE(MPU_Init->IsShareable));
 | 
			
		||||
  assert_param(IS_MPU_ACCESS_CACHEABLE(MPU_Init->IsCacheable));
 | 
			
		||||
  assert_param(IS_MPU_ACCESS_BUFFERABLE(MPU_Init->IsBufferable));
 | 
			
		||||
  assert_param(IS_MPU_SUB_REGION_DISABLE(MPU_Init->SubRegionDisable));
 | 
			
		||||
  assert_param(IS_MPU_REGION_SIZE(MPU_Init->Size));
 | 
			
		||||
  /* Set the Region number */
 | 
			
		||||
  MPU->RNR = MPU_Init->Number;
 | 
			
		||||
 | 
			
		||||
/* Disable the Region */
 | 
			
		||||
  CLEAR_BIT(MPU->RASR, MPU_RASR_ENABLE_Msk);
 | 
			
		||||
 | 
			
		||||
  /* Apply configuration */
 | 
			
		||||
  MPU->RBAR = MPU_Init->BaseAddress;
 | 
			
		||||
  MPU->RASR = ((uint32_t)MPU_Init->DisableExec             << MPU_RASR_XN_Pos)   |
 | 
			
		||||
              ((uint32_t)MPU_Init->AccessPermission        << MPU_RASR_AP_Pos)   |
 | 
			
		||||
              ((uint32_t)MPU_Init->TypeExtField            << MPU_RASR_TEX_Pos)  |
 | 
			
		||||
              ((uint32_t)MPU_Init->IsShareable             << MPU_RASR_S_Pos)    |
 | 
			
		||||
              ((uint32_t)MPU_Init->IsCacheable             << MPU_RASR_C_Pos)    |
 | 
			
		||||
              ((uint32_t)MPU_Init->IsBufferable            << MPU_RASR_B_Pos)    |
 | 
			
		||||
              ((uint32_t)MPU_Init->SubRegionDisable        << MPU_RASR_SRD_Pos)  |
 | 
			
		||||
              ((uint32_t)MPU_Init->Size                    << MPU_RASR_SIZE_Pos) |
 | 
			
		||||
              ((uint32_t)MPU_Init->Enable                  << MPU_RASR_ENABLE_Pos);
 | 
			
		||||
}
 | 
			
		||||
#endif /* __MPU_PRESENT */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_CORTEX_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										1174
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_dma.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1174
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_dma.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										307
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_dma_ex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										307
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_dma_ex.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,307 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_dma_ex.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   DMA Extension HAL module driver
 | 
			
		||||
  *         This file provides firmware functions to manage the following
 | 
			
		||||
  *         functionalities of the DMA Extension peripheral:
 | 
			
		||||
  *           + Extended features functions
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                        ##### How to use this driver #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
  [..]
 | 
			
		||||
  The DMA Extension HAL driver can be used as follows:
 | 
			
		||||
 | 
			
		||||
   (+) Configure the DMA_MUX Synchronization Block using HAL_DMAEx_ConfigMuxSync function.
 | 
			
		||||
   (+) Configure the DMA_MUX Request Generator Block using HAL_DMAEx_ConfigMuxRequestGenerator function.
 | 
			
		||||
       Functions HAL_DMAEx_EnableMuxRequestGenerator and HAL_DMAEx_DisableMuxRequestGenerator can then be used
 | 
			
		||||
       to respectively enable/disable the request generator.
 | 
			
		||||
 | 
			
		||||
   (+) To handle the DMAMUX Interrupts, the function  HAL_DMAEx_MUX_IRQHandler should be called from
 | 
			
		||||
       the DMAMUX IRQ handler i.e DMAMUX1_OVR_IRQHandler.
 | 
			
		||||
       As only one interrupt line is available for all DMAMUX channels and request generators , HAL_DMAEx_MUX_IRQHandler should be
 | 
			
		||||
       called with, as parameter, the appropriate DMA handle as many as used DMAs in the user project
 | 
			
		||||
      (exception done if a given DMA is not using the DMAMUX SYNC block neither a request generator)
 | 
			
		||||
 | 
			
		||||
     -@-  In Memory-to-Memory transfer mode, Multi (Double) Buffer mode is not allowed.
 | 
			
		||||
     -@-  When Multi (Double) Buffer mode is enabled, the transfer is circular by default.
 | 
			
		||||
     -@-  In Multi (Double) buffer mode, it is possible to update the base address for
 | 
			
		||||
          the AHB memory port on the fly (DMA_CM0ARx or DMA_CM1ARx) when the channel is enabled.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
#if defined(DMAMUX1)
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup DMAEx DMAEx
 | 
			
		||||
  * @brief DMA Extended HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_DMA_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private define ------------------------------------------------------------*/
 | 
			
		||||
/* Private macro -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private Constants ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/* Private functions ---------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/** @defgroup DMAEx_Exported_Functions DMAEx Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup DMAEx_Exported_Functions_Group1 DMAEx Extended features functions
 | 
			
		||||
 *  @brief   Extended features functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                #####  Extended features functions  #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]  This section provides functions allowing to:
 | 
			
		||||
 | 
			
		||||
    (+) Configure the DMAMUX Synchronization Block using HAL_DMAEx_ConfigMuxSync function.
 | 
			
		||||
    (+) Configure the DMAMUX Request Generator Block using HAL_DMAEx_ConfigMuxRequestGenerator function.
 | 
			
		||||
       Functions HAL_DMAEx_EnableMuxRequestGenerator and HAL_DMAEx_DisableMuxRequestGenerator can then be used
 | 
			
		||||
       to respectively enable/disable the request generator.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure the DMAMUX synchronization parameters for a given DMA channel (instance).
 | 
			
		||||
  * @param  hdma pointer to a DMA_HandleTypeDef structure that contains
 | 
			
		||||
  *              the configuration information for the specified DMA channel.
 | 
			
		||||
  * @param  pSyncConfig : pointer to HAL_DMA_MuxSyncConfigTypeDef : contains the DMAMUX synchronization parameters
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_DMAEx_ConfigMuxSync(DMA_HandleTypeDef *hdma, HAL_DMA_MuxSyncConfigTypeDef *pSyncConfig)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 | 
			
		||||
 | 
			
		||||
  assert_param(IS_DMAMUX_SYNC_SIGNAL_ID(pSyncConfig->SyncSignalID));
 | 
			
		||||
 | 
			
		||||
  assert_param(IS_DMAMUX_SYNC_POLARITY(pSyncConfig-> SyncPolarity));
 | 
			
		||||
  assert_param(IS_DMAMUX_SYNC_STATE(pSyncConfig->SyncEnable));
 | 
			
		||||
  assert_param(IS_DMAMUX_SYNC_EVENT(pSyncConfig->EventEnable));
 | 
			
		||||
  assert_param(IS_DMAMUX_SYNC_REQUEST_NUMBER(pSyncConfig->RequestNumber));
 | 
			
		||||
 | 
			
		||||
  /*Check if the DMA state is ready */
 | 
			
		||||
  if (hdma->State == HAL_DMA_STATE_READY)
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hdma);
 | 
			
		||||
 | 
			
		||||
    /* Set the new synchronization parameters (and keep the request ID filled during the Init)*/
 | 
			
		||||
    MODIFY_REG(hdma->DMAmuxChannel->CCR, \
 | 
			
		||||
               (~DMAMUX_CxCR_DMAREQ_ID), \
 | 
			
		||||
               ((pSyncConfig->SyncSignalID) << DMAMUX_CxCR_SYNC_ID_Pos) | ((pSyncConfig->RequestNumber - 1U) << DMAMUX_CxCR_NBREQ_Pos) | \
 | 
			
		||||
               pSyncConfig->SyncPolarity | ((uint32_t)pSyncConfig->SyncEnable << DMAMUX_CxCR_SE_Pos) | \
 | 
			
		||||
               ((uint32_t)pSyncConfig->EventEnable << DMAMUX_CxCR_EGE_Pos));
 | 
			
		||||
 | 
			
		||||
    /* Process UnLocked */
 | 
			
		||||
    __HAL_UNLOCK(hdma);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    /*DMA State not Ready*/
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure the DMAMUX request generator block used by the given DMA channel (instance).
 | 
			
		||||
  * @param  hdma pointer to a DMA_HandleTypeDef structure that contains
 | 
			
		||||
  *              the configuration information for the specified DMA channel.
 | 
			
		||||
  * @param  pRequestGeneratorConfig : pointer to HAL_DMA_MuxRequestGeneratorConfigTypeDef :
 | 
			
		||||
  *         contains the request generator parameters.
 | 
			
		||||
  *
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_DMAEx_ConfigMuxRequestGenerator(DMA_HandleTypeDef *hdma, HAL_DMA_MuxRequestGeneratorConfigTypeDef *pRequestGeneratorConfig)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 | 
			
		||||
 | 
			
		||||
  assert_param(IS_DMAMUX_REQUEST_GEN_SIGNAL_ID(pRequestGeneratorConfig->SignalID));
 | 
			
		||||
 | 
			
		||||
  assert_param(IS_DMAMUX_REQUEST_GEN_POLARITY(pRequestGeneratorConfig->Polarity));
 | 
			
		||||
  assert_param(IS_DMAMUX_REQUEST_GEN_REQUEST_NUMBER(pRequestGeneratorConfig->RequestNumber));
 | 
			
		||||
 | 
			
		||||
  /* check if the DMA state is ready
 | 
			
		||||
     and DMA is using a DMAMUX request generator block
 | 
			
		||||
  */
 | 
			
		||||
  if ((hdma->State == HAL_DMA_STATE_READY) && (hdma->DMAmuxRequestGen != 0U))
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hdma);
 | 
			
		||||
 | 
			
		||||
    /* Set the request generator new parameters */
 | 
			
		||||
    hdma->DMAmuxRequestGen->RGCR = pRequestGeneratorConfig->SignalID | \
 | 
			
		||||
                                   ((pRequestGeneratorConfig->RequestNumber - 1U) << DMAMUX_RGxCR_GNBREQ_Pos) | \
 | 
			
		||||
                                   pRequestGeneratorConfig->Polarity;
 | 
			
		||||
    /* Process UnLocked */
 | 
			
		||||
    __HAL_UNLOCK(hdma);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable the DMAMUX request generator block used by the given DMA channel (instance).
 | 
			
		||||
  * @param  hdma pointer to a DMA_HandleTypeDef structure that contains
 | 
			
		||||
  *              the configuration information for the specified DMA channel.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_DMAEx_EnableMuxRequestGenerator(DMA_HandleTypeDef *hdma)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 | 
			
		||||
 | 
			
		||||
  /* check if the DMA state is ready
 | 
			
		||||
     and DMA is using a DMAMUX request generator block
 | 
			
		||||
  */
 | 
			
		||||
  if ((hdma->State != HAL_DMA_STATE_RESET) && (hdma->DMAmuxRequestGen != 0))
 | 
			
		||||
  {
 | 
			
		||||
 | 
			
		||||
    /* Enable the request generator*/
 | 
			
		||||
    hdma->DMAmuxRequestGen->RGCR |= DMAMUX_RGxCR_GE;
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable the DMAMUX request generator block used by the given DMA channel (instance).
 | 
			
		||||
  * @param  hdma pointer to a DMA_HandleTypeDef structure that contains
 | 
			
		||||
  *              the configuration information for the specified DMA channel.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_DMAEx_DisableMuxRequestGenerator(DMA_HandleTypeDef *hdma)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 | 
			
		||||
 | 
			
		||||
  /* check if the DMA state is ready
 | 
			
		||||
     and DMA is using a DMAMUX request generator block
 | 
			
		||||
  */
 | 
			
		||||
  if ((hdma->State != HAL_DMA_STATE_RESET) && (hdma->DMAmuxRequestGen != 0))
 | 
			
		||||
  {
 | 
			
		||||
 | 
			
		||||
    /* Disable the request generator*/
 | 
			
		||||
    hdma->DMAmuxRequestGen->RGCR &= ~DMAMUX_RGxCR_GE;
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Handles DMAMUX interrupt request.
 | 
			
		||||
  * @param  hdma pointer to a DMA_HandleTypeDef structure that contains
 | 
			
		||||
  *              the configuration information for the specified DMA channel.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_DMAEx_MUX_IRQHandler(DMA_HandleTypeDef *hdma)
 | 
			
		||||
{
 | 
			
		||||
  /* Check for DMAMUX Synchronization overrun */
 | 
			
		||||
  if ((hdma->DMAmuxChannelStatus->CSR & hdma->DMAmuxChannelStatusMask) != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /* Disable the synchro overrun interrupt */
 | 
			
		||||
    hdma->DMAmuxChannel->CCR &= ~DMAMUX_CxCR_SOIE;
 | 
			
		||||
 | 
			
		||||
    /* Clear the DMAMUX synchro overrun flag */
 | 
			
		||||
    hdma->DMAmuxChannelStatus->CFR = hdma->DMAmuxChannelStatusMask;
 | 
			
		||||
 | 
			
		||||
    /* Update error code */
 | 
			
		||||
    hdma->ErrorCode |= HAL_DMA_ERROR_SYNC;
 | 
			
		||||
 | 
			
		||||
    if (hdma->XferErrorCallback != NULL)
 | 
			
		||||
    {
 | 
			
		||||
      /* Transfer error callback */
 | 
			
		||||
      hdma->XferErrorCallback(hdma);
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (hdma->DMAmuxRequestGen != 0)
 | 
			
		||||
  {
 | 
			
		||||
    /* if using a DMAMUX request generator block Check for DMAMUX request generator overrun */
 | 
			
		||||
    if ((hdma->DMAmuxRequestGenStatus->RGSR & hdma->DMAmuxRequestGenStatusMask) != 0U)
 | 
			
		||||
    {
 | 
			
		||||
      /* Disable the request gen overrun interrupt */
 | 
			
		||||
      hdma->DMAmuxRequestGen->RGCR &= ~DMAMUX_RGxCR_OIE;
 | 
			
		||||
 | 
			
		||||
      /* Clear the DMAMUX request generator overrun flag */
 | 
			
		||||
      hdma->DMAmuxRequestGenStatus->RGCFR = hdma->DMAmuxRequestGenStatusMask;
 | 
			
		||||
 | 
			
		||||
      /* Update error code */
 | 
			
		||||
      hdma->ErrorCode |= HAL_DMA_ERROR_REQGEN;
 | 
			
		||||
 | 
			
		||||
      if (hdma->XferErrorCallback != NULL)
 | 
			
		||||
      {
 | 
			
		||||
        /* Transfer error callback */
 | 
			
		||||
        hdma->XferErrorCallback(hdma);
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_DMA_MODULE_ENABLED */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* DMAMUX1 */
 | 
			
		||||
							
								
								
									
										638
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_exti.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										638
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_exti.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,638 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_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 "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_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
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
#define EXTI_MODE_OFFSET                    0x08u   /* 0x20: offset between MCU IMR/EMR registers */
 | 
			
		||||
#define EXTI_CONFIG_OFFSET                  0x08u   /* 0x20: offset between MCU Rising/Falling configuration registers */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* 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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t regval;
 | 
			
		||||
  uint32_t linepos;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* 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 register offset and line mask */
 | 
			
		||||
  offset = ((pExtiConfig->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  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 */
 | 
			
		||||
    regaddr = (&EXTI->RTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
    /* Mask or set line */
 | 
			
		||||
    if ((pExtiConfig->Trigger & EXTI_TRIGGER_RISING) != 0x00u)
 | 
			
		||||
    {
 | 
			
		||||
      regval |= maskline;
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      regval &= ~maskline;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* Store rising trigger mode */
 | 
			
		||||
    *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
    /* Configure falling trigger */
 | 
			
		||||
    regaddr = (&EXTI->FTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
    /* Mask or set line */
 | 
			
		||||
    if ((pExtiConfig->Trigger & EXTI_TRIGGER_FALLING) != 0x00u)
 | 
			
		||||
    {
 | 
			
		||||
      regval |= maskline;
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      regval &= ~maskline;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* Store falling trigger mode */
 | 
			
		||||
    *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
    /* 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 */
 | 
			
		||||
  regaddr = (&EXTI->IMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
  /* Mask or set line */
 | 
			
		||||
  if ((pExtiConfig->Mode & EXTI_MODE_INTERRUPT) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    regval |= maskline;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    regval &= ~maskline;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Store interrupt mode */
 | 
			
		||||
  *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
  /* The event mode cannot be configured if the line does not support it */
 | 
			
		||||
  assert_param(((pExtiConfig->Line & EXTI_EVENT) == EXTI_EVENT) || ((pExtiConfig->Mode & EXTI_MODE_EVENT) != EXTI_MODE_EVENT));
 | 
			
		||||
 | 
			
		||||
  /* Configure event mode : read current mode */
 | 
			
		||||
  regaddr = (&EXTI->EMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
  /* Mask or set line */
 | 
			
		||||
  if ((pExtiConfig->Mode & EXTI_MODE_EVENT) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    regval |= maskline;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    regval &= ~maskline;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Store event mode */
 | 
			
		||||
  *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
  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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t regval;
 | 
			
		||||
  uint32_t linepos;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* 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 register offset and line mask */
 | 
			
		||||
  offset = ((pExtiConfig->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  linepos = (pExtiConfig->Line & EXTI_PIN_MASK);
 | 
			
		||||
  maskline = (1uL << linepos);
 | 
			
		||||
 | 
			
		||||
  /* 1] Get core mode : interrupt */
 | 
			
		||||
  regaddr = (&EXTI->IMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
  /* Check if selected line is enable */
 | 
			
		||||
  if ((regval & maskline) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    pExtiConfig->Mode = EXTI_MODE_INTERRUPT;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    pExtiConfig->Mode = EXTI_MODE_NONE;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Get event mode */
 | 
			
		||||
  regaddr = (&EXTI->EMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
  /* Check if selected line is enable */
 | 
			
		||||
  if ((regval & 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)
 | 
			
		||||
  {
 | 
			
		||||
    regaddr = (&EXTI->RTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
    /* Check if configuration of selected line is enable */
 | 
			
		||||
    if ((regval & maskline) != 0x00u)
 | 
			
		||||
    {
 | 
			
		||||
      pExtiConfig->Trigger = EXTI_TRIGGER_RISING;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* Get falling configuration */
 | 
			
		||||
    regaddr = (&EXTI->FTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = *regaddr;
 | 
			
		||||
 | 
			
		||||
    /* Check if configuration of selected line is enable */
 | 
			
		||||
    if ((regval & 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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t regval;
 | 
			
		||||
  uint32_t linepos;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* Check null pointer */
 | 
			
		||||
  if (hexti == NULL)
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Check the parameter */
 | 
			
		||||
  assert_param(IS_EXTI_LINE(hexti->Line));
 | 
			
		||||
 | 
			
		||||
  /* compute line register offset and line mask */
 | 
			
		||||
  offset = ((hexti->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  linepos = (hexti->Line & EXTI_PIN_MASK);
 | 
			
		||||
  maskline = (1uL << linepos);
 | 
			
		||||
 | 
			
		||||
  /* 1] Clear interrupt mode */
 | 
			
		||||
  regaddr = (&EXTI->IMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = (*regaddr & ~maskline);
 | 
			
		||||
  *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
  /* 2] Clear event mode */
 | 
			
		||||
  regaddr = (&EXTI->EMR1 + (EXTI_MODE_OFFSET * offset));
 | 
			
		||||
  regval = (*regaddr & ~maskline);
 | 
			
		||||
  *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
  /* 3] Clear triggers in case of configurable lines */
 | 
			
		||||
  if ((hexti->Line & EXTI_CONFIG) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    regaddr = (&EXTI->RTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = (*regaddr & ~maskline);
 | 
			
		||||
    *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
    regaddr = (&EXTI->FTSR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
    regval = (*regaddr & ~maskline);
 | 
			
		||||
    *regaddr = regval;
 | 
			
		||||
 | 
			
		||||
    /* 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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t regval;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* Compute line register offset and line mask */
 | 
			
		||||
  offset = ((hexti->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
 | 
			
		||||
 | 
			
		||||
  /* Get pending bit  */
 | 
			
		||||
  regaddr = (&EXTI->PR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
  regval = (*regaddr & maskline);
 | 
			
		||||
 | 
			
		||||
  if (regval != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    /* Clear pending bit */
 | 
			
		||||
    *regaddr = 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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t regval;
 | 
			
		||||
  uint32_t linepos;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* Prevent unused argument(s) compilation warning */
 | 
			
		||||
  UNUSED(Edge);
 | 
			
		||||
 | 
			
		||||
  /* 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 register offset and line mask */
 | 
			
		||||
  offset = ((hexti->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  linepos = (hexti->Line & EXTI_PIN_MASK);
 | 
			
		||||
  maskline = (1uL << linepos);
 | 
			
		||||
 | 
			
		||||
  /* Get pending bit */
 | 
			
		||||
  regaddr = (&EXTI->PR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
 | 
			
		||||
  /* return 1 if bit is set else 0 */
 | 
			
		||||
  regval = ((*regaddr & 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)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* Prevent unused argument(s) compilation warning */
 | 
			
		||||
  UNUSED(Edge);
 | 
			
		||||
 | 
			
		||||
  /* 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 register offset and line mask */
 | 
			
		||||
  offset = ((hexti->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
 | 
			
		||||
 | 
			
		||||
  /* Get pending register address */
 | 
			
		||||
  regaddr = (&EXTI->PR1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
 | 
			
		||||
  /* Clear Pending bit */
 | 
			
		||||
  *regaddr =  maskline;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Generate a software interrupt for a dedicated line.
 | 
			
		||||
  * @param  hexti Exti handle.
 | 
			
		||||
  * @retval None.
 | 
			
		||||
  */
 | 
			
		||||
void HAL_EXTI_GenerateSWI(EXTI_HandleTypeDef *hexti)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t *regaddr;
 | 
			
		||||
  uint32_t maskline;
 | 
			
		||||
  uint32_t offset;
 | 
			
		||||
 | 
			
		||||
  /* Check parameters */
 | 
			
		||||
  assert_param(IS_EXTI_LINE(hexti->Line));
 | 
			
		||||
  assert_param(IS_EXTI_CONFIG_LINE(hexti->Line));
 | 
			
		||||
 | 
			
		||||
  /* compute line register offset and line mask */
 | 
			
		||||
  offset = ((hexti->Line & EXTI_REG_MASK) >> EXTI_REG_SHIFT);
 | 
			
		||||
  maskline = (1uL << (hexti->Line & EXTI_PIN_MASK));
 | 
			
		||||
 | 
			
		||||
  regaddr = (&EXTI->SWIER1 + (EXTI_CONFIG_OFFSET * offset));
 | 
			
		||||
  *regaddr = maskline;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_EXTI_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										764
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										764
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,764 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_flash.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   FLASH HAL module driver.
 | 
			
		||||
  *          This file provides firmware functions to manage the following
 | 
			
		||||
  *          functionalities of the internal FLASH memory:
 | 
			
		||||
  *           + Program operations functions
 | 
			
		||||
  *           + Memory Control functions
 | 
			
		||||
  *           + Peripheral Errors functions
 | 
			
		||||
  *
 | 
			
		||||
 @verbatim
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                        ##### FLASH peripheral features #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
 | 
			
		||||
  [..] The Flash memory interface manages CPU AHB I-Code and D-Code accesses
 | 
			
		||||
       to the Flash memory. It implements the erase and program Flash memory operations
 | 
			
		||||
       and the read and write protection mechanisms.
 | 
			
		||||
 | 
			
		||||
  [..] The Flash memory interface accelerates code execution with a system of instruction
 | 
			
		||||
       prefetch and cache lines.
 | 
			
		||||
 | 
			
		||||
  [..] The FLASH main features are:
 | 
			
		||||
      (+) Flash memory read operations
 | 
			
		||||
      (+) Flash memory program/erase operations
 | 
			
		||||
      (+) Read / write protections
 | 
			
		||||
      (+) Option bytes programming
 | 
			
		||||
      (+) Prefetch on I-Code
 | 
			
		||||
      (+) 32 cache lines of 4*64 bits on I-Code
 | 
			
		||||
      (+) 8 cache lines of 4*64 bits on D-Code
 | 
			
		||||
      (+) Error code correction (ECC) : Data in flash are 72-bits word
 | 
			
		||||
          (8 bits added per double word)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
                        ##### How to use this driver #####
 | 
			
		||||
 ==============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
      This driver provides functions and macros to configure and program the FLASH
 | 
			
		||||
      memory of all STM32L4xx devices.
 | 
			
		||||
 | 
			
		||||
      (#) Flash Memory IO Programming functions:
 | 
			
		||||
           (++) Lock and Unlock the FLASH interface using HAL_FLASH_Unlock() and
 | 
			
		||||
                HAL_FLASH_Lock() functions
 | 
			
		||||
           (++) Program functions: double word and fast program (full row programming)
 | 
			
		||||
           (++) There Two modes of programming :
 | 
			
		||||
            (+++) Polling mode using HAL_FLASH_Program() function
 | 
			
		||||
            (+++) Interrupt mode using HAL_FLASH_Program_IT() function
 | 
			
		||||
 | 
			
		||||
      (#) Interrupts and flags management functions :
 | 
			
		||||
           (++) Handle FLASH interrupts by calling HAL_FLASH_IRQHandler()
 | 
			
		||||
           (++) Callback functions are called when the flash operations are finished :
 | 
			
		||||
                HAL_FLASH_EndOfOperationCallback() when everything is ok, otherwise
 | 
			
		||||
                HAL_FLASH_OperationErrorCallback()
 | 
			
		||||
           (++) Get error flag status by calling HAL_GetError()
 | 
			
		||||
 | 
			
		||||
      (#) Option bytes management functions :
 | 
			
		||||
           (++) Lock and Unlock the option bytes using HAL_FLASH_OB_Unlock() and
 | 
			
		||||
                HAL_FLASH_OB_Lock() functions
 | 
			
		||||
           (++) Launch the reload of the option bytes using HAL_FLASH_Launch() function.
 | 
			
		||||
                In this case, a reset is generated
 | 
			
		||||
 | 
			
		||||
    [..]
 | 
			
		||||
      In addition to these functions, this driver includes a set of macros allowing
 | 
			
		||||
      to handle the following operations:
 | 
			
		||||
       (+) Set the latency
 | 
			
		||||
       (+) Enable/Disable the prefetch buffer
 | 
			
		||||
       (+) Enable/Disable the Instruction cache and the Data cache
 | 
			
		||||
       (+) Reset the Instruction cache and the Data cache
 | 
			
		||||
       (+) Enable/Disable the Flash power-down during low-power run and sleep modes
 | 
			
		||||
       (+) Enable/Disable the Flash interrupts
 | 
			
		||||
       (+) Monitor the Flash flags status
 | 
			
		||||
 | 
			
		||||
 @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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.
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH FLASH
 | 
			
		||||
  * @brief FLASH HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_FLASH_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private defines -----------------------------------------------------------*/
 | 
			
		||||
#if defined (STM32L4P5xx) || defined (STM32L4Q5xx) || defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined (STM32L4S9xx)
 | 
			
		||||
#define FLASH_NB_DOUBLE_WORDS_IN_ROW  64
 | 
			
		||||
#else
 | 
			
		||||
#define FLASH_NB_DOUBLE_WORDS_IN_ROW  32
 | 
			
		||||
#endif
 | 
			
		||||
/* Private macros ------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/** @defgroup FLASH_Private_Variables FLASH Private Variables
 | 
			
		||||
 * @{
 | 
			
		||||
 */
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Variable used for Program/Erase sectors under interruption
 | 
			
		||||
  */
 | 
			
		||||
FLASH_ProcessTypeDef pFlash = {.Lock = HAL_UNLOCKED, \
 | 
			
		||||
                               .ErrorCode = HAL_FLASH_ERROR_NONE, \
 | 
			
		||||
                               .ProcedureOnGoing = FLASH_PROC_NONE, \
 | 
			
		||||
                               .Address = 0U, \
 | 
			
		||||
                               .Bank = FLASH_BANK_1, \
 | 
			
		||||
                               .Page = 0U, \
 | 
			
		||||
                               .NbPagesToErase = 0U, \
 | 
			
		||||
                               .CacheToReactivate = FLASH_CACHE_DISABLED};
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/** @defgroup FLASH_Private_Functions FLASH Private Functions
 | 
			
		||||
 * @{
 | 
			
		||||
 */
 | 
			
		||||
static void          FLASH_Program_DoubleWord(uint32_t Address, uint64_t Data);
 | 
			
		||||
static void          FLASH_Program_Fast(uint32_t Address, uint32_t DataAddress);
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Exported functions --------------------------------------------------------*/
 | 
			
		||||
/** @defgroup FLASH_Exported_Functions FLASH Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_Exported_Functions_Group1 Programming operation functions
 | 
			
		||||
 *  @brief   Programming operation functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                  ##### Programming operation functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    This subsection provides a set of functions allowing to manage the FLASH
 | 
			
		||||
    program operations.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Program double word or fast program of a row at a specified address.
 | 
			
		||||
  * @param  TypeProgram  Indicate the way to program at a specified address.
 | 
			
		||||
  *                           This parameter can be a value of @ref FLASH_Type_Program
 | 
			
		||||
  * @param  Address  specifies the address to be programmed.
 | 
			
		||||
  * @param  Data specifies the data to be programmed
 | 
			
		||||
  *                This parameter is the data for the double word program and the address where
 | 
			
		||||
  *                are stored the data for the row fast program
 | 
			
		||||
  *
 | 
			
		||||
  * @retval HAL_StatusTypeDef HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef status;
 | 
			
		||||
  uint32_t prog_bit = 0;
 | 
			
		||||
 | 
			
		||||
  /* Process Locked */
 | 
			
		||||
  __HAL_LOCK(&pFlash);
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
 | 
			
		||||
 | 
			
		||||
  /* Wait for last operation to be completed */
 | 
			
		||||
  status = FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE);
 | 
			
		||||
 | 
			
		||||
  if(status == HAL_OK)
 | 
			
		||||
  {
 | 
			
		||||
    pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
 | 
			
		||||
 | 
			
		||||
    /* Deactivate the data cache if they are activated to avoid data misbehavior */
 | 
			
		||||
    if(READ_BIT(FLASH->ACR, FLASH_ACR_DCEN) != 0U)
 | 
			
		||||
    {
 | 
			
		||||
      /* Disable data cache  */
 | 
			
		||||
      __HAL_FLASH_DATA_CACHE_DISABLE();
 | 
			
		||||
      pFlash.CacheToReactivate = FLASH_CACHE_DCACHE_ENABLED;
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      pFlash.CacheToReactivate = FLASH_CACHE_DISABLED;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if(TypeProgram == FLASH_TYPEPROGRAM_DOUBLEWORD)
 | 
			
		||||
    {
 | 
			
		||||
      /* Program double-word (64-bit) at a specified address */
 | 
			
		||||
      FLASH_Program_DoubleWord(Address, Data);
 | 
			
		||||
      prog_bit = FLASH_CR_PG;
 | 
			
		||||
    }
 | 
			
		||||
    else if((TypeProgram == FLASH_TYPEPROGRAM_FAST) || (TypeProgram == FLASH_TYPEPROGRAM_FAST_AND_LAST))
 | 
			
		||||
    {
 | 
			
		||||
      /* Fast program a 32 row double-word (64-bit) at a specified address */
 | 
			
		||||
      FLASH_Program_Fast(Address, (uint32_t)Data);
 | 
			
		||||
 | 
			
		||||
      /* If it is the last row, the bit will be cleared at the end of the operation */
 | 
			
		||||
      if(TypeProgram == FLASH_TYPEPROGRAM_FAST_AND_LAST)
 | 
			
		||||
      {
 | 
			
		||||
        prog_bit = FLASH_CR_FSTPG;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      /* Nothing to do */
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* Wait for last operation to be completed */
 | 
			
		||||
    status = FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE);
 | 
			
		||||
 | 
			
		||||
    /* If the program operation is completed, disable the PG or FSTPG Bit */
 | 
			
		||||
    if (prog_bit != 0U)
 | 
			
		||||
    {
 | 
			
		||||
      CLEAR_BIT(FLASH->CR, prog_bit);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* Flush the caches to be sure of the data consistency */
 | 
			
		||||
    FLASH_FlushCaches();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Process Unlocked */
 | 
			
		||||
  __HAL_UNLOCK(&pFlash);
 | 
			
		||||
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Program double word or fast program of a row at a specified address with interrupt enabled.
 | 
			
		||||
  * @param  TypeProgram  Indicate the way to program at a specified address.
 | 
			
		||||
  *                           This parameter can be a value of @ref FLASH_Type_Program
 | 
			
		||||
  * @param  Address  specifies the address to be programmed.
 | 
			
		||||
  * @param  Data specifies the data to be programmed
 | 
			
		||||
  *                This parameter is the data for the double word program and the address where
 | 
			
		||||
  *                are stored the data for the row fast program
 | 
			
		||||
  *
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef status = HAL_OK;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
 | 
			
		||||
 | 
			
		||||
  /* Process Locked */
 | 
			
		||||
  __HAL_LOCK(&pFlash);
 | 
			
		||||
 | 
			
		||||
  pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
 | 
			
		||||
 | 
			
		||||
  /* Deactivate the data cache if they are activated to avoid data misbehavior */
 | 
			
		||||
  if(READ_BIT(FLASH->ACR, FLASH_ACR_DCEN) != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /* Disable data cache  */
 | 
			
		||||
    __HAL_FLASH_DATA_CACHE_DISABLE();
 | 
			
		||||
    pFlash.CacheToReactivate = FLASH_CACHE_DCACHE_ENABLED;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    pFlash.CacheToReactivate = FLASH_CACHE_DISABLED;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Set internal variables used by the IRQ handler */
 | 
			
		||||
  if(TypeProgram == FLASH_TYPEPROGRAM_FAST_AND_LAST)
 | 
			
		||||
  {
 | 
			
		||||
    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAM_LAST;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAM;
 | 
			
		||||
  }
 | 
			
		||||
  pFlash.Address = Address;
 | 
			
		||||
 | 
			
		||||
  /* Enable End of Operation and Error interrupts */
 | 
			
		||||
  __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP | FLASH_IT_OPERR);
 | 
			
		||||
 | 
			
		||||
  if(TypeProgram == FLASH_TYPEPROGRAM_DOUBLEWORD)
 | 
			
		||||
  {
 | 
			
		||||
    /* Program double-word (64-bit) at a specified address */
 | 
			
		||||
    FLASH_Program_DoubleWord(Address, Data);
 | 
			
		||||
  }
 | 
			
		||||
  else if((TypeProgram == FLASH_TYPEPROGRAM_FAST) || (TypeProgram == FLASH_TYPEPROGRAM_FAST_AND_LAST))
 | 
			
		||||
  {
 | 
			
		||||
    /* Fast program a 32 row double-word (64-bit) at a specified address */
 | 
			
		||||
    FLASH_Program_Fast(Address, (uint32_t)Data);
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    /* Nothing to do */
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Handle FLASH interrupt request.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_FLASH_IRQHandler(void)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t tmp_page;
 | 
			
		||||
  uint32_t error;
 | 
			
		||||
  FLASH_ProcedureTypeDef procedure;
 | 
			
		||||
 | 
			
		||||
  /* If the operation is completed, disable the PG, PNB, MER1, MER2 and PER Bit */
 | 
			
		||||
  CLEAR_BIT(FLASH->CR, (FLASH_CR_PG | FLASH_CR_MER1 | FLASH_CR_PER | FLASH_CR_PNB));
 | 
			
		||||
#if defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || \
 | 
			
		||||
    defined (STM32L496xx) || defined (STM32L4A6xx) || \
 | 
			
		||||
    defined (STM32L4P5xx) || defined (STM32L4Q5xx) || \
 | 
			
		||||
    defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined (STM32L4S9xx)
 | 
			
		||||
  CLEAR_BIT(FLASH->CR, FLASH_CR_MER2);
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
  /* Disable the FSTPG Bit only if it is the last row programmed */
 | 
			
		||||
  if(pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAM_LAST)
 | 
			
		||||
  {
 | 
			
		||||
    CLEAR_BIT(FLASH->CR, FLASH_CR_FSTPG);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Check FLASH operation error flags */
 | 
			
		||||
  error = (FLASH->SR & FLASH_FLAG_SR_ERRORS);
 | 
			
		||||
 | 
			
		||||
  if (error !=0U)
 | 
			
		||||
  {
 | 
			
		||||
    /*Save the error code*/
 | 
			
		||||
    pFlash.ErrorCode |= error;
 | 
			
		||||
 | 
			
		||||
    /* Clear error programming flags */
 | 
			
		||||
    __HAL_FLASH_CLEAR_FLAG(error);
 | 
			
		||||
 | 
			
		||||
    /* Flush the caches to be sure of the data consistency */
 | 
			
		||||
    FLASH_FlushCaches() ;
 | 
			
		||||
 | 
			
		||||
    /* FLASH error interrupt user callback */
 | 
			
		||||
    procedure = pFlash.ProcedureOnGoing;
 | 
			
		||||
    if(procedure == FLASH_PROC_PAGE_ERASE)
 | 
			
		||||
    {
 | 
			
		||||
       HAL_FLASH_OperationErrorCallback(pFlash.Page);
 | 
			
		||||
    }
 | 
			
		||||
    else if(procedure == FLASH_PROC_MASS_ERASE)
 | 
			
		||||
    {
 | 
			
		||||
        HAL_FLASH_OperationErrorCallback(pFlash.Bank);
 | 
			
		||||
    }
 | 
			
		||||
    else if((procedure == FLASH_PROC_PROGRAM) ||
 | 
			
		||||
            (procedure == FLASH_PROC_PROGRAM_LAST))
 | 
			
		||||
    {
 | 
			
		||||
       HAL_FLASH_OperationErrorCallback(pFlash.Address);
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
       HAL_FLASH_OperationErrorCallback(0U);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /*Stop the procedure ongoing*/
 | 
			
		||||
    pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Check FLASH End of Operation flag  */
 | 
			
		||||
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP) != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /* Clear FLASH End of Operation pending bit */
 | 
			
		||||
    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
 | 
			
		||||
 | 
			
		||||
    if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGE_ERASE)
 | 
			
		||||
    {
 | 
			
		||||
      /* Nb of pages to erased can be decreased */
 | 
			
		||||
      pFlash.NbPagesToErase--;
 | 
			
		||||
 | 
			
		||||
      /* Check if there are still pages to erase*/
 | 
			
		||||
      if(pFlash.NbPagesToErase != 0U)
 | 
			
		||||
      {
 | 
			
		||||
        /* Indicate user which page has been erased*/
 | 
			
		||||
        HAL_FLASH_EndOfOperationCallback(pFlash.Page);
 | 
			
		||||
 | 
			
		||||
        /* Increment page number */
 | 
			
		||||
        pFlash.Page++;
 | 
			
		||||
        tmp_page = pFlash.Page;
 | 
			
		||||
        FLASH_PageErase(tmp_page, pFlash.Bank);
 | 
			
		||||
      }
 | 
			
		||||
      else
 | 
			
		||||
      {
 | 
			
		||||
        /* No more pages to Erase */
 | 
			
		||||
        /* Reset Address and stop Erase pages procedure */
 | 
			
		||||
        pFlash.Page = 0xFFFFFFFFU;
 | 
			
		||||
        pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
 | 
			
		||||
 | 
			
		||||
        /* Flush the caches to be sure of the data consistency */
 | 
			
		||||
        FLASH_FlushCaches() ;
 | 
			
		||||
 | 
			
		||||
        /* FLASH EOP interrupt user callback */
 | 
			
		||||
        HAL_FLASH_EndOfOperationCallback(pFlash.Page);
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    else
 | 
			
		||||
    {
 | 
			
		||||
      /* Flush the caches to be sure of the data consistency */
 | 
			
		||||
      FLASH_FlushCaches() ;
 | 
			
		||||
 | 
			
		||||
      procedure = pFlash.ProcedureOnGoing;
 | 
			
		||||
      if(procedure == FLASH_PROC_MASS_ERASE)
 | 
			
		||||
      {
 | 
			
		||||
        /* MassErase ended. Return the selected bank */
 | 
			
		||||
        /* FLASH EOP interrupt user callback */
 | 
			
		||||
        HAL_FLASH_EndOfOperationCallback(pFlash.Bank);
 | 
			
		||||
      }
 | 
			
		||||
      else if((procedure == FLASH_PROC_PROGRAM) ||
 | 
			
		||||
              (procedure == FLASH_PROC_PROGRAM_LAST))
 | 
			
		||||
      {
 | 
			
		||||
        /* Program ended. Return the selected address */
 | 
			
		||||
        /* FLASH EOP interrupt user callback */
 | 
			
		||||
        HAL_FLASH_EndOfOperationCallback(pFlash.Address);
 | 
			
		||||
      }
 | 
			
		||||
      else
 | 
			
		||||
      {
 | 
			
		||||
        /* Nothing to do */
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /*Clear the procedure ongoing*/
 | 
			
		||||
      pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if(pFlash.ProcedureOnGoing == FLASH_PROC_NONE)
 | 
			
		||||
  {
 | 
			
		||||
    /* Disable End of Operation and Error interrupts */
 | 
			
		||||
    __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP | FLASH_IT_OPERR);
 | 
			
		||||
 | 
			
		||||
    /* Process Unlocked */
 | 
			
		||||
    __HAL_UNLOCK(&pFlash);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  FLASH end of operation interrupt callback.
 | 
			
		||||
  * @param  ReturnValue The value saved in this parameter depends on the ongoing procedure
 | 
			
		||||
  *                  Mass Erase: Bank number which has been requested to erase
 | 
			
		||||
  *                  Page Erase: Page which has been erased
 | 
			
		||||
  *                    (if 0xFFFFFFFF, it means that all the selected pages have been erased)
 | 
			
		||||
  *                  Program: Address which was selected for data program
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue)
 | 
			
		||||
{
 | 
			
		||||
  /* Prevent unused argument(s) compilation warning */
 | 
			
		||||
  UNUSED(ReturnValue);
 | 
			
		||||
 | 
			
		||||
  /* NOTE : This function should not be modified, when the callback is needed,
 | 
			
		||||
            the HAL_FLASH_EndOfOperationCallback could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  FLASH operation error interrupt callback.
 | 
			
		||||
  * @param  ReturnValue The value saved in this parameter depends on the ongoing procedure
 | 
			
		||||
  *                 Mass Erase: Bank number which has been requested to erase
 | 
			
		||||
  *                 Page Erase: Page number which returned an error
 | 
			
		||||
  *                 Program: Address which was selected for data program
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue)
 | 
			
		||||
{
 | 
			
		||||
  /* Prevent unused argument(s) compilation warning */
 | 
			
		||||
  UNUSED(ReturnValue);
 | 
			
		||||
 | 
			
		||||
  /* NOTE : This function should not be modified, when the callback is needed,
 | 
			
		||||
            the HAL_FLASH_OperationErrorCallback could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_Exported_Functions_Group2 Peripheral Control functions
 | 
			
		||||
 *  @brief   Management functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### Peripheral Control functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    This subsection provides a set of functions allowing to control the FLASH
 | 
			
		||||
    memory operations.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Unlock the FLASH control register access.
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_Unlock(void)
 | 
			
		||||
{
 | 
			
		||||
  HAL_StatusTypeDef status = HAL_OK;
 | 
			
		||||
 | 
			
		||||
  if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /* Authorize the FLASH Registers access */
 | 
			
		||||
    WRITE_REG(FLASH->KEYR, FLASH_KEY1);
 | 
			
		||||
    WRITE_REG(FLASH->KEYR, FLASH_KEY2);
 | 
			
		||||
 | 
			
		||||
    /* Verify Flash is unlocked */
 | 
			
		||||
    if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != 0U)
 | 
			
		||||
    {
 | 
			
		||||
      status = HAL_ERROR;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Lock the FLASH control register access.
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_Lock(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set the LOCK Bit to lock the FLASH Registers access */
 | 
			
		||||
  SET_BIT(FLASH->CR, FLASH_CR_LOCK);
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Unlock the FLASH Option Bytes Registers access.
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void)
 | 
			
		||||
{
 | 
			
		||||
  if(READ_BIT(FLASH->CR, FLASH_CR_OPTLOCK) != 0U)
 | 
			
		||||
  {
 | 
			
		||||
    /* Authorizes the Option Byte register programming */
 | 
			
		||||
    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY1);
 | 
			
		||||
    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY2);
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Lock the FLASH Option Bytes Registers access.
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_OB_Lock(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set the OPTLOCK Bit to lock the FLASH Option Byte Registers access */
 | 
			
		||||
  SET_BIT(FLASH->CR, FLASH_CR_OPTLOCK);
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Launch the option byte loading.
 | 
			
		||||
  * @retval HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_FLASH_OB_Launch(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set the bit to force the option byte reloading */
 | 
			
		||||
  SET_BIT(FLASH->CR, FLASH_CR_OBL_LAUNCH);
 | 
			
		||||
 | 
			
		||||
  /* Wait for last operation to be completed */
 | 
			
		||||
  return(FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_Exported_Functions_Group3 Peripheral State and Errors functions
 | 
			
		||||
 *  @brief   Peripheral Errors functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                ##### Peripheral Errors functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    This subsection permits to get in run-time Errors of the FLASH peripheral.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Get the specific FLASH error flag.
 | 
			
		||||
  * @retval FLASH_ErrorCode: The returned value can be:
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_RD: FLASH Read Protection error flag (PCROP)
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PGS: FLASH Programming Sequence error flag
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PGP: FLASH Programming Parallelism error flag
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PGA: FLASH Programming Alignment error flag
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_WRP: FLASH Write protected error flag
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_OPERATION: FLASH operation Error flag
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_NONE: No error set
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_OP: FLASH Operation error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PROG: FLASH Programming error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_WRP: FLASH Write protection error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PGA: FLASH Programming alignment error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_SIZ: FLASH Size error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_PGS: FLASH Programming sequence error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_MIS: FLASH Fast programming data miss error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_FAST: FLASH Fast programming error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_RD: FLASH PCROP read error
 | 
			
		||||
  *            @arg HAL_FLASH_ERROR_OPTV: FLASH Option validity error
 | 
			
		||||
  *            @arg FLASH_FLAG_PEMPTY : FLASH Boot from not programmed flash (apply only for STM32L43x/STM32L44x devices)
 | 
			
		||||
  */
 | 
			
		||||
uint32_t HAL_FLASH_GetError(void)
 | 
			
		||||
{
 | 
			
		||||
   return pFlash.ErrorCode;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Private functions ---------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @addtogroup FLASH_Private_Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Wait for a FLASH operation to complete.
 | 
			
		||||
  * @param  Timeout maximum flash operation timeout
 | 
			
		||||
  * @retval HAL_StatusTypeDef HAL Status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout)
 | 
			
		||||
{
 | 
			
		||||
  /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
 | 
			
		||||
     Even if the FLASH operation fails, the BUSY flag will be reset and an error
 | 
			
		||||
     flag will be set */
 | 
			
		||||
 | 
			
		||||
  uint32_t tickstart = HAL_GetTick();
 | 
			
		||||
  uint32_t error;
 | 
			
		||||
 | 
			
		||||
  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY))
 | 
			
		||||
  {
 | 
			
		||||
    if(Timeout != HAL_MAX_DELAY)
 | 
			
		||||
    {
 | 
			
		||||
      if((HAL_GetTick() - tickstart) >= Timeout)
 | 
			
		||||
      {
 | 
			
		||||
        return HAL_TIMEOUT;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  error = (FLASH->SR & FLASH_FLAG_SR_ERRORS);
 | 
			
		||||
 | 
			
		||||
  if(error != 0u)
 | 
			
		||||
  {
 | 
			
		||||
    /*Save the error code*/
 | 
			
		||||
    pFlash.ErrorCode |= error;
 | 
			
		||||
 | 
			
		||||
    /* Clear error programming flags */
 | 
			
		||||
    __HAL_FLASH_CLEAR_FLAG(error);
 | 
			
		||||
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Check FLASH End of Operation flag  */
 | 
			
		||||
  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
 | 
			
		||||
  {
 | 
			
		||||
    /* Clear FLASH End of Operation pending bit */
 | 
			
		||||
    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* If there is an error flag set */
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Program double-word (64-bit) at a specified address.
 | 
			
		||||
  * @param  Address specifies the address to be programmed.
 | 
			
		||||
  * @param  Data specifies the data to be programmed.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
static void FLASH_Program_DoubleWord(uint32_t Address, uint64_t Data)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
 | 
			
		||||
 | 
			
		||||
  /* Set PG bit */
 | 
			
		||||
  SET_BIT(FLASH->CR, FLASH_CR_PG);
 | 
			
		||||
 | 
			
		||||
  /* Program first word */
 | 
			
		||||
  *(__IO uint32_t*)Address = (uint32_t)Data;
 | 
			
		||||
 | 
			
		||||
  /* Barrier to ensure programming is performed in 2 steps, in right order
 | 
			
		||||
    (independently of compiler optimization behavior) */
 | 
			
		||||
  __ISB();
 | 
			
		||||
 | 
			
		||||
  /* Program second word */
 | 
			
		||||
  *(__IO uint32_t*)(Address+4U) = (uint32_t)(Data >> 32);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Fast program a row double-word (64-bit) at a specified address.
 | 
			
		||||
  * @param  Address specifies the address to be programmed.
 | 
			
		||||
  * @param  DataAddress specifies the address where the data are stored.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
static void FLASH_Program_Fast(uint32_t Address, uint32_t DataAddress)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t primask_bit;
 | 
			
		||||
  uint8_t row_index = (2*FLASH_NB_DOUBLE_WORDS_IN_ROW);
 | 
			
		||||
  __IO uint32_t *dest_addr = (__IO uint32_t*)Address;
 | 
			
		||||
  __IO uint32_t *src_addr = (__IO uint32_t*)DataAddress;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_FLASH_MAIN_MEM_ADDRESS(Address));
 | 
			
		||||
 | 
			
		||||
  /* Set FSTPG bit */
 | 
			
		||||
  SET_BIT(FLASH->CR, FLASH_CR_FSTPG);
 | 
			
		||||
 | 
			
		||||
  /* Disable interrupts to avoid any interruption during the loop */
 | 
			
		||||
  primask_bit = __get_PRIMASK();
 | 
			
		||||
  __disable_irq();
 | 
			
		||||
 | 
			
		||||
  /* Program the double word of the row */
 | 
			
		||||
  do
 | 
			
		||||
  {
 | 
			
		||||
    *dest_addr = *src_addr;
 | 
			
		||||
    dest_addr++;
 | 
			
		||||
    src_addr++;
 | 
			
		||||
    row_index--;
 | 
			
		||||
  } while (row_index != 0U);
 | 
			
		||||
 | 
			
		||||
  /* Re-enable the interrupts */
 | 
			
		||||
  __set_PRIMASK(primask_bit);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_FLASH_MODULE_ENABLED */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										1316
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash_ex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1316
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash_ex.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										251
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash_ramfunc.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										251
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_flash_ramfunc.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,251 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_flash_ramfunc.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   FLASH RAMFUNC driver.
 | 
			
		||||
  *          This file provides a Flash firmware functions which should be
 | 
			
		||||
  *          executed from internal SRAM
 | 
			
		||||
  *            + FLASH HalfPage Programming
 | 
			
		||||
  *            + FLASH Power Down in Run mode
 | 
			
		||||
  *
 | 
			
		||||
  *  @verbatim
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                   ##### Flash RAM functions #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
 | 
			
		||||
    *** ARM Compiler ***
 | 
			
		||||
    --------------------
 | 
			
		||||
    [..] RAM functions are defined using the toolchain options.
 | 
			
		||||
         Functions that are executed in RAM should reside in a separate
 | 
			
		||||
         source module. Using the 'Options for File' dialog you can simply change
 | 
			
		||||
         the 'Code / Const' area of a module to a memory space in physical RAM.
 | 
			
		||||
         Available memory areas are declared in the 'Target' tab of the
 | 
			
		||||
         Options for Target' dialog.
 | 
			
		||||
 | 
			
		||||
    *** ICCARM Compiler ***
 | 
			
		||||
    -----------------------
 | 
			
		||||
    [..] RAM functions are defined using a specific toolchain keyword "__ramfunc".
 | 
			
		||||
 | 
			
		||||
    *** GNU Compiler ***
 | 
			
		||||
    --------------------
 | 
			
		||||
    [..] RAM functions are defined using a specific toolchain attribute
 | 
			
		||||
         "__attribute__((section(".RamFunc")))".
 | 
			
		||||
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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.
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_RAMFUNC FLASH_RAMFUNC
 | 
			
		||||
  * @brief FLASH functions executed from RAM
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_FLASH_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private define ------------------------------------------------------------*/
 | 
			
		||||
/* Private macro -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/* Exported functions -------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_RAMFUNC_Exported_Functions FLASH in RAM function Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup FLASH_RAMFUNC_Exported_Functions_Group1 Peripheral features functions
 | 
			
		||||
 *  @brief   Data transfers functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### ramfunc functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
    This subsection provides a set of functions that should be executed from RAM.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief   Enable the Power down in Run Mode
 | 
			
		||||
  * @note    This function should be called and executed from SRAM memory
 | 
			
		||||
  * @retval  HAL status
 | 
			
		||||
  */
 | 
			
		||||
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_EnableRunPowerDown(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Enable the Power Down in Run mode*/
 | 
			
		||||
  __HAL_FLASH_POWER_DOWN_ENABLE();
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief   Disable the Power down in Run Mode
 | 
			
		||||
  * @note    This function should be called and executed from SRAM memory
 | 
			
		||||
  * @retval  HAL status
 | 
			
		||||
  */
 | 
			
		||||
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_DisableRunPowerDown(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Disable the Power Down in Run mode*/
 | 
			
		||||
  __HAL_FLASH_POWER_DOWN_DISABLE();
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
#if defined (STM32L4P5xx) || defined (STM32L4Q5xx) || defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined (STM32L4S9xx)
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Program the FLASH DBANK User Option Byte.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   To configure the user option bytes, the option lock bit OPTLOCK must
 | 
			
		||||
  *         be cleared with the call of the HAL_FLASH_OB_Unlock() function.
 | 
			
		||||
  * @note   To modify the DBANK option byte, no PCROP region should be defined.
 | 
			
		||||
  *         To deactivate PCROP, user should perform RDP changing
 | 
			
		||||
  *
 | 
			
		||||
  * @param  DBankConfig The FLASH DBANK User Option Byte value.
 | 
			
		||||
  *          This parameter  can be one of the following values:
 | 
			
		||||
  *            @arg OB_DBANK_128_BITS: Single-bank with 128-bits data
 | 
			
		||||
  *            @arg OB_DBANK_64_BITS: Dual-bank with 64-bits data
 | 
			
		||||
  *
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_OB_DBankConfig(uint32_t DBankConfig)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t count, reg;
 | 
			
		||||
  HAL_StatusTypeDef status = HAL_ERROR;
 | 
			
		||||
 | 
			
		||||
  /* Process Locked */
 | 
			
		||||
  __HAL_LOCK(&pFlash);
 | 
			
		||||
 | 
			
		||||
  /* Check if the PCROP is disabled */
 | 
			
		||||
  reg = FLASH->PCROP1SR;
 | 
			
		||||
  if (reg > FLASH->PCROP1ER)
 | 
			
		||||
  {
 | 
			
		||||
    reg = FLASH->PCROP2SR;
 | 
			
		||||
    if (reg > FLASH->PCROP2ER)
 | 
			
		||||
    {
 | 
			
		||||
      /* Disable Flash prefetch */
 | 
			
		||||
      __HAL_FLASH_PREFETCH_BUFFER_DISABLE();
 | 
			
		||||
 | 
			
		||||
      if (READ_BIT(FLASH->ACR, FLASH_ACR_ICEN) != 0U)
 | 
			
		||||
      {
 | 
			
		||||
        /* Disable Flash instruction cache */
 | 
			
		||||
        __HAL_FLASH_INSTRUCTION_CACHE_DISABLE();
 | 
			
		||||
 | 
			
		||||
        /* Flush Flash instruction cache */
 | 
			
		||||
        __HAL_FLASH_INSTRUCTION_CACHE_RESET();
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      if (READ_BIT(FLASH->ACR, FLASH_ACR_DCEN) != 0U)
 | 
			
		||||
      {
 | 
			
		||||
        /* Disable Flash data cache */
 | 
			
		||||
        __HAL_FLASH_DATA_CACHE_DISABLE();
 | 
			
		||||
 | 
			
		||||
        /* Flush Flash data cache */
 | 
			
		||||
        __HAL_FLASH_DATA_CACHE_RESET();
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Disable WRP zone 1 of 1st bank if needed */
 | 
			
		||||
      reg = FLASH->WRP1AR;
 | 
			
		||||
      if (((reg & FLASH_WRP1AR_WRP1A_STRT) >> FLASH_WRP1AR_WRP1A_STRT_Pos) <=
 | 
			
		||||
          ((reg & FLASH_WRP1AR_WRP1A_END) >> FLASH_WRP1AR_WRP1A_END_Pos))
 | 
			
		||||
      {
 | 
			
		||||
        MODIFY_REG(FLASH->WRP1AR, (FLASH_WRP1AR_WRP1A_STRT | FLASH_WRP1AR_WRP1A_END), FLASH_WRP1AR_WRP1A_STRT);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Disable WRP zone 2 of 1st bank if needed */
 | 
			
		||||
      reg = FLASH->WRP1BR;
 | 
			
		||||
      if (((reg & FLASH_WRP1BR_WRP1B_STRT) >> FLASH_WRP1BR_WRP1B_STRT_Pos) <=
 | 
			
		||||
          ((reg & FLASH_WRP1BR_WRP1B_END) >> FLASH_WRP1BR_WRP1B_END_Pos))
 | 
			
		||||
      {
 | 
			
		||||
        MODIFY_REG(FLASH->WRP1BR, (FLASH_WRP1BR_WRP1B_STRT | FLASH_WRP1BR_WRP1B_END), FLASH_WRP1BR_WRP1B_STRT);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Disable WRP zone 1 of 2nd bank if needed */
 | 
			
		||||
      reg = FLASH->WRP2AR;
 | 
			
		||||
      if (((reg & FLASH_WRP2AR_WRP2A_STRT) >> FLASH_WRP2AR_WRP2A_STRT_Pos) <=
 | 
			
		||||
          ((reg & FLASH_WRP2AR_WRP2A_END) >> FLASH_WRP2AR_WRP2A_END_Pos))
 | 
			
		||||
      {
 | 
			
		||||
        MODIFY_REG(FLASH->WRP2AR, (FLASH_WRP2AR_WRP2A_STRT | FLASH_WRP2AR_WRP2A_END), FLASH_WRP2AR_WRP2A_STRT);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Disable WRP zone 2 of 2nd bank if needed */
 | 
			
		||||
      reg = FLASH->WRP2BR;
 | 
			
		||||
      if (((reg & FLASH_WRP2BR_WRP2B_STRT) >> FLASH_WRP2BR_WRP2B_STRT_Pos) <=
 | 
			
		||||
          ((reg & FLASH_WRP2BR_WRP2B_END) >> FLASH_WRP2BR_WRP2B_END_Pos))
 | 
			
		||||
      {
 | 
			
		||||
        MODIFY_REG(FLASH->WRP2BR, (FLASH_WRP2BR_WRP2B_STRT | FLASH_WRP2BR_WRP2B_END), FLASH_WRP2BR_WRP2B_STRT);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Modify the DBANK user option byte */
 | 
			
		||||
      MODIFY_REG(FLASH->OPTR, FLASH_OPTR_DBANK, DBankConfig);
 | 
			
		||||
 | 
			
		||||
      /* Set OPTSTRT Bit */
 | 
			
		||||
      SET_BIT(FLASH->CR, FLASH_CR_OPTSTRT);
 | 
			
		||||
 | 
			
		||||
      /* Wait for last operation to be completed */
 | 
			
		||||
      /* 8 is the number of required instruction cycles for the below loop statement (timeout expressed in ms) */
 | 
			
		||||
      count = FLASH_TIMEOUT_VALUE * (SystemCoreClock / 8U / 1000U);
 | 
			
		||||
      do
 | 
			
		||||
      {
 | 
			
		||||
        if (count == 0U)
 | 
			
		||||
        {
 | 
			
		||||
          break;
 | 
			
		||||
        }
 | 
			
		||||
        count--;
 | 
			
		||||
      } while (__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY) != RESET);
 | 
			
		||||
 | 
			
		||||
      /* If the option byte program operation is completed, disable the OPTSTRT Bit */
 | 
			
		||||
      CLEAR_BIT(FLASH->CR, FLASH_CR_OPTSTRT);
 | 
			
		||||
 | 
			
		||||
      /* Set the bit to force the option byte reloading */
 | 
			
		||||
      SET_BIT(FLASH->CR, FLASH_CR_OBL_LAUNCH);
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Process Unlocked */
 | 
			
		||||
  __HAL_UNLOCK(&pFlash);
 | 
			
		||||
 | 
			
		||||
  return status;
 | 
			
		||||
}
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
#endif /* HAL_FLASH_MODULE_ENABLED */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										551
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_gpio.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										551
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_gpio.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,551 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_gpio.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   GPIO HAL module driver.
 | 
			
		||||
  *          This file provides firmware functions to manage the following
 | 
			
		||||
  *          functionalities of the General Purpose Input/Output (GPIO) peripheral:
 | 
			
		||||
  *           + Initialization and de-initialization functions
 | 
			
		||||
  *           + IO operation functions
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
                    ##### GPIO Peripheral features #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
  [..]
 | 
			
		||||
    (+) Each port bit of the general-purpose I/O (GPIO) ports can be individually
 | 
			
		||||
        configured by software in several modes:
 | 
			
		||||
        (++) Input mode
 | 
			
		||||
        (++) Analog mode
 | 
			
		||||
        (++) Output mode
 | 
			
		||||
        (++) Alternate function mode
 | 
			
		||||
        (++) External interrupt/event lines
 | 
			
		||||
 | 
			
		||||
    (+) During and just after reset, the alternate functions and external interrupt
 | 
			
		||||
        lines are not active and the I/O ports are configured in input floating mode.
 | 
			
		||||
 | 
			
		||||
    (+) All GPIO pins have weak internal pull-up and pull-down resistors, which can be
 | 
			
		||||
        activated or not.
 | 
			
		||||
 | 
			
		||||
    (+) In Output or Alternate mode, each IO can be configured on open-drain or push-pull
 | 
			
		||||
        type and the IO speed can be selected depending on the VDD value.
 | 
			
		||||
 | 
			
		||||
    (+) The microcontroller IO pins are connected to onboard peripherals/modules through a
 | 
			
		||||
        multiplexer that allows only one peripheral alternate function (AF) connected
 | 
			
		||||
       to an IO pin at a time. In this way, there can be no conflict between peripherals
 | 
			
		||||
       sharing the same IO pin.
 | 
			
		||||
 | 
			
		||||
    (+) All ports have external interrupt/event capability. To use external interrupt
 | 
			
		||||
        lines, the port must be configured in input mode. All available GPIO pins are
 | 
			
		||||
        connected to the 16 external interrupt/event lines from EXTI0 to EXTI15.
 | 
			
		||||
 | 
			
		||||
    (+) The external interrupt/event controller consists of up to 39 edge detectors
 | 
			
		||||
        (16 lines are connected to GPIO) for generating event/interrupt requests (each
 | 
			
		||||
        input line can be independently configured to select the type (interrupt or event)
 | 
			
		||||
        and the corresponding trigger event (rising or falling or both). Each line can
 | 
			
		||||
        also be masked independently.
 | 
			
		||||
 | 
			
		||||
                     ##### How to use this driver #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
  [..]
 | 
			
		||||
    (#) Enable the GPIO AHB clock using the following function: __HAL_RCC_GPIOx_CLK_ENABLE().
 | 
			
		||||
 | 
			
		||||
    (#) Configure the GPIO pin(s) using HAL_GPIO_Init().
 | 
			
		||||
        (++) Configure the IO mode using "Mode" member from GPIO_InitTypeDef structure
 | 
			
		||||
        (++) Activate Pull-up, Pull-down resistor using "Pull" member from GPIO_InitTypeDef
 | 
			
		||||
             structure.
 | 
			
		||||
        (++) In case of Output or alternate function mode selection: the speed is
 | 
			
		||||
             configured through "Speed" member from GPIO_InitTypeDef structure.
 | 
			
		||||
        (++) In alternate mode is selection, the alternate function connected to the IO
 | 
			
		||||
             is configured through "Alternate" member from GPIO_InitTypeDef structure.
 | 
			
		||||
        (++) Analog mode is required when a pin is to be used as ADC channel
 | 
			
		||||
             or DAC output.
 | 
			
		||||
        (++) In case of external interrupt/event selection the "Mode" member from
 | 
			
		||||
             GPIO_InitTypeDef structure select the type (interrupt or event) and
 | 
			
		||||
             the corresponding trigger event (rising or falling or both).
 | 
			
		||||
 | 
			
		||||
    (#) In case of external interrupt/event mode selection, configure NVIC IRQ priority
 | 
			
		||||
        mapped to the EXTI line using HAL_NVIC_SetPriority() and enable it using
 | 
			
		||||
        HAL_NVIC_EnableIRQ().
 | 
			
		||||
 | 
			
		||||
    (#) To get the level of a pin configured in input mode use HAL_GPIO_ReadPin().
 | 
			
		||||
 | 
			
		||||
    (#) To set/reset the level of a pin configured in output mode use
 | 
			
		||||
        HAL_GPIO_WritePin()/HAL_GPIO_TogglePin().
 | 
			
		||||
 | 
			
		||||
   (#) To lock pin configuration until next reset use HAL_GPIO_LockPin().
 | 
			
		||||
 | 
			
		||||
    (#) During and just after reset, the alternate functions are not
 | 
			
		||||
        active and the GPIO pins are configured in input floating mode (except JTAG
 | 
			
		||||
        pins).
 | 
			
		||||
 | 
			
		||||
    (#) The LSE oscillator pins OSC32_IN and OSC32_OUT can be used as general purpose
 | 
			
		||||
        (PC14 and PC15, respectively) when the LSE oscillator is off. The LSE has
 | 
			
		||||
        priority over the GPIO function.
 | 
			
		||||
 | 
			
		||||
    (#) The HSE oscillator pins OSC_IN/OSC_OUT can be used as
 | 
			
		||||
        general purpose PH0 and PH1, respectively, when the HSE oscillator is off.
 | 
			
		||||
        The HSE has priority over the GPIO function.
 | 
			
		||||
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup GPIO GPIO
 | 
			
		||||
  * @brief GPIO HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
/** MISRA C:2012 deviation rule has been granted for following rules:
 | 
			
		||||
  * Rule-12.2 - Medium: RHS argument is in interval [0,INF] which is out of
 | 
			
		||||
  * range of the shift operator in following API :
 | 
			
		||||
  * HAL_GPIO_Init
 | 
			
		||||
  * HAL_GPIO_DeInit
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_GPIO_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private defines -----------------------------------------------------------*/
 | 
			
		||||
/** @addtogroup GPIO_Private_Defines GPIO Private Defines
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
#define GPIO_NUMBER           (16u)
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Private macros ------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/* Exported functions --------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup GPIO_Exported_Functions GPIO Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup GPIO_Exported_Functions_Group1 Initialization/de-initialization functions
 | 
			
		||||
 *  @brief    Initialization and Configuration functions
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
              ##### Initialization and de-initialization functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Initialize the GPIOx peripheral according to the specified parameters in the GPIO_Init.
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Init pointer to a GPIO_InitTypeDef structure that contains
 | 
			
		||||
  *         the configuration information for the specified GPIO peripheral.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_GPIO_Init(GPIO_TypeDef  *GPIOx, GPIO_InitTypeDef *GPIO_Init)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t position = 0x00u;
 | 
			
		||||
  uint32_t iocurrent;
 | 
			
		||||
  uint32_t temp;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Init->Pin));
 | 
			
		||||
  assert_param(IS_GPIO_MODE(GPIO_Init->Mode));
 | 
			
		||||
 | 
			
		||||
  /* Configure the port pins */
 | 
			
		||||
  while (((GPIO_Init->Pin) >> position) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    /* Get current io position */
 | 
			
		||||
    iocurrent = (GPIO_Init->Pin) & (1uL << position);
 | 
			
		||||
 | 
			
		||||
    if (iocurrent != 0x00u)
 | 
			
		||||
    {
 | 
			
		||||
      /*--------------------- GPIO Mode Configuration ------------------------*/
 | 
			
		||||
      /* In case of Output or Alternate function mode selection */
 | 
			
		||||
      if (((GPIO_Init->Mode & GPIO_MODE) == MODE_OUTPUT) || ((GPIO_Init->Mode & GPIO_MODE) == MODE_AF))
 | 
			
		||||
      {
 | 
			
		||||
        /* Check the Speed parameter */
 | 
			
		||||
        assert_param(IS_GPIO_SPEED(GPIO_Init->Speed));
 | 
			
		||||
 | 
			
		||||
        /* Configure the IO Speed */
 | 
			
		||||
        temp = GPIOx->OSPEEDR;
 | 
			
		||||
        temp &= ~(GPIO_OSPEEDR_OSPEED0 << (position * 2u));
 | 
			
		||||
        temp |= (GPIO_Init->Speed << (position * 2u));
 | 
			
		||||
        GPIOx->OSPEEDR = temp;
 | 
			
		||||
 | 
			
		||||
        /* Configure the IO Output Type */
 | 
			
		||||
        temp = GPIOx->OTYPER;
 | 
			
		||||
        temp &= ~(GPIO_OTYPER_OT0 << position) ;
 | 
			
		||||
        temp |= (((GPIO_Init->Mode & OUTPUT_TYPE) >> OUTPUT_TYPE_Pos) << position);
 | 
			
		||||
        GPIOx->OTYPER = temp;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
#if defined(STM32L471xx) || defined(STM32L475xx) || defined(STM32L476xx) || defined(STM32L485xx) || defined(STM32L486xx)
 | 
			
		||||
 | 
			
		||||
      /* In case of Analog mode, check if ADC control mode is selected */
 | 
			
		||||
      if((GPIO_Init->Mode & GPIO_MODE_ANALOG) == GPIO_MODE_ANALOG)
 | 
			
		||||
      {
 | 
			
		||||
        /* Configure the IO Output Type */
 | 
			
		||||
        temp = GPIOx->ASCR;
 | 
			
		||||
        temp &= ~(GPIO_ASCR_ASC0 << position) ;
 | 
			
		||||
        temp |= (((GPIO_Init->Mode & GPIO_MODE_ANALOG_ADC_CONTROL) >> 3) << position);
 | 
			
		||||
        GPIOx->ASCR = temp;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
#endif /* STM32L471xx || STM32L475xx || STM32L476xx || STM32L485xx || STM32L486xx */
 | 
			
		||||
 | 
			
		||||
      /* Activate the Pull-up or Pull down resistor for the current IO */
 | 
			
		||||
      if ((GPIO_Init->Mode & GPIO_MODE) != MODE_ANALOG)
 | 
			
		||||
      {
 | 
			
		||||
        /* Check the Pull parameter */
 | 
			
		||||
        assert_param(IS_GPIO_PULL(GPIO_Init->Pull));
 | 
			
		||||
 | 
			
		||||
        temp = GPIOx->PUPDR;
 | 
			
		||||
        temp &= ~(GPIO_PUPDR_PUPD0 << (position * 2U));
 | 
			
		||||
        temp |= ((GPIO_Init->Pull) << (position * 2U));
 | 
			
		||||
        GPIOx->PUPDR = temp;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* In case of Alternate function mode selection */
 | 
			
		||||
      if ((GPIO_Init->Mode & GPIO_MODE) == MODE_AF)
 | 
			
		||||
      {
 | 
			
		||||
        /* Check the Alternate function parameters */
 | 
			
		||||
        assert_param(IS_GPIO_AF_INSTANCE(GPIOx));
 | 
			
		||||
        assert_param(IS_GPIO_AF(GPIO_Init->Alternate));
 | 
			
		||||
 | 
			
		||||
        /* Configure Alternate function mapped with the current IO */
 | 
			
		||||
        temp = GPIOx->AFR[position >> 3u];
 | 
			
		||||
        temp &= ~(0xFu << ((position & 0x07u) * 4u));
 | 
			
		||||
        temp |= ((GPIO_Init->Alternate) << ((position & 0x07u) * 4u));
 | 
			
		||||
        GPIOx->AFR[position >> 3u] = temp;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /* Configure IO Direction mode (Input, Output, Alternate or Analog) */
 | 
			
		||||
      temp = GPIOx->MODER;
 | 
			
		||||
      temp &= ~(GPIO_MODER_MODE0 << (position * 2u));
 | 
			
		||||
      temp |= ((GPIO_Init->Mode & GPIO_MODE) << (position * 2u));
 | 
			
		||||
      GPIOx->MODER = temp;
 | 
			
		||||
 | 
			
		||||
      /*--------------------- EXTI Mode Configuration ------------------------*/
 | 
			
		||||
      /* Configure the External Interrupt or event for the current IO */
 | 
			
		||||
      if ((GPIO_Init->Mode & EXTI_MODE) != 0x00u)
 | 
			
		||||
      {
 | 
			
		||||
        /* Enable SYSCFG Clock */
 | 
			
		||||
        __HAL_RCC_SYSCFG_CLK_ENABLE();
 | 
			
		||||
 | 
			
		||||
        temp = SYSCFG->EXTICR[position >> 2u];
 | 
			
		||||
        temp &= ~(0x0FuL << (4u * (position & 0x03u)));
 | 
			
		||||
        temp |= (GPIO_GET_INDEX(GPIOx) << (4u * (position & 0x03u)));
 | 
			
		||||
        SYSCFG->EXTICR[position >> 2u] = temp;
 | 
			
		||||
 | 
			
		||||
        /* Clear Rising Falling edge configuration */
 | 
			
		||||
        temp = EXTI->RTSR1;
 | 
			
		||||
        temp &= ~(iocurrent);
 | 
			
		||||
        if ((GPIO_Init->Mode & TRIGGER_RISING) != 0x00u)
 | 
			
		||||
        {
 | 
			
		||||
          temp |= iocurrent;
 | 
			
		||||
        }
 | 
			
		||||
        EXTI->RTSR1 = temp;
 | 
			
		||||
 | 
			
		||||
        temp = EXTI->FTSR1;
 | 
			
		||||
        temp &= ~(iocurrent);
 | 
			
		||||
        if ((GPIO_Init->Mode & TRIGGER_FALLING) != 0x00u)
 | 
			
		||||
        {
 | 
			
		||||
          temp |= iocurrent;
 | 
			
		||||
        }
 | 
			
		||||
        EXTI->FTSR1 = temp;
 | 
			
		||||
 | 
			
		||||
        /* Clear EXTI line configuration */
 | 
			
		||||
        temp = EXTI->EMR1;
 | 
			
		||||
        temp &= ~(iocurrent);
 | 
			
		||||
        if ((GPIO_Init->Mode & EXTI_EVT) != 0x00u)
 | 
			
		||||
        {
 | 
			
		||||
          temp |= iocurrent;
 | 
			
		||||
        }
 | 
			
		||||
        EXTI->EMR1 = temp;
 | 
			
		||||
 | 
			
		||||
        temp = EXTI->IMR1;
 | 
			
		||||
        temp &= ~(iocurrent);
 | 
			
		||||
        if ((GPIO_Init->Mode & EXTI_IT) != 0x00u)
 | 
			
		||||
        {
 | 
			
		||||
          temp |= iocurrent;
 | 
			
		||||
        }
 | 
			
		||||
        EXTI->IMR1 = temp;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    position++;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  De-initialize the GPIOx peripheral registers to their default reset values.
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Pin specifies the port bit to be written.
 | 
			
		||||
  *         This parameter can be any combination of GPIO_PIN_x where x can be (0..15).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_GPIO_DeInit(GPIO_TypeDef  *GPIOx, uint32_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t position = 0x00u;
 | 
			
		||||
  uint32_t iocurrent;
 | 
			
		||||
  uint32_t tmp;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Pin));
 | 
			
		||||
 | 
			
		||||
  /* Configure the port pins */
 | 
			
		||||
  while ((GPIO_Pin >> position) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    /* Get current io position */
 | 
			
		||||
    iocurrent = (GPIO_Pin) & (1uL << position);
 | 
			
		||||
 | 
			
		||||
    if (iocurrent != 0x00u)
 | 
			
		||||
    {
 | 
			
		||||
      /*------------------------- EXTI Mode Configuration --------------------*/
 | 
			
		||||
      /* Clear the External Interrupt or Event for the current IO */
 | 
			
		||||
 | 
			
		||||
      tmp = SYSCFG->EXTICR[position >> 2u];
 | 
			
		||||
      tmp &= (0x0FuL << (4u * (position & 0x03u)));
 | 
			
		||||
      if (tmp == (GPIO_GET_INDEX(GPIOx) << (4u * (position & 0x03u))))
 | 
			
		||||
      {
 | 
			
		||||
        /* Clear EXTI line configuration */
 | 
			
		||||
        EXTI->IMR1 &= ~(iocurrent);
 | 
			
		||||
        EXTI->EMR1 &= ~(iocurrent);
 | 
			
		||||
 | 
			
		||||
        /* Clear Rising Falling edge configuration */
 | 
			
		||||
        EXTI->FTSR1 &= ~(iocurrent);
 | 
			
		||||
        EXTI->RTSR1 &= ~(iocurrent);
 | 
			
		||||
 | 
			
		||||
        tmp = 0x0FuL << (4u * (position & 0x03u));
 | 
			
		||||
        SYSCFG->EXTICR[position >> 2u] &= ~tmp;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      /*------------------------- GPIO Mode Configuration --------------------*/
 | 
			
		||||
      /* Configure IO in Analog Mode */
 | 
			
		||||
      GPIOx->MODER |= (GPIO_MODER_MODE0 << (position * 2u));
 | 
			
		||||
 | 
			
		||||
      /* Configure the default Alternate Function in current IO */
 | 
			
		||||
      GPIOx->AFR[position >> 3u] &= ~(0xFu << ((position & 0x07u) * 4u)) ;
 | 
			
		||||
 | 
			
		||||
      /* Configure the default value for IO Speed */
 | 
			
		||||
      GPIOx->OSPEEDR &= ~(GPIO_OSPEEDR_OSPEED0 << (position * 2u));
 | 
			
		||||
 | 
			
		||||
      /* Configure the default value IO Output Type */
 | 
			
		||||
      GPIOx->OTYPER  &= ~(GPIO_OTYPER_OT0 << position) ;
 | 
			
		||||
 | 
			
		||||
      /* Deactivate the Pull-up and Pull-down resistor for the current IO */
 | 
			
		||||
      GPIOx->PUPDR &= ~(GPIO_PUPDR_PUPD0 << (position * 2u));
 | 
			
		||||
 | 
			
		||||
#if defined(STM32L471xx) || defined(STM32L475xx) || defined(STM32L476xx) || defined(STM32L485xx) || defined(STM32L486xx)
 | 
			
		||||
      /* Deactivate the Control bit of Analog mode for the current IO */
 | 
			
		||||
      GPIOx->ASCR &= ~(GPIO_ASCR_ASC0<< position);
 | 
			
		||||
#endif /* STM32L471xx || STM32L475xx || STM32L476xx || STM32L485xx || STM32L486xx */
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    position++;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup GPIO_Exported_Functions_Group2 IO operation functions
 | 
			
		||||
 *  @brief GPIO Read, Write, Toggle, Lock and EXTI management functions.
 | 
			
		||||
 *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                       ##### IO operation functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Read the specified input port pin.
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Pin specifies the port bit to read.
 | 
			
		||||
  *         This parameter can be any combination of GPIO_PIN_x where x can be (0..15).
 | 
			
		||||
  * @retval The input port pin value.
 | 
			
		||||
  */
 | 
			
		||||
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  GPIO_PinState bitstatus;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Pin));
 | 
			
		||||
 | 
			
		||||
  if ((GPIOx->IDR & GPIO_Pin) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    bitstatus = GPIO_PIN_SET;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    bitstatus = GPIO_PIN_RESET;
 | 
			
		||||
  }
 | 
			
		||||
  return bitstatus;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Set or clear the selected data port bit.
 | 
			
		||||
  *
 | 
			
		||||
  * @note   This function uses GPIOx_BSRR and GPIOx_BRR registers to allow atomic read/modify
 | 
			
		||||
  *         accesses. In this way, there is no risk of an IRQ occurring between
 | 
			
		||||
  *         the read and the modify access.
 | 
			
		||||
  *
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Pin specifies the port bit to be written.
 | 
			
		||||
  *         This parameter can be any combination of GPIO_PIN_x where x can be (0..15).
 | 
			
		||||
  * @param  PinState specifies the value to be written to the selected bit.
 | 
			
		||||
  *         This parameter can be one of the GPIO_PinState enum values:
 | 
			
		||||
  *            @arg GPIO_PIN_RESET: to clear the port pin
 | 
			
		||||
  *            @arg GPIO_PIN_SET: to set the port pin
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Pin));
 | 
			
		||||
  assert_param(IS_GPIO_PIN_ACTION(PinState));
 | 
			
		||||
 | 
			
		||||
  if(PinState != GPIO_PIN_RESET)
 | 
			
		||||
  {
 | 
			
		||||
    GPIOx->BSRR = (uint32_t)GPIO_Pin;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    GPIOx->BRR = (uint32_t)GPIO_Pin;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Toggle the specified GPIO pin.
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Pin specifies the pin to be toggled.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t odr;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Pin));
 | 
			
		||||
 | 
			
		||||
  /* get current Output Data Register value */
 | 
			
		||||
  odr = GPIOx->ODR;
 | 
			
		||||
 | 
			
		||||
  /* Set selected pins that were at low level, and reset ones that were high */
 | 
			
		||||
  GPIOx->BSRR = ((odr & GPIO_Pin) << GPIO_NUMBER) | (~odr & GPIO_Pin);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
* @brief  Lock GPIO Pins configuration registers.
 | 
			
		||||
  * @note   The locked registers are GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR,
 | 
			
		||||
  *         GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH.
 | 
			
		||||
  * @note   The configuration of the locked GPIO pins can no longer be modified
 | 
			
		||||
  *         until the next reset.
 | 
			
		||||
  * @param  GPIOx where x can be (A..H) to select the GPIO peripheral for STM32L4 family
 | 
			
		||||
  * @param  GPIO_Pin specifies the port bits to be locked.
 | 
			
		||||
  *         This parameter can be any combination of GPIO_PIN_x where x can be (0..15).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  __IO uint32_t tmp = GPIO_LCKR_LCKK;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_GPIO_LOCK_INSTANCE(GPIOx));
 | 
			
		||||
  assert_param(IS_GPIO_PIN(GPIO_Pin));
 | 
			
		||||
 | 
			
		||||
  /* Apply lock key write sequence */
 | 
			
		||||
  tmp |= GPIO_Pin;
 | 
			
		||||
  /* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
 | 
			
		||||
  GPIOx->LCKR = tmp;
 | 
			
		||||
  /* Reset LCKx bit(s): LCKK='0' + LCK[15-0] */
 | 
			
		||||
  GPIOx->LCKR = GPIO_Pin;
 | 
			
		||||
  /* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
 | 
			
		||||
  GPIOx->LCKR = tmp;
 | 
			
		||||
  /* Read LCKK register. This read is mandatory to complete key lock sequence */
 | 
			
		||||
  tmp = GPIOx->LCKR;
 | 
			
		||||
 | 
			
		||||
  /* Read again in order to confirm lock is active */
 | 
			
		||||
  if ((GPIOx->LCKR & GPIO_LCKR_LCKK) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_ERROR;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Handle EXTI interrupt request.
 | 
			
		||||
  * @param  GPIO_Pin Specifies the port pin connected to corresponding EXTI line.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  /* EXTI line interrupt detected */
 | 
			
		||||
  if(__HAL_GPIO_EXTI_GET_IT(GPIO_Pin) != 0x00u)
 | 
			
		||||
  {
 | 
			
		||||
    __HAL_GPIO_EXTI_CLEAR_IT(GPIO_Pin);
 | 
			
		||||
    HAL_GPIO_EXTI_Callback(GPIO_Pin);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  EXTI line detection callback.
 | 
			
		||||
  * @param  GPIO_Pin Specifies the port pin connected to corresponding EXTI line.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
 | 
			
		||||
{
 | 
			
		||||
  /* Prevent unused argument(s) compilation warning */
 | 
			
		||||
  UNUSED(GPIO_Pin);
 | 
			
		||||
 | 
			
		||||
  /* NOTE: This function should not be modified, when the callback is needed,
 | 
			
		||||
           the HAL_GPIO_EXTI_Callback could be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_GPIO_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										7548
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_i2c.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										7548
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_i2c.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										368
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_i2c_ex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										368
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_i2c_ex.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,368 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_i2c_ex.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   I2C Extended HAL module driver.
 | 
			
		||||
  *          This file provides firmware functions to manage the following
 | 
			
		||||
  *          functionalities of I2C Extended peripheral:
 | 
			
		||||
  *           + Filter Mode Functions
 | 
			
		||||
  *           + WakeUp Mode Functions
 | 
			
		||||
  *           + FastModePlus Functions
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2017 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
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
               ##### I2C peripheral Extended features  #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
 | 
			
		||||
  [..] Comparing to other previous devices, the I2C interface for STM32L4xx
 | 
			
		||||
       devices contains the following additional features
 | 
			
		||||
 | 
			
		||||
       (+) Possibility to disable or enable Analog Noise Filter
 | 
			
		||||
       (+) Use of a configured Digital Noise Filter
 | 
			
		||||
       (+) Disable or enable wakeup from Stop mode(s)
 | 
			
		||||
       (+) Disable or enable Fast Mode Plus
 | 
			
		||||
 | 
			
		||||
                     ##### How to use this driver #####
 | 
			
		||||
  ==============================================================================
 | 
			
		||||
  [..] This driver provides functions to configure Noise Filter and Wake Up Feature
 | 
			
		||||
    (#) Configure I2C Analog noise filter using the function HAL_I2CEx_ConfigAnalogFilter()
 | 
			
		||||
    (#) Configure I2C Digital noise filter using the function HAL_I2CEx_ConfigDigitalFilter()
 | 
			
		||||
    (#) Configure the enable or disable of I2C Wake Up Mode using the functions :
 | 
			
		||||
          (++) HAL_I2CEx_EnableWakeUp()
 | 
			
		||||
          (++) HAL_I2CEx_DisableWakeUp()
 | 
			
		||||
    (#) Configure the enable or disable of fast mode plus driving capability using the functions :
 | 
			
		||||
          (++) HAL_I2CEx_EnableFastModePlus()
 | 
			
		||||
          (++) HAL_I2CEx_DisableFastModePlus()
 | 
			
		||||
  @endverbatim
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup I2CEx I2CEx
 | 
			
		||||
  * @brief I2C Extended HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_I2C_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private define ------------------------------------------------------------*/
 | 
			
		||||
/* Private macro -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/* Private functions ---------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup I2CEx_Exported_Functions I2C Extended Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup I2CEx_Exported_Functions_Group1 Filter Mode Functions
 | 
			
		||||
  * @brief    Filter Mode Functions
 | 
			
		||||
  *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### Filter Mode Functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..] This section provides functions allowing to:
 | 
			
		||||
      (+) Configure Noise Filters
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure I2C Analog noise filter.
 | 
			
		||||
  * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | 
			
		||||
  *                the configuration information for the specified I2Cx peripheral.
 | 
			
		||||
  * @param  AnalogFilter New state of the Analog filter.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_I2CEx_ConfigAnalogFilter(I2C_HandleTypeDef *hi2c, uint32_t AnalogFilter)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
 | 
			
		||||
  assert_param(IS_I2C_ANALOG_FILTER(AnalogFilter));
 | 
			
		||||
 | 
			
		||||
  if (hi2c->State == HAL_I2C_STATE_READY)
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_BUSY;
 | 
			
		||||
 | 
			
		||||
    /* Disable the selected I2C peripheral */
 | 
			
		||||
    __HAL_I2C_DISABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    /* Reset I2Cx ANOFF bit */
 | 
			
		||||
    hi2c->Instance->CR1 &= ~(I2C_CR1_ANFOFF);
 | 
			
		||||
 | 
			
		||||
    /* Set analog filter bit*/
 | 
			
		||||
    hi2c->Instance->CR1 |= AnalogFilter;
 | 
			
		||||
 | 
			
		||||
    __HAL_I2C_ENABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_READY;
 | 
			
		||||
 | 
			
		||||
    /* Process Unlocked */
 | 
			
		||||
    __HAL_UNLOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_BUSY;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Configure I2C Digital noise filter.
 | 
			
		||||
  * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | 
			
		||||
  *                the configuration information for the specified I2Cx peripheral.
 | 
			
		||||
  * @param  DigitalFilter Coefficient of digital noise filter between Min_Data=0x00 and Max_Data=0x0F.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_I2CEx_ConfigDigitalFilter(I2C_HandleTypeDef *hi2c, uint32_t DigitalFilter)
 | 
			
		||||
{
 | 
			
		||||
  uint32_t tmpreg;
 | 
			
		||||
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
 | 
			
		||||
  assert_param(IS_I2C_DIGITAL_FILTER(DigitalFilter));
 | 
			
		||||
 | 
			
		||||
  if (hi2c->State == HAL_I2C_STATE_READY)
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_BUSY;
 | 
			
		||||
 | 
			
		||||
    /* Disable the selected I2C peripheral */
 | 
			
		||||
    __HAL_I2C_DISABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    /* Get the old register value */
 | 
			
		||||
    tmpreg = hi2c->Instance->CR1;
 | 
			
		||||
 | 
			
		||||
    /* Reset I2Cx DNF bits [11:8] */
 | 
			
		||||
    tmpreg &= ~(I2C_CR1_DNF);
 | 
			
		||||
 | 
			
		||||
    /* Set I2Cx DNF coefficient */
 | 
			
		||||
    tmpreg |= DigitalFilter << 8U;
 | 
			
		||||
 | 
			
		||||
    /* Store the new register value */
 | 
			
		||||
    hi2c->Instance->CR1 = tmpreg;
 | 
			
		||||
 | 
			
		||||
    __HAL_I2C_ENABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_READY;
 | 
			
		||||
 | 
			
		||||
    /* Process Unlocked */
 | 
			
		||||
    __HAL_UNLOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_BUSY;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup I2CEx_Exported_Functions_Group2 WakeUp Mode Functions
 | 
			
		||||
  * @brief    WakeUp Mode Functions
 | 
			
		||||
  *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### WakeUp Mode Functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..] This section provides functions allowing to:
 | 
			
		||||
      (+) Configure Wake Up Feature
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Enable I2C wakeup from Stop mode(s).
 | 
			
		||||
  * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | 
			
		||||
  *                the configuration information for the specified I2Cx peripheral.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_I2CEx_EnableWakeUp(I2C_HandleTypeDef *hi2c)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_I2C_WAKEUP_FROMSTOP_INSTANCE(hi2c->Instance));
 | 
			
		||||
 | 
			
		||||
  if (hi2c->State == HAL_I2C_STATE_READY)
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_BUSY;
 | 
			
		||||
 | 
			
		||||
    /* Disable the selected I2C peripheral */
 | 
			
		||||
    __HAL_I2C_DISABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    /* Enable wakeup from stop mode */
 | 
			
		||||
    hi2c->Instance->CR1 |= I2C_CR1_WUPEN;
 | 
			
		||||
 | 
			
		||||
    __HAL_I2C_ENABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_READY;
 | 
			
		||||
 | 
			
		||||
    /* Process Unlocked */
 | 
			
		||||
    __HAL_UNLOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_BUSY;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief  Disable I2C wakeup from Stop mode(s).
 | 
			
		||||
  * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | 
			
		||||
  *                the configuration information for the specified I2Cx peripheral.
 | 
			
		||||
  * @retval HAL status
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_I2CEx_DisableWakeUp(I2C_HandleTypeDef *hi2c)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_I2C_WAKEUP_FROMSTOP_INSTANCE(hi2c->Instance));
 | 
			
		||||
 | 
			
		||||
  if (hi2c->State == HAL_I2C_STATE_READY)
 | 
			
		||||
  {
 | 
			
		||||
    /* Process Locked */
 | 
			
		||||
    __HAL_LOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_BUSY;
 | 
			
		||||
 | 
			
		||||
    /* Disable the selected I2C peripheral */
 | 
			
		||||
    __HAL_I2C_DISABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    /* Enable wakeup from stop mode */
 | 
			
		||||
    hi2c->Instance->CR1 &= ~(I2C_CR1_WUPEN);
 | 
			
		||||
 | 
			
		||||
    __HAL_I2C_ENABLE(hi2c);
 | 
			
		||||
 | 
			
		||||
    hi2c->State = HAL_I2C_STATE_READY;
 | 
			
		||||
 | 
			
		||||
    /* Process Unlocked */
 | 
			
		||||
    __HAL_UNLOCK(hi2c);
 | 
			
		||||
 | 
			
		||||
    return HAL_OK;
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    return HAL_BUSY;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup I2CEx_Exported_Functions_Group3 Fast Mode Plus Functions
 | 
			
		||||
  * @brief    Fast Mode Plus Functions
 | 
			
		||||
  *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                      ##### Fast Mode Plus Functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..] This section provides functions allowing to:
 | 
			
		||||
      (+) Configure Fast Mode Plus
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable the I2C fast mode plus driving capability.
 | 
			
		||||
  * @param ConfigFastModePlus Selects the pin.
 | 
			
		||||
  *   This parameter can be one of the @ref I2CEx_FastModePlus values
 | 
			
		||||
  * @note  For I2C1, fast mode plus driving capability can be enabled on all selected
 | 
			
		||||
  *        I2C1 pins using I2C_FASTMODEPLUS_I2C1 parameter or independently
 | 
			
		||||
  *        on each one of the following pins PB6, PB7, PB8 and PB9.
 | 
			
		||||
  * @note  For remaining I2C1 pins (PA14, PA15...) fast mode plus driving capability
 | 
			
		||||
  *        can be enabled only by using I2C_FASTMODEPLUS_I2C1 parameter.
 | 
			
		||||
  * @note  For all I2C2 pins fast mode plus driving capability can be enabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C2 parameter.
 | 
			
		||||
  * @note  For all I2C3 pins fast mode plus driving capability can be enabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C3 parameter.
 | 
			
		||||
  * @note  For all I2C4 pins fast mode plus driving capability can be enabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C4 parameter.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_I2CEx_EnableFastModePlus(uint32_t ConfigFastModePlus)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameter */
 | 
			
		||||
  assert_param(IS_I2C_FASTMODEPLUS(ConfigFastModePlus));
 | 
			
		||||
 | 
			
		||||
  /* Enable SYSCFG clock */
 | 
			
		||||
  __HAL_RCC_SYSCFG_CLK_ENABLE();
 | 
			
		||||
 | 
			
		||||
  /* Enable fast mode plus driving capability for selected pin */
 | 
			
		||||
  SET_BIT(SYSCFG->CFGR1, (uint32_t)ConfigFastModePlus);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable the I2C fast mode plus driving capability.
 | 
			
		||||
  * @param ConfigFastModePlus Selects the pin.
 | 
			
		||||
  *   This parameter can be one of the @ref I2CEx_FastModePlus values
 | 
			
		||||
  * @note  For I2C1, fast mode plus driving capability can be disabled on all selected
 | 
			
		||||
  *        I2C1 pins using I2C_FASTMODEPLUS_I2C1 parameter or independently
 | 
			
		||||
  *        on each one of the following pins PB6, PB7, PB8 and PB9.
 | 
			
		||||
  * @note  For remaining I2C1 pins (PA14, PA15...) fast mode plus driving capability
 | 
			
		||||
  *        can be disabled only by using I2C_FASTMODEPLUS_I2C1 parameter.
 | 
			
		||||
  * @note  For all I2C2 pins fast mode plus driving capability can be disabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C2 parameter.
 | 
			
		||||
  * @note  For all I2C3 pins fast mode plus driving capability can be disabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C3 parameter.
 | 
			
		||||
  * @note  For all I2C4 pins fast mode plus driving capability can be disabled
 | 
			
		||||
  *        only by using I2C_FASTMODEPLUS_I2C4 parameter.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_I2CEx_DisableFastModePlus(uint32_t ConfigFastModePlus)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameter */
 | 
			
		||||
  assert_param(IS_I2C_FASTMODEPLUS(ConfigFastModePlus));
 | 
			
		||||
 | 
			
		||||
  /* Enable SYSCFG clock */
 | 
			
		||||
  __HAL_RCC_SYSCFG_CLK_ENABLE();
 | 
			
		||||
 | 
			
		||||
  /* Disable fast mode plus driving capability for selected pin */
 | 
			
		||||
  CLEAR_BIT(SYSCFG->CFGR1, (uint32_t)ConfigFastModePlus);
 | 
			
		||||
}
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_I2C_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
							
								
								
									
										658
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_pwr.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										658
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_pwr.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,658 @@
 | 
			
		|||
/**
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @file    stm32l4xx_hal_pwr.c
 | 
			
		||||
  * @author  MCD Application Team
 | 
			
		||||
  * @brief   PWR HAL module driver.
 | 
			
		||||
  *          This file provides firmware functions to manage the following
 | 
			
		||||
  *          functionalities of the Power Controller (PWR) peripheral:
 | 
			
		||||
  *           + Initialization/de-initialization functions
 | 
			
		||||
  *           + Peripheral Control functions
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  * @attention
 | 
			
		||||
  *
 | 
			
		||||
  * Copyright (c) 2019 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.
 | 
			
		||||
  *
 | 
			
		||||
  ******************************************************************************
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Includes ------------------------------------------------------------------*/
 | 
			
		||||
#include "stm32l4xx_hal.h"
 | 
			
		||||
 | 
			
		||||
/** @addtogroup STM32L4xx_HAL_Driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR PWR
 | 
			
		||||
  * @brief PWR HAL module driver
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#ifdef HAL_PWR_MODULE_ENABLED
 | 
			
		||||
 | 
			
		||||
/* Private typedef -----------------------------------------------------------*/
 | 
			
		||||
/* Private define ------------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR_Private_Defines PWR Private Defines
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR_PVD_Mode_Mask PWR PVD Mode Mask
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
#define PVD_MODE_IT               ((uint32_t)0x00010000)  /*!< Mask for interruption yielded by PVD threshold crossing */
 | 
			
		||||
#define PVD_MODE_EVT              ((uint32_t)0x00020000)  /*!< Mask for event yielded by PVD threshold crossing        */
 | 
			
		||||
#define PVD_RISING_EDGE           ((uint32_t)0x00000001)  /*!< Mask for rising edge set as PVD trigger                 */
 | 
			
		||||
#define PVD_FALLING_EDGE          ((uint32_t)0x00000002)  /*!< Mask for falling edge set as PVD trigger                */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/* Private macro -------------------------------------------------------------*/
 | 
			
		||||
/* Private variables ---------------------------------------------------------*/
 | 
			
		||||
/* Private function prototypes -----------------------------------------------*/
 | 
			
		||||
/* Exported functions --------------------------------------------------------*/
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR_Exported_Functions PWR Exported Functions
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR_Exported_Functions_Group1 Initialization and de-initialization functions
 | 
			
		||||
  *  @brief    Initialization and de-initialization functions
 | 
			
		||||
  *
 | 
			
		||||
@verbatim
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
              ##### Initialization and de-initialization functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
    [..]
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Deinitialize the HAL PWR peripheral registers to their default reset values.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DeInit(void)
 | 
			
		||||
{
 | 
			
		||||
  __HAL_RCC_PWR_FORCE_RESET();
 | 
			
		||||
  __HAL_RCC_PWR_RELEASE_RESET();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable access to the backup domain
 | 
			
		||||
  *        (RTC registers, RTC backup data registers).
 | 
			
		||||
  * @note  After reset, the backup domain is protected against
 | 
			
		||||
  *        possible unwanted write accesses.
 | 
			
		||||
  * @note  RTCSEL that sets the RTC clock source selection is in the RTC back-up domain.
 | 
			
		||||
  *        In order to set or modify the RTC clock, the backup domain access must be
 | 
			
		||||
  *        disabled.
 | 
			
		||||
  * @note  LSEON bit that switches on and off the LSE crystal belongs as well to the
 | 
			
		||||
  *        back-up domain.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnableBkUpAccess(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(PWR->CR1, PWR_CR1_DBP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable access to the backup domain
 | 
			
		||||
  *        (RTC registers, RTC backup data registers).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DisableBkUpAccess(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(PWR->CR1, PWR_CR1_DBP);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/** @defgroup PWR_Exported_Functions_Group2 Peripheral Control functions
 | 
			
		||||
  *  @brief Low Power modes configuration functions
 | 
			
		||||
  *
 | 
			
		||||
@verbatim
 | 
			
		||||
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
                 ##### Peripheral Control functions #####
 | 
			
		||||
 ===============================================================================
 | 
			
		||||
 | 
			
		||||
     [..]
 | 
			
		||||
     *** PVD configuration ***
 | 
			
		||||
    =========================
 | 
			
		||||
    [..]
 | 
			
		||||
      (+) The PVD is used to monitor the VDD power supply by comparing it to a
 | 
			
		||||
          threshold selected by the PVD Level (PLS[2:0] bits in PWR_CR2 register).
 | 
			
		||||
 | 
			
		||||
      (+) PVDO flag is available to indicate if VDD/VDDA is higher or lower
 | 
			
		||||
          than the PVD threshold. This event is internally connected to the EXTI
 | 
			
		||||
          line16 and can generate an interrupt if enabled. This is done through
 | 
			
		||||
          __HAL_PVD_EXTI_ENABLE_IT() macro.
 | 
			
		||||
      (+) The PVD is stopped in Standby mode.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
    *** WakeUp pin configuration ***
 | 
			
		||||
    ================================
 | 
			
		||||
    [..]
 | 
			
		||||
      (+) WakeUp pins are used to wakeup the system from Standby mode or Shutdown mode.
 | 
			
		||||
          The polarity of these pins can be set to configure event detection on high
 | 
			
		||||
          level (rising edge) or low level (falling edge).
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
    *** Low Power modes configuration ***
 | 
			
		||||
    =====================================
 | 
			
		||||
    [..]
 | 
			
		||||
      The devices feature 8 low-power modes:
 | 
			
		||||
      (+) Low-power Run mode: core and peripherals are running, main regulator off, low power regulator on.
 | 
			
		||||
      (+) Sleep mode: Cortex-M4 core stopped, peripherals kept running, main and low power regulators on.
 | 
			
		||||
      (+) Low-power Sleep mode: Cortex-M4 core stopped, peripherals kept running, main regulator off, low power regulator on.
 | 
			
		||||
      (+) Stop 0 mode: all clocks are stopped except LSI and LSE, main and low power regulators on.
 | 
			
		||||
      (+) Stop 1 mode: all clocks are stopped except LSI and LSE, main regulator off, low power regulator on.
 | 
			
		||||
      (+) Stop 2 mode: all clocks are stopped except LSI and LSE, main regulator off, low power regulator on, reduced set of waking up IPs compared to Stop 1 mode.
 | 
			
		||||
      (+) Standby mode with SRAM2: all clocks are stopped except LSI and LSE, SRAM2 content preserved, main regulator off, low power regulator on.
 | 
			
		||||
      (+) Standby mode without SRAM2: all clocks are stopped except LSI and LSE, main and low power regulators off.
 | 
			
		||||
      (+) Shutdown mode: all clocks are stopped except LSE, main and low power regulators off.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
   *** Low-power run mode ***
 | 
			
		||||
   ==========================
 | 
			
		||||
    [..]
 | 
			
		||||
      (+) Entry: (from main run mode)
 | 
			
		||||
        (++) set LPR bit with HAL_PWREx_EnableLowPowerRunMode() API after having decreased the system clock below 2 MHz.
 | 
			
		||||
 | 
			
		||||
      (+) Exit:
 | 
			
		||||
        (++) clear LPR bit then wait for REGLP bit to be reset with HAL_PWREx_DisableLowPowerRunMode() API. Only
 | 
			
		||||
             then can the system clock frequency be increased above 2 MHz.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
   *** Sleep mode / Low-power sleep mode ***
 | 
			
		||||
   =========================================
 | 
			
		||||
    [..]
 | 
			
		||||
      (+) Entry:
 | 
			
		||||
          The Sleep mode / Low-power Sleep mode is entered through HAL_PWR_EnterSLEEPMode() API
 | 
			
		||||
          in specifying whether or not the regulator is forced to low-power mode and if exit is interrupt or event-triggered.
 | 
			
		||||
          (++) PWR_MAINREGULATOR_ON: Sleep mode (regulator in main mode).
 | 
			
		||||
          (++) PWR_LOWPOWERREGULATOR_ON: Low-power sleep (regulator in low power mode).
 | 
			
		||||
          In the latter case, the system clock frequency must have been decreased below 2 MHz beforehand.
 | 
			
		||||
          (++) PWR_SLEEPENTRY_WFI: enter SLEEP mode with WFI instruction
 | 
			
		||||
          (++) PWR_SLEEPENTRY_WFE: enter SLEEP mode with WFE instruction
 | 
			
		||||
 | 
			
		||||
      (+) WFI Exit:
 | 
			
		||||
        (++) Any peripheral interrupt acknowledged by the nested vectored interrupt
 | 
			
		||||
             controller (NVIC) or any wake-up event.
 | 
			
		||||
 | 
			
		||||
      (+) WFE Exit:
 | 
			
		||||
        (++) Any wake-up event such as an EXTI line configured in event mode.
 | 
			
		||||
 | 
			
		||||
         [..] When exiting the Low-power sleep mode by issuing an interrupt or a wakeup event,
 | 
			
		||||
             the MCU is in Low-power Run mode.
 | 
			
		||||
 | 
			
		||||
   *** Stop 0, Stop 1 and Stop 2 modes ***
 | 
			
		||||
   ===============================
 | 
			
		||||
    [..]
 | 
			
		||||
      (+) Entry:
 | 
			
		||||
          The Stop 0, Stop 1 or Stop 2 modes are entered through the following API's:
 | 
			
		||||
          (++) HAL_PWREx_EnterSTOP0Mode() for mode 0 or HAL_PWREx_EnterSTOP1Mode() for mode 1 or for porting reasons HAL_PWR_EnterSTOPMode().
 | 
			
		||||
          (++) HAL_PWREx_EnterSTOP2Mode() for mode 2.
 | 
			
		||||
      (+) Regulator setting (applicable to HAL_PWR_EnterSTOPMode() only):
 | 
			
		||||
          (++) PWR_MAINREGULATOR_ON
 | 
			
		||||
          (++) PWR_LOWPOWERREGULATOR_ON
 | 
			
		||||
      (+) Exit (interrupt or event-triggered, specified when entering STOP mode):
 | 
			
		||||
          (++) PWR_STOPENTRY_WFI: enter Stop mode with WFI instruction
 | 
			
		||||
          (++) PWR_STOPENTRY_WFE: enter Stop mode with WFE instruction
 | 
			
		||||
 | 
			
		||||
      (+) WFI Exit:
 | 
			
		||||
          (++) Any EXTI Line (Internal or External) configured in Interrupt mode.
 | 
			
		||||
          (++) Some specific communication peripherals (USART, LPUART, I2C) interrupts
 | 
			
		||||
               when programmed in wakeup mode.
 | 
			
		||||
      (+) WFE Exit:
 | 
			
		||||
          (++) Any EXTI Line (Internal or External) configured in Event mode.
 | 
			
		||||
 | 
			
		||||
       [..]
 | 
			
		||||
          When exiting Stop 0 and Stop 1 modes, the MCU is either in Run mode or in Low-power Run mode
 | 
			
		||||
          depending on the LPR bit setting.
 | 
			
		||||
          When exiting Stop 2 mode, the MCU is in Run mode.
 | 
			
		||||
 | 
			
		||||
   *** Standby mode ***
 | 
			
		||||
   ====================
 | 
			
		||||
     [..]
 | 
			
		||||
      The Standby mode offers two options:
 | 
			
		||||
      (+) option a) all clocks off except LSI and LSE, RRS bit set (keeps voltage regulator in low power mode).
 | 
			
		||||
        SRAM and registers contents are lost except for the SRAM2 content, the RTC registers, RTC backup registers
 | 
			
		||||
        and Standby circuitry.
 | 
			
		||||
      (+) option b) all clocks off except LSI and LSE, RRS bit cleared (voltage regulator then disabled).
 | 
			
		||||
        SRAM and register contents are lost except for the RTC registers, RTC backup registers
 | 
			
		||||
        and Standby circuitry.
 | 
			
		||||
 | 
			
		||||
      (++) Entry:
 | 
			
		||||
          (+++) The Standby mode is entered through HAL_PWR_EnterSTANDBYMode() API.
 | 
			
		||||
                SRAM1 and register contents are lost except for registers in the Backup domain and
 | 
			
		||||
                Standby circuitry. SRAM2 content can be preserved if the bit RRS is set in PWR_CR3 register.
 | 
			
		||||
                To enable this feature, the user can resort to HAL_PWREx_EnableSRAM2ContentRetention() API
 | 
			
		||||
                to set RRS bit.
 | 
			
		||||
 | 
			
		||||
      (++) Exit:
 | 
			
		||||
          (+++) WKUP pin rising edge, RTC alarm or wakeup, tamper event, time-stamp event,
 | 
			
		||||
                external reset in NRST pin, IWDG reset.
 | 
			
		||||
 | 
			
		||||
      [..]    After waking up from Standby mode, program execution restarts in the same way as after a Reset.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
    *** Shutdown mode ***
 | 
			
		||||
   ======================
 | 
			
		||||
     [..]
 | 
			
		||||
      In Shutdown mode,
 | 
			
		||||
        voltage regulator is disabled, all clocks are off except LSE, RRS bit is cleared.
 | 
			
		||||
        SRAM and registers contents are lost except for backup domain registers.
 | 
			
		||||
 | 
			
		||||
      (+) Entry:
 | 
			
		||||
          The Shutdown mode is entered through HAL_PWREx_EnterSHUTDOWNMode() API.
 | 
			
		||||
 | 
			
		||||
      (+) Exit:
 | 
			
		||||
          (++) WKUP pin rising edge, RTC alarm or wakeup, tamper event, time-stamp event,
 | 
			
		||||
               external reset in NRST pin.
 | 
			
		||||
 | 
			
		||||
         [..] After waking up from Shutdown mode, program execution restarts in the same way as after a Reset.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
   *** Auto-wakeup (AWU) from low-power mode ***
 | 
			
		||||
   =============================================
 | 
			
		||||
    [..]
 | 
			
		||||
      The MCU can be woken up from low-power mode by an RTC Alarm event, an RTC
 | 
			
		||||
      Wakeup event, a tamper event or a time-stamp event, without depending on
 | 
			
		||||
      an external interrupt (Auto-wakeup mode).
 | 
			
		||||
 | 
			
		||||
      (+) RTC auto-wakeup (AWU) from the Stop, Standby and Shutdown modes
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
        (++) To wake up from the Stop mode with an RTC alarm event, it is necessary to
 | 
			
		||||
             configure the RTC to generate the RTC alarm using the HAL_RTC_SetAlarm_IT() function.
 | 
			
		||||
 | 
			
		||||
        (++) To wake up from the Stop mode with an RTC Tamper or time stamp event, it
 | 
			
		||||
             is necessary to configure the RTC to detect the tamper or time stamp event using the
 | 
			
		||||
             HAL_RTCEx_SetTimeStamp_IT() or HAL_RTCEx_SetTamper_IT() functions.
 | 
			
		||||
 | 
			
		||||
        (++) To wake up from the Stop mode with an RTC WakeUp event, it is necessary to
 | 
			
		||||
              configure the RTC to generate the RTC WakeUp event using the HAL_RTCEx_SetWakeUpTimer_IT() function.
 | 
			
		||||
 | 
			
		||||
@endverbatim
 | 
			
		||||
  * @{
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Configure the voltage threshold detected by the Power Voltage Detector (PVD).
 | 
			
		||||
  * @param sConfigPVD: pointer to a PWR_PVDTypeDef structure that contains the PVD
 | 
			
		||||
  *        configuration information.
 | 
			
		||||
  * @note Refer to the electrical characteristics of your device datasheet for
 | 
			
		||||
  *         more details about the voltage thresholds corresponding to each
 | 
			
		||||
  *         detection level.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
HAL_StatusTypeDef HAL_PWR_ConfigPVD(PWR_PVDTypeDef *sConfigPVD)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_PWR_PVD_LEVEL(sConfigPVD->PVDLevel));
 | 
			
		||||
  assert_param(IS_PWR_PVD_MODE(sConfigPVD->Mode));
 | 
			
		||||
 | 
			
		||||
  /* Set PLS bits according to PVDLevel value */
 | 
			
		||||
  MODIFY_REG(PWR->CR2, PWR_CR2_PLS, sConfigPVD->PVDLevel);
 | 
			
		||||
 | 
			
		||||
  /* Clear any previous config. Keep it clear if no event or IT mode is selected */
 | 
			
		||||
  __HAL_PWR_PVD_EXTI_DISABLE_EVENT();
 | 
			
		||||
  __HAL_PWR_PVD_EXTI_DISABLE_IT();
 | 
			
		||||
  __HAL_PWR_PVD_EXTI_DISABLE_FALLING_EDGE();
 | 
			
		||||
  __HAL_PWR_PVD_EXTI_DISABLE_RISING_EDGE();
 | 
			
		||||
 | 
			
		||||
  /* Configure interrupt mode */
 | 
			
		||||
  if((sConfigPVD->Mode & PVD_MODE_IT) == PVD_MODE_IT)
 | 
			
		||||
  {
 | 
			
		||||
    __HAL_PWR_PVD_EXTI_ENABLE_IT();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Configure event mode */
 | 
			
		||||
  if((sConfigPVD->Mode & PVD_MODE_EVT) == PVD_MODE_EVT)
 | 
			
		||||
  {
 | 
			
		||||
    __HAL_PWR_PVD_EXTI_ENABLE_EVENT();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Configure the edge */
 | 
			
		||||
  if((sConfigPVD->Mode & PVD_RISING_EDGE) == PVD_RISING_EDGE)
 | 
			
		||||
  {
 | 
			
		||||
    __HAL_PWR_PVD_EXTI_ENABLE_RISING_EDGE();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if((sConfigPVD->Mode & PVD_FALLING_EDGE) == PVD_FALLING_EDGE)
 | 
			
		||||
  {
 | 
			
		||||
    __HAL_PWR_PVD_EXTI_ENABLE_FALLING_EDGE();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return HAL_OK;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable the Power Voltage Detector (PVD).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnablePVD(void)
 | 
			
		||||
{
 | 
			
		||||
  SET_BIT(PWR->CR2, PWR_CR2_PVDE);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable the Power Voltage Detector (PVD).
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DisablePVD(void)
 | 
			
		||||
{
 | 
			
		||||
  CLEAR_BIT(PWR->CR2, PWR_CR2_PVDE);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable the WakeUp PINx functionality.
 | 
			
		||||
  * @param WakeUpPinPolarity: Specifies which Wake-Up pin to enable.
 | 
			
		||||
  *         This parameter can be one of the following legacy values which set the default polarity
 | 
			
		||||
  *         i.e. detection on high level (rising edge):
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN1, PWR_WAKEUP_PIN2, PWR_WAKEUP_PIN3, PWR_WAKEUP_PIN4, PWR_WAKEUP_PIN5
 | 
			
		||||
  *
 | 
			
		||||
  *         or one of the following value where the user can explicitly specify the enabled pin and
 | 
			
		||||
  *         the chosen polarity:
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN1_HIGH or PWR_WAKEUP_PIN1_LOW
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN2_HIGH or PWR_WAKEUP_PIN2_LOW
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN3_HIGH or PWR_WAKEUP_PIN3_LOW
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN4_HIGH or PWR_WAKEUP_PIN4_LOW
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN5_HIGH or PWR_WAKEUP_PIN5_LOW
 | 
			
		||||
  * @note  PWR_WAKEUP_PINx and PWR_WAKEUP_PINx_HIGH are equivalent.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnableWakeUpPin(uint32_t WakeUpPinPolarity)
 | 
			
		||||
{
 | 
			
		||||
  assert_param(IS_PWR_WAKEUP_PIN(WakeUpPinPolarity));
 | 
			
		||||
 | 
			
		||||
  /* Specifies the Wake-Up pin polarity for the event detection
 | 
			
		||||
    (rising or falling edge) */
 | 
			
		||||
  MODIFY_REG(PWR->CR4, (PWR_CR3_EWUP & WakeUpPinPolarity), (WakeUpPinPolarity >> PWR_WUP_POLARITY_SHIFT));
 | 
			
		||||
 | 
			
		||||
  /* Enable wake-up pin */
 | 
			
		||||
  SET_BIT(PWR->CR3, (PWR_CR3_EWUP & WakeUpPinPolarity));
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable the WakeUp PINx functionality.
 | 
			
		||||
  * @param WakeUpPinx: Specifies the Power Wake-Up pin to disable.
 | 
			
		||||
  *         This parameter can be one of the following values:
 | 
			
		||||
  *           @arg @ref PWR_WAKEUP_PIN1, PWR_WAKEUP_PIN2, PWR_WAKEUP_PIN3, PWR_WAKEUP_PIN4, PWR_WAKEUP_PIN5
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DisableWakeUpPin(uint32_t WakeUpPinx)
 | 
			
		||||
{
 | 
			
		||||
  assert_param(IS_PWR_WAKEUP_PIN(WakeUpPinx));
 | 
			
		||||
 | 
			
		||||
  CLEAR_BIT(PWR->CR3, (PWR_CR3_EWUP & WakeUpPinx));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enter Sleep or Low-power Sleep mode.
 | 
			
		||||
  * @note  In Sleep/Low-power Sleep mode, all I/O pins keep the same state as in Run mode.
 | 
			
		||||
  * @param Regulator: Specifies the regulator state in Sleep/Low-power Sleep mode.
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg @ref PWR_MAINREGULATOR_ON Sleep mode (regulator in main mode)
 | 
			
		||||
  *            @arg @ref PWR_LOWPOWERREGULATOR_ON Low-power Sleep mode (regulator in low-power mode)
 | 
			
		||||
  * @note  Low-power Sleep mode is entered from Low-power Run mode. Therefore, if not yet
 | 
			
		||||
  *        in Low-power Run mode before calling HAL_PWR_EnterSLEEPMode() with Regulator set
 | 
			
		||||
  *        to PWR_LOWPOWERREGULATOR_ON, the user can optionally configure the
 | 
			
		||||
  *        Flash in power-down monde in setting the SLEEP_PD bit in FLASH_ACR register.
 | 
			
		||||
  *        Additionally, the clock frequency must be reduced below 2 MHz.
 | 
			
		||||
  *        Setting SLEEP_PD in FLASH_ACR then appropriately reducing the clock frequency must
 | 
			
		||||
  *        be done before calling HAL_PWR_EnterSLEEPMode() API.
 | 
			
		||||
  * @note  When exiting Low-power Sleep mode, the MCU is in Low-power Run mode. To move in
 | 
			
		||||
  *        Run mode, the user must resort to HAL_PWREx_DisableLowPowerRunMode() API.
 | 
			
		||||
  * @param SLEEPEntry: Specifies if Sleep mode is entered with WFI or WFE instruction.
 | 
			
		||||
  *           This parameter can be one of the following values:
 | 
			
		||||
  *            @arg @ref PWR_SLEEPENTRY_WFI enter Sleep or Low-power Sleep mode with WFI instruction
 | 
			
		||||
  *            @arg @ref PWR_SLEEPENTRY_WFE enter Sleep or Low-power Sleep mode with WFE instruction
 | 
			
		||||
  * @note  When WFI entry is used, tick interrupt have to be disabled if not desired as
 | 
			
		||||
  *        the interrupt wake up source.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnterSLEEPMode(uint32_t Regulator, uint8_t SLEEPEntry)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_PWR_REGULATOR(Regulator));
 | 
			
		||||
  assert_param(IS_PWR_SLEEP_ENTRY(SLEEPEntry));
 | 
			
		||||
 | 
			
		||||
  /* Set Regulator parameter */
 | 
			
		||||
  if (Regulator == PWR_MAINREGULATOR_ON)
 | 
			
		||||
  {
 | 
			
		||||
    /* If in low-power run mode at this point, exit it */
 | 
			
		||||
    if (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_REGLPF))
 | 
			
		||||
    {
 | 
			
		||||
      if (HAL_PWREx_DisableLowPowerRunMode() != HAL_OK)
 | 
			
		||||
      {
 | 
			
		||||
        return ;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    /* Regulator now in main mode. */
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    /* If in run mode, first move to low-power run mode.
 | 
			
		||||
       The system clock frequency must be below 2 MHz at this point. */
 | 
			
		||||
    if (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_REGLPF) == RESET)
 | 
			
		||||
    {
 | 
			
		||||
      HAL_PWREx_EnableLowPowerRunMode();
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  /* Clear SLEEPDEEP bit of Cortex System Control Register */
 | 
			
		||||
  CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk));
 | 
			
		||||
 | 
			
		||||
  /* Select SLEEP mode entry -------------------------------------------------*/
 | 
			
		||||
  if(SLEEPEntry == PWR_SLEEPENTRY_WFI)
 | 
			
		||||
  {
 | 
			
		||||
    /* Request Wait For Interrupt */
 | 
			
		||||
    __WFI();
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    /* Request Wait For Event */
 | 
			
		||||
    __SEV();
 | 
			
		||||
    __WFE();
 | 
			
		||||
    __WFE();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enter Stop mode
 | 
			
		||||
  * @note  This API is named HAL_PWR_EnterSTOPMode to ensure compatibility with legacy code running
 | 
			
		||||
  *        on devices where only "Stop mode" is mentioned with main or low power regulator ON.
 | 
			
		||||
  * @note  In Stop mode, all I/O pins keep the same state as in Run mode.
 | 
			
		||||
  * @note  All clocks in the VCORE domain are stopped; the PLL, the MSI,
 | 
			
		||||
  *        the HSI and the HSE oscillators are disabled. Some peripherals with the wakeup capability
 | 
			
		||||
  *        (I2Cx, USARTx and LPUART) can switch on the HSI to receive a frame, and switch off the HSI
 | 
			
		||||
  *        after receiving the frame if it is not a wakeup frame. In this case, the HSI clock is propagated
 | 
			
		||||
  *        only to the peripheral requesting it.
 | 
			
		||||
  *        SRAM1, SRAM2 and register contents are preserved.
 | 
			
		||||
  *        The BOR is available.
 | 
			
		||||
  *        The voltage regulator can be configured either in normal (Stop 0) or low-power mode (Stop 1).
 | 
			
		||||
  * @note  When exiting Stop 0 or Stop 1 mode by issuing an interrupt or a wakeup event,
 | 
			
		||||
  *         the HSI RC oscillator is selected as system clock if STOPWUCK bit in RCC_CFGR register
 | 
			
		||||
  *         is set; the MSI oscillator is selected if STOPWUCK is cleared.
 | 
			
		||||
  * @note  When the voltage regulator operates in low power mode (Stop 1), an additional
 | 
			
		||||
  *         startup delay is incurred when waking up.
 | 
			
		||||
  *         By keeping the internal regulator ON during Stop mode (Stop 0), the consumption
 | 
			
		||||
  *         is higher although the startup time is reduced.
 | 
			
		||||
  * @param Regulator: Specifies the regulator state in Stop mode.
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg @ref PWR_MAINREGULATOR_ON  Stop 0 mode (main regulator ON)
 | 
			
		||||
  *            @arg @ref PWR_LOWPOWERREGULATOR_ON  Stop 1 mode (low power regulator ON)
 | 
			
		||||
  * @param STOPEntry: Specifies Stop 0 or Stop 1 mode is entered with WFI or WFE instruction.
 | 
			
		||||
  *          This parameter can be one of the following values:
 | 
			
		||||
  *            @arg @ref PWR_STOPENTRY_WFI  Enter Stop 0 or Stop 1 mode with WFI instruction.
 | 
			
		||||
  *            @arg @ref PWR_STOPENTRY_WFE  Enter Stop 0 or Stop 1 mode with WFE instruction.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnterSTOPMode(uint32_t Regulator, uint8_t STOPEntry)
 | 
			
		||||
{
 | 
			
		||||
  /* Check the parameters */
 | 
			
		||||
  assert_param(IS_PWR_REGULATOR(Regulator));
 | 
			
		||||
 | 
			
		||||
  if(Regulator == PWR_LOWPOWERREGULATOR_ON)
 | 
			
		||||
  {
 | 
			
		||||
    HAL_PWREx_EnterSTOP1Mode(STOPEntry);
 | 
			
		||||
  }
 | 
			
		||||
  else
 | 
			
		||||
  {
 | 
			
		||||
    HAL_PWREx_EnterSTOP0Mode(STOPEntry);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enter Standby mode.
 | 
			
		||||
  * @note  In Standby mode, the PLL, the HSI, the MSI and the HSE oscillators are switched
 | 
			
		||||
  *        off. The voltage regulator is disabled, except when SRAM2 content is preserved
 | 
			
		||||
  *        in which case the regulator is in low-power mode.
 | 
			
		||||
  *        SRAM1 and register contents are lost except for registers in the Backup domain and
 | 
			
		||||
  *        Standby circuitry. SRAM2 content can be preserved if the bit RRS is set in PWR_CR3 register.
 | 
			
		||||
  *        To enable this feature, the user can resort to HAL_PWREx_EnableSRAM2ContentRetention() API
 | 
			
		||||
  *        to set RRS bit.
 | 
			
		||||
  *        The BOR is available.
 | 
			
		||||
  * @note  The I/Os can be configured either with a pull-up or pull-down or can be kept in analog state.
 | 
			
		||||
  *        HAL_PWREx_EnableGPIOPullUp() and HAL_PWREx_EnableGPIOPullDown() respectively enable Pull Up and
 | 
			
		||||
  *        Pull Down state, HAL_PWREx_DisableGPIOPullUp() and HAL_PWREx_DisableGPIOPullDown() disable the
 | 
			
		||||
  *        same.
 | 
			
		||||
  *        These states are effective in Standby mode only if APC bit is set through
 | 
			
		||||
  *        HAL_PWREx_EnablePullUpPullDownConfig() API.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnterSTANDBYMode(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set Stand-by mode */
 | 
			
		||||
  MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, PWR_CR1_LPMS_STANDBY);
 | 
			
		||||
 | 
			
		||||
  /* Set SLEEPDEEP bit of Cortex System Control Register */
 | 
			
		||||
  SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk));
 | 
			
		||||
 | 
			
		||||
/* This option is used to ensure that store operations are completed */
 | 
			
		||||
#if defined ( __CC_ARM)
 | 
			
		||||
  __force_stores();
 | 
			
		||||
#endif
 | 
			
		||||
  /* Request Wait For Interrupt */
 | 
			
		||||
  __WFI();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Indicate Sleep-On-Exit when returning from Handler mode to Thread mode.
 | 
			
		||||
  * @note Set SLEEPONEXIT bit of SCR register. When this bit is set, the processor
 | 
			
		||||
  *       re-enters SLEEP mode when an interruption handling is over.
 | 
			
		||||
  *       Setting this bit is useful when the processor is expected to run only on
 | 
			
		||||
  *       interruptions handling.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnableSleepOnExit(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set SLEEPONEXIT bit of Cortex System Control Register */
 | 
			
		||||
  SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPONEXIT_Msk));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable Sleep-On-Exit feature when returning from Handler mode to Thread mode.
 | 
			
		||||
  * @note Clear SLEEPONEXIT bit of SCR register. When this bit is set, the processor
 | 
			
		||||
  *       re-enters SLEEP mode when an interruption handling is over.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DisableSleepOnExit(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Clear SLEEPONEXIT bit of Cortex System Control Register */
 | 
			
		||||
  CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPONEXIT_Msk));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable CORTEX M4 SEVONPEND bit.
 | 
			
		||||
  * @note Set SEVONPEND bit of SCR register. When this bit is set, this causes
 | 
			
		||||
  *       WFE to wake up when an interrupt moves from inactive to pended.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_EnableSEVOnPend(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Set SEVONPEND bit of Cortex System Control Register */
 | 
			
		||||
  SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SEVONPEND_Msk));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Disable CORTEX M4 SEVONPEND bit.
 | 
			
		||||
  * @note Clear SEVONPEND bit of SCR register. When this bit is set, this causes
 | 
			
		||||
  *       WFE to wake up when an interrupt moves from inactive to pended.
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
void HAL_PWR_DisableSEVOnPend(void)
 | 
			
		||||
{
 | 
			
		||||
  /* Clear SEVONPEND bit of Cortex System Control Register */
 | 
			
		||||
  CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SEVONPEND_Msk));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief PWR PVD interrupt callback
 | 
			
		||||
  * @retval None
 | 
			
		||||
  */
 | 
			
		||||
__weak void HAL_PWR_PVDCallback(void)
 | 
			
		||||
{
 | 
			
		||||
  /* NOTE : This function should not be modified; when the callback is needed,
 | 
			
		||||
            the HAL_PWR_PVDCallback can be implemented in the user file
 | 
			
		||||
   */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
#endif /* HAL_PWR_MODULE_ENABLED */
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @}
 | 
			
		||||
  */
 | 
			
		||||
							
								
								
									
										1474
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_pwr_ex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1474
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_pwr_ex.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										1942
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_rcc.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1942
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_rcc.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										3556
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_rcc_ex.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										3556
									
								
								Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_rcc_ex.c
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue