/**
******************************************************************************
* @file stm8l10x_tim4.c
* @brief This file contains all the functions for the TIM4 peripheral.
* @author STMicroelectronics - MCD Application Team
* @version V1.1.0
* @date 09/14/2009
******************************************************************************
*
* THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
* WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
* TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
* DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
* FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
* CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
*
*
© COPYRIGHT 2009 STMicroelectronics
* @image html logo.bmp
******************************************************************************
*/
/* Includes ------------------------------------------------------------------*/
#include "stm8l10x_tim4.h"
/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/**
* @addtogroup TIM4_Public_Functions
* @{
*/
/**
* @brief Deinitializes the TIM4 peripheral registers to their default reset values.
* @par Parameters:
* None
* @retval None
*/
void TIM4_DeInit(void)
{
TIM4->CR1 = TIM4_CR1_RESET_VALUE;
TIM4->CR2 = TIM4_CR2_RESET_VALUE;
TIM4->SMCR = TIM4_SMCR_RESET_VALUE;
TIM4->IER = TIM4_IER_RESET_VALUE;
TIM4->CNTR = TIM4_CNTR_RESET_VALUE;
TIM4->PSCR = TIM4_PSCR_RESET_VALUE;
TIM4->ARR = TIM4_ARR_RESET_VALUE;
TIM4->SR1 = TIM4_SR1_RESET_VALUE;
}
/**
* @brief Initializes the TIM4 Time Base Unit according to the specified
* parameters.
* @param[in] TIM4_Prescaler : This parameter can be any of the @Ref TIM2_Prescaler_TypeDef enumeration.
* @param[in] TIM4_Period : This parameter must be a value between 0x00 and 0xFF.
* @retval None
*/
void TIM4_TimeBaseInit(TIM4_Prescaler_TypeDef TIM4_Prescaler,
uint8_t TIM4_Period)
{
/* Check TIM4 prescaler value */
assert_param(IS_TIM4_PRESCALER(TIM4_Prescaler));
/* Set the Autoreload value */
TIM4->ARR = (uint8_t)(TIM4_Period);
/* Set the Prescaler value */
TIM4->PSCR = (uint8_t)(TIM4_Prescaler);
}
/**
* @brief Enables or disables the TIM4 peripheral.
* @param[in] NewState : The new state of the TIM4 peripheral.
* This parameter can be any of the @ref FunctionalState enumeration.
* @retval None
*/
void TIM4_Cmd(FunctionalState NewState)
{
/* Check the parameters */
assert_param(IS_FUNCTIONAL_STATE(NewState));
/* set or Reset the CEN Bit */
if (NewState != DISABLE)
{
TIM4->CR1 |= TIM4_CR1_CEN ;
}
else
{
TIM4->CR1 &= (uint8_t)(~TIM4_CR1_CEN) ;
}
}
/**
* @brief Enables or disables the specified TIM4 interrupts.
* @param[in] TIM4_IT : Specifies the TIM4 interrupts sources to be enabled or disabled.
* This parameter can be any combination of the @ref TIM4_IT_TypeDef enumeration.
* @param[in] NewState : The new state of the TIM4 peripheral.
* This parameter can be any of the @ref FunctionalState enumeration.
* @retval None
*/
void TIM4_ITConfig(TIM4_IT_TypeDef TIM4_IT, FunctionalState NewState)
{
/* Check the parameters */
assert_param(IS_TIM4_IT(TIM4_IT));
assert_param(IS_FUNCTIONAL_STATE(NewState));
if (NewState != DISABLE)
{
/* Enable the Interrupt sources */
TIM4->IER |= (uint8_t)TIM4_IT;
}
else
{
/* Disable the Interrupt sources */
TIM4->IER &= (uint8_t)(~(uint8_t)TIM4_IT);
}
}
/**
* @brief Enables the TIM4 internal Clock.
* @par Parameters:
* None
* @retval None
*/
void TIM4_InternalClockConfig(void)
{
/* Disable slave mode to clock the prescaler directly with the internal clock */
TIM4->SMCR &= (uint8_t)(~TIM4_SMCR_SMS);
}
/**
* @brief Selects the TIM4 Input Trigger source.
* @param[in] TIM4_InputTriggerSource : Specifies Input Trigger source.
* This parameter can be one of the @ref TIM4_TRGSelection_TypeDef enumeration.
* @retval None
*/
void TIM4_SelectInputTrigger(TIM4_TRGSelection_TypeDef TIM4_InputTriggerSource)
{
uint8_t tmpsmcr = 0;
/* Check the parameters */
assert_param(IS_TIM4_TRIGGER_SELECTION(TIM4_InputTriggerSource));
tmpsmcr = TIM4->SMCR;
/* Select the Tgigger Source */
tmpsmcr &= (uint8_t)(~TIM4_SMCR_TS);
tmpsmcr |= (uint8_t)TIM4_InputTriggerSource;
TIM4->SMCR = (uint8_t)tmpsmcr;
}
/**
* @brief Enables or Disables the TIM4 Update event.
* @param[in] NewState : The new state of the TIM4 peripheral Preload register.
* This parameter can be any of the @ref FunctionalState enumeration.
* @retval None
*/
void TIM4_UpdateDisableConfig(FunctionalState NewState)
{
/* Check the parameters */
assert_param(IS_FUNCTIONAL_STATE(NewState));
/* Set or Reset the UDIS Bit */
if (NewState != DISABLE)
{
TIM4->CR1 |= TIM4_CR1_UDIS ;
}
else
{
TIM4->CR1 &= (uint8_t)(~TIM4_CR1_UDIS) ;
}
}
/**
* @brief Selects the TIM4 Update Request Interrupt source.
* @param[in] TIM4_UpdateSource : Specifies the Update source.
* This parameter can be one of the @ref TIM4_UpdateSource_TypeDef enumeration.
* @retval None
*/
void TIM4_UpdateRequestConfig(TIM4_UpdateSource_TypeDef TIM4_UpdateSource)
{
/* Check the parameters */
assert_param(IS_TIM4_UPDATE_SOURCE(TIM4_UpdateSource));
/* Set or Reset the URS Bit */
if (TIM4_UpdateSource == TIM4_UpdateSource_Regular)
{
TIM4->CR1 |= TIM4_CR1_URS ;
}
else
{
TIM4->CR1 &= (uint8_t)(~TIM4_CR1_URS) ;
}
}
/**
* @brief Selects the TIM4’s One Pulse Mode.
* @param[in] TIM4_OPMode : Specifies the OPM Mode to be used.
* This parameter can be one of the @ref TIM4_OPMode_TypeDef enumeration.
* @retval None
*/
void TIM4_SelectOnePulseMode(TIM4_OPMode_TypeDef TIM4_OPMode)
{
/* Check the parameters */
assert_param(IS_TIM4_OPM_MODE(TIM4_OPMode));
/* Set or Reset the OPM Bit */
if (TIM4_OPMode == TIM4_OPMode_Single)
{
TIM4->CR1 |= TIM4_CR1_OPM ;
}
else
{
TIM4->CR1 &= (uint8_t)(~TIM4_CR1_OPM) ;
}
}
/**
* @brief Selects the TIM4 Trigger Output Mode.
* @param[in] TIM4_TRGOSource : Specifies the Trigger Output source.
* This parameter can be one of the @ref TIM4_TRGOSource_TypeDef enumeration.
* @retval None
*/
void TIM4_SelectOutputTrigger(TIM4_TRGOSource_TypeDef TIM4_TRGOSource)
{
uint8_t tmpcr2 = 0;
/* Check the parameters */
assert_param(IS_TIM4_TRGO_SOURCE(TIM4_TRGOSource));
tmpcr2 = TIM4->CR2;
/* Reset the MMS Bits */
tmpcr2 &= (uint8_t)(~TIM4_CR2_MMS);
/* Select the TRGO source */
tmpcr2 |= (uint8_t)TIM4_TRGOSource;
TIM4->CR2 = tmpcr2;
}
/**
* @brief Selects the TIM4 Slave Mode.
* @param[in] TIM4_SlaveMode : Specifies the TIM4 Slave Mode.
* This parameter can be one of the @ref TIM4_SlaveMode_TypeDef enumeration.
* @retval None
*/
void TIM4_SelectSlaveMode(TIM4_SlaveMode_TypeDef TIM4_SlaveMode)
{
uint8_t tmpsmcr = 0;
/* Check the parameters */
assert_param(IS_TIM4_SLAVE_MODE(TIM4_SlaveMode));
tmpsmcr = TIM4->SMCR;
/* Reset the SMS Bits */
tmpsmcr &= (uint8_t)(~TIM4_SMCR_SMS);
/* Select the Slave Mode */
tmpsmcr |= (uint8_t)TIM4_SlaveMode;
TIM4->SMCR = tmpsmcr;
}
/**
* @brief Sets or Resets the TIM4 Master/Slave Mode.
* @param[in] NewState : The new state of the synchronization between TIM4 and its slaves (through TRGO).
* This parameter can be any of the @ref FunctionalState enumeration.
* @retval None
*/
void TIM4_SelectMasterSlaveMode(FunctionalState NewState)
{
/* Check the parameters */
assert_param(IS_FUNCTIONAL_STATE(NewState));
/* Set or Reset the MSM Bit */
if (NewState != DISABLE)
{
TIM4->SMCR |= TIM4_SMCR_MSM;
}
else
{
TIM4->SMCR &= (uint8_t)(~TIM4_SMCR_MSM);
}
}
/**
* @brief Configures the TIM4 Prescaler.
* @param[in] TIM4_Prescaler : Specifies the Prescaler Register value
* This parameter can be one of the @ref TIM4_Prescaler_TypeDef enumeration.
* @param[in] TIM4_PSCReloadMode : Specifies the TIM4 Prescaler Reload mode.
* This parameter can be one of the @ref TIM4_PSCReloadMode_TypeDef enumeration.
* @retval None
*/
void TIM4_PrescalerConfig(TIM4_Prescaler_TypeDef TIM4_Prescaler,
TIM4_PSCReloadMode_TypeDef TIM4_PSCReloadMode)
{
/* Check the parameters */
assert_param(IS_TIM4_PRESCALER_RELOAD(TIM4_PSCReloadMode));
assert_param(IS_TIM4_PRESCALER(TIM4_Prescaler));
/* Set the Prescaler value */
TIM4->PSCR = TIM4_Prescaler;
/* Set or reset the UG Bit */
if (TIM4_PSCReloadMode == TIM4_PSCReloadMode_Immediate)
{
TIM4->EGR |= TIM4_EGR_UG ;
}
else
{
TIM4->EGR &= (uint8_t)(~TIM4_EGR_UG) ;
}
}
/**
* @brief Enables or disables TIM4 peripheral Preload register on ARR.
* @param[in] NewState : The new state of the TIM4 peripheral Preload register.
* This parameter can be any of the @ref FunctionalState enumeration.
* @retval None
*/
void TIM4_ARRPreloadConfig(FunctionalState NewState)
{
/* Check the parameters */
assert_param(IS_FUNCTIONAL_STATE(NewState));
/* Set or Reset the ARPE Bit */
if (NewState != DISABLE)
{
TIM4->CR1 |= TIM4_CR1_ARPE ;
}
else
{
TIM4->CR1 &= (uint8_t)(~TIM4_CR1_ARPE) ;
}
}
/**
* @brief Configures the TIM4 event to be generated by software.
* @param[in] TIM4_EventSource : Specifies the event source.
* This parameter can be one of the @ref TIM4_EventSource_TypeDef enumeration.
* @retval None
*/
void TIM4_GenerateEvent(TIM4_EventSource_TypeDef TIM4_EventSource)
{
/* Check the parameters */
assert_param(IS_TIM4_EVENT_SOURCE((uint8_t)TIM4_EventSource));
/* Set the event sources */
TIM4->EGR |= (uint8_t)TIM4_EventSource;
}
/**
* @brief Sets the TIM4 Counter Register value.
* @param[in] TIM4_Counter : Specifies the Counter register new value.
* This parameter is between 0x00 and 0xFF.
* @retval None
*/
void TIM4_SetCounter(uint8_t TIM4_Counter)
{
/* Set the Counter Register value */
TIM4->CNTR = (uint8_t)(TIM4_Counter);
}
/**
* @brief Sets the TIM4 Autoreload Register value.
* @param[in] TIM4_Autoreload : Specifies the Autoreload register new value.
* This parameter is between 0x00 and 0xFF.
* @retval None
*/
void TIM4_SetAutoreload(uint8_t TIM4_Autoreload)
{
/* Set the Autoreload Register value */
TIM4->ARR = (uint8_t)(TIM4_Autoreload);
}
/**
* @brief Gets the TIM4 Counter value.
* @par Parameters:
* None
* @retval uint8_t: Counter Register value.
*/
uint8_t TIM4_GetCounter(void)
{
uint8_t tmpcntr=0;
tmpcntr = TIM4->CNTR;
/* Get the Counter Register value */
return ((uint8_t)tmpcntr);
}
/**
* @brief Gets the TIM4 Prescaler value.
* @par Parameters:
* None
* @retval TIM4_Prescaler_TypeDef : Prescaler Register configuration value.
*/
TIM4_Prescaler_TypeDef TIM4_GetPrescaler(void)
{
/* Get the Prescaler Register value */
return ((TIM4_Prescaler_TypeDef)TIM4->PSCR);
}
/**
* @brief Checks whether the TIM4 device is enabled or not.
* @par Parameters:
* None
* @retval FunctionalState : The new state of the TIM4 device.
* This parameter can be any of the @ref FunctionalState enumeration.
*/
FunctionalState TIM4_GetStatus(void)
{
return ((FunctionalState) (TIM4->CR1 & TIM4_CR1_CEN));
}
/**
* @brief Checks whether the specified TIM4 flag is set or not.
* @param[in] TIM4_FLAG : Specifies the flag to check.
* This parameter can be one of the @ref TIM4_FLAG_TypeDef enumeration.
* @retval FlagStatus : The new state of TIM4_FLAG.
* This parameter can be any of the @ref FlagStatus enumeration.
*/
FlagStatus TIM4_GetFlagStatus(TIM4_FLAG_TypeDef TIM4_FLAG)
{
__IO FlagStatus bitstatus = RESET;
/* Check the parameters */
assert_param(IS_TIM4_GET_FLAG(TIM4_FLAG));
if ((TIM4->SR1 & (uint8_t)TIM4_FLAG) != 0)
{
bitstatus = SET;
}
else
{
bitstatus = RESET;
}
return ((FlagStatus)bitstatus);
}
/**
* @brief Clears the TIM’s pending flags.
* @param[in] TIM4_FLAG : Specifies the flag to clear.
* This parameter can be one of the @ref TIM4_FLAG_TypeDef enumeration.
* @retval None
*/
void TIM4_ClearFlag(TIM4_FLAG_TypeDef TIM4_FLAG)
{
/* Check the parameters */
assert_param(IS_TIM4_CLEAR_FLAG((uint8_t)TIM4_FLAG));
/* Clear the flags (rc_w0) clear this bit by writing 0. Writing ‘1’ has no effect*/
TIM4->SR1 = (uint8_t)(~((uint8_t)TIM4_FLAG));
}
/**
* @brief Checks whether the TIM4 interrupt has occurred or not.
* @param[in] TIM4_IT : Specifies the TIM4 interrupt source to check.
* This parameter can be one of the @ref TIM4_IT_TypeDef enumeration.
* @retval ITStatus : The new state of the TIM4_IT.
* This parameter can be any of the @ref ITStatus enumeration.
*/
ITStatus TIM4_GetITStatus(TIM4_IT_TypeDef TIM4_IT)
{
__IO ITStatus bitstatus = RESET;
__IO uint8_t itStatus = 0x0, itEnable = 0x0;
/* Check the parameters */
assert_param(IS_TIM4_GET_IT(TIM4_IT));
itStatus = (uint8_t)(TIM4->SR1 & (uint8_t)TIM4_IT);
itEnable = (uint8_t)(TIM4->IER & (uint8_t)TIM4_IT);
if ((itStatus != (uint8_t)RESET ) && (itEnable != (uint8_t)RESET ))
{
bitstatus = (ITStatus)SET;
}
else
{
bitstatus = (ITStatus)RESET;
}
return ((ITStatus)bitstatus);
}
/**
* @brief Clears the TIM4's interrupt pending bits.
* @param[in] TIM4_IT : Specifies the pending bit to clear.
* This parameter can be one of the @ref TIM4_IT_TypeDef enumeration.
* @retval None
*/
void TIM4_ClearITPendingBit(TIM4_IT_TypeDef TIM4_IT)
{
/* Check the parameters */
assert_param(IS_TIM4_IT(TIM4_IT));
/* Clear the IT pending Bit */
TIM4->SR1 = (uint8_t)(~(uint8_t)TIM4_IT);
}
/**
* @}
*/
/******************* (C) COPYRIGHT 2009 STMicroelectronics *****END OF FILE****/