Linux dma驱动程序dma_cap_set，dma_cap_zero

Question

我正在为一个dma编写linux设备驱动程序，当我在LXR中查看dma驱动程序的源代码时，我遇到了函数dma_cap_zero和dma_cap_set以及整个dma_cap_*家族。这些函数是什么？还有一个叫做dma_transaction_type的结构

enum dma_transaction_type {
         DMA_MEMCPY,
          DMA_XOR,
          DMA_PQ,
          DMA_XOR_VAL,
         DMA_PQ_VAL,
          DMA_MEMSET,
         DMA_INTERRUPT,
          DMA_SG,
          DMA_PRIVATE,
          DMA_ASYNC_TX,
          DMA_SLAVE,
          DMA_CYCLIC,
          DMA_INTERLEAVE,
  /* last transaction type for creation of the capabilities mask */
          DMA_TX_TYPE_END,
  };

枚举类型代表什么？

Answer 1

这些函数实际上是预处理器宏函数，由从机DMA器件用来配置和请求DMA通道。

下面是一个使用它们的示例：

dma_cap_mask_t mask;

dma_cap_zero(mask);
dma_cap_set(DMA_MEMCPY,mask);
dma_chan1 = dma_request_channel(mask,0,NULL);

这段代码来自http://ecourse.wikidot.com/dmatest。

首先，是在dmaengine.h, ~line 233中定义的数据类型dma_cap_mask_t。它是位字段的一种类型，其中的位指示DMA通道能够进行的传输类型。

在上面的代码片段中(出现在链接代码的__init例程中)，掩码被声明为特殊dma_cap_mask_t数据类型。然后调用dma_cap_zero()函数并将掩码传递给它。

我相信dma_cap_zero只是简单地调零了功能掩码。它在dmaengine.h, ~line 733中定义。函数的返回值是void，我认为它会将位字段置零。不过，我不能完全确定，因为内核代码是一堆巨大的宏魔法，有时我很难破译。

在掩码归零或由dma_cap_zero以某种方式初始化后，必须设置通道的功能。dma_cap_set函数实现了这一点。它获取请求通道类型，并根据执行该类型事务所需的功能设置掩码。如果您对枚举的使用方式感到困惑，请看一下this page，简单回顾一下枚举。在本例中，枚举中的值似乎用于描述不同类型的DMA事务，每个事务都需要一组不同的“功能”。dma_set_cap函数根据指定交易类型所需的能力设置能力掩码。

一旦为您想要执行的DMA事务类型正确设置了掩码，您就可以请求DMA通道。

其他的DMA宏用于在dma_cap*掩码上执行其他类型的操作，而不真正知道幕后发生了什么。这些类型的宏在内核代码中到处都是，用于更多的操作，而不仅仅是DMA。它们允许设备驱动程序在内核中完成任务，而不必担心内核是如何完成的。