SAM4E单片机之旅——20、DMAC之使用Multi-buffer进行内存拷贝

这次使用这个DMAC的Multi-buffer传输功能，将两个缓冲区的内容拷贝至一个连续的缓冲区中。

一、 DMAC

在M4中，DMA控制器（DMAC）比外设DMA控制器（PDC）要复杂，但是功能更加强大。

为适应不同的传输要求，DMAC 可以进行灵活的自定义配置，甚至配备了一个FIFO缓存。比如可以为源设备和目标设备分别设定传输时，地址的变动方式（递增、递减或固定）；以及一次传输的数据量（字节、半字或字）。

DMAC有4个通道，每个通道可以进行一个传输任务。进行传输的设备可分为“内存”及“非内存”：内存表示随时可以对该设备进行访问，而非内存表示需要一个信号（握手接口）来触发或控制对设备的访问。握手接口可以选择硬件或软件的，并且可以在传输的过程中动态配置。

另外，比起PDC只能设置下一次传输的参数（传输地址，数据量大小等），DMAC可以先在内存中保存好若干次传输的参数，然后自动进行多次传输（Multi-buffer传输）。

二、 Multi-buffer传输的实现机制

每个通道有若干个寄存器。其中：源地址和目的地址寄存器（SADDR和DADDR），描述符地址寄存器（DSCR），控制器存器（CTRLA和CTRLB）这几个寄存器可以根据需要进行自动修改。在内存中有一块区域（LLI），连续地储存着这几个寄存器的目标设置。然后就像一个链表一样，DSCR表示下一个区域的地址：

SAM4E单片机之旅——20、DMAC之使用Multi-buffer进行内存拷贝

在启用通道时，如果DSCR为0，则表示只需进行一次传输，在传输完成后就关闭通道。

如果DSCR不为0，则表示进行多次传输，而这几个寄存器的更新过程如下：

获取DSCR指向的LLI的内容。如果DSCR为0，则任务结束。
根据当前CTRLB寄存器的内容，判断是否需要根据该LLI更新SADDR及DADDR。然后根据该LLI更新其余寄存器（CTRLA，CTRLB，DSCR）。
根据新的寄存器内容进行传输。
传输完成后，将CTRLA的内容回写至内存中（传输中仅有该寄存器的BTSIZE和DONE字段会发生该变）。
根据通道CFG寄存器的Stop On Done（SOD）字段判断是否需要重新执行以上过程。

所以，在启用通道前，除了要设置好CFG寄存器外，也需要设置好CTRLB。

三、实现思路

重申一下目标：将两个缓冲区的内容拷贝至一个连续的缓冲区中。

由于源缓冲区有两个，所以我们将使用两个LLI。其中每个LLI的SADDR指向每个源缓冲区的首地址，并且在每次获取LLI时，更新SADDR。而由于目标缓冲区是连续的，所以不需要更新DADDR。

然后在启用通道前，设置好DADDR。同时，设置CTRLB，该通道不从LLI中更新DADDR地址；设置好DSCR，使其指向第一个LLI。

四、使用LLI

定义LLI结构体。

LLI的内存布局不复杂，但是使用结构体来进行操作也很有助于简化工作。而且由于布局简单，也不用太关注内存对齐的细节。（另外，在使用LLI时，需要它的地址是字对齐的。）
```
typedef struct _lli{

	uint32_t SADDR;

	uint32_t DADDR;

	uint32_t CTRLA;

	uint32_t CTRLB;

	uint32_t DSCR;

}LLI;
```

LLI的初始化。

由于两个LLI的设置有许多相同的部分，所以将共同的部分抽象出来。

// lli:		需要初始化的LLI的地址

// saddr:		源地址

// btsize:	传输次数

// next_lli:	下一个LLI的地址。如果是最后一个LLI，该参数为NULL即可

void InitLLI(LLI* lli, void* saddr, uint16_t btsize, LLI* next_lli)

{

	lli->SADDR = (uint32_t)saddr;

	lli->DADDR = 0;		// DADDR 不会被使用，初始化为即可

	lli->DSCR = DMAC_DSCR_DSCR_Msk & (uint32_t)next_lli;

	lli->CTRLA =

		  DMAC_CTRLA_BTSIZE(btsize)		// 传输次数

		| DMAC_CTRLA_SRC_WIDTH_WORD		// 源设备一次传输一个字

		| DMAC_CTRLA_DST_WIDTH_WORD		// 目标设备一次传输一个字

		;

	lli->CTRLB =

		  DMAC_CTRLB_SRC_DSCR_FETCH_FROM_MEM	// 从LLI中更新SRC地址

		| DMAC_CTRLB_DST_DSCR_FETCH_DISABLE	// 不更新DST地址

		| DMAC_CTRLB_FC_MEM2MEM_DMA_FC		// 设备类型：内存至内存

		| DMAC_CTRLB_SRC_INCR_INCREMENTING	// 传输时，源地址递增

		| DMAC_CTRLB_DST_INCR_INCREMENTING	// 传输时，目标地址递增

		;

}

五、实现过程

缓冲区。

// 源缓冲区

uint32_t src1[2];

uint32_t src2[3];

// 目标缓冲区

uint32_t dst[5];

// 向源缓冲区时填充内容

src1[0] = 50; src1[1] = 51;

src2[0] = 52; src2[1] = 53; src2[2] = 54;

设置LLI。

注意，要确保LLI的实例在整个程序的运行过程中都是有效的。比如如果LLI是储存在函数的栈中的话，那么函数退出后，该LLI即无效了。所以可以选择在堆中分配LLI实例的空间，或是将其定义为全局变量，也可以在main函数中定义实例。
```
LLI first_lli, last_lli;

InitLLI(&first_lli, (void*)src1, 2, &last_lli);

InitLLI(&last_lli, (void*)src2, 3, 0);
```

启用DMAC。

// PMC

PMC->PMC_PCER0 = 1 << ID_DMAC;

DMAC->DMAC_GCFG =

	 DMAC_GCFG_ARB_CFG_ROUND_ROBIN;	// 轮转优先级

DMAC->DMAC_EN = DMAC_EN_ENABLE;

配置通道。

// 使用的通道为通道0

#define DMAC_CH 0

// 使DSCR指向first_lli

DMAC->DMAC_CH_NUM[DMAC_CH].DMAC_DSCR =

		(uint32_t)(void*)(&first_lli);

// 设置目标地址

DMAC->DMAC_CH_NUM[DMAC_CH].DMAC_DADDR =

(uint32_t)(void*) dst;

// 设置CTRLB，使通道从LLI中更新源地址

DMAC->DMAC_CH_NUM[DMAC_CH].DMAC_CTRLB =

		  DMAC_CTRLB_SRC_DSCR_FETCH_FROM_MEM

		| DMAC_CTRLB_DST_DSCR_FETCH_DISABLE;

// 配置CFG寄存器

DMAC->DMAC_CH_NUM[DMAC_CH].DMAC_CFG =

DMAC_CFG_SOD_DISABLE

		| DMAC_CFG_FIFOCFG_ALAP_CFG

		;

启用通道。

DMAC->DMAC_CHER = DMAC_CHER_ENA0 << DMAC_CH;

等待通道关闭，即传输完成。

const uint32_t check_bit = DMAC_CHSR_ENA0 << DMAC_CH;

while( (DMAC->DMAC_CHSR & check_bit) != 0);