1 /*******************************************************************************
2 * Copyright (C) 2018, 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 rng.h
44  **
45  ** Headerfile for RNG functions
46  ** @link RNG Group Some description @endlink
47  **
48  ** History:
49  **   - 2018-04-15   Lux     First Version
50  **
51  ******************************************************************************/
52 
53 #ifndef __RNG_H__
54 #define __RNG_H__
55 
56 /*******************************************************************************
57  * Include files
58  ******************************************************************************/
59 #include "ddl.h"
60 #include "interrupts_hc32l136.h"
61 
62 #ifdef __cplusplus
63 extern "C"
64 {
65 #endif
66 
67 /**
68  ******************************************************************************
69  ** \defgroup RngGroup (RNG)
70   **
71  ******************************************************************************/
72 //@{
73 
74 /**
75  *******************************************************************************
76  ** function prototypes.
77  ******************************************************************************/
78 
79 /*******************************************************************************
80  * Global definitions
81  ******************************************************************************/
82 
83 /******************************************************************************
84  * Global variable declarations ('extern', definition in C source)
85  ******************************************************************************/
86 
87 /******************************************************************************
88  * Global function prototypes (definition in C source)
89  ******************************************************************************/
90 ///< 随机数初始化(上电第一次生成随机数)
91 en_result_t Rng_Init(void);
92 ///< 生成随机数(非上电第一次生成随机数)
93 en_result_t Rng_Generate(void);
94 ///< 获取64bits随机数(执行随机数初始化或生成随机数函数后可使用该函数获取随机数值)
95 uint32_t Rng_GetData0(void);
96 uint32_t Rng_GetData1(void);
97 
98 //@} // Rng Group
99 
100 #ifdef __cplusplus
101 #endif
102 
103 #endif /* __RNG_H__ */
104 /*******************************************************************************
105  * EOF (not truncated)
106  ******************************************************************************/
107 
108 
109