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

349 lines
11 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/******************************************************************************
*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 中断类型RefStop、CalCntOf、XTAL32KFault、XTAL32MFault
**
** \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 中断类型RefStop、CalCntOf、XTAL32KFault、XTAL32MFault
**
** \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)
******************************************************************************/