DMA driver modules. More...

Modules
	DMA_Exported_Constants

	DMA_Private_Functions

Data Structures
struct	DMA_InitTypeDef
	DMA Init structure definition. More...

Macros
#define	TRANSFER_IT_ENABLE_MASK

#define	DMA_Stream0_IT_MASK

#define	DMA_Stream1_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 6)

#define	DMA_Stream2_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 16)

#define	DMA_Stream3_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 22)

#define	DMA_Stream4_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK \| (uint32_t)0x20000000)

#define	DMA_Stream5_IT_MASK (uint32_t)(DMA_Stream1_IT_MASK \| (uint32_t)0x20000000)

#define	DMA_Stream6_IT_MASK (uint32_t)(DMA_Stream2_IT_MASK \| (uint32_t)0x20000000)

#define	DMA_Stream7_IT_MASK (uint32_t)(DMA_Stream3_IT_MASK \| (uint32_t)0x20000000)

#define	TRANSFER_IT_MASK (uint32_t)0x0F3C0F3C

#define	HIGH_ISR_MASK (uint32_t)0x20000000

#define	RESERVED_MASK (uint32_t)0x0F7D0F7D

Functions
void	DMA_DeInit (DMA_Stream_TypeDef *DMAy_Streamx)
	Deinitialize the DMAy Streamx registers to their default reset values. More...

void	DMA_Init (DMA_Stream_TypeDef DMAy_Streamx, DMA_InitTypeDef DMA_InitStruct)
	Initializes the DMAy Streamx according to the specified parameters in the DMA_InitStruct structure. More...

void	DMA_StructInit (DMA_InitTypeDef *DMA_InitStruct)
	Fills each DMA_InitStruct member with its default value. More...

void	DMA_Cmd (DMA_Stream_TypeDef *DMAy_Streamx, FunctionalState NewState)
	Enables or disables the specified DMAy Streamx. More...

void	DMA_PeriphIncOffsetSizeConfig (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_Pincos)
	Configures, when the PINC (Peripheral Increment address mode) bit is set, if the peripheral address should be incremented with the data size (configured with PSIZE bits) or by a fixed offset equal to 4 (32-bit aligned addresses). More...

void	DMA_FlowControllerConfig (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_FlowCtrl)
	Configures, when the DMAy Streamx is disabled, the flow controller for the next transactions (Peripheral or Memory). More...

void	DMA_SetCurrDataCounter (DMA_Stream_TypeDef *DMAy_Streamx, uint16_t Counter)
	Writes the number of data units to be transferred on the DMAy Streamx. More...

uint16_t	DMA_GetCurrDataCounter (DMA_Stream_TypeDef *DMAy_Streamx)
	Returns the number of remaining data units in the current DMAy Streamx transfer. More...

void	DMA_DoubleBufferModeConfig (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t Memory1BaseAddr, uint32_t DMA_CurrentMemory)
	Configures, when the DMAy Streamx is disabled, the double buffer mode and the current memory target. More...

void	DMA_DoubleBufferModeCmd (DMA_Stream_TypeDef *DMAy_Streamx, FunctionalState NewState)
	Enables or disables the double buffer mode for the selected DMA stream. More...

void	DMA_MemoryTargetConfig (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t MemoryBaseAddr, uint32_t DMA_MemoryTarget)
	Configures the Memory address for the next buffer transfer in double buffer mode (for dynamic use). This function can be called when the DMA Stream is enabled and when the transfer is ongoing. More...

uint32_t	DMA_GetCurrentMemoryTarget (DMA_Stream_TypeDef *DMAy_Streamx)
	Returns the current memory target used by double buffer transfer. More...

FunctionalState	DMA_GetCmdStatus (DMA_Stream_TypeDef *DMAy_Streamx)
	Returns the status of EN bit for the specified DMAy Streamx. More...

uint32_t	DMA_GetFIFOStatus (DMA_Stream_TypeDef *DMAy_Streamx)
	Returns the current DMAy Streamx FIFO filled level. More...

FlagStatus	DMA_GetFlagStatus (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_FLAG)
	Checks whether the specified DMAy Streamx flag is set or not. More...

