Allwinner R128 SDK HAL Module Development Guide TRNG

aleksib

Allwinner R128 SDK HAL Module Development Guide TRNG [Copy link]

 

# TRNG TRNG is a true random number generator. The random source is 8 independent ring oscillators. The frequency jitter is generated by the power supply noise of the analog device. It is always resampled with a low frequency, and then elastic extraction and entropy extraction are performed to finally output a 128-bit true random number. ## Module configuration Its menuconfig configuration is as follows: ``` Kernel Setup ---> Drivers Setup ---> SoC HAL Drivers ---> TRNG devices ---> [*] enable trng driver [*] enable trng hal APIs Test command ``` ## Source code structure``` drv_trng.c drv_trng.h hal_trng.c ``` ## Module interface description header file```c #include<sunxi_hal_trng.h> ``` ### Return value enumeration```c typedef enum { HAL_TRNG_STATUS_OK = 0, /* success */ HAL_TRNG_STATUS_ERROR = -1, /* general error */ HAL_TRNG_STATUS_BUSY = -2, /* device or resource busy */ HAL_TRNG_STATUS_TIMEOUT = -3, /* wait timeout */ HAL_TRNG_STATUS_INVALID = -4 /* invalid argument */ } HAL_TRNG_Status; ``` ### Get random number function prototype```c HAL_TRNG_Status HAL_TRNG_Extract(uint8_t type, uint32_t random[4]); ``` Parameters: - type: random number generation entropy extraction mode (0: crc, 1: xor) - random: store the generated random number Return value: - 0: success - negative number: failure## Module usage example ```c #include<stdio.h> #include<string.h> #include<hal_log.h> #include<hal_cmd.h> #include<sunxi_hal_trng.h> static int cmd_test_trng(int argc, const char **argv) { int ret = 0; uint32_t random[4] = {0}; if (argc != 2) { printf("Parameter number Error!\n"); printf ("Usage: hal_trng<crc>\n"); return -1; } if (strcmp(argv[1], "crc") == 0) ret = HAL_TRNG_Extract(0, random); else if (strcmp(argv[1], "xor") == 0) ret = HAL_TRNG_Extract(1, random); else { printf("Parameter Error!\n"); printf("Usage: hal_trng<crc>\n"); ret = -1; return ret; } if (ret) { printf("trng extract failed: %d\n", ret); return ret; } printf("trng result: 0x%08x 0x% 08x 0x%08x 0x%08x\n", random[0], random[1], random[2], random[3]); return ret; } FINSH_FUNCTION_EXPORT_CMD(cmd_test_trng, hal_trng, trng hal APIs tests) ``` </crc></crc></sunxi_hal_trng.h></hal_cmd.h></hal_log.h></string.h></stdio.h></sunxi_hal_trng.h>

lugl4313820

Thanks for sharing!