Struct embassy_nrf::rng::Rng

pub struct Rng<'d, T: Instance> { /* private fields */ }

A wrapper around an nRF RNG peripheral.

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

Implementations

impl<'d, T: Instance> Rng<'d, T>

pub fn new( rng: impl Peripheral<P = T> + 'd, _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 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 async fn fill_bytes(&mut self, dest: &mut [u8])

Fill the buffer with random bytes.

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

Fill the buffer with random bytes, blocking version.

Trait Implementations

impl<'d, T: Instance> Drop for Rng<'d, T>

fn drop(&mut self)

Executes the destructor for this type.

impl<'d, T: Instance> RngCore for Rng<'d, T>

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

Fill dest with random data.

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

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

Fill dest entirely with random data.

impl<'d, T: Instance> CryptoRng for Rng<'d, T>