rt-thread/bsp/hc32l136/Libraries/HC32L136_StdPeriph_Driver/src/trim.c

349 lines
11 KiB
C
Raw Normal View History

2021-08-21 14:10:33 +08:00
/******************************************************************************
*Copyright(C)2017, Huada Semiconductor Co.,Ltd All rights reserved.
*
* This software is owned and published by:
* Huada Semiconductor Co.,Ltd("HDSC").
*
* BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND
* BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT.
*
* This software contains source code for use with HDSC
* components. This software is licensed by HDSC to be adapted only
* for use in systems utilizing HDSC components. HDSC shall not be
* responsible for misuse or illegal use of this software for devices not
* supported herein. HDSC is providing this software "AS IS" and will
* not be responsible for issues arising from incorrect user implementation
* of the software.
*
* Disclaimer:
* HDSC MAKES NO WARRANTY, EXPRESS OR IMPLIED, ARISING BY LAW OR OTHERWISE,
* REGARDING THE SOFTWARE (INCLUDING ANY ACOOMPANYING WRITTEN MATERIALS),
* ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING,
* WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED
* WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED
* WARRANTY OF NONINFRINGEMENT.
* HDSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT,
* NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT
* LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
* LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR
* INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT,
* INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA,
* SAVINGS OR PROFITS,
* EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
* YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR
* INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED
* FROM, THE SOFTWARE.
*
* This software may be replicated in part or whole for the licensed use,
* with the restriction that this Disclaimer and Copyright notice must be
* included with each copy of this software, whether used in part or whole,
* at all times.
*/
/** \file trim.c
**
** Common API of trim.
** @link trimGroup Some description @endlink
**
** - 2017-05-16
**
******************************************************************************/
/*******************************************************************************
* Include files
******************************************************************************/
#include "trim.h"
/**
*******************************************************************************
** \addtogroup TrimGroup
******************************************************************************/
//@{
/*******************************************************************************
* Local pre-processor symbols/macros ('#define')
******************************************************************************/
/*******************************************************************************
* Global variable definitions (declared in header file with 'extern')
******************************************************************************/
#define IS_VALID_TRIMINT(x) (TrimStop == (x) ||\
TrimCalCntOf == (x) ||\
TrimXTLFault == (x) ||\
TrimXTHFault == (x) ||\
TrimPLLFault == (x))
/*******************************************************************************
* Local type definitions ('typedef')
******************************************************************************/
/*******************************************************************************
* Local variable definitions ('static')
******************************************************************************/
/*******************************************************************************
* Local function prototypes ('static')
******************************************************************************/
static func_ptr_t pfnTrimCallback = NULL;
/*******************************************************************************
* Function implementation - global ('extern') and local ('static')
******************************************************************************/
/**
*****************************************************************************
** \brief Trim中断标志获取
**
**
** \param [in] enIntType RefStopCalCntOfXTAL32KFaultXTAL32MFault
**
** \retval TRUE or FALSE
*****************************************************************************/
boolean_t Trim_GetIntFlag(en_trim_inttype_t enIntType)
{
boolean_t bRetVal = FALSE;
ASSERT(IS_VALID_TRIMINT(enIntType));
switch (enIntType)
{
case TrimStop:
bRetVal = M0P_CLK_TRIM->IFR_f.STOP ? TRUE : FALSE;
break;
case TrimCalCntOf:
bRetVal = M0P_CLK_TRIM->IFR_f.CALCNT_OF ? TRUE : FALSE;
break;
case TrimXTLFault:
bRetVal = M0P_CLK_TRIM->IFR_f.XTL_FAULT ? TRUE : FALSE;
break;
case TrimXTHFault:
bRetVal = M0P_CLK_TRIM->IFR_f.XTH_FAULT ? TRUE : FALSE;
break;
case TrimPLLFault:
bRetVal = M0P_CLK_TRIM->IFR_f.PLL_FAULT ? TRUE : FALSE;
break;
default:
bRetVal = FALSE;
break;
}
return bRetVal;
}
/**
*****************************************************************************
** \brief Trim中断标志清除
**
**
** \param [in] enIntType RefStopCalCntOfXTAL32KFaultXTAL32MFault
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_ClearIntFlag(en_trim_inttype_t enIntType)
{
en_result_t enResult = Error;
ASSERT(IS_VALID_TRIMINT(enIntType));
switch (enIntType)
{
case TrimStop:
M0P_CLK_TRIM->CR_f.TRIM_START = FALSE;
enResult = Ok;
break;
case TrimCalCntOf:
M0P_CLK_TRIM->CR_f.TRIM_START = FALSE;
enResult = Ok;
break;
case TrimXTLFault:
M0P_CLK_TRIM->ICLR_f.XTL_FAULT_CLR = FALSE;
enResult = Ok;
break;
case TrimXTHFault:
M0P_CLK_TRIM->ICLR_f.XTH_FAULT_CLR = FALSE;
enResult = Ok;
break;
case TrimPLLFault:
M0P_CLK_TRIM->ICLR_f.PLL_FAULT_CLR = FALSE;
enResult = Ok;
break;
default:
enResult = Error;
break;
}
return enResult;
}
/**
*****************************************************************************
** \brief Trim中断服务函数
**
**
** \param [in] u8Param == 0
**
** \retval NULL
*****************************************************************************/
void ClkTrim_IRQHandler(uint8_t u8Param)
{
if(NULL != pfnTrimCallback)
{
pfnTrimCallback();
}
}
/**
*****************************************************************************
** \brief Trim中断使能
**
**
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_EnableIrq (void)
{
en_result_t enResult = Error;
M0P_CLK_TRIM->CR_f.IE = TRUE;
enResult = Ok;
return enResult;
}
/**
*****************************************************************************
** \brief Trim中断禁止
**
**
**
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_DisableIrq(void)
{
en_result_t enResult = Error;
M0P_CLK_TRIM->CR_f.IE = FALSE;
enResult = Ok;
return enResult;
}
/**
*****************************************************************************
** \brief Trim初始化配置
**
**
** \param [in] pstcConfig Trim配置结构体指针
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_Init(stc_trim_config_t* pstcConfig)
{
en_result_t enResult = Error;
M0P_CLK_TRIM->CR_f.MON_EN = pstcConfig->enMON;
if (TrimCalPLL == pstcConfig->enCALCLK)
{
M0P_CLK_TRIM->CR_f.CALCLK_SEL2 = TRUE;
M0P_CLK_TRIM->CR_f.CALCLK_SEL = pstcConfig->enCALCLK;
}
else
{
M0P_CLK_TRIM->CR_f.CALCLK_SEL2 = FALSE;
M0P_CLK_TRIM->CR_f.CALCLK_SEL = pstcConfig->enCALCLK;
}
M0P_CLK_TRIM->CR_f.REFCLK_SEL = pstcConfig->enREFCLK;
M0P_CLK_TRIM->REFCON_f.RCNTVAL = pstcConfig->u32RefCon;
if(TrimMonEnable == pstcConfig->enMON)
{
M0P_CLK_TRIM->CALCON_f.CCNTVAL = pstcConfig->u32CalCon;
}
pfnTrimCallback = pstcConfig->pfnTrimCb;
enResult = Ok;
return enResult;
}
/**
*****************************************************************************
** \brief Trim校准/
**
**
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_Run(void)
{
en_result_t enResult = Error;
M0P_CLK_TRIM->CR_f.TRIM_START = TRUE;
enResult = Ok;
return enResult;
}
/**
*****************************************************************************
** \brief Trim校准/
**
**
**
**
** \retval Ok or Error
*****************************************************************************/
en_result_t Trim_Stop(void)
{
en_result_t enResult = Error;
M0P_CLK_TRIM->CR_f.TRIM_START = FALSE;
enResult = Ok;
return enResult;
}
/**
*****************************************************************************
** \brief Trim参考计数器计数值获取
**
**
** \retval u32Data
*****************************************************************************/
uint32_t Trim_RefCntGet(void)
{
uint32_t u32Data = 0;
u32Data = M0P_CLK_TRIM->REFCNT_f.REFCNT;
return u32Data;
}
/**
*****************************************************************************
** \brief Trim校准计数器计数值获取
**
**
**
**
** \retval u32Data
*****************************************************************************/
uint32_t Trim_CalCntGet(void)
{
uint32_t u32Data = 0;
u32Data = M0P_CLK_TRIM->CALCNT_f.CALCNT;
return u32Data;
}
//@} // TrimGroup
/*******************************************************************************
* EOF (not truncated)
******************************************************************************/