10 STM32标准库函数 之 DMA控制器（DMA）所有函数的介绍及使用

函数描述格式：

函数名	外设函数的名称
函数原形	原形声明
功能描述	简要解释函数是如何执行的
输入参数{x}	输入参数描述
输出参数{x}	输出参数描述
返回值	函数的返回值
先决条件	调用函数前应满足的要求
被调用函数	其他被该函数调用的库函数

缩写定义

缩写	外设/单元
ADC	模数转换器
BKP	备份寄存器
CAN	控制器局域网模块
DMA	直接内存存取控制器
EXTI	外部中断事件控制器
FLASH	闪存存储器
GPIO	通用输入输出
I2C	内部集成电路
IWDG	独立看门狗
NVIC	嵌套中断向量列表控制器
PWR	电源/功耗控制
RCC	复位与时钟控制器
RTC	实时时钟
SPI	串行外设接口
SysTick	系统嘀嗒定时器
TIM	通用定时器
TIM1	高级控制定时器
USART	通用同步异步接收发射端
WWDG	窗口看门狗

1 DMA库函数预览

函数名	描述
DMA_DeInit	将 DMA 的通道 x 寄存器重设为缺省值
DMA_Init	根据 DMA_InitStruct 中指定的参数初始化 DMA 的通道 x 寄存器
DMA_StructInit	把 DMA_InitStruct 中的每一个参数按缺省值填入
DMA_Cmd	使能或者失能指定的通道 x
DMA_ITConfig	使能或者失能指定的通道 x 中断
DMA_GetCurrDataCount	返回当前 DMA 通道 x 剩余的待传输数据数目
DMA_GetFlagStatus	检查指定的 DMA 通道 x 标志位设置与否
DMA_ClearFlag	清除 DMA 通道 x 待处理标志位
DMA_GetITStatus	检查指定的 DMA 通道 x 中断发生与否
DMA_ClearITPendingBit	清除 DMA 通道 x 中断待处理标志位

1.1 函数 DMA_DeInit

函数名	DMA_DeInit
函数原形	void DMA_DeInit(DMA_Channel_TypeDef* DMA_Channelx)
功能描述	将 DMA 的通道 x 寄存器重设为缺省值
输入参数	DMA Channelx：x 可以是 1，2…，或者 7 来选择DMA 通道 x
输出参数	无
返回值	无
先决条件	无
被调用函数	RCC_APBPeriphResetCmd()

例：
/* Deinitialize the DMA Channel2 */ DMA_DeInit(DMA_Channel2);

2.2 函数DMA_Init

函数名	DMA_Init
函数原形	void DMA_Init(DMA_Channel_TypeDef* DMA_Channelx, DMA_InitTypeDef* DMA_InitStruct)
功能描述	根据 DMA_InitStruct 中指定的参数初始化 DMA 的通道 x 寄存器
输入参数 1	DMA Channelx：x 可以是 1，2…，或者 7 来选择DMA 通道 x
输入参数 2	DMA_InitStruct：指向结构 DMA_InitTypeDef 的指针，包含了 DMA 通道 x 的配置信息
输出参数	无
返回值	无
先决条件	无
被调用函数	无

DMA_InitTypeDef structure
typedef struct
{
u32 DMA_PeripheralBaseAddr; u32 DMA_MemoryBaseAddr;
u32 DMA_DIR;
u32 DMA_BufferSize; u32 DMA_PeripheralInc; u32 DMA_MemoryInc;
u32 DMA_PeripheralDataSize; u32 DMA_MemoryDataSize;
u32 DMA_Mode;
u32 DMA_Priority; u32 DMA_M2M;
} DMA_InitTypeDef;

DMA_PeripheralBaseAddr
该参数用以定义 DMA 外设基地址
DMA_MemoryBaseAddr
该参数用以定义 DMA 内存基地址
DMA_DIR
DMA_DIR 规定了外设是作为数据传输的目的地还是来源

DMA_DIR	描述
DMA_DIR_PeripheralDST	外设作为数据传输的目的地
DMA_DIR_PeripheralSRC	外设作为数据传输的来源

