Struct esp32c3_hal::Rng

pub struct Rng { /* private fields */ }

Random Number Generator

It should be noted that there are certain pre-conditions which must be met in order for the RNG to produce true random numbers. The hardware RNG produces true random numbers under any of the following conditions:

• RF subsystem is enabled (i.e. Wi-Fi or Bluetooth are enabled).
• An internal entropy source has been enabled by calling bootloader_random_enable() and not yet disabled by calling bootloader_random_disable().
• While the ESP-IDF Second stage bootloader is running. This is because the default ESP-IDF bootloader implementation calls bootloader_random_enable() when the bootloader starts, and bootloader_random_disable() before executing the app.

When any of these conditions are true, samples of physical noise are continuously mixed into the internal hardware RNG state to provide entropy. If none of the above conditions are true, the output of the RNG should be considered pseudo-random only.

For more information, please refer to the ESP-IDF documentation: https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/random.html

Implementations

impl Rng

pub fn new(rng: RNG) -> Rng

Create a new random number generator instance

pub fn random(&mut self) -> u32

Reads currently available u32 integer from RNG

pub fn free(self) -> RNG

Return the raw interface to the underlying Rng instance

Trait Implementations

impl Debug for Rng

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Read for Rng

type Error = Infallible

Error type

fn read(&mut self, buffer: &mut [u8]) -> Result<(), <Rng as Read>::Error>

Reads enough bytes from hardware random number generator to fill buffer