Struct Trng 

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

True Random Number Generator Driver for RP2350

This driver provides async and blocking options.

See Config for configuration details.

Usage example:

use embassy_executor::Spawner;
use embassy_rp::trng::Trng;
use embassy_rp::peripherals::TRNG;
use embassy_rp::bind_interrupts;

bind_interrupts!(struct Irqs {
    TRNG_IRQ => embassy_rp::trng::InterruptHandler<TRNG>;
});

#[embassy_executor::main]
async fn main(spawner: Spawner) {
    let peripherals = embassy_rp::init(Default::default());
    let mut trng = Trng::new(peripherals.TRNG, Irqs, embassy_rp::trng::Config::default());

    let mut randomness = [0u8; 58];
    loop {
        trng.fill_bytes(&mut randomness).await;
        assert_ne!(randomness, [0u8; 58]);
    }
}

Implementations

impl<'d> Trng<'d, Async>

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

Create a new TRNG driver in async mode.

impl<'d> Trng<'d, Blocking>

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

Create a new TRNG driver in blocking mode.

impl<'d> Trng<'d, Async>

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

Fill the buffer with random bytes.

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

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

Fill the buffer with random bytes, blocking version.

pub fn blocking_next_u32(&mut self) -> u32

Return a random u32, blocking.

pub fn blocking_next_u64(&mut self) -> u64

Return a random u64, blocking.

Trait Implementations

impl<'d, M: Mode> TryCryptoRng for Trng<'d, M>

impl<'d, M: Mode> TryRng for Trng<'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.