hc32l196_trng.h 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108
  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 trng.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. #ifndef __TRNG_H__
  53. #define __TRNG_H__
  54. /*******************************************************************************
  55. * Include files
  56. ******************************************************************************/
  57. #include "ddl.h"
  58. #ifdef __cplusplus
  59. extern "C"
  60. {
  61. #endif
  62. /**
  63. ******************************************************************************
  64. ** \defgroup TrngGroup (TRNG)
  65. **
  66. ******************************************************************************/
  67. //@{
  68. /**
  69. *******************************************************************************
  70. ** function prototypes.
  71. ******************************************************************************/
  72. /*******************************************************************************
  73. * Global definitions
  74. ******************************************************************************/
  75. /******************************************************************************
  76. * Global variable declarations ('extern', definition in C source)
  77. ******************************************************************************/
  78. /******************************************************************************
  79. * Global function prototypes (definition in C source)
  80. ******************************************************************************/
  81. ///< 随机数初始化(上电第一次生成随机数)
  82. en_result_t Trng_Init(void);
  83. ///< 生成随机数(非上电第一次生成随机数)
  84. en_result_t Trng_Generate(void);
  85. ///< 获取64bits随机数(执行随机数初始化或生成随机数函数后可使用该函数获取随机数值)
  86. uint32_t Trng_GetData0(void);
  87. uint32_t Trng_GetData1(void);
  88. //@} // Trng Group
  89. #ifdef __cplusplus
  90. #endif
  91. #endif /* __TRNG_H__ */
  92. /*******************************************************************************
  93. * EOF (not truncated)
  94. ******************************************************************************/