Struct Trng

pub struct Trng<'d, T: Instance> { /* 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, T: Instance> Trng<'d, T>

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

Create a new TRNG driver.

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

Fill the buffer with random bytes, async version.

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, T: Instance> RngCore for Trng<'d, T>

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.