【正点原子STM32连载】第三十二章 DMA实验摘自【正点原子】APM32E103最小系统板使用指南

1）实验平台：正点原子APM32E103最小系统板
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/docs/boards/xiaoxitongban

第三十二章 DMA实验

本章介绍APM32E103直接存储访问（DMA）的使用，DMA能够在无CPU干预的情况下，实现外设与存储器或存储器与存储器之间数据的高速传输，从而节省CPU资源来做其他操作。通过本章的学习，读者将学习到DMA的使用。
本章分为如下几个小节：
32.1 硬件设计
32.2 程序设计
32.3 下载验证

32.1 硬件设计
32.1.1 例程功能

按下KEY0按键，USART1以DMA方式发送数据，同时在LCD上显示DMA传输的进度
LED0闪烁，指示程序正在运行
32.1.2 硬件资源
LED
LED0 - PB5
按键
KEY0 - PE4
正点原子 2.8/3.5/4.3/7/10寸TFTLCD模块（仅限MCU屏，16位8080并口驱动）
USART1（PA9、PA10连接至板载USB转串口芯片上）
DMA（DMA1通道4）
32.1.3 原理图
本章实验使用的DMA为APM32E103的片上资源，因此没有对应的连接原理图。
32.2 程序设计
32.2.1 Geehy标准库的DMA驱动
在使用DMA之前，需要先根据需求对DMA的通道进行配置，例如本章实验要使用DMA进行串口数据的发送，因此应将DMA的通道配置为存储器到外设的模式等等。使用DMA的具体步骤如下：
①：根据需求配置DMA通道
②：使能DMA通道进行数据传输
③：读DMA通道的状态标志判断传输是否完成
④：传输完成后清除DMA通道的传输完成标志
在Geehy标准库中对应的驱动函数如下：
①：配置DMA通道
该函数用于配置DMA通道的各项参数，其函数原型如下所示：
void DMA_Config(DMA_Channel_T* channel, DMA_Config_T* dmaConfig)
该函数的形参描述，如下表所示：
形参描述
channel 指定的DMA通道
例如：DMA1_channelx，其中x可以从1到7或DMA2_channely，同样的y可以从1至5（在apm32e10x.h文件中有定义）
dmaConfig 指向DMA通道配置结构体的指针
需自行定义，并根据DMA通道的配置参数填充结构体中的成员变量
表32.2.1.1 函数DMA_Config()形参描述
该函数的返回值描述，如下表所示：
返回值描述
无无
表32.2.1.2 函数DMA_Config()返回值描述
该函数使用DMA_Config_T类型的结构体变量传入DMA通道的配置参数，该结构体的定义如下所示：