void	DMA_ClearFlag (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_FLAG)
	Clears the DMAy Streamx's pending flags. More...

void	DMA_ITConfig (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_IT, FunctionalState NewState)
	Enables or disables the specified DMAy Streamx interrupts. More...

ITStatus	DMA_GetITStatus (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_IT)
	Checks whether the specified DMAy Streamx interrupt has occurred or not. More...

void	DMA_ClearITPendingBit (DMA_Stream_TypeDef *DMAy_Streamx, uint32_t DMA_IT)
	Clears the DMAy Streamx's interrupt pending bits. More...

Detailed Description

DMA driver modules.

Macro Definition Documentation

#define DMA_Stream0_IT_MASK

Value:

(uint32_t)(DMA_LISR_FEIF0 | DMA_LISR_DMEIF0 | \
                                           DMA_LISR_TEIF0 | DMA_LISR_HTIF0 | \
                                           DMA_LISR_TCIF0)

#define TRANSFER_IT_ENABLE_MASK

Value:

(uint32_t)(DMA_SxCR_TCIE | DMA_SxCR_HTIE | \

DMA_SxCR_TEIE | DMA_SxCR_DMEIE)

Function Documentation

void DMA_ClearFlag	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_FLAG
	)

Clears the DMAy Streamx's pending flags.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_FLAG,:	specifies the flag to clear. This parameter can be any combination of the following values: DMA_FLAG_TCIFx: Streamx transfer complete flag DMA_FLAG_HTIFx: Streamx half transfer complete flag DMA_FLAG_TEIFx: Streamx transfer error flag DMA_FLAG_DMEIFx: Streamx direct mode error flag DMA_FLAG_FEIFx: Streamx FIFO error flag Where x can be 0 to 7 to select the DMA Stream.

Return values

None

void DMA_ClearITPendingBit	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_IT
	)

Clears the DMAy Streamx's interrupt pending bits.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

DMA_IT,:

specifies the DMA interrupt pending bit to clear. This parameter can be any combination of the following values:

DMA_IT_TCIFx: Streamx transfer complete interrupt
DMA_IT_HTIFx: Streamx half transfer complete interrupt
DMA_IT_TEIFx: Streamx transfer error interrupt
DMA_IT_DMEIFx: Streamx direct mode error interrupt
DMA_IT_FEIFx: Streamx FIFO error interrupt Where x can be 0 to 7 to select the DMA Stream.

Return values

None

void DMA_Cmd	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		FunctionalState	NewState
	)

Enables or disables the specified DMAy Streamx.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
NewState,:	new state of the DMAy Streamx. This parameter can be: ENABLE or DISABLE.

Note: This function may be used to perform Pause-Resume operation. When a transfer is ongoing, calling this function to disable the Stream will cause the transfer to be paused. All configuration registers and the number of remaining data will be preserved. When calling again this function to re-enable the Stream, the transfer will be resumed from the point where it was paused.; After configuring the DMA Stream (DMA_Init() function) and enabling the stream, it is recommended to check (or wait until) the DMA Stream is effectively enabled. A Stream may remain disabled if a configuration parameter is wrong. After disabling a DMA Stream, it is also recommended to check (or wait until) the DMA Stream is effectively disabled. If a Stream is disabled while a data transfer is ongoing, the current data will be transferred and the Stream will be effectively disabled only after the transfer of this single data is finished.

Return values

None

void DMA_DeInit ( DMA_Stream_TypeDef * DMAy_Streamx )

Deinitialize the DMAy Streamx registers to their default reset values.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

Return values

None

void DMA_DoubleBufferModeCmd	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		FunctionalState	NewState
	)

Enables or disables the double buffer mode for the selected DMA stream.

Note: This function can be called only when the DMA Stream is disabled.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
NewState,:	new state of the DMAy Streamx double buffer mode. This parameter can be: ENABLE or DISABLE.

Return values

None

void DMA_DoubleBufferModeConfig	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	Memory1BaseAddr,
		uint32_t	DMA_CurrentMemory
	)

