WebSVN – DashDisplay – Diff – /branches/Dashboard_L152_v2/Drivers/STM32L1xx_HAL_Driver/Src/stm32l1xx_hal_timebase_tim_template.c

 /**
   ******************************************************************************
   * @file    stm32l1xx_hal_timebase_tim_template.c
   * @author  MCD Application Team
   * @brief   HAL time base based on the hardware TIM Template.
   *
   *          This file override the native HAL time base functions (defined as weak)
   *          the TIM time base:
-  *           + Intializes the TIM peripheral to generate a Period elapsed Event each 1ms
+  *           + Initializes the TIM peripheral to generate a Period elapsed Event each 1ms
   *           + HAL_IncTick is called inside HAL_TIM_PeriodElapsedCallback ie each 1ms
   *
- @verbatim
+  ******************************************************************************
-  ==============================================================================
+  * @attention
-                        ##### How to use this driver #####
+  *
-  ==============================================================================
+  * Copyright (c) 2017 STMicroelectronics.
-    [..]
+  * All rights reserved.
-    This file must be copied to the application folder and modified as follows:
+  *
-    (#) Rename it to 'stm32l1xx_hal_timebase_tim.c'
+  * This software is licensed under terms that can be found in the LICENSE file
-    (#) Add this file and the TIM HAL driver files to your project and make sure
+  * in the root directory of this software component.
-       HAL_TIM_MODULE_ENABLED is defined in stm32l1xx_hal_conf.h
+  * If no LICENSE file comes with this software, it is provided AS-IS.
+  *
-    [..]
+  ******************************************************************************
-    (@) The application needs to ensure that the time base is always set to 1 millisecond
+ @verbatim
-       to have correct HAL operation.
+  ==============================================================================
+                        ##### How to use this driver #####
-  @endverbatim
+  ==============================================================================
-  ******************************************************************************
+    [..]
-  * @attention
+    This file must be copied to the application folder and modified as follows:
-  *
+    (#) Rename it to 'stm32l1xx_hal_timebase_tim.c'
-  * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
+    (#) Add this file and the TIM HAL driver files to your project and make sure
-  * All rights reserved.</center></h2>
+       HAL_TIM_MODULE_ENABLED is defined in stm32l1xx_hal_conf.h
-  *
-  * This software component is licensed by ST under BSD 3-Clause license,
+    [..]
-  * the "License"; You may not use this file except in compliance with the
+    (@) The application needs to ensure that the time base is always set to 1 millisecond
-  * License. You may obtain a copy of the License at:
+       to have correct HAL operation.
-  *                        opensource.org/licenses/BSD-3-Clause
-  *
+  @endverbatim
   ******************************************************************************
   */
 /* Includes ------------------------------------------------------------------*/
 #include "stm32l1xx_hal.h"
 /** @addtogroup STM32L1xx_HAL_Driver
   * @{
   */
 /** @addtogroup HAL_TimeBase_TIM
   * @{
   */
 /* Private typedef -----------------------------------------------------------*/
 /* Private define ------------------------------------------------------------*/
 /* Private macro -------------------------------------------------------------*/
 /* Private variables ---------------------------------------------------------*/
 TIM_HandleTypeDef        TimHandle;
 /* Private function prototypes -----------------------------------------------*/
 void TIM6_IRQHandler(void);
 /* Private functions ---------------------------------------------------------*/
 /**
   * @brief  This function configures the TIM6 as a time base source.
   *         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 configured, by HAL_RCC_ClockConfig().
   * @param  TickPriority Tick interrupt priority.
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_InitTick (uint32_t TickPriority)
 {
   RCC_ClkInitTypeDef    clkconfig;
   uint32_t              uwTimclock, uwAPB1Prescaler = 0U;
   uint32_t              uwPrescalerValue = 0U;
   uint32_t              pFLatency;
   HAL_StatusTypeDef     status = HAL_OK;
   /* Enable TIM6 clock */
   __HAL_RCC_TIM6_CLK_ENABLE();
   /* Get clock configuration */
   HAL_RCC_GetClockConfig(&clkconfig, &pFLatency);
   /* Get APB1 prescaler */
   uwAPB1Prescaler = clkconfig.APB1CLKDivider;
   /* Compute TIM6 clock */
   if (uwAPB1Prescaler == RCC_HCLK_DIV1)
   {
     uwTimclock = HAL_RCC_GetPCLK1Freq();
   }
   else
   {
     uwTimclock = 2U * HAL_RCC_GetPCLK1Freq();
   }
   /* Compute the prescaler value to have TIM6 counter clock equal to 1MHz */
   uwPrescalerValue = (uint32_t) ((uwTimclock / 1000000U) - 1U);
   /* Initialize TIM6 */
   TimHandle.Instance = TIM6;
   /* Initialize TIMx peripheral as follow:
   + Period = [(TIM6CLK/1000) - 1]. to have a (1/1000) s time base.
   + Prescaler = (uwTimclock/1000000 - 1) to have a 1MHz counter clock.
   + ClockDivision = 0
   + Counter direction = Up
   */
   TimHandle.Init.Period = (1000000U / 1000U) - 1U;
   TimHandle.Init.Prescaler = uwPrescalerValue;
   TimHandle.Init.ClockDivision = 0U;
   TimHandle.Init.CounterMode = TIM_COUNTERMODE_UP;
   status = HAL_TIM_Base_Init(&TimHandle);
   if (status == HAL_OK)
   {
     /* Start the TIM time Base generation in interrupt mode */
     status = HAL_TIM_Base_Start_IT(&TimHandle);
     if (status == HAL_OK)
     {
       /* Enable the TIM6 global Interrupt */
       HAL_NVIC_EnableIRQ(TIM6_IRQn);
       if (TickPriority < (1UL << __NVIC_PRIO_BITS))
       {
         /*Configure the TIM6 IRQ priority */
         HAL_NVIC_SetPriority(TIM6_IRQn, TickPriority ,0);
         uwTickPrio = TickPriority;
       }
       else
       {
         status = HAL_ERROR;
       }
     }
   }
   /* Return function status */
   return status;
 }
 /**
   * @brief  Suspend Tick increment.
   * @note   Disable the tick increment by disabling TIM6 update interrupt.
   * @param  None
   * @retval None
   */
 void HAL_SuspendTick(void)
 {
   /* Disable TIM6 update interrupt */
   __HAL_TIM_DISABLE_IT(&TimHandle, TIM_IT_UPDATE);
 }
 /**
   * @brief  Resume Tick increment.
   * @note   Enable the tick increment by enabling TIM6 update interrupt.
   * @param  None
   * @retval None
   */
 void HAL_ResumeTick(void)
 {
   /* Enable TIM6 update interrupt */
   __HAL_TIM_ENABLE_IT(&TimHandle, TIM_IT_UPDATE);
 }
 /**
   * @brief  Period elapsed callback in non blocking mode
   * @note   This function is called  when TIM6 interrupt took place, inside
   * HAL_TIM_IRQHandler(). It makes a direct call to HAL_IncTick() to increment
   * a global variable "uwTick" used as application time base.
   * @param  htim  TIM handle
   * @retval None
   */
 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
 {
   HAL_IncTick();
 }
 /**
   * @brief  This function handles TIM interrupt request.
   * @param  None
   * @retval None
   */
 void TIM6_IRQHandler(void)
 {
   HAL_TIM_IRQHandler(&TimHandle);
 }
 /**
   * @}
   */
 /**
   * @}
   */
-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Subversion Repositories DashDisplay

(root)/branches/Dashboard_L152_v2/Drivers/STM32L1xx_HAL_Driver/Src/stm32l1xx_hal_timebase_tim_template.c – Rev 61 → 77