typedef enum
{DMA_DIR_PERIPHERAL_SRC,DMA_DIR_PERIPHERAL_DST
} DMA_DIR_T;typedef enum
{DMA_PERIPHERAL_INC_DISABLE,						/* 禁止外设增量模式 */DMA_PERIPHERAL_INC_ENABLE						/* 使能外设增量模式 */
} DMA_PERIPHERAL_INC_T;typedef enum
{DMA_MEMORY_INC_DISABLE,							/* 禁用存储器递增模式 */DMA_MEMORY_INC_ENABLE							/* 使能存储器递增模式 */
} DMA_MEMORY_INC_T;typedef enum
{DMA_PERIPHERAL_DATA_SIZE_BYTE,					/* 外设数据大小为字节 */DMA_PERIPHERAL_DATA_SIZE_HALFWORD,				/* 外设数据大小为半字 */DMA_PERIPHERAL_DATA_SIZE_WORD					/* 外设数据大小为字 */
} DMA_PERIPHERAL_DATA_SIZE_T;typedef enum
{DMA_MODE_NORMAL,								/* 禁用循环模式 */DMA_MODE_CIRCULAR								/* 使能循环模式 */
} DMA_LOOP_MODE_T;typedef enum
{DMA_PRIORITY_LOW,								/* 优先级低 */DMA_PRIORITY_MEDIUM,							/* 优先级中 */DMA_PRIORITY_HIGH,								/* 优先级高 */DMA_PRIORITY_VERYHIGH							/* 优先级非常高 */
} DMA_PRIORITY_T;typedef struct
{uint32_t					peripheralBaseAddr;	/* 外设基地址 */uint32_t					memoryBaseAddr;		/* 存储器基地址 */DMA_DIR_T					dir;				/* 数据传输方向 */uint32_t					bufferSize;			/* 传输的数据项数目 */DMA_PERIPHERAL_INC_T		peripheralInc;		/* 外设增量模式 */DMA_MEMORY_INC_T			memoryInc;			/* 存储器递增模式 */DMA_PERIPHERAL_DATA_SIZE_T	peripheralDataSize;	/* 外设数据大小 */DMA_MEMORY_DATA_SIZE_T		memoryDataSize;		/* 存储器数据大小 */DMA_LOOP_MODE_T				loopMode;			/* 循环模式 */
DMA_PRIORITY_T				priority;			/* 优先级 */
DMA_M2MEN_T                M2M;
} DMA_Config_T;
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_dma.h"static uint8_t membuf[256];void example_fun(void)
{DMA_Config_T dma_init_struct;/* 配置DMA1通道0通道0 */dma_init_struct.channel				= DMA_CHANNEL_0;dma_init_struct.peripheralBaseAddr	= (uint32_t)&USART1->DATA;dma_init_struct.memoryBaseAddr		= (uint32_t)&membuf[0];dma_init_struct.dir					= DMA_DIR_MEMORYTOPERIPHERAL;dma_init_struct.bufferSize			= sizeof(membuf) / sizeof(membuf[0]);dma_init_struct.peripheralInc		= DMA_PERIPHERAL_INC_DISABLE;dma_init_struct.memoryInc			= DMA_MEMORY_INC_ENABLE;dma_init_struct.peripheralDataSize	= DMA_PERIPHERAL_DATA_SIZE_BYTE;dma_init_struct.memoryDataSize		= DMA_MEMORY_DATA_SIZE_BYTE;dma_init_struct.loopMode			= DMA_MODE_NORMAL;dma_init_struct.priority			= DMA_PRIORITY_MEDIUM;dma_init_struct.fifoMode			= DMA_FIFOMODE_DISABLE;dma_init_struct.fifoThreshold		= DMA_FIFOTHRESHOLD_FULL;dma_init_struct.memoryBurst			= DMA_MEMORYBURST_SINGLE;dma_init_struct.peripheralBurst	= DMA_PERIPHERALBURST_SINGLE;DMA_Config(DMA1_Stream0, &dma_init_struct);
}

②：使能DMA通道
该函数用于使能DMA通道进行数据传输，其函数原型如下所示：
void DMA_Enable(DMA_Channel_T *channel);
该函数的形参描述，如下表所示：
形参描述
channel 指定的DMA通道
表32.2.1.3 函数DMA_Enable()形参描述
该函数的返回值描述，如下表所示：
返回值描述
无无
表32.2.1.4 函数DMA_Enable()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_dma.h"void example_fun(DMA_Channel_T *dma_chx)
{/* 使能DMA通道 */DMA_Enable(dma_chx);
}

③：读取DMA通道的状态标志
该函数用于读取DMA通道的指定状态标志，其函数原型如下所示：
uint8_t DMA_ReadStatusFlag(DMA_FLAG_T flag);
该函数的形参描述，如下表所示：
形参描述
flag 指定DMA通道的状态标志
例如：DMA1_FLAG_GINT1、DMA1_FLAG_TC1等（在apm32e10x_dma.h文件中有定义）
表32.1.2.5 函数DMA_ReadStatusFlag()形参描述
该函数的返回值描述，如下表所示：
返回值描述
SET 事件标志发生
RESET 事件标志未发生
表32.1.2.6 函数DMA_ReadStatusFlag()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_dma.h"void example_fun(void)
{uint8_t flag;/* 读取DMA1通道4的数据传输完成标志 */flag = DMA_ReadStatusFlag(DMA1_FLAG_TC4);if (flag == SET){/* Do something. */}else{/* Do something. */}
}

