DMA

简要说明

• DMA(Direct Memory Access，直接内存存取)它允许不同速度的硬件装置之间沟通，而不需要依赖于CPU的大量中断负载。

函数列表

DMA的CSI接口在用户对接时是否必须适配的说明如下所示：

接口描述

csi_dma_ch_t

csi_dma_ctrl_t

csi_dma_cb_t

typedef void (*csi_dma_cb_t)(csi_dma_ch_t *dma, csi_dma_event_t event, void *arg);

其中dma为通道句柄，event 为传给回调函数的事件类型，arg为用户自定义的回调函数对应的参数。 dma 回调事件枚举类型csi_dma_event_t定义如下：

csi_dma_ctrl_init

csi_error_t csi_dma_ctrl_init(csi_dma_ctrl_t *dma, int8_t ctrl_id)

• 功能描述:

  • 初始化DMA控制器

• 参数:

  • dma: DMA控制器句柄
  • ctrl_id: 控制器id

• 返回值:

  • 错误码。

csi_dma_ctrl_uninit

void csi_dma_ctrl_uninit(csi_dma_ctrl_t *dma)

• 功能描述:

  • DMA控制器反初始化

• 参数:

  • dma: DMA控制器句柄

• 返回值:

  • 无。

csi_dma_ch_alloc

csi_error_t csi_dma_ch_alloc(csi_dma_ch_t *dma, int8_t ch_id, int8_t ctrl_id)

• 功能描述:

  • 申请dma通道号。

• 参数:

  • dma: DMA通道句柄
  • ch_id: DMA通道ID，当传入-1时，将由驱动自行选择
  • ctrl_id: DMA控制器ID，当传入-1时，将由驱动自行选择

• 返回值:

  • 错误码。

csi_dma_ch_free

void csi_dma_ch_free(csi_dma_ch_t *dma)

• 功能描述:

  • 释放DMA特定通道占用。

• 参数:

  • dma: DMA通道句柄。

csi_dma_addr_inc_t

csi_dma_data_width_t

csi_dma_endian_t（仅WJ使用）

csi_dma_trig_t（仅WJ使用）

csi_dma_req_mode_t（仅WJ使用）

csi_dma_single_dir_t（仅WJ使用）

wj_dma_ch_config（仅WJ使用）

csi_dma_trans_dir_t（仅DW使用）

dw_dma_ch_config（仅DW使用）

csi_dma_ch_config_t

csi_dma_ch_config

csi_error_t csi_dma_ch_config(csi_dma_ch_t *dma, csi_dma_ch_config_t *config, csi_dma_cb_t cb, void *arg);

• 功能描述:

  • 配置DMA通道工作方式，并配置回调函数。

• 参数:

  • dma: DMA通道句柄。
  • config: DMA通道配置结构体
  • cb: DMA用户回调函数
  • arg: DMA回调函数参数指针

• 返回值:

  • 错误码。

csi_dma_ch_start

void csi_dma_ch_start(csi_dma_ch_t *dma, void *srcaddr, void *dstaddr, uint32_t length)

• 功能描述:

  • 使能DMA通道，开始工作。

• 参数:

  • dma: DMA通道句柄。
  • srcaddr: 传输的源地址
  • dstaddr: 传输的目的地址
  • length: 数据的长度（字节为单位）

• 返回值:

  • 无。

csi_dma_ch_stop

void csi_dma_ch_stop(csi_dma_ch_t *dma)

• 功能描述:

  • 关闭DMA通道，结束工作。

• 参数:

  • dma: DMA通道句柄