1、异步传输描述符(linux/dmaengine.h):
struct dma_async_tx_descriptor {
dma_cookie_t cookie; /*本次传输的跟踪cookie,如果本次传输位于独立的链表,则设置为-EBUSY*/
enum dma_ctrl_flags flags; /* not a 'long' to pack with cookie */
dma_addr_t phys; /*该描述符的物理地址*/
struct dma_chan *chan; /*本次操作的目标通道*/
dma_cookie_t (*tx_submit)(struct dma_async_tx_descriptor *tx); /*设置准备好的描述符被DMA引擎执行*/
dma_async_tx_callback callback; /*本次操作完成后的回调函数*/
void *callback_param; /*完成回调函数的参数*/
struct dma_async_tx_descriptor *next; /*完成后递交该描述符*/
struct dma_async_tx_descriptor *parent; /*升级的下一个描述符*/
spinlock_t lock;
};
2、异步传输递交/完成控制器(linux/async_tx.h)
/**
* struct async_submit_ctl - async_tx submission/completion modifiers
* @flags: submission modifiers
* @depend_tx: parent dependency of the current operation being submitted
* @cb_fn: callback routine to run at operation completion
* @cb_param: parameter for the callback routine
* @scribble: caller provided space for dma/page address conversions
*/
struct async_submit_ctl {
enum async_tx_flags flags; /*异步传