Entropy

Interfaces for entropy hardware. More...

Modules
	Entropy Driver Backend API

Files
file	entropy.h
	Main header file for entropy driver API.

Macros
#define	ENTROPY_BUSYWAIT   BIT(0)
	Driver is allowed to busy-wait for random data to be ready.

Functions
int	entropy_get_entropy (const struct device *dev, uint8_t *buffer, uint16_t length)
	Fills a buffer with entropy.
static int	entropy_get_entropy_isr (const struct device *dev, uint8_t *buffer, uint16_t length, uint32_t flags)
	Fills a buffer with entropy in a non-blocking or busy-wait manner.

Detailed Description

Interfaces for entropy hardware.

Since

1.10

Version

1.0.0

Macro Definition Documentation

ENTROPY_BUSYWAIT

#define ENTROPY_BUSYWAIT   BIT(0)

#include <zephyr/drivers/entropy.h>

Driver is allowed to busy-wait for random data to be ready.

Function Documentation

entropy_get_entropy()

int entropy_get_entropy	(	const struct device *	dev,
		uint8_t *	buffer,
		uint16_t	length
	)

#include <zephyr/drivers/entropy.h>

Fills a buffer with entropy.

Blocks if required in order to generate the necessary random data.

Parameters

dev	Pointer to the entropy device.
buffer	Buffer to fill with entropy.
length	Buffer length.

Return values

0	on success.
-ERRNO	errno code on error.

entropy_get_entropy_isr()

static int entropy_get_entropy_isr ( const struct device *  dev, uint8_t *  buffer, uint16_t  length, uint32_t  flags  )

inlinestatic

#include <zephyr/drivers/entropy.h>

Fills a buffer with entropy in a non-blocking or busy-wait manner.

Callable from ISRs.

Parameters

dev	Pointer to the device structure.
buffer	Buffer to fill with entropy.
length	Buffer length.
flags	Flags to modify the behavior of the call.

Returns

number of bytes filled with entropy or -error.

Return values

-ENOSYS

Driver does not implement the function