AMiRo-OS

/**

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

  * @file    stm32f4xx_tim.c

  * @author  MCD Application Team

  * @version V1.1.0

  * @date    11-January-2013

  * @brief   This file provides firmware functions to manage the following 

  *          functionalities of the TIM peripheral:

  *            + TimeBase management

  *            + Output Compare management

  *            + Input Capture management

  *            + Advanced-control timers (TIM1 and TIM8) specific features  

  *            + Interrupts, DMA and flags management

  *            + Clocks management

  *            + Synchronization management

  *            + Specific interface management

  *            + Specific remapping management      

  *              

  @verbatim   

 ===============================================================================

                   #####  How to use this driver #####

 ===============================================================================

    [..]

    This driver provides functions to configure and program the TIM 

    of all STM32F4xx devices.

    These functions are split in 9 groups: 

      (#) TIM TimeBase management: this group includes all needed functions 

          to configure the TM Timebase unit:

        (++) Set/Get Prescaler

        (++) Set/Get Autoreload  

        (++) Counter modes configuration

        (++) Set Clock division  

        (++) Select the One Pulse mode

        (++) Update Request Configuration

        (++) Update Disable Configuration

        (++) Auto-Preload Configuration 

        (++) Enable/Disable the counter     

      (#) TIM Output Compare management: this group includes all needed 

          functions to configure the Capture/Compare unit used in Output 

          compare mode: 

        (++) Configure each channel, independently, in Output Compare mode

        (++) Select the output compare modes

        (++) Select the Polarities of each channel

        (++) Set/Get the Capture/Compare register values

        (++) Select the Output Compare Fast mode 

        (++) Select the Output Compare Forced mode  

        (++) Output Compare-Preload Configuration 

        (++) Clear Output Compare Reference

        (++) Select the OCREF Clear signal

        (++) Enable/Disable the Capture/Compare Channels    

      (#) TIM Input Capture management: this group includes all needed 

          functions to configure the Capture/Compare unit used in 

          Input Capture mode:

        (++) Configure each channel in input capture mode

        (++) Configure Channel1/2 in PWM Input mode

        (++) Set the Input Capture Prescaler

        (++) Get the Capture/Compare values      

      (#) Advanced-control timers (TIM1 and TIM8) specific features

        (++) Configures the Break input, dead time, Lock level, the OSSI,

             the OSSR State and the AOE(automatic output enable)

        (++) Enable/Disable the TIM peripheral Main Outputs

        (++) Select the Commutation event

        (++) Set/Reset the Capture Compare Preload Control bit

      (#) TIM interrupts, DMA and flags management

        (++) Enable/Disable interrupt sources

        (++) Get flags status

        (++) Clear flags/ Pending bits

        (++) Enable/Disable DMA requests 

        (++) Configure DMA burst mode

        (++) Select CaptureCompare DMA request  

      (#) TIM clocks management: this group includes all needed functions 

          to configure the clock controller unit:

        (++) Select internal/External clock

        (++) Select the external clock mode: ETR(Mode1/Mode2), TIx or ITRx

      (#) TIM synchronization management: this group includes all needed 

          functions to configure the Synchronization unit:

        (++) Select Input Trigger  

        (++) Select Output Trigger  

        (++) Select Master Slave Mode 

        (++) ETR Configuration when used as external trigger   

      (#) TIM specific interface management, this group includes all 

          needed functions to use the specific TIM interface:

        (++) Encoder Interface Configuration

        (++) Select Hall Sensor   

      (#) TIM specific remapping management includes the Remapping 

          configuration of specific timers               

  @endverbatim    

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

  * @attention

  *

  * <h2><center>&copy; COPYRIGHT 2013 STMicroelectronics</center></h2>

  *

  * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");

  * You may not use this file except in compliance with the License.

  * You may obtain a copy of the License at:

  *

  *        http://www.st.com/software_license_agreement_liberty_v2

  *

  * Unless required by applicable law or agreed to in writing, software 

  * distributed under the License is distributed on an "AS IS" BASIS, 

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  *

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

  */

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

#include "stm32f4xx_tim.h"