④：清除DMA通道状态标志
该函数用于清除DMA通道的状态标志，其函数原型如下所示：
void DMA_ClearStatusFlag(uint32_t flag);
该函数的形参描述，如下表所示：
形参描述
flag 清除指定DMA通道的标志
例如：DMA1_FLAG_GINT1、DMA1_FLAG_TC1等（在apm32e10x_dma.h文件中有定义）
表32.2.1.7 函数DMA_ClearStatusFlag()形参描述
该函数的返回值描述，如下表所示：
返回值描述
无无
表32.2.1.8 函数DMA_ClearStatusFlag()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_dma.h"void example_fun(void)
{/* 清除DMA1通道1的传输完成标志 */DMA_ClearStatusFlag(DMA1_FLAG_TC1);
}

32.2.2 DMA驱动
本章实验的DMA驱动主要负责向应用层提供DMA的初始化和开启传输的函数。本章实验中，DMA的驱动代码包括dma.c和dma.h两个文件。
DMA驱动中，DMA的初始化函数，如下所示：

/*** @brief       初始化DMA* @param       dma_chx   : DMA通道* @param       par       : 外设地址* @param       mar       : 存储器0地址* @param       ndtr      : 传输的数据项数目* @retval      无*/
void dma_init(	DMA_Channel_T *dma_chx,uint32_t par, uint32_t mar,uint16_t ndtr)
{DMA_Config_T dma_init_struct;RCM_EnableAHBPeriphClock(RCM_AHB_PERIPH_DMA1);          /* 使能DMA时钟 */DMA_Reset(dma_chx);                                     /* 复位DMA *//* 配置DMA */dma_init_struct.peripheralBaseAddr = par;               /* 外设基地址 */dma_init_struct.memoryBaseAddr = mar;                   /* DMA内存基地址 */dma_init_struct.dir = DMA_DIR_PERIPHERAL_DST;           /* 数据传输方向 */
dma_init_struct.bufferSize = ndtr;                      /* 传输的数据项数目 */
/* 外设增量模式 */dma_init_struct.peripheralInc = DMA_PERIPHERAL_INC_DISABLE;
dma_init_struct.memoryInc = DMA_MEMORY_INC_ENABLE;      /* 存储器递增模式 */
/* 外设数据大小 */
dma_init_struct.peripheralDataSize = DMA_PERIPHERAL_DATA_SIZE_BYTE; 
/* 存储器数据大小 */dma_init_struct.memoryDataSize = DMA_MEMORY_DATA_SIZE_BYTE;         dma_init_struct.loopMode = DMA_MODE_NORMAL;             /* 正常工作模式 */
dma_init_struct.priority = DMA_PRIORITY_MEDIUM;         /* 优先级 */
/* DMA通道x没有设置为内存到内存传输 */dma_init_struct.M2M = DMA_M2MEN_DISABLE;DMA_Config(dma_chx, &dma_init_struct);                  /* 配置DMA通道 */DMA_Enable(dma_chx);                                    /* 使能DMA通道 */
}

从上面的代码中可以看到，DMA的初始化函数提供了DMA通道、外设基地址、存储器基地址、传输数据项数据的配置参数，结合这些传入的参数，通过DMA通道配置函数DMA_Config()配置了指定的DMA通道。
DMA驱动中，开启DMA传输的函数，如下所示：

/*** @brief       开启一次DMA传输* @param       dma_chx   : DMA通道* @param       ndtr      : 传输的数据项数目* @retval      无*/
void dma_enable(DMA_Channel_T *dma_chx, uint16_t ndtr)
{DMA_Disable(dma_chx);                    /* 关闭USART1 TX DMA1 所指示的通道 */DMA_ConfigDataNumber(dma_chx, ndtr);     /* 配置传输的数据项数目 */DMA_Enable(dma_chx);                     /* 使能USART1 TX DMA1 所指示的通道 */
}

