DMA HAL module driver. More...

Data Structures
struct	DMA_Base_Registers
Modules
	DMA Exported Types
	DMA Exported Types.
	DMA Exported Constants
	DMA Exported constants.
	DMA Exported Functions
	DMA Exported functions.
	DMA Private Constants
	DMA private defines and constants.
	DMA Private Macros
	DMA private macros.
	DMA Private Functions
	DMA private functions.
Defines
#define	__HAL_DMA_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_DMA_STATE_RESET)
	Reset DMA handle state.
#define	__HAL_DMA_GET_FS(__HANDLE__) (((__HANDLE__)->Instance->FCR & (DMA_SxFCR_FS)))
	Return the current DMA Stream FIFO filled level.
#define	__HAL_DMA_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR \|= DMA_SxCR_EN)
	Enable the specified DMA Stream.
#define	__HAL_DMA_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~DMA_SxCR_EN)
	Disable the specified DMA Stream.
#define	__HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__)
	Return the current DMA Stream transfer complete flag.
#define	__HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)
	Return the current DMA Stream half transfer complete flag.
#define	__HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)
	Return the current DMA Stream transfer error flag.
#define	__HAL_DMA_GET_FE_FLAG_INDEX(__HANDLE__)
	Return the current DMA Stream FIFO error flag.
#define	__HAL_DMA_GET_DME_FLAG_INDEX(__HANDLE__)
	Return the current DMA Stream direct mode error flag.
#define	__HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__)
	Get the DMA Stream pending flags.
#define	__HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__)
	Clear the DMA Stream pending flags.
#define	__HAL_DMA_ENABLE_IT(__HANDLE__, __INTERRUPT__)
	Enable the specified DMA Stream interrupts.
#define	__HAL_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__)
	Disable the specified DMA Stream interrupts.
#define	__HAL_DMA_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)
	Check whether the specified DMA Stream interrupt is enabled or disabled.
#define	__HAL_DMA_SET_COUNTER(__HANDLE__, __COUNTER__) ((__HANDLE__)->Instance->NDTR = (uint16_t)(__COUNTER__))
	Writes the number of data units to be transferred on the DMA Stream.
#define	__HAL_DMA_GET_COUNTER(__HANDLE__) ((__HANDLE__)->Instance->NDTR)
	Returns the number of remaining data units in the current DMAy Streamx transfer.

Detailed Description

DMA HAL module driver.

Define Documentation

#define __HAL_DMA_CLEAR_FLAG	(	__HANDLE__,
		__FLAG__
	)

Value:

