Struct ScatterGatherBuilder 

pub struct ScatterGatherBuilder<'a, W: Word> { /* private fields */ }

A builder for constructing scatter-gather DMA transfer chains.

This provides a type-safe way to build TCD chains for scatter-gather transfers without manual TCD manipulation.

Example

use embassy_mcxa::dma::{DmaChannel, ScatterGatherBuilder};

let mut builder = ScatterGatherBuilder::<u32>::new();

// Add transfer segments
builder.add_transfer(&src1, &mut dst1);
builder.add_transfer(&src2, &mut dst2);
builder.add_transfer(&src3, &mut dst3);

// Build and execute
let transfer = unsafe { builder.build(&dma_ch).unwrap() };
transfer.await;

Implementations

impl<'a, W: Word> ScatterGatherBuilder<'a, W>

pub fn new() -> Self

Create a new scatter-gather builder.

pub fn add_transfer<'b: 'a>( &mut self, src: &'b [W], dst: &'b mut [W], ) -> &mut Self

Add a memory-to-memory transfer segment to the chain.

Arguments

• src - Source buffer for this segment
• dst - Destination buffer for this segment

Panics

Panics if the maximum number of segments (16) is exceeded.

pub fn segment_count(&self) -> usize

Get the number of transfer segments added.

pub fn build<C: Channel>( &mut self, channel: &DmaChannel<C>, ) -> Result<Transfer<'a>, Error>

Build the scatter-gather chain and start the transfer.

Arguments

• channel - The DMA channel to use for the transfer

Returns

A Transfer future that completes when the entire chain has executed.

pub fn clear(&mut self)

Reset the builder for reuse.

Trait Implementations

impl<W: Word> Default for ScatterGatherBuilder<'_, W>

fn default() -> Self

Returns the “default value” for a type.