1 /******************************************************************************
2 *Copyright(C)2017, Huada Semiconductor Co.,Ltd All rights reserved.
3 *
4 * This software is owned and published by:
5 * Huada Semiconductor Co.,Ltd("HDSC").
6 *
7 * BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND
8 * BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT.
9 *
10 * This software contains source code for use with HDSC
11 * components. This software is licensed by HDSC to be adapted only
12 * for use in systems utilizing HDSC components. HDSC shall not be
13 * responsible for misuse or illegal use of this software for devices not
14 * supported herein. HDSC is providing this software "AS IS" and will
15 * not be responsible for issues arising from incorrect user implementation
16 * of the software.
17 *
18 * Disclaimer:
19 * HDSC MAKES NO WARRANTY, EXPRESS OR IMPLIED, ARISING BY LAW OR OTHERWISE,
20 * REGARDING THE SOFTWARE (INCLUDING ANY ACOOMPANYING WRITTEN MATERIALS),
21 * ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING,
22 * WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED
23 * WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED
24 * WARRANTY OF NONINFRINGEMENT.
25 * HDSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT,
26 * NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT
27 * LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
28 * LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR
29 * INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT,
30 * INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA,
31 * SAVINGS OR PROFITS,
32 * EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
33 * YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR
34 * INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED
35 * FROM, THE SOFTWARE.
36 *
37 * This software may be replicated in part or whole for the licensed use,
38 * with the restriction that this Disclaimer and Copyright notice must be
39 * included with each copy of this software, whether used in part or whole,
40 * at all times.
41 */
42
43 /** \file trim.c
44 **
45 ** Common API of trim.
46 ** @link trimGroup Some description @endlink
47 **
48 ** - 2017-05-16
49 **
50 ******************************************************************************/
51
52 /*******************************************************************************
53 * Include files
54 ******************************************************************************/
55 #include "hc32l196_trim.h"
56 /**
57 *******************************************************************************
58 ** \addtogroup TrimGroup
59 ******************************************************************************/
60 //@{
61
62 /*******************************************************************************
63 * Local pre-processor symbols/macros ('#define')
64 ******************************************************************************/
65
66 /*******************************************************************************
67 * Global variable definitions (declared in header file with 'extern')
68 ******************************************************************************/
69 #define IS_VALID_TRIMINT(x) (TrimStop == (x) ||\
70 TrimCalCntOf == (x) ||\
71 TrimXTLFault == (x) ||\
72 TrimXTHFault == (x) ||\
73 TrimPLLFault == (x))
74
75
76 /*******************************************************************************
77 * Local type definitions ('typedef')
78 ******************************************************************************/
79
80 /*******************************************************************************
81 * Local variable definitions ('static')
82 ******************************************************************************/
83
84 /*******************************************************************************
85 * Local function prototypes ('static')
86 ******************************************************************************/
87
88 /*******************************************************************************
89 * Function implementation - global ('extern') and local ('static')
90 ******************************************************************************/
91 /**
92 *****************************************************************************
93 ** \brief Trim中断标志获取
94 **
95 **
96 ** \param [in] enIntType 中断类型（RefStop、CalCntOf、XTAL32KFault、XTAL32MFault）
97 **
98 ** \retval TRUE or FALSE
99 *****************************************************************************/
Trim_GetIntFlag(en_trim_inttype_t enIntType)100 boolean_t Trim_GetIntFlag(en_trim_inttype_t enIntType)
101 {
102 ASSERT(IS_VALID_TRIMINT(enIntType));
103
104 if(M0P_CLK_TRIM->IFR&enIntType)
105 {
106 return TRUE;
107 }
108 else
109 {
110 return FALSE;
111 }
112
113 }
114
115 /**
116 *****************************************************************************
117 ** \brief Trim中断标志清除
118 **
119 **
120 ** \param [in] enIntType 中断类型（RefStop、CalCntOf、XTAL32KFault、XTAL32MFault）
121 **
122 ** \retval Ok or Error
123 *****************************************************************************/
Trim_ClearIntFlag(en_trim_inttype_t enIntType)124 en_result_t Trim_ClearIntFlag(en_trim_inttype_t enIntType)
125 {
126 en_result_t enResult = Error;
127
128 ASSERT(IS_VALID_TRIMINT(enIntType));
129
130 M0P_CLK_TRIM->ICLR &= ~(uint32_t)enIntType;
131
132 return enResult;
133 }
134
135
136
137 /**
138 *****************************************************************************
139 ** \brief Trim中断使能
140 **
141 **
142 **
143 ** \retval Null
144 *****************************************************************************/
Trim_EnableIrq(void)145 void Trim_EnableIrq (void)
146 {
147 M0P_CLK_TRIM->CR_f.IE = TRUE;
148 }
149
150 /**
151 *****************************************************************************
152 ** \brief Trim中断禁止
153 **
154 **
155 **
156 **
157 ** \retval Ok or Error
158 *****************************************************************************/
Trim_DisableIrq(void)159 void Trim_DisableIrq(void)
160 {
161 M0P_CLK_TRIM->CR_f.IE = FALSE;
162 }
163
164 /**
165 *****************************************************************************
166 ** \brief Trim初始化配置
167 **
168 **
169 ** \param [in] pstcCfg Trim配置结构体指针
170 **
171 ** \retval Ok or Error
172 *****************************************************************************/
Trim_Init(stc_trim_cfg_t * pstcCfg)173 en_result_t Trim_Init(stc_trim_cfg_t* pstcCfg)
174 {
175 en_result_t enResult = Error;
176
177 M0P_CLK_TRIM->CR = 0;
178
179 M0P_CLK_TRIM->CR = (uint32_t)pstcCfg->enCALCLK |
180 (uint32_t)pstcCfg->enREFCLK |
181 (uint32_t)pstcCfg->enMON;
182
183 M0P_CLK_TRIM->REFCON = pstcCfg->u32RefCon;
184 M0P_CLK_TRIM->CALCON = pstcCfg->u32CalCon;
185
186 enResult = Ok;
187
188 return enResult;
189 }
190
191 /**
192 *****************************************************************************
193 ** \brief Trim校准/监测启动运行
194 **
195 **
196 **
197 ** \retval Null
198 *****************************************************************************/
Trim_Run(void)199 void Trim_Run(void)
200 {
201 M0P_CLK_TRIM->CR_f.TRIM_START = TRUE;
202 }
203
204 /**
205 *****************************************************************************
206 ** \brief Trim校准/监测停止
207 **
208 **
209 **
210 **
211 ** \retval Null
212 *****************************************************************************/
Trim_Stop(void)213 void Trim_Stop(void)
214 {
215 M0P_CLK_TRIM->CR_f.TRIM_START = FALSE;
216 }
217
218 /**
219 *****************************************************************************
220 ** \brief Trim参考计数器计数值获取
221 **
222 **
223 ** \retval u32Data 参考计数器计数值
224 *****************************************************************************/
Trim_RefCntGet(void)225 uint32_t Trim_RefCntGet(void)
226 {
227 return (uint32_t)M0P_CLK_TRIM->REFCNT;
228 }
229
230 /**
231 *****************************************************************************
232 ** \brief Trim校准计数器计数值获取
233 **
234 **
235 **
236 **
237 ** \retval u32Data 校准计数器计数值
238 *****************************************************************************/
Trim_CalCntGet(void)239 uint32_t Trim_CalCntGet(void)
240 {
241 return (uint32_t)M0P_CLK_TRIM->CALCNT;
242 }
243
244 //@} // TrimGroup
245
246 /*******************************************************************************
247 * EOF (not truncated)
248 ******************************************************************************/
249