1 /***************************************************************************** 2 * Copyright (c) 2019, Nations Technologies Inc. 3 * 4 * All rights reserved. 5 * **************************************************************************** 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions are met: 9 * 10 * - Redistributions of source code must retain the above copyright notice, 11 * this list of conditions and the disclaimer below. 12 * 13 * Nations' name may not be used to endorse or promote products derived from 14 * this software without specific prior written permission. 15 * 16 * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY NATIONS "AS IS" AND ANY EXPRESS OR 17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE 19 * DISCLAIMED. IN NO EVENT SHALL NATIONS BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 21 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 22 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 23 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 24 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 25 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 * ****************************************************************************/ 27 28 /** 29 * @file n32wb452_rng.h 30 * @author Nations 31 * @version v1.0.0 32 * 33 * @copyright Copyright (c) 2019, Nations Technologies Inc. All rights reserved. 34 */ 35 #ifndef __N32WB452_RNG_H__ 36 #define __N32WB452_RNG_H__ 37 38 #include <stdint.h> 39 40 /** @addtogroup N32WB452_Algorithm_Library 41 * @{ 42 */ 43 44 /** @addtogroup RNG 45 * @brief Random number generator 46 * @{ 47 */ 48 49 50 51 enum{ 52 RNG_OK = 0x5a5a5a5a, 53 LENError = 0x311ECF50, //RNG generation of key length error 54 ADDRNULL = 0x7A9DB86C, // This address is empty 55 }; 56 57 58 //u32 RNG_init(void); 59 /** 60 * @brief Get pseudo random number 61 * @param[out] rand pointer to random number 62 * @param[in] the wordlen of random number 63 * @param[in] the seed, can be NULL 64 * @return RNG_OK:get random number success; othets: get random number fail 65 * @note 66 */ 67 uint32_t GetPseudoRand_U32(uint32_t *rand, uint32_t wordLen,uint32_t seed[2]); 68 69 70 /** 71 * @brief Get true random number 72 * @param[out] rand pointer to random number 73 * @param[in] the wordlen of random number 74 * @return RNG_OK:get random number success; othets: get random number fail 75 * @note 76 */ 77 uint32_t GetTrueRand_U32(uint32_t *rand, uint32_t wordLen); 78 79 /** 80 * @brief Get RNG lib version 81 * @param[out] type pointer one byte type information represents the type of the lib, like Commercial version.\ 82 * @Bits 0~4 stands for Commercial (C), Security (S), Normal (N), Evaluation (E), Test (T), Bits 5~7 are reserved. e.g. 0x09 stands for CE version. 83 * @param[out] customer pointer one byte customer information represents customer ID. for example, 0x00 stands for standard version, 0x01 is for Tianyu customized version... 84 * @param[out] date pointer array which include three bytes date information. If the returned bytes are 18,9,13,this denotes September 13,2018 85 * @param[out] version pointer one byte version information represents develop version of the lib. e.g. 0x12 denotes version 1.2. 86 * @return none 87 * @1.You can recall this function to get RSA lib information 88 */ 89 void RNG_Version(uint8_t *type, uint8_t *customer, uint8_t date[3], uint8_t *version); 90 91 #endif 92 93 94