Configures, when the DMAy Streamx is disabled, the double buffer mode and the current memory target.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
Memory1BaseAddr,:	the base address of the second buffer (Memory 1)
DMA_CurrentMemory,:	specifies which memory will be first buffer for the transactions when the Stream will be enabled. This parameter can be one of the following values: DMA_Memory_0: Memory 0 is the current buffer. DMA_Memory_1: Memory 1 is the current buffer.

Note: Memory0BaseAddr is set by the DMA structure configuration in DMA_Init().

Return values

None

void DMA_FlowControllerConfig	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_FlowCtrl
	)

Configures, when the DMAy Streamx is disabled, the flow controller for the next transactions (Peripheral or Memory).

Note: Before enabling this feature, check if the used peripheral supports the Flow Controller mode or not.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_FlowCtrl,:	specifies the DMA flow controller. This parameter can be one of the following values: DMA_FlowCtrl_Memory: DMAy_Streamx transactions flow controller is the DMA controller. DMA_FlowCtrl_Peripheral: DMAy_Streamx transactions flow controller is the peripheral.

Return values

None

FunctionalState DMA_GetCmdStatus ( DMA_Stream_TypeDef * DMAy_Streamx )

Returns the status of EN bit for the specified DMAy Streamx.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

Note: After configuring the DMA Stream (DMA_Init() function) and enabling the stream, it is recommended to check (or wait until) the DMA Stream is effectively enabled. A Stream may remain disabled if a configuration parameter is wrong. After disabling a DMA Stream, it is also recommended to check (or wait until) the DMA Stream is effectively disabled. If a Stream is disabled while a data transfer is ongoing, the current data will be transferred and the Stream will be effectively disabled only after the transfer of this single data is finished.

Return values

Current state of the DMAy Streamx (ENABLE or DISABLE).

uint16_t DMA_GetCurrDataCounter ( DMA_Stream_TypeDef * DMAy_Streamx )

Returns the number of remaining data units in the current DMAy Streamx transfer.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

Return values

The	number of remaining data units in the current DMAy Streamx transfer.

uint32_t DMA_GetCurrentMemoryTarget ( DMA_Stream_TypeDef * DMAy_Streamx )

Returns the current memory target used by double buffer transfer.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

Return values

The	memory target number: 0 for Memory0 or 1 for Memory1.

uint32_t DMA_GetFIFOStatus ( DMA_Stream_TypeDef * DMAy_Streamx )

Returns the current DMAy Streamx FIFO filled level.

Parameters

DMAy_Streamx,: where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.

Return values

The

FIFO filling state.

DMA_FIFOStatus_Less1QuarterFull: when FIFO is less than 1 quarter-full and not empty.
DMA_FIFOStatus_1QuarterFull: if more than 1 quarter-full.
DMA_FIFOStatus_HalfFull: if more than 1 half-full.
DMA_FIFOStatus_3QuartersFull: if more than 3 quarters-full.
DMA_FIFOStatus_Empty: when FIFO is empty
DMA_FIFOStatus_Full: when FIFO is full

FlagStatus DMA_GetFlagStatus	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_FLAG
	)

Checks whether the specified DMAy Streamx flag is set or not.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_FLAG,:	specifies the flag to check. This parameter can be one of the following values: DMA_FLAG_TCIFx: Streamx transfer complete flag DMA_FLAG_HTIFx: Streamx half transfer complete flag DMA_FLAG_TEIFx: Streamx transfer error flag DMA_FLAG_DMEIFx: Streamx direct mode error flag DMA_FLAG_FEIFx: Streamx FIFO error flag Where x can be 0 to 7 to select the DMA Stream.

Return values

The	new state of DMA_FLAG (SET or RESET).

ITStatus DMA_GetITStatus	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_IT
	)

Checks whether the specified DMAy Streamx interrupt has occurred or not.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_IT,:	specifies the DMA interrupt source to check. This parameter can be one of the following values: DMA_IT_TCIFx: Streamx transfer complete interrupt DMA_IT_HTIFx: Streamx half transfer complete interrupt DMA_IT_TEIFx: Streamx transfer error interrupt DMA_IT_DMEIFx: Streamx direct mode error interrupt DMA_IT_FEIFx: Streamx FIFO error interrupt Where x can be 0 to 7 to select the DMA Stream.

