Struct Trng

pub struct Trng<'d> {
    pub rng: Rng,
    /* private fields */
}

Available on crate feature unstable only.

True Random Number Generator (TRNG) driver

The Trng struct represents a true random number generator that combines the randomness from the hardware RNG and an ADC. This struct provides methods to generate random numbers and fill buffers with random bytes. Due to pulling the entropy source from the ADC, it uses the associated registers, so to use TRNG we need to “occupy” the ADC peripheral.

Fields

rng: Rng

The hardware random number generator instance.

Implementations

impl<'d> Trng<'d>

pub fn new( rng: impl Peripheral<P = RNG>, adc: impl Peripheral<P = ADC1> + 'd, ) -> Self

Creates a new True Random Number Generator (TRNG) instance.

Arguments

• rng - A peripheral instance implementing the RNG trait.
• adc - A mutable reference to an Adc instance.

Returns

Returns a new Trng instance.

pub fn random(&mut self) -> u32

Reads currently available u32 integer from TRNG

pub fn read(&mut self, buffer: &mut [u8])

Fills the provided buffer with random bytes.

pub fn downgrade(self) -> Rng

Downgrades the Trng instance to a Rng instance and releases the ADC1.

Trait Implementations

impl Drop for Trng<'_>

fn drop(&mut self)

Executes the destructor for this type.

impl Peripheral for Trng<'_>

type P = Trng<'_>

Peripheral singleton type

unsafe fn clone_unchecked(&self) -> Self::P

Unsafely clone (duplicate) a peripheral singleton.

fn into_ref<'a>(self) -> PeripheralRef<'a, Self::P>

where Self: 'a,

Convert a value into a PeripheralRef.

fn map_into<U>(self) -> U

where Self::P: Into<U>, U: Peripheral<P = U>,

Map the peripheral using Into.

fn map<U>(self, transform: impl FnOnce(Self::P) -> U) -> U

where U: Peripheral<P = U>,

Map the peripheral using Into.

impl RngCore for Trng<'_>

Implementing RngCore trait from rand_core for Trng structure

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

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

Fill dest with random data.

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

Fill dest entirely with random data.

impl CryptoRng for Trng<'_>

Implementing a CryptoRng marker trait that indicates that the generator is cryptographically secure.