1.25.24 True Random Number Generator (TRNG)

Using The Library

The library provides both blocking and callback methods to generate and read the random number.

• With blocking API, it enables the TRNG module, waits for new random number to be available and then returns the newly generated random number.

• With callback, it enables the TRNG module and the registered callback function will be called once the new random value is available.

Blocking API

The example code to generate 32-bit random number using blocking API is given below.

uint32_t trueRandomNumber

trueRandomNumber = TRNG_ReadData();

Callback method

This example demonstrates how to use callback to generate 32-bit random number.

uint32_t trueRandomNumber;

/* Random number is provided as part of callback */
void TRNG_EventHandler(uint32_t randomNumber, uintptr_t context)
{
    trueRandomNumber = randomNumber;
}

int main(void)
{
    /* Register Callback */
    TRNG_CallbackRegister(TRNG_EventHandler, (uintptr_t) NULL);

    /* Enable TRNG */
    TRNG_RandomNumberGenerate();
}

Library Interface

True Random Number Generator peripheral library provides the following interfaces:

Functions

Data types and constants