/****************************************************************************** *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) ******************************************************************************/