初始版本
This commit is contained in:
@@ -0,0 +1,184 @@
|
||||
/******************************************************************************
|
||||
* Copyright (C) 2018, 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.h
|
||||
**
|
||||
** TRIM 数据结构及API声明
|
||||
**
|
||||
**
|
||||
** History:
|
||||
** - 2018-04-21 Lux V1.0
|
||||
**
|
||||
*****************************************************************************/
|
||||
|
||||
#ifndef __TRIM_H__
|
||||
#define __TRIM_H__
|
||||
|
||||
/*****************************************************************************
|
||||
* Include files
|
||||
*****************************************************************************/
|
||||
#include "ddl.h"
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \defgroup TrimGroup Clock Trimming (TRIM)
|
||||
**
|
||||
******************************************************************************/
|
||||
//@{
|
||||
|
||||
/******************************************************************************
|
||||
** Global pre-processor symbols/macros ('#define')
|
||||
******************************************************************************/
|
||||
|
||||
/******************************************************************************
|
||||
* Global type definitions
|
||||
******************************************************************************/
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \brief 监测模式使能枚举重定义 (MON_EN)
|
||||
*****************************************************************************/
|
||||
typedef enum en_trim_monitor
|
||||
{
|
||||
TrimMonDisable = 0u, ///< 禁止
|
||||
TrimMonEnable = 0x40u, ///< 使能
|
||||
}en_trim_monitor_t;
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \brief 待校准/监测时钟选择枚举重定义 (CALCLK_SEL)
|
||||
*****************************************************************************/
|
||||
typedef enum en_trim_calclksel
|
||||
{
|
||||
TrimCalMskRCH = 0x000u, ///< RCH
|
||||
TrimCalMskXTH = 0x010u, ///< XTH
|
||||
TrimCalMskRCL = 0x020u, ///< RCL
|
||||
TrimCalMskXTL = 0x030u, ///< XTL
|
||||
TrimCalMskPLL = 0x100u, ///< PLL
|
||||
}en_trim_calclksel_t;
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \brief 参考时钟选择枚举重定义 (REFCLK_SEL)
|
||||
*****************************************************************************/
|
||||
typedef enum en_trim_refclksel
|
||||
{
|
||||
TrimRefMskRCH = 0x0u, ///< RCH
|
||||
TrimRefMskXTH = 0x2u, ///< XTH
|
||||
TrimRefMskRCL = 0x4u, ///< RCL
|
||||
TrimRefMskXTL = 0x6u, ///< XTL
|
||||
TrimRefMskIRC10K = 0x8u, ///< IRC10K
|
||||
TrimRefMskExtClk = 0xau, ///< 外部输入时钟
|
||||
}en_trim_refclksel_t;
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \brief 中断标志类型枚举重定义
|
||||
*****************************************************************************/
|
||||
typedef enum en_trim_inttype
|
||||
{
|
||||
TrimStop = 0x01u, ///< 参考计数器停止标志
|
||||
TrimCalCntOf = 0x02u, ///< 校准计数器溢出标志
|
||||
TrimXTLFault = 0x04u, ///< XTL 失效标志
|
||||
TrimXTHFault = 0x08u, ///< XTH 失效标志
|
||||
TrimPLLFault = 0x10u, ///< PLL 失效标志
|
||||
}en_trim_inttype_t;
|
||||
|
||||
/**
|
||||
******************************************************************************
|
||||
** \brief TRIM 配置结构体定义
|
||||
*****************************************************************************/
|
||||
typedef struct stc_trim_cfg
|
||||
{
|
||||
en_trim_monitor_t enMON; ///< 监测模式使能
|
||||
en_trim_calclksel_t enCALCLK; ///< 校准时钟选择
|
||||
uint32_t u32CalCon; ///< 校准计数器溢出值配置
|
||||
en_trim_refclksel_t enREFCLK; ///< 参考时钟选择
|
||||
uint32_t u32RefCon; ///< 参考计数器初值配置
|
||||
}stc_trim_cfg_t;
|
||||
|
||||
/******************************************************************************
|
||||
* Global variable declarations ('extern', definition in C source)
|
||||
*****************************************************************************/
|
||||
|
||||
/******************************************************************************
|
||||
* Global function prototypes (definition in C source)
|
||||
*****************************************************************************/
|
||||
///<<功能配置及操作函数
|
||||
///<Trim 配置及初始化
|
||||
en_result_t Trim_Init(stc_trim_cfg_t* pstcCfg);
|
||||
///<校准/监测启动/停止
|
||||
void Trim_Run(void);
|
||||
void Trim_Stop(void);
|
||||
|
||||
///<参考计数器计数值获取
|
||||
uint32_t Trim_RefCntGet(void);
|
||||
///<校准计数器计数值获取
|
||||
uint32_t Trim_CalCntGet(void);
|
||||
|
||||
///<中断操作相关函数
|
||||
///中断使能/禁止
|
||||
void Trim_EnableIrq(void);
|
||||
void Trim_DisableIrq(void);
|
||||
///<中断标志获取
|
||||
boolean_t Trim_GetIntFlag(en_trim_inttype_t enIntType);
|
||||
///<中断标志清除
|
||||
en_result_t Trim_ClearIntFlag(en_trim_inttype_t enIntType);
|
||||
|
||||
//@} // TrimGroup
|
||||
|
||||
#ifdef __cplusplus
|
||||
#endif
|
||||
|
||||
|
||||
#endif /* __TRIM_H__ */
|
||||
/******************************************************************************
|
||||
* EOF (not truncated)
|
||||
*****************************************************************************/
|
||||
|
||||
|
||||
Reference in New Issue
Block a user