DMAC

特性

  • 多通道并行（Apollo 6通道）
  • 中断传输、阻塞传输
  • 传输模式：外设-内存，内存-内存
  • 外设-内存传输使用硬件握手

使用

  1. 设备初始化
#include "app_dmac_wrapper.h"
app_dmac_init_wrapper();

Apollo系统已经自动执行过上述初始化，用户无需再次初始化。

  1. 启动传输
app_dmac_transfer_param_t dma_param = {
        .callback = callback_function,
        .callback_param = cb_param,
        .src = src_data,
        .dst = dst_data,
        .length = length,
        .src_tr_width = Transfer_Width_8_bits,
        .dst_tr_width = Transfer_Width_8_bits,
        .src_msize = Burst_Transaction_Length_4,
        .dst_msize = Burst_Transaction_Length_4,
        .tt_fc = Memory_to_Memory_DMAC_Flow_Controller,
        .src_per = 0,
        .dst_per = 0,
        .int_en = Interrupt_Enabled,
};
uint8_t ch_idx = app_dmac_start_wrapper(&dma_param);

src_tr_width决定了length的单位，若src_tr_width == Transfer_Width_8_bits，则length == n对n个字节的传输；若src_tr_width == Transfer_Width_16_bits，则length == n对应2n个字节的传输。

src的地址的对齐要求由src_tr_width决定，即src_tr_width == Transfer_Width_16_bits； src应两字节对齐，src_tr_width == Transfer_Width_32_bits，src应四字节对齐。

对于内存-内存的DMA传输，tt_fc应固定设置为Memory_to_Memory_DMAC_Flow_Controller，src_msize,dst_msize可以设置为任意合法的Burst_Transaction_Length_*枚举类型。

若中断使能，则回调函数在传输完成后中断处理上下文中被调用；若中断禁用，则不会调用回调函数。

外设-内存之间的DMA传输已集成在相应外设驱动中，无需用户额外配置DMA。

  1. 等待传输完成（仅当传输参数int_en == Interrupt_Disabled时使用）
app_dmac_transfer_wait_wrapper(ch_idx);
  1. 取消传输
uint32_t remaining_length = app_dmac_transfer_cancel_wrapper(ch_idx);

返回值 == 启动传输时设定的长度 - 调用app_dmac_transfer_cancel_wrapper时实际收到的数据长度。

注解

若src_tr_width<dst_tr_width，取消传输得到的返回值可能有误，即数据有可能在DMA传输过程中丢失。