Struct Rng 

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

A wrapper around an nRF RNG peripheral.

It has a non-blocking API, and a blocking api through rand.

Implementations

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

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

Creates a new RNG driver from the RNG peripheral and interrupt.

SAFETY: The future returned from fill_bytes must not have its lifetime end without running its destructor, e.g. using mem::forget.

The synchronous API is safe.

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

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

Creates a new RNG driver from the RNG peripheral and interrupt.

SAFETY: The future returned from fill_bytes must not have its lifetime end without running its destructor, e.g. using mem::forget.

The synchronous API is safe.

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

Fill the buffer with random bytes.

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

pub fn set_bias_correction(&self, enable: bool)

Enable or disable the RNG’s bias correction.

Bias correction removes any bias towards a ‘1’ or a ‘0’ in the bits generated. However, this makes the generation of numbers slower.

Defaults to disabled.

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

Fill the buffer with random bytes, blocking version.

pub fn blocking_next_u32(&mut self) -> u32

Generate a random u32

pub fn blocking_next_u64(&mut self) -> u64

Generate a random u64

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.