Struct RingBufferedDacChannel 

pub struct RingBufferedDacChannel<'d, W: Word> { /* private fields */ }

A DAC channel backed by a DMA ring buffer.

Allows continuous waveform streaming by writing new samples into the ring buffer while DMA is simultaneously consuming and outputting them. DMA runs in circular mode so output never stops between writes.

Obtain this from [DacChannel::into_ring_buffered_8bit] or [DacChannel::into_ring_buffered_12right].

Implementations

impl<'d, W: Word> RingBufferedDacChannel<'d, W>

pub fn start(&mut self)

Start the DMA transfer.

Call this after creating the ring buffer (and optionally pre-filling it with write_immediate) to begin DAC output.

pub fn write_immediate(&mut self, buf: &[W]) -> Result<(usize, usize), Error>

Write samples directly into the raw DMA buffer without checking DMA position.

Useful for pre-filling the buffer before calling start. Writes at most capacity elements aligned to the end of the buffer.

pub fn write(&mut self, buf: &[W]) -> Result<(usize, usize), Error>

Write samples into the ring buffer.

Returns (written, remaining_space). Returns [Error::Overrun] if the DMA consumed data faster than the CPU supplied it; the ring buffer resets itself automatically in that case.

pub async fn write_exact(&mut self, buffer: &[W]) -> Result<usize, Error>

Write an exact number of samples, waiting asynchronously until space is available.

pub async fn wait_write_error(&mut self) -> Result<usize, Error>

Wait for a ring buffer write error (underrun).

pub fn capacity(&self) -> usize

Return the ring buffer capacity in samples.

pub fn is_running(&mut self) -> bool

Return whether the DMA is currently running.

pub fn request_reset(&mut self)

Request the DMA to stop, discarding the channel configuration.

pub fn request_pause(&mut self)

Request the DMA to pause, preserving the channel configuration.

Resume with start.

pub async fn stop(&mut self)

Stop the DMA transfer, waiting until all buffered samples have been output.

Trait Implementations

impl<W: Word> Drop for RingBufferedDacChannel<'_, W>

fn drop(&mut self)

Executes the destructor for this type.