#include "stm32f4xx_rcc.h"

/** @addtogroup STM32F4xx_StdPeriph_Driver

  * @{

  */

/** @defgroup TIM 

  * @brief TIM driver modules

  * @{

  */

/* Private typedef -----------------------------------------------------------*/

/* Private define ------------------------------------------------------------*/

/* ---------------------- TIM registers bit mask ------------------------ */

#define SMCR_ETR_MASK      ((uint16_t)0x00FF) 

#define CCMR_OFFSET        ((uint16_t)0x0018)

#define CCER_CCE_SET       ((uint16_t)0x0001)  

#define        CCER_CCNE_SET      ((uint16_t)0x0004) 

#define CCMR_OC13M_MASK    ((uint16_t)0xFF8F)

#define CCMR_OC24M_MASK    ((uint16_t)0x8FFF) 

/* Private macro -------------------------------------------------------------*/

/* Private variables ---------------------------------------------------------*/

/* Private function prototypes -----------------------------------------------*/

static void TI1_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection,

                       uint16_t TIM_ICFilter);

static void TI2_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection,

                       uint16_t TIM_ICFilter);

static void TI3_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection,

                       uint16_t TIM_ICFilter);

static void TI4_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection,

                       uint16_t TIM_ICFilter);

/* Private functions ---------------------------------------------------------*/

/** @defgroup TIM_Private_Functions

  * @{

  */

/** @defgroup TIM_Group1 TimeBase management functions

 *  @brief   TimeBase management functions 

 *

@verbatim   

 ===============================================================================

                     ##### TimeBase management functions #####

 ===============================================================================  

            ##### TIM Driver: how to use it in Timing(Time base) Mode #####

 ===============================================================================

    [..] 

    To use the Timer in Timing(Time base) mode, the following steps are mandatory:

      (#) Enable TIM clock using RCC_APBxPeriphClockCmd(RCC_APBxPeriph_TIMx, ENABLE) function

      (#) Fill the TIM_TimeBaseInitStruct with the desired parameters.

      (#) Call TIM_TimeBaseInit(TIMx, &TIM_TimeBaseInitStruct) to configure the Time Base unit

          with the corresponding configuration

      (#) Enable the NVIC if you need to generate the update interrupt. 

      (#) Enable the corresponding interrupt using the function TIM_ITConfig(TIMx, TIM_IT_Update) 

      (#) Call the TIM_Cmd(ENABLE) function to enable the TIM counter.

       -@- All other functions can be used separately to modify, if needed,

           a specific feature of the Timer. 

@endverbatim

  * @{

  */

/**

  * @brief  Deinitializes the TIMx peripheral registers to their default reset values.

  * @param  TIMx: where x can be 1 to 14 to select the TIM peripheral.

  * @retval None

  */

void TIM_DeInit(TIM_TypeDef* TIMx)

{

  /* Check the parameters */

  assert_param(IS_TIM_ALL_PERIPH(TIMx)); 

  if (TIMx == TIM1)

  {

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM1, ENABLE);

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM1, DISABLE);  

  } 

  else if (TIMx == TIM2) 

  {     

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM2, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM2, DISABLE);

  }  

  else if (TIMx == TIM3)

  { 

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM3, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM3, DISABLE);

  }  

  else if (TIMx == TIM4)

  { 

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM4, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM4, DISABLE);

  }  

  else if (TIMx == TIM5)

  {      

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM5, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM5, DISABLE);

  }  

  else if (TIMx == TIM6)  

  {    

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM6, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM6, DISABLE);

  }  

  else if (TIMx == TIM7)

  {      

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM7, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM7, DISABLE);

  }  

  else if (TIMx == TIM8)

  {      

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM8, ENABLE);

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM8, DISABLE);  

  }  

  else if (TIMx == TIM9)

  {      

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM9, ENABLE);

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM9, DISABLE);  

   }  

  else if (TIMx == TIM10)

  {      

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM10, ENABLE);

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM10, DISABLE);  

  }  

  else if (TIMx == TIM11) 

  {     

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM11, ENABLE);

    RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM11, DISABLE);  

  }  

  else if (TIMx == TIM12)

  {      

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM12, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM12, DISABLE);  

  }  

  else if (TIMx == TIM13) 

  {       

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM13, ENABLE);

    RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM13, DISABLE);  

  }  

  else

  { 

    if (TIMx == TIM14) 

    {     

      RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM14, ENABLE);

      RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM14, DISABLE); 

    }   

  }

}