DMA_BufferSize
DMA_BufferSize 用以定义指定 DMA 通道的 DMA 缓存的大小，单位为数据单位。根据传输方向，数据单位等于结构中参数 DMA_PeripheralDataSize 或者参数 DMA_MemoryDataSize 的值。DMA_PeripheralInc
DMA_PeripheralInc 用来设定外设地址寄存器递增与否。

DMA_PeripheralInc 值

DMA_PeripheralInc	描述
DMA_PeripheralInc_Enable	外设地址寄存器递增
DMA_PeripheralInc_Disable	外设地址寄存器不变

DMA_MemoryInc	描述
DMA_MemoryInc_Enable	内存地址寄存器递增
DMA_MemoryInc_Disable	内存地址寄存器不变

DMA_PeripheralDataSize	描述
DMA_PeripheralDataSize_Byte	数据宽度为 8 位
DMA_PeripheralDataSize_HalfWord	数据宽度为 16 位
DMA_PeripheralDataSize_Word	数据宽度为 32 位

DMA_MemoryDataSize	描述
DMA_MemoryDataSize_Byte	数据宽度为 8 位
DMA_MemoryDataSize_HalfWord	数据宽度为 16 位
DMA_MemoryDataSize_Word	数据宽度为 32 位

DMA_Mode	描述
DMA_Mode_Circular	工作在循环缓存模式
DMA_Mode_Normal	工作在正常缓存模式

DMA_Mode	描述
DMA_Priority_VeryHigh	DMA 通道 x 拥有非常高优先级
DMA_Priority_High	DMA 通道 x 拥有高优先级
DMA_Priority_Medium	DMA 通道 x 拥有中优先级
DMA_Priority_Low	DMA 通道 x 拥有低优先级

DMA_M2M	描述
DMA_M2M_Enable	DMA 通道 x 设置为内存到内存传输
DMA_M2M_Disable	DMA 通道 x 没有设置为内存到内存传输

例：
/* Initialize the DMA Channel1 according to the DMA_InitStructure members */
DMA_InitTypeDef DMA_InitStructure; DMA_InitStructure.DMA_PeripheralBaseAddr = 0x40005400; DMA_InitStructure.DMA_MemoryBaseAddr = 0x20000100; DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralSRC; DMA_InitStructure.DMA_BufferSize = 256; DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable; DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable; DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_HalfWord;
DMA_InitStructure.DMA_Mode = DMA_Mode_Normal; DMA_InitStructure.DMA_Priority = DMA_Priority_Medium; DMA_InitStructure.DMA_M2M = DMA_M2M_Disable; DMA_Init(DMA_Channel1, &DMA_InitStructure);

1.3 函数 DMA_StructInit

函数名	DMA_StructInit
函数原形	void DMA_StructInit(DMA_InitTypeDef* DMA_InitStruct)
功能描述	把 DMA_InitStruct 中的每一个参数按缺省值填入
输入参数	DMA_InitStruct：指向结构 DMA_InitTypeDef 的指针，待初始化
输出参数	无
返回值	无
先决条件	无
被调用函数	无

DMA_InitStruc

成员	缺省值
DMA_PeripheralBaseAddr	0
DMA_MemoryBaseAddr	0
DMA_DIR	DMA_DIR_PeripheralSRC
DMA_BufferSize	0
DMA_PeripheralInc	DMA_PeripheralInc_Disable
DMA_MemoryInc	DMA_MemoryInc_Disable
DMA_PeripheralDataSize	DMA_PeripheralDataSize_Byte
DMA_MemoryDataSize	DMA_MemoryDataSize_Byte
DMA_Mode	DMA_Mode_Normal
DMA_Priority	DMA_Priority_Low
DMA_M2M	DMA_M2M_Disable

例：
/* Initialize a DMA_InitTypeDef structure */ DMA_InitTypeDef DMA_InitStructure; DMA_StructInit(&DMA_InitStructure);

1.4 函数DMA_Cmd

函数名	DMA_Cmd
函数原形	void DMA_Cmd(DMA_Channel_TypeDef* DMA_Channelx, FunctionalState NewState)
功能描述	使能或者失能指定的通道 x
输入参数 1	DMA Channelx：x 可以是 1，2…，或者 7 来选择DMA 通道 x
输入参数 2	NewState：DMA 通道 x 的新状态
	这个参数可以取：ENABLE 或者 DISABLE
