AN4104

DMA firmware driver API

Doc ID 023131 Rev 1

7/13

2

DMA firmware driver API

This driver provides a set of firmware functions to manage the following functionalities of the

DMA peripheral:

–

Initialization and Configuration functions

–

Data Counter functions

–

Interrupts and flags management functions

For the STM32F0xx family, the DMA driver stm32f0xx_dma.c/.h can be found in the

directory: STM32F0xx_StdPeriph_Lib_vX.Y.Z\Libraries\STM32F0xx_StdPeriph_Driver.

This driver provides a fully compatible API making it easy to move from one product to

another.

Several parameters such as source/destination address (Location where data is to be read

or transferred) and transfer length must be specified in order for a DMA transaction to take

place.

Table 3.

DMA Functions description

Groups

Function name

Description

Initialization and

Configuration

functions

DMA_DeInit

Deinitializes the DMAy Channelx registers to

their default reset values.

DMA_Init

Initializes the DMAy Channelx according to

the specified parameters in the

DMA_InitStruct.

DMA_StructInit

Fills each DMA_InitStruct member with its

default value.

DMA_Cmd

Enables or disables the specified DMAy

Channelx.

Data Counter

functions

DMA_SetCurrDataCounter

Sets the number of data units in the current

DMAy Channelx transfer.

DMA_GetCurrDataCounter

Returns the number of remaining data units

in the current DMAy Channelx transfer.

Interrupts and flags

management

functions

DMA_ITConfig

Enables or disables the specified DMAy

Channelx interrupts.

DMA_GetFlagStatus

Checks whether the specified DMAy

Channelx flag is set or not..

DMA_ClearFlag

Clears the DMAy Channelx's pending flags.

DMA_GetITStatus

Checks whether the specified DMAy

Channelx interrupt has occurred or not.

DMA_ClearITPendingBit

Clears the DMAy Channelx's interrupt

pending bit..