Struct Saes 

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

SAES driver.

Implementations

impl<'d, T: Instance> Saes<'d, T, Blocking>

pub fn new_blocking( peripheral: Peri<'d, T>, _irq: impl Binding<T::Interrupt, InterruptHandler<T>> + 'd, ) -> Self

Instantiates, resets, and enables the SAES peripheral.

impl<'d, T: Instance> Saes<'d, T, Async>

pub fn new<D1: DmaIn<T>, D2: DmaOut<T>>( peripheral: Peri<'d, T>, dma_in: Peri<'d, D1>, dma_out: Peri<'d, D2>, _irq: impl Binding<T::Interrupt, InterruptHandler<T>> + Binding<D1::Interrupt, InterruptHandler<D1>> + Binding<D2::Interrupt, InterruptHandler<D2>> + 'd, ) -> Self

Instantiates, resets, and enables the SAES peripheral with DMA support.

impl<'d, T: Instance, M: Mode> Saes<'d, T, M>

pub fn start<'c, C>(&mut self, cipher: &'c C, dir: Direction) -> Context<'c, C>

where C: Cipher<'c> + CipherSized + IVSized,

Starts a new cipher operation with a software key.

pub fn start_with_hw_key<'c, C>( &mut self, key_source: HardwareKeySource, cipher: &'c C, dir: Direction, ) -> Context<'c, C>

where C: Cipher<'c> + CipherSized + IVSized,

Starts a new cipher operation with a hardware-derived key.

pub fn start_with_mode<'c, C>( &mut self, key_mode: KeyMode, hw_key: Option<HardwareKeySource>, cipher: &'c C, dir: Direction, ) -> Context<'c, C>

where C: Cipher<'c> + CipherSized + IVSized,

Starts a new cipher operation with an explicit SAES key mode.

This enables wrapped-key/shared-key workflows in addition to normal mode. When hw_key is provided, SAES selects a hardware key source.

pub fn start_wrapped_key<'c, C>( &mut self, cipher: &'c C, dir: Direction, ) -> Context<'c, C>

where C: Cipher<'c> + CipherSized + IVSized,

Starts a new cipher operation in wrapped-key mode.

pub fn start_shared_key<'c, C>( &mut self, cipher: &'c C, dir: Direction, ) -> Context<'c, C>

where C: Cipher<'c> + CipherSized + IVSized,

Starts a new cipher operation in shared-key mode.

pub fn share_key_with(&mut self, target: KeyShareTarget)

Share the current unwrapped key with another peripheral. This must be called after a decryption operation that unwrapped a key.

pub fn aad_blocking<'c, C>( &mut self, ctx: &mut Context<'c, C>, aad: &[u8], last: bool, ) -> Result<(), Error>

where C: Cipher<'c> + CipherAuthenticated<16>,

Process authenticated additional data (AAD) for GCM/CCM modes.

pub fn payload_blocking<'c, C>( &mut self, ctx: &mut Context<'c, C>, input: &[u8], output: &mut [u8], last: bool, ) -> Result<(), Error>

where C: Cipher<'c>,

Process payload data in blocking mode.

pub fn finish_blocking<'c, C>( &mut self, ctx: Context<'c, C>, ) -> Result<Option<[u8; 16]>, Error>

where C: Cipher<'c>,

Finishes the cipher operation and returns the authentication tag (for GCM/CCM).

impl<'d, T: Instance> Saes<'d, T, Async>

pub async fn aad<'c, C>( &mut self, ctx: &mut Context<'c, C>, aad: &[u8], last: bool, ) -> Result<(), Error>

where C: Cipher<'c> + CipherAuthenticated<16>,

Process authenticated additional data (AAD) for GCM/CCM modes (async facade).

pub async fn payload<'c, C>( &mut self, ctx: &mut Context<'c, C>, input: &[u8], output: &mut [u8], last: bool, ) -> Result<(), Error>

where C: Cipher<'c>,

Process payload data (async facade).

pub async fn finish<'c, C>( &mut self, ctx: Context<'c, C>, ) -> Result<Option<[u8; 16]>, Error>

where C: Cipher<'c>,

Finish cipher operation and return authentication tag for authenticated modes (async facade).