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 to begin DAC output.

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_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.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.