Struct Trng 

pub struct Trng<'d, L: SecurityMarker> { /* private fields */ }

True Random Number Generator (TRNG) Driver for MSPM0 series.

The driver provides blocking random numbers with TryRngCore methods and asynchronous counterparts in Trng::async_read_u32, Trng::async_read_u64, and Trng::async_read_bytes.

The TRNG can be configured with different decimation rates. See DecimRate, FastDecimRate, and CryptoDecimRate. The TRNG can be instantiated with Trng::new, Trng::new_fast, or Trng::new_secure.

Usage example:

#![no_std]
#![no_main]

use embassy_executor::Spawner;
use embassy_mspm0::Config;
use embassy_mspm0::trng::Trng;
use rand_core::TryRngCore;
use {defmt_rtt as _, panic_halt as _};

#[embassy_executor::main]
async fn main(_spawner: Spawner) -> ! {
    let p = embassy_mspm0::init(Config::default());
    let mut trng = Trng::new(p.TRNG).expect("Failed to initialize TRNG");
    let mut randomness = [0u8; 16];

    loop {
        trng.fill_bytes(&mut randomness).unwrap();
        assert_ne!(randomness, [0u8; 16]);
    }
}

Implementations

impl<'d> Trng<'d, Crypto>

pub fn new(peripheral: Peri<'d, TRNG>) -> Result<Self, Error>

Setup a TRNG driver with the default safe decimation rate (Decim4).

impl<'d> Trng<'d, Fast>

pub fn new_fast( peripheral: Peri<'d, TRNG>, rate: FastDecimRate, ) -> Result<Self, Error>

Setup a TRNG driver with a specific fast decimation rate.

The created TRNG is not suitable for cryptography. Use Trng::new_secure instead.

impl<'d> Trng<'d, Crypto>

pub fn new_secure( peripheral: Peri<'d, TRNG>, rate: CryptoDecimRate, ) -> Result<Self, Error>

Setup a TRNG driver with a specific cryptographic decimation rate.

impl<'d, D: SecurityMarker> Trng<'d, D>

pub fn fail_reset(&mut self) -> Result<(), Error>

L-series TRM 13.2.5.2(10): procedure for recovering from a failed read.

This method reinitializes the TRNG which may take some time to complete.

pub async fn async_read_u32(&mut self) -> Result<u32, Error>

Asynchronously read a 32-bit random value from the TRNG.

The synchronous counterpart is given by TryRngCore::try_next_u32.

As with the synchronous methods, an Err may be retried up to two times after calling Trng::fail_reset.

pub async fn async_read_u64(&mut self) -> Result<u64, Error>

Asynchronously read a 64-bit random value from the TRNG.

The synchronous counterpart is given by TryRngCore::try_next_u64.

As with the synchronous methods, an Err may be retried up to two times after calling Trng::fail_reset.

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

Asynchronously fill dest with random bytes from the TRNG.

The synchronous counterpart is given by TryRngCore::try_fill_bytes.

As with the synchronous methods, an Err may be retried up to two times after calling Trng::fail_reset.

Note When an error condition occurs, the buffer may be partially filled.

Trait Implementations

impl<D: SecurityMarker> TryRngCore for Trng<'_, D>

Implements the fallible TryRngCore.

If any of the methods give an Err, the operation may be retried up to two times after calling Trng::fail_reset.

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

Note When an error condition occurs, the buffer may be partially filled.

type Error = Error

The type returned in the event of a RNG error.

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

Return the next random u32.

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

Return the next random u64.

fn unwrap_err(self) -> UnwrapErr<Self>

where Self: Sized,

Wrap RNG with the UnwrapErr wrapper.

fn unwrap_mut(&mut self) -> UnwrapMut<'_, Self>

Wrap RNG with the UnwrapMut wrapper.

impl TryCryptoRng for Trng<'_, Crypto>