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 lvd.c
44 **
45 ** Low Voltage Detect driver API.
46 ** @link Lvd Group Some description @endlink
47 **
48 ** - 2017-06-28 Alex First Version
49 **
50 ******************************************************************************/
51
52 /******************************************************************************
53 * Include files
54 ******************************************************************************/
55 #include "hc32l196_lvd.h"
56
57 /**
58 ******************************************************************************
59 ** \addtogroup LvdGroup
60 ******************************************************************************/
61 //@{
62
63 /******************************************************************************
64 * Local pre-processor symbols/macros ('#define')
65 ******************************************************************************/
66
67 #define IS_VALID_INPUT(x) ( (x) <= LvdInputPB07 )
68
69 #define IS_VALID_THRESHOLD(x) ( (x) <= LvdTH3p3V )
70
71 #define IS_VALID_FILTER(x) ( (x) <= LvdFilter29ms )
72
73 #define IS_VALID_IRQTYPE(x) ( (x) <= LvdIrqFall )
74
75
76 /******************************************************************************
77 * Global variable definitions (declared in header file with 'extern') *
78 ******************************************************************************/
79
80 /******************************************************************************
81 * Local type definitions ('typedef')
82 ******************************************************************************/
83
84 /******************************************************************************
85 * Local function prototypes ('static')
86 ******************************************************************************/
87 // static void LvdEnableNvic(void);
88 // static void LvdDisableNvic(void);
89 // static en_result_t LvdEnable(en_lvd_type_t enType, boolean_t bFlag);
90
91 /******************************************************************************
92 * Local variable definitions ('static')
93 ******************************************************************************/
94
95 /*****************************************************************************
96 * Function implementation - global ('extern') and local ('static')
97 *****************************************************************************/
98 /**
99 * \brief
100 * 使能LVD中断
101 *
102 * \param [in] enType LVD中断类型
103 *
104 * \retval en_result_t Ok: 设置成功
105 * \retval en_result_t ErrorInvalidParameter: 无效类型
106 */
Lvd_EnableIrq(void)107 void Lvd_EnableIrq(void)
108 {
109 M0P_LVD->CR_f.IE = TRUE;
110 }
111
112 /**
113 * \brief
114 * 除能LVD中断
115 *
116 * \param 无
117 *
118 * \retval 无
119 */
Lvd_DisableIrq(void)120 void Lvd_DisableIrq(void)
121 {
122 M0P_LVD->CR_f.IE = FALSE;
123 }
124
125 /**
126 * \brief
127 * LVD初始化
128 *
129 * \param [in] pstcCfg LVD配置指针
130 *
131 * \retval 无
132 */
Lvd_Init(stc_lvd_cfg_t * pstcCfg)133 void Lvd_Init(stc_lvd_cfg_t *pstcCfg)
134 {
135 M0P_LVD->CR = 0;
136
137 M0P_LVD->CR = (uint32_t)pstcCfg->enAct |
138 (uint32_t)pstcCfg->enFilter |
139 (uint32_t)pstcCfg->enFilterTime |
140 (uint32_t)pstcCfg->enInputSrc |
141 (uint32_t)pstcCfg->enIrqType |
142 (uint32_t)pstcCfg->enThreshold;
143 }
144
145 /**
146 * \brief
147 * 使能LVD
148 *
149 * \param 无
150 *
151 * \retval 无
152 *
153 */
Lvd_Enable(void)154 void Lvd_Enable(void)
155 {
156 M0P_LVD->CR_f.LVDEN = 1u;
157 }
158
159 /**
160 * \brief
161 * 除能LVD
162 *
163 * \param 无
164 *
165 * \retval 无
166 */
Lvd_Disable(void)167 void Lvd_Disable(void)
168 {
169 M0P_LVD->CR_f.LVDEN = 0u;
170 }
171
172 /**
173 * \brief
174 * 获取LVD中断标志
175 *
176 * \param 无
177 *
178 * \retval boolean_t 中断标志
179 */
Lvd_GetIrqStat(void)180 boolean_t Lvd_GetIrqStat(void)
181 {
182 return M0P_LVD->IFR_f.INTF;
183
184 }
185
186 /**
187 * \brief
188 * 清除LVD中断标志
189 *
190 * \param 无
191 *
192 * \retval 无
193 */
Lvd_ClearIrq(void)194 void Lvd_ClearIrq(void)
195 {
196 M0P_LVD->IFR_f.INTF = 0u;
197 }
198
199 /**
200 * \brief
201 * 获取Filter结果
202 *
203 * \param 无
204 *
205 * \retval boolean_t Fliter结果
206 */
Lvd_GetFilterResult(void)207 boolean_t Lvd_GetFilterResult(void)
208 {
209 return (boolean_t)M0P_LVD->IFR_f.FILTER;
210 }
211 //@} // LvdGroup
212
213 /******************************************************************************
214 * EOF (not truncated)
215 ******************************************************************************/
216
217