STM32F4开发板----定时器（004）

叁歲伎倆 2022-05-19 21:06 195阅读 0赞

# 定时器 #

定时器功能：测量输入信号的脉冲长度（输入捕获）或者产生输出波形（输出比较和pwm）

# 1.通用定时器 #

## 1.1 初始化基本定时参数 ##

/**
      * @brief  TIM Time Base Init structure definition  
      * @note   This structure is used with all TIMx except for TIM6 and TIM7.  
      */
    
    typedef struct
    {
      uint16_t TIM_Prescaler;         /*!< Specifies the prescaler value used to divide the TIM clock.
                                           This parameter can be a number between 0x0000 and 0xFFFF */
      uint16_t TIM_CounterMode;       /*!< Specifies the counter mode.
                                           This parameter can be a value of @ref TIM_Counter_Mode */
      uint32_t TIM_Period;            /*!< Specifies the period value to be loaded into the active
                                           Auto-Reload Register at the next update event.
                                           This parameter must be a number between 0x0000 and 0xFFFF.  */
      uint16_t TIM_ClockDivision;     /*!< Specifies the clock division.
                                          This parameter can be a value of @ref TIM_Clock_Division_CKD */
      uint8_t TIM_RepetitionCounter;  /*!< Specifies the repetition counter value. Each time the RCR downcounter
                                           reaches zero, an update event is generated and counting restarts
                                           from the RCR value (N).
                                           This means in PWM mode that (N+1) corresponds to:
                                              - the number of PWM periods in edge-aligned mode
                                              - the number of half PWM period in center-aligned mode
                                           This parameter must be a number between 0x00 and 0xFF.
                                           @note This parameter is valid only for TIM1 and TIM8. */
    } TIM_TimeBaseInitTypeDef;

## 1.2 输出比较参数 ##

/**
      * @brief  TIM Output Compare Init structure definition  
      */
    
    typedef struct
    {
      uint16_t TIM_OCMode;        /*!< Specifies the TIM mode.
                                       This parameter can be a value of @ref TIM_Output_Compare_and_PWM_modes */
      uint16_t TIM_OutputState;   /*!< Specifies the TIM Output Compare state.
                                       This parameter can be a value of @ref TIM_Output_Compare_State */
      uint16_t TIM_OutputNState;  /*!< Specifies the TIM complementary Output Compare state.
                                       This parameter can be a value of @ref TIM_Output_Compare_N_State
                                       @note This parameter is valid only for TIM1 and TIM8. */
      uint32_t TIM_Pulse;         /*!< Specifies the pulse value to be loaded into the Capture Compare Register.
                                       This parameter can be a number between 0x0000 and 0xFFFF */
      uint16_t TIM_OCPolarity;    /*!< Specifies the output polarity.
                                       This parameter can be a value of @ref TIM_Output_Compare_Polarity */
      uint16_t TIM_OCNPolarity;   /*!< Specifies the complementary output polarity.
                                       This parameter can be a value of @ref TIM_Output_Compare_N_Polarity
                                       @note This parameter is valid only for TIM1 and TIM8. */
      uint16_t TIM_OCIdleState;   /*!< Specifies the TIM Output Compare pin state during Idle state.
                                       This parameter can be a value of @ref TIM_Output_Compare_Idle_State
                                       @note This parameter is valid only for TIM1 and TIM8. */
      uint16_t TIM_OCNIdleState;  /*!< Specifies the TIM Output Compare pin state during Idle state.
                                       This parameter can be a value of @ref TIM_Output_Compare_N_Idle_State
                                       @note This parameter is valid only for TIM1 and TIM8. */
    } TIM_OCInitTypeDef;

## 1.3 输入比较参数初始化 ##

/**
      * @brief  TIM Input Capture Init structure definition  
      */
    
    typedef struct
    {
    
      uint16_t TIM_Channel;      /*!< Specifies the TIM channel.
                                      This parameter can be a value of @ref TIM_Channel */
      uint16_t TIM_ICPolarity;   /*!< Specifies the active edge of the input signal.
                                      This parameter can be a value of @ref TIM_Input_Capture_Polarity */
      uint16_t TIM_ICSelection;  /*!< Specifies the input.
                                      This parameter can be a value of @ref TIM_Input_Capture_Selection */
      uint16_t TIM_ICPrescaler;  /*!< Specifies the Input Capture Prescaler.
                                      This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
      uint16_t TIM_ICFilter;     /*!< Specifies the input capture filter.
                                      This parameter can be a number between 0x0 and 0xF */
    } TIM_ICInitTypeDef;

