Extended features functions

Extended features functions. More...

Collaboration diagram for Extended features functions:

Functions
HAL_StatusTypeDef	HAL_DMAEx_MultiBufferStart (DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t SecondMemAddress, uint32_t DataLength)
	Starts the multi_buffer DMA Transfer.
HAL_StatusTypeDef	HAL_DMAEx_MultiBufferStart_IT (DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t SecondMemAddress, uint32_t DataLength)
	Starts the multi_buffer DMA Transfer with interrupt enabled.
HAL_StatusTypeDef	HAL_DMAEx_ChangeMemory (DMA_HandleTypeDef *hdma, uint32_t Address, HAL_DMA_MemoryTypeDef memory)
	Change the memory0 or memory1 address on the fly.

Detailed Description

Extended features functions.

 ===============================================================================
                #####  Extended features functions  #####
 ===============================================================================  
    [..]  This section provides functions allowing to:
      (+) Configure the source, destination address and data length and 
          Start MultiBuffer DMA transfer
      (+) Configure the source, destination address and data length and 
          Start MultiBuffer DMA transfer with interrupt
      (+) Change on the fly the memory0 or memory1 address.

Function Documentation

HAL_DMAEx_MultiBufferStart()

HAL_StatusTypeDef HAL_DMAEx_MultiBufferStart	(	DMA_HandleTypeDef *	hdma,
		uint32_t	SrcAddress,
		uint32_t	DstAddress,
		uint32_t	SecondMemAddress,
		uint32_t	DataLength )

#include <stm32f4xx_hal_dma_ex.h>

Starts the multi_buffer DMA Transfer.

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA Stream.
SrcAddress	The source memory Buffer address
DstAddress	The destination memory Buffer address
SecondMemAddress	The second memory Buffer address in case of multi buffer Transfer
DataLength	The length of data to be transferred from source to destination

Return values

HAL

status

Definition at line 100 of file stm32f4xx_hal_dma_ex.c.

References __HAL_DMA_ENABLE, __HAL_LOCK, assert_param, DMA_InitTypeDef::Direction, DMA_MEMORY_TO_MEMORY, DMA_MultiBufferSetConfig(), __DMA_HandleTypeDef::ErrorCode, HAL_BUSY, HAL_DMA_ERROR_NOT_SUPPORTED, HAL_DMA_STATE_BUSY, HAL_DMA_STATE_READY, HAL_ERROR, HAL_OK, __DMA_HandleTypeDef::Init, __DMA_HandleTypeDef::Instance, IS_DMA_BUFFER_SIZE, and __DMA_HandleTypeDef::State.

HAL_DMAEx_MultiBufferStart_IT()

HAL_StatusTypeDef HAL_DMAEx_MultiBufferStart_IT	(	DMA_HandleTypeDef *	hdma,
		uint32_t	SrcAddress,
		uint32_t	DstAddress,
		uint32_t	SecondMemAddress,
		uint32_t	DataLength )

#include <stm32f4xx_hal_dma_ex.h>

Starts the multi_buffer DMA Transfer with interrupt enabled.

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA Stream.
SrcAddress	The source memory Buffer address
DstAddress	The destination memory Buffer address
SecondMemAddress	The second memory Buffer address in case of multi buffer Transfer
DataLength	The length of data to be transferred from source to destination

Return values

HAL

status

Definition at line 154 of file stm32f4xx_hal_dma_ex.c.

References __HAL_DMA_CLEAR_FLAG, __HAL_DMA_ENABLE, __HAL_DMA_GET_DME_FLAG_INDEX, __HAL_DMA_GET_FE_FLAG_INDEX, __HAL_DMA_GET_HT_FLAG_INDEX, __HAL_DMA_GET_TC_FLAG_INDEX, __HAL_DMA_GET_TE_FLAG_INDEX, __HAL_LOCK, __HAL_UNLOCK, assert_param, DMA_InitTypeDef::Direction, DMA_IT_DME, DMA_IT_FE, DMA_IT_HT, DMA_IT_TC, DMA_IT_TE, DMA_MEMORY_TO_MEMORY, DMA_MultiBufferSetConfig(), __DMA_HandleTypeDef::ErrorCode, HAL_BUSY, HAL_DMA_ERROR_NONE, HAL_DMA_ERROR_NOT_SUPPORTED, HAL_DMA_ERROR_PARAM, HAL_DMA_STATE_BUSY, HAL_DMA_STATE_READY, HAL_ERROR, HAL_OK, __DMA_HandleTypeDef::Init, __DMA_HandleTypeDef::Instance, IS_DMA_BUFFER_SIZE, __DMA_HandleTypeDef::State, __DMA_HandleTypeDef::XferCpltCallback, __DMA_HandleTypeDef::XferErrorCallback, __DMA_HandleTypeDef::XferHalfCpltCallback, __DMA_HandleTypeDef::XferM1CpltCallback, and __DMA_HandleTypeDef::XferM1HalfCpltCallback.

Referenced by HAL_DCMI_Start_DMA().

HAL_DMAEx_ChangeMemory()

HAL_StatusTypeDef HAL_DMAEx_ChangeMemory	(	DMA_HandleTypeDef *	hdma,
		uint32_t	Address,
		HAL_DMA_MemoryTypeDef	memory )

#include <stm32f4xx_hal_dma_ex.h>

Change the memory0 or memory1 address on the fly.

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA Stream.
Address	The new address
memory	the memory to be changed, This parameter can be one of the following values: MEMORY0 / MEMORY1

Note

The MEMORY0 address can be changed only when the current transfer use MEMORY1 and the MEMORY1 address can be changed only when the current transfer use MEMORY0.

Return values

HAL

status

Definition at line 239 of file stm32f4xx_hal_dma_ex.c.

References HAL_OK, __DMA_HandleTypeDef::Instance, and MEMORY0.

Referenced by DCMI_DMAXferCplt().