Struct DMA_COPY 

#[non_exhaustive]
pub struct DMA_COPY<'a> { /* private fields */ }

Available on crate feature unstable only.

DMA_COPY peripheral singleton

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

Implementations

impl DMA_COPY<'_>

pub unsafe fn steal() -> Self

Unsafely creates an instance of this peripheral out of thin air.

Safety

The caller must ensure that only one instance of this type is used at a time.

pub unsafe fn clone_unchecked(&self) -> Self

Unsafely clone this peripheral reference.

Safety

The caller must ensure that only one instance of this type is used at a time.

pub fn reborrow(&mut self) -> DMA_COPY<'_>

Creates a new peripheral reference with a shorter lifetime.

Use this method to keep working with the peripheral after the driver that consumes it is dropped.

pub fn bind_dma_interrupt(&self, handler: InterruptHandler)

Binds an interrupt handler to the corresponding interrupt for this peripheral, and enables the interrupt.

Very low-level interrupt API. Unless writing drivers, this is probably not the interrupt API to use.

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn enable_dma_interrupt(&self, priority: Priority)

Enables the DMA_COPY peripheral interrupt on the given priority level.

Very low-level interrupt API. Unless writing drivers, this is probably not the interrupt API to use.

A suitable interrupt handler must be set up before the first interrupt is triggered; otherwise the default handler panics. To set up an interrupt handler, use Self::bind_dma_interrupt or create a function that has the same (non-mangled) name as the interrupt to handle.

Examples

use esp_hal::interrupt::Priority;

#[unsafe(no_mangle)]
unsafe extern "C" fn DMA_COPY() {
    // do something
}

peripherals.DMA_COPY.enable_dma_interrupt(Priority::Priority1);
peripherals.DMA_COPY.disable_dma_interrupt_on_all_cores();

pub fn disable_dma_interrupt(&self)

Disables the DMA_COPY peripheral interrupt handler on the current CPU core.

Very low-level interrupt API. Unless writing drivers, this is probably not the interrupt API to use.

# Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn disable_dma_interrupt_on_all_cores(&self)

Disables the DMA_COPY peripheral interrupt handler on all cores.

Very low-level interrupt API. Unless writing drivers, this is probably not the interrupt API to use.

impl DMA_COPY<'_>

pub const PTR: *const <COPY_DMA as Deref>::Target = pac::COPY_DMA::PTR

Pointer to the register block

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub const fn ptr() -> *const <COPY_DMA as Deref>::Target

Return the pointer to the register block

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn regs<'a>() -> &'a <COPY_DMA as Deref>::Target

Return a reference to the register block

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn register_block(&self) -> &<COPY_DMA as Deref>::Target

Return a reference to the register block

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

Trait Implementations

impl<'a> Debug for DMA_COPY<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'d> DmaChannel for DMA_COPY<'d>

type Rx = CopyDmaRxChannel<'d>

A description of the RX half of a DMA Channel.

type Tx = CopyDmaTxChannel<'d>

A description of the TX half of a DMA Channel.

unsafe fn split_internal(self, _: Internal) -> (Self::Rx, Self::Tx)

Splits the DMA channel into its RX and TX halves.

impl<'d> From<DMA_COPY<'d>> for CopyDmaRxChannel<'d>

fn from(this: DMA_COPY<'d>) -> CopyDmaRxChannel<'d>

Converts to this type from the input type.

impl<'d> From<DMA_COPY<'d>> for CopyDmaTxChannel<'d>

fn from(this: DMA_COPY<'d>) -> CopyDmaTxChannel<'d>

Converts to this type from the input type.

impl<'d> Mem2MemCapableChannel<'d> for DMA_COPY<'d>

fn mem2mem_id(&self) -> DmaPeripheral

Peripheral selector programmed for memory-to-memory on this channel.