异步传输/转换（APIAsynchronous Transfers/Transforms API）

3.7 范例
进行一个xor->copy->xor操作.并且每个操作依赖前之前操作的运行结果.

void callback(void *param)  
{  
       struct completion *cmp = param;  
 
        complete(cmp);  
}  
 
void run_xor_copy_xor(struct page **xor_srcs,  
                      int xor_src_cnt,  
                      struct page *xor_dest,  
                      size_t xor_len,  
                      struct page *copy_src,  
                      struct page *copy_dest,  
                      size_t copy_len)  
{  
        struct dma_async_tx_descriptor *tx;  
        addr_conv_t addr_conv[xor_src_cnt];  
        struct async_submit_ctl submit;  
        addr_conv_t addr_conv[NDISKS];  
        struct completion cmp;  
 
        init_async_submit(&submit, ASYNC_TX_XOR_DROP_DST, NULL, NULL, NULL,  
                          addr_conv);  
        tx = async_xor(xor_dest, xor_srcs, 0, xor_src_cnt, xor_len, submit)  
 
        submit->depend_tx = tx;  
        tx = async_memcpy(copy_dest, copy_src, 0, 0, copy_len, &submit);  
 
        init_completion(&cmp);  
        init_async_submit(&submit, ASYNC_TX_XOR_DROP_DST | ASYNC_TX_ACK, tx,  
                         callback, &cmp, addr_conv);  
       tx = async_xor(xor_dest, xor_srcs, 0, xor_src_cnt, xor_len, &submit);  
 
        async_tx_issue_pending_all();  
 
        wait_for_completion(&cmp);  
}  

更多标志位的信息参见include/linux/sync_tx.h；更多的实现例子参加drivers/md/raid5.c的ops_run_*和ops_complete_*例程.

4.驱动开发笔记
4.1 构造点
为了适应由利用async_tx API的应用要求的假定,dmaengine驱动中有一些构造点是需要注意的：
1）回调函数的完成期望在tasklet的上下文发生
2）dma_async_tx_descriptor域从来不会被IRQ上下文左右
3）在描述符清理路径中使用async_tx_run_dependencies(),以处理有依赖关系操作的提交

4.2 “我的应用需要硬件通道的异步控制”
最基本的,这种要求来源于当一个DMA engine驱动被用来支持“设备到内存”的操作.很多平台的特殊性,提供这些操作的通道是不能被共享的.对于这种情况,要提供dma_request_channel()接口.
这种接口是： struct dma_chan *dma_request_channel(dma_cap_mask_t mask,dma_filter_fn filter_fn,void *filter_param);
其中,dma_filter_fn的定义为：
typedef bool (*dma_filter_fn)(struct dma_chan *chan, void *filter_param);

当可选的‘filter_fn’参数置为NULL时,dma_request_channel简单的返回第一个满足有能力mask的通道.否则,当mask参数不足以区别必要的通道时候,filter_fn例程可以用来排列系统中可用的通道.filter_fn例程被系统中每个空闲的通道调用.当找到一个适合的通道的时候,filter_fn返回一个DMA_ACK,该标志和dma_request_channel的返回值相连.一个通道通过这个接口被分配,和调用者是异步的关系,直到dma_release_channel()被调用.

DMA_PRIVATE标志被用来标记不能用作一般目的分配器的DMA设备.如果知道一个通道将一直是私有的时候,该标志位需要被置位.否则,当dma_request_channel()发现一个没有使用的“共有”通道,要被置位.

以下是两个实现驱动和消费者需要注意的地方：
1）一旦一个通道已经被私有的分配,它将不再被当做一般目的的分配器对待,即使在调用dma_release_channel()之后.
2

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!