从上面的代码中可以看到，开启DMA数据传输实际上就是调用函数DMA_Enable()使能DMA通道，但考虑到每次传输的数据量可能不同，因此在使能DMA通道前，还配置了DMA通道传输数据项目的数量。
32.2.3 实验应用代码
本实验的应用代码，如下所示：
/* 要循环发送的字符串 */

const uint8_t text_to_send[] = {"正点原子 APM32E103最小系统板 DMA实验\r\n"};
#define SEND_BUF_SIZE (sizeof(text_to_send) * 200)  /* 发送数据长度 */
uint8_t g_sendbuf[SEND_BUF_SIZE];                   /* 发送数据缓冲区 */int main(void)
{uint8_t key;uint16_t i;uint16_t len;uint16_t pro;NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_4);/* 设置中断优先级分组为组4 */sys_apm32_clock_init(15);                       /* 配置系统时钟 */delay_init(120);                                /* 初始化延时功能 */usart_init(115200);                             /* 初始化串口 */led_init();                                     /* 初始化LED */lcd_init();                                     /* 初始化LCD */
dma_init( DMA1_Channel4, (uint32_t) & USART1->DATA, (uint32_t)g_sendbuf, SEND_BUF_SIZE);                       /* 初始化DMA */lcd_show_string(30, 50, 200, 16, 16, "APM32", RED);lcd_show_string(30, 70, 200, 16, 16, "DMA TEST", RED);lcd_show_string(30, 90, 200, 16, 16, "ATOM@ALIENTEK", RED);lcd_show_string(30, 110, 200, 16, 16, "KEY0:Start", RED);len = sizeof(text_to_send);                                                             /* 填充发送数据缓冲区 */for (i = 0; i < SEND_BUF_SIZE; i++){g_sendbuf[i] = text_to_send[i % len];}i = 0;while (1){key = key_scan(0);if (key == KEY0_PRES){lcd_show_string(30, 130, 200, 16, 16, "Start Transimit....", BLUE);lcd_show_string(30, 150, 200, 16, 16, "   %", BLUE);USART_EnableDMA(USART_UX, USART_DMA_TX);                                        /* 使能USART的DMA发送 */dma_enable(DMA1_Channel4, SEND_BUF_SIZE);                                       /* 开启一次DMA传输 *//* 等待DMA传输完成* 实际应用中，在等待DMA传输完成期间，可以执行另外的任务*/while (1){   /* 判断通道4传输完成 */if (DMA_ReadStatusFlag(DMA1_FLAG_TC4) != RESET){   /* 清除通道4传输完成标志 */DMA_ClearStatusFlag(DMA1_FLAG_TC4);break;}pro = DMA_ReadDataNumber(DMA1_Channel4);                                    /* 得到当前还剩余多少个数据  */pro = ((SEND_BUF_SIZE - pro) * 100) / SEND_BUF_SIZE;                        /* 获得百分比 */lcd_show_num(30, 150, pro, 3, 16, BLUE);                                    /* LCD显示DMA传输进度 */}pro = DMA_ReadDataNumber(DMA1_Channel4);pro = ((SEND_BUF_SIZE - pro) * 100) / SEND_BUF_SIZE;lcd_show_num(30, 150, pro, 3, 16, BLUE);lcd_show_string(30, 130, 200, 16, 16, "Transimit Finished!", BLUE);             /* LCD显示传送完成 */}i++;if ((i % 20) == 0){i = 0;LED0_TOGGLE();                                                                  }delay_ms(10);}
}

从上面的代码中可以看到，在DMA的初始化中，初始化了DMA1通道4，这是因为USART1的发送就对应了DMA1通道4，完成初始化工作后，就不断地扫描按键，若扫描到KEY0按键，并使用DMA进行USART1发送数据，在DMA进行数据传输的此期间，LCD上不断刷新显示DMA传输的进度，直至DMA传输完毕。
32.3 下载验证
在完成编译和烧录操作后，可以看到LCD上显示了本实验的实验信息，此时若按下KEY0按键，可以看到串口调试助手不断打印“正点原子 APM32E103最小系统板 DMA实验\r\n”（200次），在此期间也能看到LCD上不断地实时刷新串口打印的进度。