Return values

The	new state of DMA_IT (SET or RESET).

void DMA_Init	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		DMA_InitTypeDef *	DMA_InitStruct
	)

Initializes the DMAy Streamx according to the specified parameters in the DMA_InitStruct structure.

Note: Before calling this function, it is recommended to check that the Stream is actually disabled using the function DMA_GetCmdStatus().

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_InitStruct,:	pointer to a DMA_InitTypeDef structure that contains the configuration information for the specified DMA Stream.

Return values

None

void DMA_ITConfig	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_IT,
		FunctionalState	NewState
	)

Enables or disables the specified DMAy Streamx interrupts.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_IT,:	specifies the DMA interrupt sources to be enabled or disabled. This parameter can be any combination of the following values: DMA_IT_TC: Transfer complete interrupt mask DMA_IT_HT: Half transfer complete interrupt mask DMA_IT_TE: Transfer error interrupt mask DMA_IT_FE: FIFO error interrupt mask
NewState,:	new state of the specified DMA interrupts. This parameter can be: ENABLE or DISABLE.

Return values

None

void DMA_MemoryTargetConfig	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	MemoryBaseAddr,
		uint32_t	DMA_MemoryTarget
	)

Configures the Memory address for the next buffer transfer in double buffer mode (for dynamic use). This function can be called when the DMA Stream is enabled and when the transfer is ongoing.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
MemoryBaseAddr,:	The base address of the target memory buffer
DMA_MemoryTarget,:	Next memory target to be used. This parameter can be one of the following values: DMA_Memory_0: To use the memory address 0 DMA_Memory_1: To use the memory address 1

Note: It is not allowed to modify the Base Address of a target Memory when this target is involved in the current transfer. ie. If the DMA Stream is currently transferring to/from Memory 1, then it not possible to modify Base address of Memory 1, but it is possible to modify Base address of Memory 0. To know which Memory is currently used, you can use the function DMA_GetCurrentMemoryTarget().

Return values

None

void DMA_PeriphIncOffsetSizeConfig	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint32_t	DMA_Pincos
	)

Configures, when the PINC (Peripheral Increment address mode) bit is set, if the peripheral address should be incremented with the data size (configured with PSIZE bits) or by a fixed offset equal to 4 (32-bit aligned addresses).

Note: This function has no effect if the Peripheral Increment mode is disabled.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
DMA_Pincos,:	specifies the Peripheral increment offset size. This parameter can be one of the following values: DMA_PINCOS_Psize: Peripheral address increment is done accordingly to PSIZE parameter. DMA_PINCOS_WordAligned: Peripheral address increment offset is fixed to 4 (32-bit aligned addresses).

Return values

None

void DMA_SetCurrDataCounter	(	DMA_Stream_TypeDef *	DMAy_Streamx,
		uint16_t	Counter
	)

Writes the number of data units to be transferred on the DMAy Streamx.

Parameters

DMAy_Streamx,:	where y can be 1 or 2 to select the DMA and x can be 0 to 7 to select the DMA Stream.
Counter,:	Number of data units to be transferred (from 0 to 65535) Number of data items depends only on the Peripheral data format.

Note: If Peripheral data format is Bytes: number of data units is equal to total number of bytes to be transferred.; If Peripheral data format is Half-Word: number of data units is equal to total number of bytes to be transferred / 2.; If Peripheral data format is Word: number of data units is equal to total number of bytes to be transferred / 4.; In Memory-to-Memory transfer mode, the memory buffer pointed by DMAy_SxPAR register is considered as Peripheral.

Return values

The	number of remaining data units in the current DMAy Streamx transfer.

void DMA_StructInit ( DMA_InitTypeDef * DMA_InitStruct )

Fills each DMA_InitStruct member with its default value.

Parameters

DMA_InitStruct : pointer to a DMA_InitTypeDef structure which will be initialized.

Return values

None

Modules

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

Function Documentation