(((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA2_Stream3)? (DMA2->HIFCR = (__FLAG__)) :\
 ((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Stream7)? (DMA2->LIFCR = (__FLAG__)) :\
 ((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Stream3)? (DMA1->HIFCR = (__FLAG__)) : (DMA1->LIFCR = (__FLAG__)))

Clear the DMA Stream pending flags.

Parameters:

__HANDLE__	DMA handle
__FLAG__	specifies the flag to clear. This parameter can be any combination of the following values: DMA_FLAG_TCIFx: Transfer complete flag. DMA_FLAG_HTIFx: Half transfer complete flag. DMA_FLAG_TEIFx: Transfer error flag. DMA_FLAG_DMEIFx: Direct mode error flag. DMA_FLAG_FEIFx: FIFO error flag. Where x can be 0_4, 1_5, 2_6 or 3_7 to select the DMA Stream flag.

Return values:

None

Definition at line 560 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_DISABLE ( __HANDLE__ ) ((__HANDLE__)->Instance->CR &= ~DMA_SxCR_EN)

Disable the specified DMA Stream.

Parameters:

__HANDLE__ DMA handle

Return values:

None

Definition at line 425 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMA_Abort(), HAL_DMA_Abort_IT(), HAL_DMA_DeInit(), HAL_DMA_Init(), HAL_DMA_IRQHandler(), HAL_QSPI_IRQHandler(), SDRAM_DMACplt(), SDRAM_DMACpltProt(), SDRAM_DMAError(), SRAM_DMACplt(), SRAM_DMACpltProt(), and SRAM_DMAError().

#define __HAL_DMA_DISABLE_IT	(	__HANDLE__,
		__INTERRUPT__
	)

Value:

(((__INTERRUPT__) != DMA_IT_FE)? \
((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__)) : ((__HANDLE__)->Instance->FCR &= ~(__INTERRUPT__)))

Disable the specified DMA Stream interrupts.

Parameters:

__HANDLE__	DMA handle
__INTERRUPT__	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. DMA_IT_DME: Direct mode error interrupt.

Return values:

None

Definition at line 592 of file stm32f4xx_hal_dma.h.

#define __HAL_DMA_ENABLE ( __HANDLE__ ) ((__HANDLE__)->Instance->CR |= DMA_SxCR_EN)

Enable the specified DMA Stream.

Parameters:

__HANDLE__ DMA handle

Return values:

None

Definition at line 418 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMA_Start(), HAL_DMA_Start_IT(), HAL_DMAEx_MultiBufferStart(), and HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_ENABLE_IT	(	__HANDLE__,
		__INTERRUPT__
	)

Value:

(((__INTERRUPT__) != DMA_IT_FE)? \
((__HANDLE__)->Instance->CR |= (__INTERRUPT__)) : ((__HANDLE__)->Instance->FCR |= (__INTERRUPT__)))

Enable the specified DMA Stream interrupts.

Parameters:

__HANDLE__	DMA handle
__INTERRUPT__	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. DMA_IT_DME: Direct mode error interrupt.

Return values:

None

Definition at line 577 of file stm32f4xx_hal_dma.h.

#define __HAL_DMA_GET_COUNTER ( __HANDLE__ ) ((__HANDLE__)->Instance->NDTR)

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

Parameters:

__HANDLE__ DMA handle

Return values:

The	number of remaining data units in the current DMA Stream transfer.

Definition at line 636 of file stm32f4xx_hal_dma.h.

Referenced by HAL_UART_IRQHandler(), and I2C_Slave_STOPF().

#define __HAL_DMA_GET_DME_FLAG_INDEX ( __HANDLE__ )

Value:

(((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream0))? DMA_FLAG_DMEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream0))? DMA_FLAG_DMEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream4))? DMA_FLAG_DMEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream4))? DMA_FLAG_DMEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream1))? DMA_FLAG_DMEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream1))? DMA_FLAG_DMEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream5))? DMA_FLAG_DMEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream5))? DMA_FLAG_DMEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream2))? DMA_FLAG_DMEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream2))? DMA_FLAG_DMEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream6))? DMA_FLAG_DMEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream6))? DMA_FLAG_DMEIF2_6 :\
   DMA_FLAG_DMEIF3_7)

Return the current DMA Stream direct mode error flag.

Parameters:

__HANDLE__ DMA handle

Return values:

The	specified direct mode error flag index.

Definition at line 514 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_GET_FE_FLAG_INDEX ( __HANDLE__ )

Value:

(((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream0))? DMA_FLAG_FEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream0))? DMA_FLAG_FEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream4))? DMA_FLAG_FEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream4))? DMA_FLAG_FEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream1))? DMA_FLAG_FEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream1))? DMA_FLAG_FEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream5))? DMA_FLAG_FEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream5))? DMA_FLAG_FEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream2))? DMA_FLAG_FEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream2))? DMA_FLAG_FEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream6))? DMA_FLAG_FEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream6))? DMA_FLAG_FEIF2_6 :\
   DMA_FLAG_FEIF3_7)

Return the current DMA Stream FIFO error flag.

Parameters:

__HANDLE__ DMA handle

Return values:

The	specified FIFO error flag index.

Definition at line 494 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_GET_FLAG	(	__HANDLE__,
		__FLAG__
	)

Value:

(((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA2_Stream3)? (DMA2->HISR & (__FLAG__)) :\
 ((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Stream7)? (DMA2->LISR & (__FLAG__)) :\
 ((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Stream3)? (DMA1->HISR & (__FLAG__)) : (DMA1->LISR & (__FLAG__)))

Get the DMA Stream pending flags.

Parameters:

__HANDLE__	DMA handle
__FLAG__	Get the specified flag. This parameter can be any combination of the following values: DMA_FLAG_TCIFx: Transfer complete flag. DMA_FLAG_HTIFx: Half transfer complete flag. DMA_FLAG_TEIFx: Transfer error flag. DMA_FLAG_DMEIFx: Direct mode error flag. DMA_FLAG_FEIFx: FIFO error flag. Where x can be 0_4, 1_5, 2_6 or 3_7 to select the DMA Stream flag.

Return values:

The	state of FLAG (SET or RESET).

Definition at line 542 of file stm32f4xx_hal_dma.h.

#define __HAL_DMA_GET_FS ( __HANDLE__ ) (((__HANDLE__)->Instance->FCR & (DMA_SxFCR_FS)))

Return the current DMA Stream FIFO filled level.

Parameters:

__HANDLE__ DMA handle

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

Definition at line 411 of file stm32f4xx_hal_dma.h.

#define __HAL_DMA_GET_HT_FLAG_INDEX ( __HANDLE__ )

Value:

(((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream0))? DMA_FLAG_HTIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream0))? DMA_FLAG_HTIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream4))? DMA_FLAG_HTIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream4))? DMA_FLAG_HTIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream1))? DMA_FLAG_HTIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream1))? DMA_FLAG_HTIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream5))? DMA_FLAG_HTIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream5))? DMA_FLAG_HTIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream2))? DMA_FLAG_HTIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream2))? DMA_FLAG_HTIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream6))? DMA_FLAG_HTIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream6))? DMA_FLAG_HTIF2_6 :\
   DMA_FLAG_HTIF3_7)

