Embassy

Trng

embassy_mcxa::trng

Struct Trng

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

Expand description

TRNG Driver

Implementations§

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

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

Fill the buffer with random bytes, blocking version.

pub fn blocking_next_u32(&mut self) -> u32

Return a random u32, blocking version.

pub fn blocking_next_u64(&mut self) -> u64

Return a random u64, blocking version.

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

pub fn new_blocking_128(_peri: Peri<'d, TRNG0>) -> Self

Instantiates a new TRNG peripheral driver with 128 samples of entropy.

pub fn new_blocking_256(_peri: Peri<'d, TRNG0>) -> Self

Instantiates a new TRNG peripheral driver with 256 samples of entropy.

pub fn new_blocking_512(_peri: Peri<'d, TRNG0>) -> Self

Instantiates a new TRNG peripheral driver with 512 samples of entropy.

pub fn new_blocking_with_custom_config( _peri: Peri<'d, TRNG0>, config: Config, ) -> Self

Instantiates a new TRNG peripheral driver.

NOTE: this constructor makes no attempt at validating the parameters. If you get this wrong, the security guarantees of the TRNG with regards to entropy may be violated

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

pub fn new_128( _peri: Peri<'d, TRNG0>, _irq: impl Binding<TRNG0, InterruptHandler> + 'd, ) -> Self

Instantiates a new TRNG peripheral driver with 128 samples of entropy.

pub fn new_256( _peri: Peri<'d, TRNG0>, _irq: impl Binding<TRNG0, InterruptHandler> + 'd, ) -> Self

Instantiates a new TRNG peripheral driver with 256 samples of entropy.

pub fn new_512( _peri: Peri<'d, TRNG0>, _irq: impl Binding<TRNG0, InterruptHandler> + 'd, ) -> Self

Instantiates a new TRNG peripheral driver with 512 samples of entropy.

pub fn new_with_custom_config( _peri: Peri<'d, TRNG0>, _irq: impl Binding<TRNG0, InterruptHandler> + 'd, config: Config, ) -> Self

Instantiates a new TRNG peripheral driver.

NOTE: this constructor makes no attempt at validating the parameters. If you get this wrong, the security guarantees of the TRNG with regards to entropy may be violated

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

Fill the buffer with random bytes, async version.

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

Return a random u32, async version.

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

Return a random u64, async version.

Trait Implementations§

impl<M: Mode> Drop for Trng<'_, M>

fn drop(&mut self)

Executes the destructor for this type. Read more

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

fn next_u32(&mut self) -> u32

Return the next random u32. Read more

fn next_u64(&mut self) -> u64

Return the next random u64. Read more

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

Fill dest with random data. Read more

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

Fill dest entirely with random data. Read more

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

fn next_u32(&mut self) -> u32

Return the next random u32. Read more

fn next_u64(&mut self) -> u64

Return the next random u64. Read more

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

Fill dest with random data. Read more

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

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

Auto Trait Implementations§

impl<'d, M> Freeze for Trng<'d, M>

impl<'d, M> RefUnwindSafe for Trng<'d, M>
where M: RefUnwindSafe,

impl<'d, M> Send for Trng<'d, M>
where M: Send,

impl<'d, M> Sync for Trng<'d, M>
where M: Sync,

impl<'d, M> Unpin for Trng<'d, M>
where M: Unpin,

impl<'d, M> !UnwindSafe for Trng<'d, M>

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CryptoRngCore for T
where T: CryptoRng + RngCore,

fn as_rngcore(&mut self) -> &mut dyn RngCore

Upcast to an RngCore trait object.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<R> TryRngCore for R
where R: RngCore + ?Sized,

type Error = Infallible

The type returned in the event of a RNG error.

fn try_next_u32(&mut self) -> Result<u32, <R as TryRngCore>::Error>

Return the next random u32.

fn try_next_u64(&mut self) -> Result<u64, <R as TryRngCore>::Error>

Return the next random u64.

fn try_fill_bytes( &mut self, dst: &mut [u8], ) -> Result<(), <R as TryRngCore>::Error>

Fill dest entirely with random data.

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<R> TryCryptoRng for R
where R: CryptoRng + ?Sized,