输出参数	无
返回值	无
先决条件	无
被调用函数	无

例：
/* Enable DMA Channel7 */ DMA_Cmd(DMA_Channel7, ENABLE);

1.5 函数DMA_ITConfig

函数名	DMA_ITConfig
函数原形	void DMA_ITConfig(DMA_Channel_TypeDef* DMA_Channelx, u32 DMA_IT, FunctionalState NewState)
功能描述	使能或者失能指定的通道 x 中断
输入参数 1	DMA Channelx：x 可以是 1，2…，或者 7 来选择DMA 通道 x
输入参数 2	DMA_IT：待使能或者失能的 DMA 中断源，使用操作符“
参阅 Section	DMA_IT 查阅更多该参数允许取值范围
输入参数 3	NewState：DMA 通道 x 中断的新状态
	这个参数可以取：ENABLE 或者 DISABLE
输出参数	无
返回值	无
先决条件	无
被调用函数	无

输入参数 DMA_IT 使能或者失能 DMA 通道 x 的中断。

DMA_IT	描述
DMA_IT_TC	传输完成中断屏蔽
DMA_IT_HT	传输过半中断屏蔽
DMA_IT_TE	传输错误中断屏蔽

例：
/* Enable DMA Channel5 complete transfer interrupt */ DMA_ITConfig(DMA_Channel5, DMA_IT_TC, ENABLE);

1.6 函 数 DMA_GetCurrDataCounte

函数名	DMA_GetCurrDataCounter
函数原形	u16 DMA_GetCurrDataCounter(DMA_Channel_TypeDef* DMA_Channelx)
功能描述	返回当前 DMA 通道 x 剩余的待传输数据数目
输入参数	DMA Channelx：x 可以是 1，2…，或者 7 来选择DMA 通道 x
输出参数	无
返回值	当前 DMA 通道 x 剩余的待传输数据数目
先决条件	无
被调用函数	无

例：
/* Get the number of remaining data units in the current DMA Channel2 transfer */
u16 CurrDataCount;
CurrDataCount = DMA_GetCurrDataCounter(DMA_Channel2);

1.7 函数DMA_GetFlagStatus

函数名	DMA_GetFlagStatus
函数原形	FlagStatus DMA_GetFlagStatus(u32 DMA_FLAG)
功能描述	检查指定的 DMA 通道 x 标志位设置与否
输入参数	DMA_FLAG：待检查的 DMA 标志位
参阅 Section	DMA_FLAG 查阅更多该参数允许取值范围
输出参数	无
返回值	DMA_FLAG 的新状态（SET 或者 RESET）
先决条件	无
被调用函数	无

参数 DMA_FLAG 定义了待检察的标志位类型.

DMA_FLAG	描述
DMA_FLAG_GL1	通道 1 全局标志位
DMA_FLAG_TC1	通道 1 传输完成标志位
DMA_FLAG_HT1	通道 1 传输过半标志位
DMA_FLAG_TE1	通道 1 传输错误标志位
DMA_FLAG_GL2	通道 2 全局标志位
DMA_FLAG_TC2	通道 2 传输完成标志位
DMA_FLAG_HT2	通道 2 传输过半标志位
DMA_FLAG_TE2	通道 2 传输错误标志位
DMA_FLAG_GL3	通道 3 全局标志位
DMA_FLAG_TC3	通道 3 传输完成标志位
DMA_FLAG_HT3	通道 3 传输过半标志位
DMA_FLAG_TE3	通道 3 传输错误标志位
DMA_FLAG_GL4	通道 4 全局标志位
DMA_FLAG_TC4	通道 4 传输完成标志位
DMA_FLAG_HT4	通道 4 传输过半标志位
DMA_FLAG_TE4	通道 4 传输错误标志位
DMA_FLAG_GL5	通道 5 全局标志位
DMA_FLAG_TC5	通道 5 传输完成标志位
DMA_FLAG_HT5	通道 5 传输过半标志位
DMA_FLAG_TE5	通道 5 传输错误标志位
DMA_FLAG_GL6	通道 6 全局标志位
DMA_FLAG_TC6	通道 6 传输完成标志位
DMA_FLAG_HT6	通道 6 传输过半标志位
DMA_FLAG_TE6	通道 6 传输错误标志位
DMA_FLAG_GL7	通道 7 全局标志位
DMA_FLAG_TC7	通道 7 传输完成标志位
DMA_FLAG_HT7	通道 7 传输过半标志位
DMA_FLAG_TE7	通道 7 传输错误标志位

