接口设计
26 Nov 2024
Read time: 3 minute(s)
以下接口是遵循 Linux DMA Engine 子系统的标准接口：
| 函数原型 | static int aic_dma_config(struct dma_chan *chan, struct dma_slave_config *config) |
|---|---|
| 功能说明 | 配置指定的 DMA 物理通道 |
| 参数定义 | chan - 指向一个 DMA 物理通道 config - 保存了需要的配置信息 |
| 返回值 | 0，成功 |
| 注意事项 | - |
| 函数原型 | static int aic_dma_pause(struct dma_chan *chan) |
|---|---|
| 功能说明 | 暂停指定通道的传输操作 |
| 参数定义 | chan - 指向一个 DMA 物理通道 |
| 返回值 | 0，成功 |
| 注意事项 | - |
| 函数原型 | static int aic_dma_resume(struct dma_chan *chan) |
|---|---|
| 功能说明 | 恢复指定通道的传输操作 |
| 参数定义 | chan - 指向一个 DMA 物理通道 |
| 返回值 | 0，成功 |
| 注意事项 | - |
| 函数原型 | static struct dma_async_tx_descriptor *aic_dma_prep_dma_memcpy(struct dma_chan *chan,dma_addr_t dest, dma_addr_t src,size_t len, unsigned long flags) |
|---|---|
| 功能说明 | memcpy 操作的预处理 |
| 参数定义 | chan - 指向一个 DMA 物理通道 dest - 目标 Buffer 的物理地址 src - 源 Buffer 的物理地址 len - 数据长度 flags - 一些标记 |
| 返回值 | 成功，则返回一个 DMA 描述符。失败，返回 NULL |
| 注意事项 | - |
| 函数原型 | static struct dma_async_tx_descriptor *aic_dma_prep_slave_sg(struct dma_chan *chan,struct scatterlist *sgl, unsigned int sg_len,enum dma_transfer_direction dir, unsigned long flags,void *context) |
|---|---|
| 功能说明 | 设备与内存之间传输操作的预处理 |
| 参数定义 | chan - 指向一个 DMA 物理通道 sgl - 指向一个散列列表 sg_len - 散列中的数据长度 flags - 一些标记 context - 指向一些私有的上下文信息 dir - 传输方向，是 Dev to Mem，还是 Mem to Dev |
| 返回值 | 成功，则返回一个 DMA 描述符。失败，返回 NULL |
| 注意事项 | - |
| 函数原型 | static struct dma_async_tx_descriptor *aic_dma_prep_dma_cyclic(struct dma_chan *chan,dma_addr_t buf_addr, size_t buf_len, size_t period_len,enum dma_transfer_direction dir, unsigned long flags) |
|---|---|
| 功能说明 | （设备与内存之间）循环传输操作的预处理 |
| 参数定义 | chan - 指向一个 DMA 物理通道 buf_addr - 循环 Buffer 的起始物理地址 buf_len - 循环 Buffer 的总长度 period_len - 循环的 Buffer 片段长度 dir - 传输方向，是 Dev to Mem，还是 Mem to Dev flags - 一些标记 |
| 返回值 | 成功，则返回一个 DMA 描述符。失败，返回 NULL |
| 注意事项 | - |
| 函数原型 | static void aic_dma_issue_pending(struct dma_chan *chan) |
|---|---|
| 功能说明 | 启动指定通道的数据传输 |
| 参数定义 | chan - 指向一个 DMA 物理通道 |
| 返回值 | 无 |
| 注意事项 | - |
| 函数原型 | static int aic_dma_terminate_all(struct dma_chan *chan) |
|---|---|
| 功能说明 | 终止所有通道的数据传输 |
| 参数定义 | chan - 指向一个 DMA 物理通道 |
| 返回值 | 0，成功 |
| 注意事项 | - |