关键流程设计

除了执行普通 platform 设备的处理过程，如申请 regs 资源、clk、reset 等，还需要调用 DMA 子系统的接口 dma_async_device_register() 来注册 DMA 备，示例如下：

int dma_async_device_register(struct dma_device *device)

其中参数 struct dma_device 需要提供下列关键信息：

• DMA 控制器能力描述，包括但不限于地址宽度、传输方向以及剩余粒度。配置示例如下：

  if (of_device_is_compatible(pdev->dev.of_node,
                  "artinchip,aic-dma-v0.1"))
      sdev->slave.copy_align = DMAENGINE_ALIGN_128_BYTES;
  else
      sdev->slave.copy_align = DMAENGINE_ALIGN_8_BYTES;
  sdev->slave.src_addr_widths = AIC_DMA_BUS_WIDTH;
  sdev->slave.dst_addr_widths = AIC_DMA_BUS_WIDTH;
  sdev->slave.directions = BIT(DMA_DEV_TO_MEM) | BIT(DMA_MEM_TO_DEV);
  sdev->slave.residue_granularity = DMA_RESIDUE_GRANULARITY_BURST;
  
  INIT_LIST_HEAD(&sdev->slave.channels);
  
  dma_cap_set(DMA_PRIVATE, sdev->slave.cap_mask);
  dma_cap_set(DMA_MEMCPY, sdev->slave.cap_mask);
  dma_cap_set(DMA_SLAVE, sdev->slave.cap_mask);
  dma_cap_set(DMA_CYCLIC, sdev->slave.cap_mask);

  表 1. DMA 控制器的能力特性含义

  能力特性	含义
  DMA_PRIVATE	不支持异步传输
  DMA_MEMCPY	支持内存到内存的拷贝操作
  DMA_SLAVE	支持设备到内存的传输操作
  DMA_CYCLIC	支持循环 Buffer 的情况

• DMA 操作 API，初始化示例如下：

  sdev->slave.device_free_chan_resources = aic_dma_free_chan_resources;
  sdev->slave.device_prep_dma_memcpy = aic_dma_prep_dma_memcpy;
  sdev->slave.device_prep_slave_sg = aic_dma_prep_slave_sg;
  sdev->slave.device_prep_dma_cyclic = aic_dma_prep_dma_cyclic;
  
  sdev->slave.device_config = aic_dma_config;
  sdev->slave.device_pause = aic_dma_pause;
  sdev->slave.device_resume = aic_dma_resume;
  sdev->slave.device_terminate_all = aic_dma_terminate_all;
  sdev->slave.device_tx_status = aic_dma_tx_status;
  sdev->slave.device_issue_pending = aic_dma_issue_pending;
  sdev->slave.device_release = aic_dma_device_release;