FlagStatus Status;
Status = DMA_GetFlagStatus(DMA_FLAG_HT6);

1.8 7.2.8函数DMA_ClearFlag

函数名	DMA_ClearFlag
函数原形	void DMA_ClearFlag(u32 DMA_FLAG)
功能描述	清除 DMA 通道 x 待处理标志位
输入参数	DMA_FLAG：待清除的 DMA 标志位，使用操作符“
参阅 Section	DMA_FLAG 查阅更多该参数允许取值范围，用户可以使用或操作选中多个标志位
输出参数	无
返回值	无
先决条件	无
被调用函数	无

例：
/* Clear the DMA Channel3 transfer error interrupt pending bit */ DMA_ClearFlag(DMA_FLAG_TE3);

1.9 函数DMA_GetITStatus

函数名	DMA_GetITStatus
函数原形	ITStatus DMA_GetITStatus(u32 DMA_IT)
功能描述	检查指定的 DMA 通道 x 中断发生与否
输入参数	DMA_IT：待检查的 DMA 中断源
参阅 Section	DMA_IT 查阅更多该参数允许取值范围
输出参数	无
返回值	DMA_IT 的新状态（SET 或者 RESET）
先决条件	无
被调用函数	无

DMA_IT	描述
DMA_IT_GL1	通道 1 全局中断
DMA_IT_TC1	通道 1 传输完成中断
DMA_IT_HT1	通道 1 传输过半中断
DMA_IT_TE1	通道 1 传输错误中断
DMA_IT_GL2	通道 2 全局中断
DMA_IT_TC2	通道 2 传输完成中断
DMA_IT_HT2	通道 2 传输过半中断
DMA_IT_TE2	通道 2 传输错误中断
DMA_IT_GL3	通道 3 全局中断
DMA_IT_TC3	通道 3 传输完成中断
DMA_IT_HT3	通道 3 传输过半中断
DMA_IT_TE3	通道 3 传输错误中断
DMA_IT_GL4	通道 4 全局中断
DMA_IT_TC4	通道 4 传输完成中断
DMA_IT_HT4	通道 4 传输过半中断
DMA_IT_TE4	通道 4 传输错误中断
DMA_IT_GL5	通道 5 全局中断
DMA_IT_TC5	通道 5 传输完成中断
DMA_IT_HT5	通道 5 传输过半中断
DMA_IT_TE5	通道 5 传输错误中断
DMA_IT_GL6	通道 6 全局中断
DMA_IT_TC6	通道 6 传输完成中断
DMA_IT_HT6	通道 6 传输过半中断
DMA_IT_TE6	通道 6 传输错误中断
DMA_IT_GL7	通道 7 全局中断
DMA_IT_TC7	通道 7 传输完成中断
DMA_IT_HT7	通道 7 传输过半中断
DMA_IT_TE7	通道 7 传输错误中断

7 transfer complete interrupt has occurred or not */
ITStatus Status;
Status = DMA_GetITStatus(DMA_IT_TC7);

1.10 函 数 DMA_ClearITPendingBit

函数名	DMA_ClearITPendingBit
函数原形	void DMA_ClearITPendingBit(u32 DMA_IT)
功能描述	清除 DMA 通道 x 中断待处理标志位
输入参数	DMA_IT：待清除的 DMA 中断待处理标志位
参阅 Section	DMA_IT 查阅更多该参数允许取值范围
输出参数	无
返回值	无
先决条件	无
被调用函数	无

例：
/* Clear the DMA Channel5 global interrupt pending bit */ DMA_ClearITPendingBit(DMA_IT_GL5);

该文档修改记录：

修改时间	修改说明
2024年1月14日	第一次发布，介绍了10 STM32标准库函数 之 DMA控制器（DMA）所有函数的介绍及使用

总结

以上就是10 STM32标准库函数 之 DMA控制器（DMA）所有函数的介绍及使用的内容，本文介绍了10 STM32标准库函数 之 DMA控制器（DMA）所有函数的介绍及使用。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。