Return the current DMA Stream half transfer complete flag.

Parameters:

__HANDLE__ DMA handle

Return values:

The	specified half transfer complete flag index.

Definition at line 454 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_GET_IT_SOURCE	(	__HANDLE__,
		__INTERRUPT__
	)

Value:

(((__INTERRUPT__) != DMA_IT_FE)? \
                                                        ((__HANDLE__)->Instance->CR & (__INTERRUPT__)) : \
                                                        ((__HANDLE__)->Instance->FCR & (__INTERRUPT__)))

Check whether the specified DMA Stream interrupt is enabled or disabled.

Parameters:

__HANDLE__	DMA handle
__INTERRUPT__	specifies the DMA interrupt source to check. This parameter can be one 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. DMA_IT_DME: Direct mode error interrupt.

Return values:

The	state of DMA_IT.

Definition at line 607 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMA_IRQHandler().

#define __HAL_DMA_GET_TC_FLAG_INDEX ( __HANDLE__ )

Value:

(((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream0))? DMA_FLAG_TCIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream0))? DMA_FLAG_TCIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream4))? DMA_FLAG_TCIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream4))? DMA_FLAG_TCIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream1))? DMA_FLAG_TCIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream1))? DMA_FLAG_TCIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream5))? DMA_FLAG_TCIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream5))? DMA_FLAG_TCIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream2))? DMA_FLAG_TCIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream2))? DMA_FLAG_TCIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream6))? DMA_FLAG_TCIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream6))? DMA_FLAG_TCIF2_6 :\
   DMA_FLAG_TCIF3_7)

Return the current DMA Stream transfer complete flag.

Parameters:

__HANDLE__ DMA handle

Return values:

The	specified transfer complete flag index.

Definition at line 434 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_GET_TE_FLAG_INDEX ( __HANDLE__ )

Value:

(((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream0))? DMA_FLAG_TEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream0))? DMA_FLAG_TEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream4))? DMA_FLAG_TEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream4))? DMA_FLAG_TEIF0_4 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream1))? DMA_FLAG_TEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream1))? DMA_FLAG_TEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream5))? DMA_FLAG_TEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream5))? DMA_FLAG_TEIF1_5 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream2))? DMA_FLAG_TEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream2))? DMA_FLAG_TEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Stream6))? DMA_FLAG_TEIF2_6 :\
 ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Stream6))? DMA_FLAG_TEIF2_6 :\
   DMA_FLAG_TEIF3_7)

Return the current DMA Stream transfer error flag.

Parameters:

__HANDLE__ DMA handle

Return values:

The	specified transfer error flag index.

Definition at line 474 of file stm32f4xx_hal_dma.h.

Referenced by HAL_DMAEx_MultiBufferStart_IT().

#define __HAL_DMA_RESET_HANDLE_STATE ( __HANDLE__ ) ((__HANDLE__)->State = HAL_DMA_STATE_RESET)

Reset DMA handle state.

Parameters:

__HANDLE__ specifies the DMA handle.

Return values:

None

Definition at line 397 of file stm32f4xx_hal_dma.h.

#define __HAL_DMA_SET_COUNTER	(	__HANDLE__,
		__COUNTER__
	)	((__HANDLE__)->Instance->NDTR = (uint16_t)(__COUNTER__))

Writes the number of data units to be transferred on the DMA Stream.

Parameters:

__HANDLE__	DMA handle
__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.

Return values:

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

Definition at line 628 of file stm32f4xx_hal_dma.h.

Data Structures

Modules

Defines

Detailed Description

Define Documentation