Struct Rng 

pub struct Rng<'d, M: Mode> { /* private fields */ }

RNG driver.

Implementations

impl<'d> Rng<'d, Async>

pub fn new<T: Instance>( inner: Peri<'d, T>, _irq: impl Binding<T::Interrupt, InterruptHandler<T>> + 'd, ) -> Self

Create a new RNG driver.

impl<'d> Rng<'d, Blocking>

pub fn new_blocking<T: Instance>(inner: Peri<'d, T>) -> Self

Create a new blocking RNG driver.

impl<'d, M: Mode> Rng<'d, M>

pub fn reset(&mut self)

Reset the RNG.

pub fn recover_seed_error(&mut self)

Try to recover from a seed error.

pub fn blocking_next_u32(&mut self) -> u32

Get a random u32.

This call is infallible: a seed or clock error is recovered by resetting the RNG. If the error persists after MAX_RESET_RETRIES resets (almost always a misconfigured RNG clock) it panics, since an infallible API has no other way to surface the fault. Use fill_bytes for a fallible path that returns Error instead.

pub fn blocking_next_u64(&mut self) -> u64

Get a random u64

pub fn blocking_fill_bytes(&mut self, dest: &mut [u8])

Fill a slice with random bytes

impl<'d> Rng<'d, Async>

pub async fn fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>

Fill the given slice with random values.

Trait Implementations

impl<'d, M: Mode> Drop for Rng<'d, M>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<'d, M: Mode> TryCryptoRng for Rng<'d, M>

impl<'d, M: Mode> TryRng for Rng<'d, M>

type Error = !

The type returned in the event of a RNG error.

fn try_next_u32(&mut self) -> Result<u32, Self::Error>

Return the next random u32.

fn try_next_u64(&mut self) -> Result<u64, Self::Error>

Return the next random u64.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Self::Error>

Fill dst entirely with random data.