Struct Rng

pub struct Rng<'d, T: Instance, 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, T: Instance> Rng<'d, T, Blocking>

pub fn new_blocking(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, T: Instance> Rng<'d, T, Async>

pub fn new( 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, T: Instance, M: Mode> Rng<'d, T, 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, T: Instance, M: Mode> Drop for Rng<'d, T, M>

fn drop(&mut self)

Executes the destructor for this type.

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

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, M: Mode> RngCore for Rng<'d, T, M>

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.

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

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