TRNG

Modules
	TRNG_Registers

Functions
int	MXC_TRNG_Init (void)
void	MXC_TRNG_EnableInt (void)
void	MXC_TRNG_DisableInt (void)
int	MXC_TRNG_Shutdown (void)
void	MXC_TRNG_Handler (void)
int	MXC_TRNG_RandomInt (void)
int	MXC_TRNG_Random (uint8_t *data, uint32_t len)
void	MXC_TRNG_RandomAsync (uint8_t *data, uint32_t len, mxc_trng_complete_t callback)
int	MXC_TRNG_HealthTest (void)

Detailed Description

Function Documentation

MXC_TRNG_HealthTest()

int MXC_TRNG_HealthTest

(

void

)

Perform health test of the TRNG entropy source.

Returns

If test fails the function will return E_BAD_STATE (-7), otherwise it will return E_NO_ERROR.

MXC_TRNG_Init()

int MXC_TRNG_Init

(

void

)

Enable portions of the TRNG.

Returns

Success/Fail, see Error Codes for a list of return codes.

MXC_TRNG_Random()

int MXC_TRNG_Random	(	uint8_t *	data,
		uint32_t	len
	)

Get a random number of length len.

Parameters

data	Pointer to a location to store the number
len	Length of random number in bytes

Returns

Success/Fail, see Error Codes for a list of return codes.

MXC_TRNG_RandomAsync()

void MXC_TRNG_RandomAsync	(	uint8_t *	data,
		uint32_t	len,
		mxc_trng_complete_t	callback
	)

Get a random number of length len, do not block while generating data.

Note

The user must call MXC_TRNG_Handler() in the ISR

Parameters

data	Pointer to a location to store the number
len	Length of random number in bytes
callback	Function that will be called when all data has been generated

MXC_TRNG_RandomInt()

int MXC_TRNG_RandomInt

(

void

)

Get a random number.

Returns

A random 32-bit number

MXC_TRNG_Shutdown()

int MXC_TRNG_Shutdown

(

void

)

Disable and reset portions of the TRNG.

Returns

Success/Fail, see Error Codes for a list of return codes.