/**

  * @brief  Initializes the TIMx Time Base Unit peripheral according to 

  *         the specified parameters in the TIM_TimeBaseInitStruct.

  * @param  TIMx: where x can be  1 to 14 to select the TIM peripheral.

  * @param  TIM_TimeBaseInitStruct: pointer to a TIM_TimeBaseInitTypeDef structure

  *         that contains the configuration information for the specified TIM peripheral.

  * @retval None

  */

void TIM_TimeBaseInit(TIM_TypeDef* TIMx, TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct)

{

  uint16_t tmpcr1 = 0;

  /* Check the parameters */

  assert_param(IS_TIM_ALL_PERIPH(TIMx)); 

  assert_param(IS_TIM_COUNTER_MODE(TIM_TimeBaseInitStruct->TIM_CounterMode));

  assert_param(IS_TIM_CKD_DIV(TIM_TimeBaseInitStruct->TIM_ClockDivision));

  tmpcr1 = TIMx->CR1;  

  if((TIMx == TIM1) || (TIMx == TIM8)||

     (TIMx == TIM2) || (TIMx == TIM3)||

     (TIMx == TIM4) || (TIMx == TIM5)) 

  {

    /* Select the Counter Mode */

    tmpcr1 &= (uint16_t)(~(TIM_CR1_DIR | TIM_CR1_CMS));

    tmpcr1 |= (uint32_t)TIM_TimeBaseInitStruct->TIM_CounterMode;

  }

  if((TIMx != TIM6) && (TIMx != TIM7))

  {

    /* Set the clock division */

    tmpcr1 &=  (uint16_t)(~TIM_CR1_CKD);

    tmpcr1 |= (uint32_t)TIM_TimeBaseInitStruct->TIM_ClockDivision;

  }

  TIMx->CR1 = tmpcr1;

  /* Set the Autoreload value */

  TIMx->ARR = TIM_TimeBaseInitStruct->TIM_Period ;

  /* Set the Prescaler value */

  TIMx->PSC = TIM_TimeBaseInitStruct->TIM_Prescaler;

  if ((TIMx == TIM1) || (TIMx == TIM8))  

  {

    /* Set the Repetition Counter value */

    TIMx->RCR = TIM_TimeBaseInitStruct->TIM_RepetitionCounter;

  }

  /* Generate an update event to reload the Prescaler 

     and the repetition counter(only for TIM1 and TIM8) value immediatly */

  TIMx->EGR = TIM_PSCReloadMode_Immediate;          

}

/**

  * @brief  Fills each TIM_TimeBaseInitStruct member with its default value.

  * @param  TIM_TimeBaseInitStruct : pointer to a TIM_TimeBaseInitTypeDef

  *         structure which will be initialized.

  * @retval None

  */

void TIM_TimeBaseStructInit(TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct)

{

  /* Set the default configuration */

  TIM_TimeBaseInitStruct->TIM_Period = 0xFFFFFFFF;

  TIM_TimeBaseInitStruct->TIM_Prescaler = 0x0000;

  TIM_TimeBaseInitStruct->TIM_ClockDivision = TIM_CKD_DIV1;

  TIM_TimeBaseInitStruct->TIM_CounterMode = TIM_CounterMode_Up;

  TIM_TimeBaseInitStruct->TIM_RepetitionCounter = 0x0000;

}

/**

  * @brief  Configures the TIMx Prescaler.

  * @param  TIMx: where x can be  1 to 14 to select the TIM peripheral.

  * @param  Prescaler: specifies the Prescaler Register value

  * @param  TIM_PSCReloadMode: specifies the TIM Prescaler Reload mode

  *          This parameter can be one of the following values:

  *            @arg TIM_PSCReloadMode_Update: Th