1.23.21 Random Number Generator (RNG)

Using The Library

RNG Peripheral library provides API's that can be used to perform below functionalities on the RNG peripheral.

• Initialize the RNG

• Enable/Disable the TRNG and PRNG blocks inside the RNG peripheral

• Read/Write the seed, polynomial and the generated random number.

• To check whether the number of valid bits in RNGSEEDx reached the required bit length for PRNG seed.

The example code below demonstrates how to generate True Random Number and Pseudo Random Number using RNG peripheral.

uint32_t true_rand_num[2];
uint32_t pseudo_rand_num[2];

int main ( void )
{
    /* Initialize all modules */
    SYS_Initialize ( NULL );

    /* Enable TRNG */
    RNG_TrngEnable();

    RNG_WaitForTrngCnt();

    true_rand_num[0] = RNG_Seed1Get();
    true_rand_num[1] = RNG_Seed2Get();

    printf("\r\nSeed available in TRNG 0x%x%x", true_rand_num[1], true_rand_num[0]);

    /* Prepare PRNG to get seed from TRNG */
    RNG_LoadSet();
    RNG_Poly1Set(0x00C00003);
    RNG_PrngEnable();

    /* Wait for at least 64 clock cycles */
    CORETIMER_DelayUs(1);

    pseudo_rand_num[0] = RNG_NumGen1Get();
    pseudo_rand_num[1] = RNG_NumGen2Get();

    RNG_PrngDisable();

    printf("\r\nGenerated 64-bit Pseudo-Random Number 0x%x%x\r\n", pseudo_rand_num[1], pseudo_rand_num[0]);

    while(true)
    {
    }

    /* Execution should not come here during normal operation */

    return ( EXIT_FAILURE );
}

Library Interface

Random Number Generator peripheral library provides the following interfaces:

Functions