## 1.4 TIM1 and TIM8 高级定时器死区初始化 ##

/**
      * @brief  BDTR structure definition
      * @note   This structure is used only with TIM1 and TIM8.    
      */
    
    typedef struct
    {
    
      uint16_t TIM_OSSRState;        /*!< Specifies the Off-State selection used in Run mode.
                                          This parameter can be a value of @ref TIM_OSSR_Off_State_Selection_for_Run_mode_state */
    
      uint16_t TIM_OSSIState;        /*!< Specifies the Off-State used in Idle state.
                                          This parameter can be a value of @ref TIM_OSSI_Off_State_Selection_for_Idle_mode_state */
    
      uint16_t TIM_LOCKLevel;        /*!< Specifies the LOCK level parameters.
                                          This parameter can be a value of @ref TIM_Lock_level */
    
      uint16_t TIM_DeadTime;         /*!< Specifies the delay time between the switching-off and the
                                          switching-on of the outputs.
                                          This parameter can be a number between 0x00 and 0xFF  */
    
      uint16_t TIM_Break;            /*!< Specifies whether the TIM Break input is enabled or not.
                                          This parameter can be a value of @ref TIM_Break_Input_enable_disable */
    
      uint16_t TIM_BreakPolarity;    /*!< Specifies the TIM Break Input pin polarity.
                                          This parameter can be a value of @ref TIM_Break_Polarity */
    
      uint16_t TIM_AutomaticOutput;  /*!< Specifies whether the TIM Automatic Output feature is enabled or not.
                                          This parameter can be a value of @ref TIM_AOE_Bit_Set_Reset */
    } TIM_BDTRInitTypeDef;

# 2 相关库函数 #

