stm8l15x_beep.c

/** ****************************************************************************** * @file stm8l15x_beep.c * @author MCD Application Team * @version V1.0.0 * @date 09/14/2009 * @brief This file provides all the BEEP firmware functions. ****************************************************************************** * @copy * * 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. * * <h2><center>&copy; COPYRIGHT 2009 STMicroelectronics</center></h2> */ /* Includes ------------------------------------------------------------------*/ #include "stm8l15x_beep.h" /** @addtogroup STM8L15x_StdPeriph_Driver * @{ */ /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Private macro -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private function prototypes -----------------------------------------------*/ /* Private functions ---------------------------------------------------------*/ /* Public functions ----------------------------------------------------------*/ /** * @addtogroup BEEP_Public_Functions * @{ */ /** * @brief Deinitializes the BEEP peripheral registers to their default reset values. * @param None * @retval None */ void BEEP_DeInit(void) { BEEP->CSR1 = BEEP_CSR1_RESET_VALUE; BEEP->CSR2 = BEEP_CSR2_RESET_VALUE; } /** * @brief Initializes the BEEP function according to the specified parameters. * @param BEEP_Frequency Frequency selection. * This parameter can be one of the values of @ref BEEP_Frequency_TypeDef. * @retval None * @par Required preconditions: * The LS RC calibration must be performed before calling this function. */ void BEEP_Init(BEEP_Frequency_TypeDef BEEP_Frequency) { /* Check parameter */ assert_param(IS_BEEP_FREQUENCY(BEEP_Frequency)); /* Set a default calibration value if no calibration is done */ if ((BEEP->CSR2 & BEEP_CSR2_BEEPDIV) == BEEP_CSR2_BEEPDIV) { BEEP->CSR2 &= (uint8_t)(~BEEP_CSR2_BEEPDIV); /* Clear bits */ BEEP->CSR2 |= BEEP_CALIBRATION_DEFAULT; } /* Select the output frequency */ BEEP->CSR2 &= (uint8_t)(~BEEP_CSR2_BEEPSEL); BEEP->CSR2 |= (uint8_t)(BEEP_Frequency); } /** * @brief Enable or disable the BEEP function. * @param NewState Indicates the new state of the BEEP function. * @retval None * @par Required preconditions: * Initialisation of BEEP and LS RC calibration must be done before. */ void BEEP_Cmd(FunctionalState NewState) { /* Check the parameters */ assert_param(IS_FUNCTIONAL_STATE(NewState)); if (NewState != DISABLE) { /* Enable the BEEP peripheral */ BEEP->CSR2 |= BEEP_CSR2_BEEPEN; } else { /* Disable the BEEP peripheral */ BEEP->CSR2 &= (uint8_t)(~BEEP_CSR2_BEEPEN); } } /** * @brief Enable or disable the LS clock source connection to TIM for measurement. * @param NewState Indicates the new state of the LS clcok to TIM connection * @retval None */ void BEEP_LSClockToTIMConnectCmd(FunctionalState NewState) { /* Check the parameters */ assert_param(IS_FUNCTIONAL_STATE(NewState)); if (NewState != DISABLE) { /* Enable the BEEP peripheral */ BEEP->CSR2 |= BEEP_CSR1_MSR; } else { /* Disable the BEEP peripheral */ BEEP->CSR2 &= (uint8_t)(~BEEP_CSR1_MSR); } } /** * @brief Update CSR register with the measured LSI frequency. * @note Note on the Prescaler calculation: * A is the integer part of LSIFreqkHz/4 and x the decimal part. * x <= A/(1+2A) is equivalent to A >= x(1+2A) and also to 4A >= 4x(1+2A) [F1] * but we know that A + x = LSIFreqkHz/4 ==> 4x = LSIFreqkHz-4A * so [F1] can be written : * 4A >= (LSIFreqkHz-4A)(1+2A) * @param LSIFreqHz Low Speed RC frequency measured by timer (in Hz). * @retval None * @par Required preconditions: * BEEP must be disabled to avoid unwanted interrupts. */ void BEEP_LSICalibrationConfig(uint32_t LSIFreqHz) { uint16_t lsifreqkhz; uint16_t A; /* Check parameter */ assert_param(IS_LSI_FREQUENCY(LSIFreqHz)); lsifreqkhz = (uint16_t)(LSIFreqHz / 1000); /* Converts value in kHz */ /* Calculation of BEEPER calibration value */ BEEP->CSR2 &= (uint8_t)(~BEEP_CSR2_BEEPDIV); /* Clear bits */ A = (uint16_t)(lsifreqkhz >> 3U); /* Division by 8, keep integer part only */ if ((8U * A) >= ((lsifreqkhz - (8U * A)) * (1U + (2U * A)))) { BEEP->CSR2 |= (uint8_t)(A - 2U); } else { BEEP->CSR2 |= (uint8_t)(A - 1U); } } /** * @} */ /** * @} */ /******************* (C) COPYRIGHT 2009 STMicroelectronics *****END OF FILE****/

下载次数 2次 资源类型 工具软件 上传时间 2014-11-21