Struct esp32c3_hal::Rng

pub struct Rng<'d> { /* 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<'d> Rng<'d>

pub fn new(rng: impl Peripheral<P = RNG> + 'd) -> Rng<'d>

Create a new random number generator instance

pub fn random(&mut self) -> u32

Reads currently available u32 integer from RNG

Trait Implementations

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