/* Exported macro ------------------------------------------------------------*/
    /* Exported functions --------------------------------------------------------*/
    
    /* TimeBase management ********************************************************/
    void TIM_DeInit(TIM_TypeDef* TIMx);
    void TIM_TimeBaseInit(TIM_TypeDef* TIMx, TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct);
    void TIM_TimeBaseStructInit(TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct);
    void TIM_PrescalerConfig(TIM_TypeDef* TIMx, uint16_t Prescaler, uint16_t TIM_PSCReloadMode);
    void TIM_CounterModeConfig(TIM_TypeDef* TIMx, uint16_t TIM_CounterMode);
    void TIM_SetCounter(TIM_TypeDef* TIMx, uint32_t Counter);
    void TIM_SetAutoreload(TIM_TypeDef* TIMx, uint32_t Autoreload);
    uint32_t TIM_GetCounter(TIM_TypeDef* TIMx);
    uint16_t TIM_GetPrescaler(TIM_TypeDef* TIMx);
    void TIM_UpdateDisableConfig(TIM_TypeDef* TIMx, FunctionalState NewState);
    void TIM_UpdateRequestConfig(TIM_TypeDef* TIMx, uint16_t TIM_UpdateSource);
    void TIM_ARRPreloadConfig(TIM_TypeDef* TIMx, FunctionalState NewState);
    void TIM_SelectOnePulseMode(TIM_TypeDef* TIMx, uint16_t TIM_OPMode);
    void TIM_SetClockDivision(TIM_TypeDef* TIMx, uint16_t TIM_CKD);
    void TIM_Cmd(TIM_TypeDef* TIMx, FunctionalState NewState);
    
    /* Output Compare management **************************************************/
    void TIM_OC1Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct);
    void TIM_OC2Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct);
    void TIM_OC3Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct);
    void TIM_OC4Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct);
    void TIM_OCStructInit(TIM_OCInitTypeDef* TIM_OCInitStruct);
    void TIM_SelectOCxM(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_OCMode);
    void TIM_SetCompare1(TIM_TypeDef* TIMx, uint32_t Compare1);
    void TIM_SetCompare2(TIM_TypeDef* TIMx, uint32_t Compare2);
    void TIM_SetCompare3(TIM_TypeDef* TIMx, uint32_t Compare3);
    void TIM_SetCompare4(TIM_TypeDef* TIMx, uint32_t Compare4);
    void TIM_ForcedOC1Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction);
    void TIM_ForcedOC2Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction);
    void TIM_ForcedOC3Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction);
    void TIM_ForcedOC4Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction);
    void TIM_OC1PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload);
    void TIM_OC2PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload);
    void TIM_OC3PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload);
    void TIM_OC4PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload);
    void TIM_OC1FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast);
    void TIM_OC2FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast);
    void TIM_OC3FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast);
    void TIM_OC4FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast);
    void TIM_ClearOC1Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear);
    void TIM_ClearOC2Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear);
    void TIM_ClearOC3Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear);
    void TIM_ClearOC4Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear);
    void TIM_OC1PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity);
    void TIM_OC1NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity);
    void TIM_OC2PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity);
    void TIM_OC2NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity);
    void TIM_OC3PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity);
    void TIM_OC3NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity);
    void TIM_OC4PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity);
    void TIM_CCxCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCx);
    void TIM_CCxNCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCxN);
    
    /* Input Capture management ***************************************************/
    void TIM_ICInit(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct);
    void TIM_ICStructInit(TIM_ICInitTypeDef* TIM_ICInitStruct);
    void TIM_PWMIConfig(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct);
    uint32_t TIM_GetCapture1(TIM_TypeDef* TIMx);
    uint32_t TIM_GetCapture2(TIM_TypeDef* TIMx);
    uint32_t TIM_GetCapture3(TIM_TypeDef* TIMx);
    uint32_t TIM_GetCapture4(TIM_TypeDef* TIMx);
    void TIM_SetIC1Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC);
    void TIM_SetIC2Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC);
    void TIM_SetIC3Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC);
    void TIM_SetIC4Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC);
    
    /* Advanced-control timers (TIM1 and TIM8) specific features ******************/
    void TIM_BDTRConfig(TIM_TypeDef* TIMx, TIM_BDTRInitTypeDef *TIM_BDTRInitStruct);
    void TIM_BDTRStructInit(TIM_BDTRInitTypeDef* TIM_BDTRInitStruct);
    void TIM_CtrlPWMOutputs(TIM_TypeDef* TIMx, FunctionalState NewState);
    void TIM_SelectCOM(TIM_TypeDef* TIMx, FunctionalState NewState);
    void TIM_CCPreloadControl(TIM_TypeDef* TIMx, FunctionalState NewState);
    
    /* Interrupts, DMA and flags management ***************************************/
    void TIM_ITConfig(TIM_TypeDef* TIMx, uint16_t TIM_IT, FunctionalState NewState);
    void TIM_GenerateEvent(TIM_TypeDef* TIMx, uint16_t TIM_EventSource);
    FlagStatus TIM_GetFlagStatus(TIM_TypeDef* TIMx, uint16_t TIM_FLAG);
    void TIM_ClearFlag(TIM_TypeDef* TIMx, uint16_t TIM_FLAG);
    ITStatus TIM_GetITStatus(TIM_TypeDef* TIMx, uint16_t TIM_IT);
    void TIM_ClearITPendingBit(TIM_TypeDef* TIMx, uint16_t TIM_IT);
    void TIM_DMAConfig(TIM_TypeDef* TIMx, uint16_t TIM_DMABase, uint16_t TIM_DMABurstLength);
    void TIM_DMACmd(TIM_TypeDef* TIMx, uint16_t TIM_DMASource, FunctionalState NewState);
    void TIM_SelectCCDMA(TIM_TypeDef* TIMx, FunctionalState NewState);
    
    /* Clocks management **********************************************************/
    void TIM_InternalClockConfig(TIM_TypeDef* TIMx);
    void TIM_ITRxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource);
    void TIM_TIxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_TIxExternalCLKSource,
     uint16_t TIM_ICPolarity, uint16_t ICFilter);
    void TIM_ETRClockMode1Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, uint16_t TIM_ExtTRGPolarity,
     uint16_t ExtTRGFilter);
    void TIM_ETRClockMode2Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler,
     uint16_t TIM_ExtTRGPolarity, uint16_t ExtTRGFilter);
    
    /* Synchronization management *************************************************/
    void TIM_SelectInputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource);
    void TIM_SelectOutputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_TRGOSource);
    void TIM_SelectSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_SlaveMode);
    void TIM_SelectMasterSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_MasterSlaveMode);
    void TIM_ETRConfig(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, uint16_t TIM_ExtTRGPolarity,
     uint16_t ExtTRGFilter);
    
    /* Specific interface management **********************************************/   
    void TIM_EncoderInterfaceConfig(TIM_TypeDef* TIMx, uint16_t TIM_EncoderMode,
     uint16_t TIM_IC1Polarity, uint16_t TIM_IC2Polarity);
    void TIM_SelectHallSensor(TIM_TypeDef* TIMx, FunctionalState NewState);
    
    /* Specific remapping management **********************************************/
    void TIM_RemapConfig(TIM_TypeDef* TIMx, uint16_t TIM_Remap);